timeEditor

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

Synopsis

timeEditor [-allClips string] [-clipId int] [-commonParentTrack] [-composition string] [-drivingClipsForAttr string] [-drivingClipsForObj string int] [-includeParent] [-mute boolean] [-selectedClips string] [-topLevelClips string]

timeEditor is undoable, queryable, and NOT editable.

Return value

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

Keywords

Related

Flags

Long name (short name)	Argument types	Properties
-allClips(-alc)	string
Return an exhaustive (recursive) list of all clip IDs from the active composition. Arguments may be used to filter the returning result. An empty string will return clip IDs for all clip types: roster container group
-clipId(-id)	int
ID of the clip to be edited.
-commonParentTrack(-cpt)
Locate the common parent track node and track index of the given clip IDs. Requires a list of clip IDs to be specified using the clipId flag. The format of the returned string is "track_node:track_index". If the clips specified are on the same track node but in different track indexes, only the track node will be returned.
-composition(-cp)	string
A flag to use in conjunction with -dca/drivingClipsForObj to indicate the name of composition to use. By default if this flag is not provided, current active composition will be used.
-drivingClipsForAttr(-dca)	string
Return a list of clips driving the specified attribute(s). If the composition is not specified, current active composition will be used.
-drivingClipsForObj(-dco)	string int
Return a list of clips driving the specified object(s) with an integer value indicating the matching mode. If no object is specified explicitly, the selected object(s) will be used. Objects that cannot be driven by clips are ignored. If the composition is not specified, current active composition will be used. Default match mode is 0. 0: Include only the clip that has an exact match 1: Include any clip that contains all of the specified objects 2: Include any clip that contains any of the specified objects 3: Include all clips that do not include any of the specified objects
-includeParent(-ip)
A toggle flag to use in conjunction with -dca/drivingClipsForObj. When toggled, parent clip is included in selection (the entire hierarchy will be selected).
-mute(-m)	boolean
Mute/unmute Time Editor.
-selectedClips(-sc)	string
Return a list of clip IDs of currently selected Time Editor clips. Arguments may be used to filter the returning result. An empty string will return clip IDs for all clip types: roster container group
-topLevelClips(-tlc)	string
Return a list of all top-level clip IDs from the active composition. Arguments may be used to filter the returning result. An empty string will return clip IDs for all clip types: roster container group

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

timeEditor -mute 1

// Get clip IDs of current selected group clips
timeEditor -selectedClips "group"

// Get clip IDs of all selected clips
timeEditor -selectedClips "";

// Get all top-level group clip IDs in the active composition
timeEditor -topLevelClips "group";

// Recursively get all container clip IDs in the active composition
timeEditor -allClips "container";

// Recursively get all clip IDs under the specified group clip (id=2)
timeEditor -allClips "" -clipId 2;

// Get all group clips directly under the specified group clip (id=21)
timeEditor -topLevelClips "group" -clipId 21;

// Find the common parent track of the given clip IDs
timeEditor -cpt -clipId 1 -clipId 2 -clipId 3;