Go to: Related nodes. Attributes.

Maya uses animation clips as the building block of its non-linear animation system, "Trax". An animation clip allows the user to bundle a set of animation curves independent of time so that they can be reused multiple times, with different timing than the original clip.

Character sets are integral to Maya's use of clips, since a clip contains whatever attributes of the character were animated when the clip was created. For more information on character sets, refer to the character node documentation.

Clips in maya can be of two types: source clips and scheduled clips. Scheduled clips are also referred to as instanced clips. In the Maya UI, source clips are visible in the Visor while scheduled clips are visible in Trax. A source clip maintains the animation curves for the clip. A scheduled clip contains data about the placement of an instance of a source clip in the Maya timeline. In this context, an "instance" means that the animation curves from the source clip are shared by the scheduled clip. Scheduled clips never contain their own animation curves, they always refer to a source clip's curves.

For example, if you create a clip called "run" in maya that lasts from frames 1-20, a source clip node will be created with a start of 1, a duration of 19, and dependency graph connections to all of the animation curves that make up the "run". If you then place an instance of the run clip at frame 5 and another instance of the run clip at frame 20, you have 2 scheduled clips: one with a start frame of 5 and one with a start frame of 20. As mentioned in the previous paragraph, only a single set of animation curves exist for the run regardless of the number of times the run is scheduled.

Trax also allows you to create "blends" between clips, which enable you to control the transition between the clips. A blend is represented in the dependency graph by an "animBlendInOut" node, which uses an animation curve to determine the transition type.

In the dependency graph, when a character has animation clips, the character node will always be connected to a "clipLibrary" node and a "clipScheduler" node. The clipLibrary node is connected to all of the source clips and their animation curves. The clipScheduler node is connected to the scheduled clips and blends. It is the clipScheduler that computes the final animation by looking at the placement and overlap of the clips and feeding the attribute data back into the character set.

Node nameParentsMFn typeCompatible function sets
animClipnodekClipkBase
kNamedObject
kDependencyNode
kClip

Related nodes

character, clipScheduler, clipLibrary, animBlend, animBlendInOut

Attributes (35)

absoluteChannel, absoluteRotations, channelOffset, clip, clipData, clipInstance, cycle, duration, enable, hold, localStartPosition, localStartPositionX, localStartPositionY, localStartPositionZ, offset, pose, postCycle, preCycle, recomputeOffset, scale, sourceEnd, sourceStart, start, startFrame, startPercent, startTrim, timeWarp, timeWarpEnable, useChannelOffset, weight, weightStyle, worldStartPosition, worldStartPositionX, worldStartPositionY, worldStartPositionZ

