timeEditorClipLayer

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

Synopsis

timeEditorClipLayer [-addAttribute string] [-addLayer string] [-addObject string] [-allLayers] [-attribute string] [-attributeKeyable string] [-clipId int] [-index int] [-keySiblings] [-layerId int] [-layerName string] [-mode int] [-mute boolean] [-name] [-path string] [-removeAttribute string] [-removeLayer] [-removeObject string] [-resetSolo] [-setKeyframe] [-solo boolean] [-zeroKeying]

timeEditorClipLayer 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
-addAttribute(-aa)	string
Add given plug to a layer with a supplied layerId.
-addLayer(-al)	string
Add a new layer with a given name.
-addObject(-ao)	string
Add given object with all its attributes in the clip to a layer with a supplied layerId.
-allLayers(-all)
Return all layers given clip ID.
-attribute(-a)	string
The attribute path to key.
-attributeKeyable(-ak)	string
Return whether specified attribute is keyable.
-clipId(-cid)	int
ID of the clip this layer command operates on. In query mode, this flag can accept a value.
-index(-idx)	int
Layer index, used when adding new layer at specific location in the stack.
-keySiblings(-ks)
If set to true, additional attributes might be keyed while keying to achieve desired result.
-layerId(-lid)	int
Layer ID used in conjunction with other edit flags. In query mode, this flag can accept a value.
-layerName(-ln)	string
Edit layer name. In query mode, return the layer name given its layer ID and clip ID.
-mode(-m)	int
To control the playback speed of the clip by animation curve: 0 : additive 1 : additive override 2 : override 3 : override passthrough
-mute(-mu)	boolean
Mute/unmute a layer given its layer ID and clip ID.
-name(-n)
Query the attribute name of a layer given its layer ID and clip ID.
-path(-pt)	string
Full path of a layer or a clip on which to operate. For example: composition1|track1|clip1|layer1; composition1|track1|group|track1|clip1. In query mode, this flag can accept a value.
-removeAttribute(-ra)	string
Remove given plug from a layer with a supplied layerId.
-removeLayer(-rl)
Remove layer with an ID.
-removeObject(-ro)	string
Remove given object with all its attributes in the clip to a layer with a supplied layerId.
-resetSolo(-rs)
Unsolo all soloed layers in a given clip ID.
-setKeyframe(-k)
Set keyframe on specified attributes on specified layer of a clip. Use -clipId to indicate the specified clip. Use -layerId to indicate the specified layer of the clip. Use -attribute to indicate the specified attributes (if no attribute flag is used, all attribute will be keyed). Use -zeroKeying to indicate that zero offset from original animation should be keyed.
-solo(-sl)	boolean
Solo/unsolo a layer given its layers ID and clip ID.
-zeroKeying(-zk)
Indicate if the key to set should be zero offset from original animation.

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

// Add an additive clip layer by clip ID
timeEditorClipLayer -e -clipId 1 -addLayer "Layer A" -mode 0;

// Add an additive clip layer by clip path
timeEditorClipLayer -e -path "Composition1|track1|Group|track1|Clip1" -addLayer "Layer B" -mode 0;

// Add an attribute to the given layer by clip ID and layer ID
timeEditorClipLayer -e -clipId 1 -addAttribute "cube.tx" -layerId 1;

// Add an attribute to the given layer path
timeEditorClipLayer -e -path "Composition1|track1|Clip1|Layer1" -addAttribute "cube.tx";

// Set key in the given layer
select cube;
move -r 10 0 0;
timeEditorClipLayer -e -setKeyframe -attribute "cube.tx" -clipId 1 -layerId 1;

// Remove layer attribute
timeEditorClipLayer -e -clipId 1 -removeAttribute "cube.tx" -layerId 1;

// Query the layer name
timeEditorClipLayer -clipId 1 -layerId 1 -q -layerName;

// Remove the specified layer by clip ID and layer ID
timeEditorClipLayer -e -clipId 1 -removeLayer -layerId 1;

// Remove the specified layer by layer path
timeEditorClipLayer -e -path "Composition1|track1|Clip1|Layer1" -removeLayer;