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

Synopsis

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

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

timeEditorTracks is undoable, queryable, and editable.

Time Editor tracks commands

Return value

IntIn edit mode, return the newly created Track index.

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

Keywords

timeEditor, nle

Related

timeEditor, timeEditorAnimSource, timeEditorClip, timeEditorComposition

Flags

activeClipWeight, activeClipWeightId, addTrack, allClips, allTracks, allTracksRecursive, composition, path, plugIndex, removeTrack, removeTrackByPath, reorderTrack, resetMute, resetSolo, selectedTracks, trackGhost, trackIndex, trackMuted, trackName, trackSolo, trackType
Long name (short name) Argument types Properties
activeClipWeight(acw) time query
Get the clip weight at the specified time.
activeClipWeightId(aci) time query
Get the clip ID carrying the active clip weight at the specified time.
addTrack(at) int edit
Add new track at the track index specified. Indices are 0-based. Specify -1 to add the track at the end.
allClips(ac) boolean query
Return a list of clip IDs under the specified track.
allTracks(atc) boolean query
Return a list of strings for all the immediate tracks for the given tracks node in the format "tracksNode:trackIndex".
allTracksRecursive(atr) boolean query
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) boolean query
Return the composition the specified track belongs to.
path(pt) string edit
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 queryedit
Get the plug index of the specified track.
removeTrack(rt) int editmultiuse
Remove track at given index. It is a multi-use flag.
removeTrackByPath(rtp) string editmultiuse
Remove track at given path. It is a multi-use flag. For example: composition1|track1|group|track1;
reorderTrack(rot) [int, int] edit
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) boolean create
Reset all the muted tracks in the active composition.
resetSolo(rs) boolean create
Reset the soloing of all tracks on the active composition.
selectedTracks(st) boolean query
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 queryedit
Ghost all clips under track.
trackIndex(ti) int queryedit
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 queryedit
Return whether the track is muted.
trackName(tn) string queryedit
Display name of the track.
trackSolo(ts) boolean queryedit
Return whether the track is soloed.
trackType(tt) int queryedit
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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

#  Insert a track at the end
#
cmds.timeEditorTracks( 'container1_tracks', e=1, addTrack=-1 )

#  Insert a track at the end by path, inside a composition
#
cmds.timeEditorTracks( path='composition1', e=1, addTrack=-1 )

#  Insert a track at the end by path, inside a group clip
#
cmds.timeEditorTracks( path='composition1|track1|groupClip', e=1, addTrack=-1 )

# Remove the track from "container1_tracks"
#
cmds.timeEditorTracks( 'container1_tracks', e=1, removeTrack=1 )

# Remove the track by paths
#
cmds.timeEditorTracks( e=1, removeTrackByPath=['composition1|track2', 'composition1|track1|group|track3'] )

# Move track 0 forward 1 siblings
#
cmds.timeEditorTracks( 'container1_tracks', e=1, reorderTrack=(0, 1) )

# Set the track name
#
cmds.timeEditorTracks( 'container1_tracks', e=1, trackName="Test", trackIndex=0 )

# Set the track name by path
#
cmds.timeEditorTracks( e=1, trackName="Test", path='composition1|track2' )

# Mute the track
#
cmds.timeEditorTracks( 'container1_tracks', e=1, trackMuted=True, trackIndex=0 )