timeEditorTracks

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

Synopsis

timeEditorTracks [-activeClipWeight time] [-activeClipWeightId time] [-addTrack int] [-allClips] [-allTracks] [-allTracksRecursive] [-composition] [-path string] [-plugIndex int] [-removeTrack int] [-removeTrackByPath string] [-reorderTrack int int] [-resetMute] [-resetSolo] [-selectedTracks] [-trackGhost boolean] [-trackIndex int] [-trackMuted boolean] [-trackName string] [-trackSolo boolean] [-trackType int]

timeEditorTracks 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
-activeClipWeight(-acw)	time
Get the clip weight at the specified time.
-activeClipWeightId(-aci)	time
Get the clip ID carrying the active clip weight at the specified time.
-addTrack(-at)	int
Add new track at the track index specified. Indices are 0-based. Specify -1 to add the track at the end.
-allClips(-ac)
Return a list of clip IDs under the specified track.
-allTracks(-atc)
Return a list of strings for all the immediate tracks for the given tracks node in the format "tracksNode:trackIndex".
-allTracksRecursive(-atr)
Return a list of strings for all the tracks for the given tracks node, or return a list of strings for all tracks of all tracks nodes in the format "tracksNode:trackIndex". If the given root tracks node is from a composition, this command returns the tracks under that composition, including the tracks within groups that is under the same composition.
-composition(-cp)
Return the composition the specified track belongs to.
-path(-pt)	string
Full path of a track node or a track on which to operate. For example: composition1|track1|group; composition1|track1. In query mode, this flag can accept a value.
-plugIndex(-pi)	int
Get the plug index of the specified track.
-removeTrack(-rt)	int
Remove track at given index. It is a multi-use flag.
-removeTrackByPath(-rtp)	string
Remove track at given path. It is a multi-use flag. For example: composition1|track1|group|track1;
-reorderTrack(-rot)	int int
Move the track relative to other tracks. The first argument is the track index (0-based). The second argument can be a positive or negative number to indicate the steps to move. Positive numbers move forward and negative numbers move backward.
-resetMute(-rm)
Reset all the muted tracks in the active composition.
-resetSolo(-rs)
Reset the soloing of all tracks on the active composition.
-selectedTracks(-st)
Return a list of the indices for all the selected tracks for the given tracks node, or return a list of strings for all selected tracks of all tracks nodes in the format "tracksNode:trackIndex".
-trackGhost(-tgh)	boolean
Ghost all clips under track.
-trackIndex(-ti)	int
Specify the track index. This flag is used in conjunction with the other flags. In query mode, this flag can accept a value.
-trackMuted(-tm)	boolean
Return whether the track is muted.
-trackName(-tn)	string
Display name of the track.
-trackSolo(-ts)	boolean
Return whether the track is soloed.
-trackType(-tt)	int
Specify the track type. Can only be used together with -at/addTrack. Does not work by itself. In query mode, return the integer corresponding to the track type. 0: Animation Track (Default) 1: Audio Track

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

// Insert a track at the end
//
timeEditorTracks -e -addTrack -1 container1_tracks;

// Insert a track at the end by path, inside a composition
//
timeEditorTracks -e -addTrack -1 -path "composition1";

// Insert a track at the end by path, inside a group clip
//
timeEditorTracks -e -addTrack -1 -path "composition1|track1|groupClip";

// Remove the track from "container1_tracks"
//
timeEditorTracks -e -removeTrack 1 container1_tracks;

// Remove the tracks by paths
//
timeEditorTracks -e -removeTrackByPath "composition1|track2" -removeTrackByPath "composition1|track1|group|track3"


// Move track 0 forward 1 siblings
//
timeEditorTracks -e -reorderTrack 0 1 container1_tracks;

// Set the track name
//
timeEditorTracks -e -trackName "Test" -trackIndex 0 container1_tracks;

// Set the track name by path
//
timeEditorTracks -e -trackName "Test" -path "composition1|track1";

// Mute the track
//
timeEditorTracks -e -trackMuted true -trackIndex 0 container1_tracks;