Inquire Trace Vertex Result

SD-INQ-TRACE-VERTEX-DATA

(sd-inq-trace-vertex-data)
  

Description:

Returns the traced positions of all vertices of the last trace operation.
A trace operation for vertices is available within the Animation Module.
To call the trace function programatically the following command can be used:

(sd-call-cmds (ANIM_TRACE_ANIMATION :ANIMATION_ITEM [SEL_ITEM of an animation]
                                    :PLAY_STEPS     [number of steps to be recorded]
                                    :TRACE_VERTICES [list of SEL_ITEMs of vertices to be traced]
                                    :PLAY)
    

The selection type for an animation is ANIM::S_ANIM_ANIMATION.

Parameters: -

Return Value:

nil - No last trace result available.

{LIST of LIST of GPNT3Ds} - A list of lists of 3D positions.

Example:

5 vertices traced with 7 steps ( + 1 initial step)

    ( 
      ( 11,11,11   - first vertex, first position
        21,21,21
        ...
        81,81,81 ) - first vertex, last (eighth) position
      ( 12,12,12   - second vertex, first position
        22,22,22
        ...
        82,82,82 )
      ...
      ( 15,15,15
        25,25,25
        ...
        85,85,85 ) - fifth vertex, eighth position
    )
    

Note: each list for one vertex contains exactly steps + 1 3D positions.