motionTrailShape

Go to: Related nodes. Attributes.

A motionTrail is a piecewise linear curve drawn a series of points. The motionTrail is not deformable or renderable, but can be used to display the trajectory of a node in time.

Related nodes

motionTrail, snapshot

Attributes (69)

The following quick index only shows top-level attributes (too many attributes to show them all): activeKeyframeColor (3), beadColor (3), extraKeyframeColor (3), extraKeyframeTimes, extraTrailColor (3), fadeInoutFrames, fastTrailColor (3), frameMarkerColor (3), frameMarkerSize, increment, keyframeColor (3), keyframeFlags, keyframeSize, keyframeTimes, localPosition (3), modifyKeys, pinned, postFrame, preFrame, showExtraKeys, showFrameMarkerFrames, showFrameMarkers, showInBead, showInTangent, showKeyframes, showOutBead, showOutTangent, slowTrailColor (3), startTime, tangentPoints (3), trailColor (3), trailDrawMode, trailPathMode, trailThickness, transformToMove, xrayDraw

Long name (short name)	Type	Default	Flags
activeKeyframeColor (ak)	float3	1.0, 1.0, 0.0
The color of selected keyframes
activeKeyframeColorR (akr) float 1.0 Active keyframe red color value
activeKeyframeColorG (akg) float 1.0 Active keyframe green color value
activeKeyframeColorB (akb) float 0.0 Active keyframe blue color value
beadColor (bc)	float3	1.0, 0.0, 1.0
The color of the bead
beadColorR (bcr) float 1.0 Bead red color value
beadColorG (bcg) float 0.0 Bead green color value
beadColorB (bcb) float 1.0 Bead blue color value
extraKeyframeColor (ec)	float3
The color of the extra keyframes
extraKeyframeColorR (ecr) float 0.451 Extra keyframes red color value
extraKeyframeColorG (ecg) float 0.451 Extra keyframes green color value
extraKeyframeColorB (ecb) float 0.451 Extra keyframes blue color value
extraKeyframeTimes (ekt)	doubleArray	empty
Stores the list of extra (non-translation) key times
extraTrailColor (etc)	float3
The additional color the trail uses when alternating colors between frames or showing the portion of the trail after the current frame in a different color.
extraTrailColorR (etcr) float 0.125 Extra trail red color value
extraTrailColorG (etcg) float 0.098 Extra trail green color value
extraTrailColorB (etcb) float 0.49 Extra trail blue color value
fadeInoutFrames (fi)	integer	0
The number of frames over which the motion trail will fade in and out.
fastTrailColor (ftc)	float3	0.612, 0, 0
The color to show on the motion trail when the object is moving at its fastest when the velocity trail draw mode is selected.
fastTrailColorR (ftr) float 0.612 Fast velocity trail red color value
fastTrailColorG (ftg) float 0 Fast velocity trail green color value
fastTrailColorB (ftb) float 0 Fast velocity trail blue color value
frameMarkerColor (fc)	float3
The color of the frame markers
frameMarkerColorR (fcr) float 0.155 Frame marker red color value
frameMarkerColorG (fcg) float 0.553 Frame marker green color value
frameMarkerColorB (fcb) float 0.111 Frame marker blue color value
frameMarkerSize (fs)	integer	1
The size of the frame markers in pixels
increment (b)	time	1film
How much time exists between copies of the geometry. We need this in order to use the pre and post frame attributes to limit the drawing of the curve
keyframeColor (kc)	float3	1.0, 1.0, 1.0
The color of the keyframe
keyframeColorR (kcr) float 1.0 Keyframe red color value
keyframeColorG (kcg) float 1.0 Keyframe green color value
keyframeColorB (kcb) float 1.0 Keyframe blue color value
keyframeFlags (fk)	intArray	empty
Stores a list of flags for each key frame specifying what type it is kMotionTrailNoTangent (0 - editable, no tangents) kMotionTrailTangent (1 - unlocked weighted fixed/spline) kMotionTrailLockedTangent (2 - locked weighted fixed/spline) kMotionTrailBreakdown (2 - breakdown)
keyframeSize (ks)	integer	1
The size of the key frames in pixels
keyframeTimes (kt)	doubleArray	empty
Stores the list of key times
localPosition (lp)	double3
Local offset from the transformToMove's world matrix, from we draw the trail
localPositionX (lpx) distance (double) 0.0cm Local location in X.
localPositionY (lpy) distance (double) 0.0cm Local location in Y.
localPositionZ (lpz) distance (double) 0.0cm Local location in Z.
modifyKeys (mok)	bool	0
Toggle the modify key tool
trailPathMode (tpm)	enum	1
Controls which part of the motion trail is shown while rendering Legal values: 0 = Before Current Frame, 1 = All Frames, 2 = After Current Frame
pinned (pd)	bool	1
Whether or not the motion trail is persistent after the selection is done
postFrame (af)	integer	0
The number of frames before the current time to draw the motion trail
preFrame (bf)	integer	0
The number of frames before the current time to draw the motion trail
showExtraKeys (sek)	bool	0
Show non-translation keys
showFrameMarkerFrames (sff)	bool	0
Show frame numbers on the frame markers
showFrameMarkers (sfm)	bool	0
Show the frame markers
showInBead (sib)	bool	0
Toggle the show in bead tool
showInTangent (sit)	bool	0
Show the in tangent handle for the selected point
showKeyframes (skf)	bool	1
Show the keyframe points
showOutBead (sob)	bool	0
Toggle the show out bead tool
showOutTangent (sot)	bool	0
Show the out tangent handle for the selected point
slowTrailColor (stc)	float3	0.230, 0.071, 0.404
The color to show on the motion trail when the object is moving at its slowest when the velocity trail draw mode is selected.
slowTrailColorR (str) float 0.230 Slow velocity trail red color value
slowTrailColorG (stg) float 0.071 Slow velocity trail green color value
slowTrailColorB (stb) float 0.404 Slow velocity trail blue color value
startTime (s)	time	::zero
The first time at which the curve is created. We need this in order to use the pre and post frame attributes to limit the drawing of the curve
tangentPoints (tps)	double3
control points for the derived shapes
txValue (txv) distance (double) 0.0cm X value of a tangent point
tyValue (tyv) distance (double) 0.0cm Y value of a tangent point
tzValue (tzv) distance (double) 0.0cm Z value of a tangent point
trailDrawMode (tdm)	enum	2
Displays the motion trail in different ways to show timing information. Legal values: 0 = Normal, 1 = Show Frame Timing, 2 = Show Current Frame
trailColor (tc)	float3
The color of the trail
trailColorR (tcr) float 0.49 Trail red color value
trailColorG (tcg) float 0.098 Trail green color value
trailColorB (tcb) float 0.125 Trail blue color value
trailThickness (tt)	integer	1
The line width for the motion trail
transformToMove (tr)	Message	n/a
This attribute is connected to the associated node that we snapshot.
xrayDraw (xd)	bool	1
Whether or not the motion trail is drawn in xray mode or not