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 name Parents MFn type Compatible function sets
animClip node kClip kBase
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) Type Default Flags
enable (ea) bool 1 outputinputconnectablestorable
Whether the clip is enabled
absoluteChannel (ac) bool false arrayoutputinputconnectablestorable
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) bool 1 outputinputconnectablestorable
Whether or not to use the channel offset
channelOffset (co) double 0.0 arrayoutputinputconnectablestorable
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) time 0film outputinputconnectablestorable
The actual start frame where the clip is placed for playback.
scale (sc) double 1.0 outputinputconnectablestorable
Used to scale the clip
hold (h) time 0film outputinputconnectablestorable
Length of time that the clip holds its end value.
preCycle (cb) double 0.0 outputinputconnectablestorable
The preCycle value is used to repeat the clip, in whole or in part, before the beginning of the basic clip.
postCycle (ca) double 0.0 outputinputconnectablestorable
The postCycle value is used to repeat the clip, in whole or in part, after the end of the basic clip.
weight (w) double 1.0 outputinputconnectablestorablekeyable
Weight for the clip
weightStyle (ws) enum 0 outputinputconnectablestorable
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) bool false outputinputconnectablestorable
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) time 0film outputinputconnectablestorable
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) time 0film outputinputconnectablestorable
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) Message n/a outputinputconnectablehidden
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) bool 1 outputinputconnectablestorablehidden
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) clip NULL outputinputconnectablestorable
Clip ghost shape transform information. Used to ensure ghost translation and rotation remain synchronized with clip.
recomputeOffset (roff) bool false outputconnectablehidden
Plug to trigger synchronization of translation and rotation offset specified by clip ghost shape.
worldStartPosition (wsp) compound n/a outputinputconnectablestorablehidden
Initial world position of offset object in the clip.
worldStartPositionX (wspx) double 0.0 outputinputconnectablestorablehidden
Initial world x position of offset object in the clip.
worldStartPositionY (wspy) double 0.0 outputinputconnectablestorablehidden
Initial world y position of offset object in the clip.
worldStartPositionZ (wspz) double 0.0 outputinputconnectablestorablehidden
Initial world z position of offset object in the clip.
localStartPosition (lsp) compound n/a outputinputconnectablestorablehidden
Initial local position of offset object in the clip.
localStartPositionX (lspx) double 0.0 outputinputconnectablestorablehidden
Initial local x position of offset object in the clip.
localStartPositionY (lspy) double 0.0 outputinputconnectablestorablehidden
Initial local y position of offset object in the clip.
localStartPositionZ (lspz) double 0.0 outputinputconnectablestorablehidden
Initial local z position of offset object in the clip.
timeWarp (tw) double 0.0 outputinputconnectablestorable
Input for a timewarp curve or expression. The only values that are used are between times 0 and 1.
timeWarpEnable (twe) bool false outputinputconnectablestorable
Determines if an animation curve connected to the timeWarp attribute is used as a time warp curve.
start (st) time 0film outputinputconnectablehidden
This attribute is obsolete, it has been replaced by the sourceStart and sourceEnd attributes.
duration (du) time 0film outputinputconnectablehidden
This attribute is obsolete, it has been replaced by the sourceStart and sourceEnd attributes.
offset (o) enum 0 outputinputconnectablehidden
This attribute is obsolete, it has been replaced by the absoluteChannel attribute.
absoluteRotations (abro) bool false outputinputconnectablehidden
This attribute is obsolete, it has been replaced by the absoluteChannel attribute.
cycle (cy) double 1.0 outputinputconnectablestorable
This attribute is obsolete.
startTrim (str) time 0film outputinputconnectablehidden
This attribute is obsolete.
startPercent (sp) double 0.0 outputinputconnectablehidden
This attribute is obsolete.