Long name (short name)TypeDefaultFlags
enable (ea) bool1outputinputconnectablestorable
Whether the clip is enabled
absoluteChannel (ac) boolfalsearrayoutputinputconnectablestorable
When set to true the channel starts at the keyed value (absolute) if set to false the channel is treated as an offset (relative) to prevent jumps
useChannelOffset (uco) bool1outputinputconnectablestorable
Whether or not to use the channel offset
channelOffset (co) double0.0arrayoutputinputconnectablestorable
After all the scaling, pre and post cycles have been determined add this value to a channel to tweak its value Use this to compensate/adjust for ending/overlapping values from previous/simultaneous clips
startFrame (sf) time0filmoutputinputconnectablestorable
The actual start frame where the clip is placed for playback.
scale (sc) double1.0outputinputconnectablestorable
Used to scale the clip
hold (h) time0filmoutputinputconnectablestorable
Length of time that the clip holds its end value.
preCycle (cb) double0.0outputinputconnectablestorable
The preCycle value is used to repeat the clip, in whole or in part, before the beginning of the basic clip.
postCycle (ca) double0.0outputinputconnectablestorable
The postCycle value is used to repeat the clip, in whole or in part, after the end of the basic clip.
weight (w) double1.0outputinputconnectablestorablekeyable
Weight for the clip
weightStyle (ws) enum0outputinputconnectablestorable
How the clip weighting is applied. `From Start` indicates that a weight of zero returns the clip to its start frame. `From Zero` indicates that a weight of zero sets the attributes in the clip to zero. `Absolute From Zero` indicates that absolute channels are weighted `From Zero` and relative channels are weighted `From Start`.
pose (ps) boolfalseoutputinputconnectablestorable
A clip pose is handled like a regular clip, but when the pose attribute is set to true, the clip is displayed in the pose section of the Visor.
sourceStart (ss) time0filmoutputinputconnectablestorable
The time on the original animCurve(s) where the clip starts. Used to trim the beginning portion of the animCurve(s) to the desired starting point. Modifying this attribute only affects this instance of the clip. See the description of the clipInstance attribute for more information about the source clip and clip instances.
sourceEnd (se) time0filmoutputinputconnectablestorable
The time on the original animCurve(s) where the clip ends. Used to trim the ending portion of the animCurve(s) to the desired ending point. Modifying this attribute only affects this instance of the clip. See the description of the clipInstance attribute for more information about the source clip and clip instances.
clip (cl) Messagen/aoutputinputconnectablehidden
The clip message attributes is used to connect instance clip nodes to their source clip node. As well it connects source clips to their library node.
clipInstance (ci) bool1outputinputconnectablestorablehidden
If this value is true, the clip is an instanced version of a "source clip", meaning that the clip shares the animCurves of the source clip but is placed in the clip editor at a different position than the original source clip was recorded. Deleting an instanced clip removes its instance from the schedule (the clip editor). If this value is false, the clip is the source clip and its animCurves are shared by all instanced version of it. Deleting the source clip deletes all instances of the clip.
clipData (cd) clipNULLoutputinputconnectablestorable
Clip ghost shape transform information. Used to ensure ghost translation and rotation remain synchronized with clip.
recomputeOffset (roff) boolfalseoutputconnectablehidden
Plug to trigger synchronization of translation and rotation offset specified by clip ghost shape.
worldStartPosition (wsp) compoundn/aoutputinputconnectablestorablehidden
Initial world position of offset object in the clip.
worldStartPositionX (wspx) double0.0outputinputconnectablestorablehidden
Initial world x position of offset object in the clip.
worldStartPositionY (wspy) double0.0outputinputconnectablestorablehidden
Initial world y position of offset object in the clip.
worldStartPositionZ (wspz) double0.0outputinputconnectablestorablehidden
Initial world z position of offset object in the clip.
localStartPosition (lsp) compoundn/aoutputinputconnectablestorablehidden
Initial local position of offset object in the clip.
localStartPositionX (lspx) double0.0outputinputconnectablestorablehidden
Initial local x position of offset object in the clip.
localStartPositionY (lspy) double0.0outputinputconnectablestorablehidden
Initial local y position of offset object in the clip.
localStartPositionZ (lspz) double0.0outputinputconnectablestorablehidden
Initial local z position of offset object in the clip.
timeWarp (tw) double0.0outputinputconnectablestorable
Input for a timewarp curve or expression. The only values that are used are between times 0 and 1.
timeWarpEnable (twe) boolfalseoutputinputconnectablestorable
Determines if an animation curve connected to the timeWarp attribute is used as a time warp curve.
start (st) time0filmoutputinputconnectablehidden
This attribute is obsolete, it has been replaced by the sourceStart and sourceEnd attributes.
duration (du) time0filmoutputinputconnectablehidden
This attribute is obsolete, it has been replaced by the sourceStart and sourceEnd attributes.
offset (o) enum0outputinputconnectablehidden
This attribute is obsolete, it has been replaced by the absoluteChannel attribute.
absoluteRotations (abro) boolfalseoutputinputconnectablehidden
This attribute is obsolete, it has been replaced by the absoluteChannel attribute.
cycle (cy) double1.0outputinputconnectablestorable
This attribute is obsolete.
startTrim (str) time0filmoutputinputconnectablehidden
This attribute is obsolete.
startPercent (sp) double0.0outputinputconnectablehidden
This attribute is obsolete.