timeEditorAnimSource

Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.

Synopsis

timeEditorAnimSource [-addObjects string] [-addRelatedKG boolean] [-addSelectedObjects] [-addSource string] [-apply] [-attribute string] [-bakeToAnimSource string] [-calculateTiming] [-copyAnimation] [-drivenClips] [-exclusive] [-export string] [-importAllFbxTakes] [-importFbx string] [-importFbxTakes string] [-importMayaFile string] [-importOption string] [-importPopulateOption string] [-importedContainerNames string] [-includeRoot] [-isUnique] [-populateImportedAnimSources string] [-poseClip boolean] [-recursively] [-removeSceneAnimation boolean] [-removeSource string] [-showAnimSourceRemapping] [-takeList string] [-takesToImport string] [-targetIndex string] [-targets] [-type string]

timeEditorAnimSource is undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Keywords

Related

Flags

Long name (short name)	Argument types	Properties
-addSource(-asc)	string
Add single new target attribute with its animation.
-apply(-ap)
Connect anim source's animation directly to the target objects. If the Time Editor is not muted, connect to scene storage instead.
-bakeToAnimSource(-bas)	string
Create a new anim source with the same animation as this anim source. All non-curve inputs will be baked down, whereas curve sources will be shared.
-calculateTiming(-ct)
Adjust start/duration when adding/removing sources. If query it returns the [start,duration] pair.
-copyAnimation(-cp)
Copy animation when adding source.
-drivenClips(-dc)
Return all clips driven by the given anim source.
-export(-ex)	string
Export given anim source and the animation curves to a specified Maya file.
-isUnique(-iu)
Return true if the anim source node is only driving a single clip.
-removeSource(-rs)	string
Remove single attribute.
-targetIndex(-ti)	string
Get target index.
-targets(-trg)
Get a list of all targets in this anim source.
-addObjects(-ao)	string
Populate the given object(s) and their attributes to anim source to Time Editor. For multiple object, pass each name separated by semicolon. In query mode, return the number of attributes that will be populated given the flags, along with the animation's first and last frames for the given object(s). Similar to -addSelectedObjects flag but acts on given object(s) instead. This flag will override the flag -addSelectedObjects.
-addRelatedKG(-akg)	boolean
During population, determine if associated keying groups should be populated or not. Normally used for populating HIK. By default the value is false.
-addSelectedObjects(-aso)
Populate the currently selected objects and their attributes to anim source or Time Editor. In query mode, return the number of attributes that will be populated given the flags, along with the animation's first and last frames.
-attribute(-at)	string
Populate a specific attribute on a object.
-exclusive(-exc)
Populate all types of animation sources which are not listed by "type" Flag.
-importAllFbxTakes(-aft)
Import all FBX takes into the new anim sources (for timeEditorAnimSource command) or new containers (for timeEditorClip command).
-importFbx(-fbx)	string
Import an animation from FBX file into the new anim source (for timeEditorAnimSource command) or new container (for timeEditorClip command).
-importFbxTakes(-ft)	string
Import multiple FBX takes (separated by semicolons) into the new anim sources (for timeEditorAnimSource command) or new containers (for timeEditorClip command).
-importMayaFile(-mf)	string
Import an animation from Maya file into the new anim sources (for timeEditorAnimSource command) or new containers (for timeEditorClip command).
-importOption(-io)	string
Option for importing animation source. Specify either 'connect' or 'generate'. connect: Only connect with nodes already existing in the scene. Importing an animation source that does not match with any element of the current scene will not create any clip. (connect is the default mode). generate: Import everything and generate new nodes for items not existing in the scene.
-importPopulateOption(-ipo)	string
Option for population when importing.
-importedContainerNames(-icn)	string
Internal use only. To be used along with populateImportedAnimSources to specify names for the created containers.
-includeRoot(-irt)
Populate transform (Translate, Rotate, Scale) of hierarchy root nodes.
-populateImportedAnimSources(-pia)	string
Internal use only. Populate the Time Editor with clips using the Animation Sources specified (use ; as a delimiter for multiple anim sources).
-poseClip(-poc)	boolean
Populate as pose clip with current attribute values.
-recursively(-rec)
Populate selection recursively, adding all the children.
-removeSceneAnimation(-rsa)	boolean
If true, remove animation from scene when creating clips or anim sources. Only Time Editor will drive the removed scene animation.
-showAnimSourceRemapping(-sar)
Show a remapping dialog when the imported anim source attributes do not match the scene attributes.
-takeList(-tl)	string
Internal use only. To be used along with populateImportedAnimSources to specify the imported take names.
-takesToImport(-toi)	string
Internal use only. To be used along with populateImportedAnimSources to specify the imported take indices.
-type(-typ)	string
Only populate the specified type of animation source.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

file -f -new;
polyCube -name cube;
currentTime  1; setAttr cube.tx  0; setKeyframe cube.tx;
currentTime  5; setAttr cube.tx -5; setKeyframe cube.tx;
currentTime 10; setAttr cube.tx  5; setKeyframe cube.tx;

// Add cube.translateX with its animation to the anim source and calculate and save timing afterwards
timeEditorAnimSource -e -addSource "cube.translateX" -calculateTiming "AnimSourceNode";

// Add cube.translateX with a copy of its animation to the anim source
timeEditorAnimSource -e -addSource "cube.translateX" -copyAnimation "AnimSourceNode";

// Remove cube.translateX from the anim source
timeEditorAnimSource -e -removeSource "cube.translateX" "AnimSourceNode";