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

Synopsis

audioTrack [-insertTrack uint] [-lock boolean] [-mute boolean] [-numTracks uint] [-removeEmptyTracks] [-removeTrack uint] [-solo boolean] [-swapTracks uint uint] [-title string] [-track uint]

audioTrack is undoable, queryable, and editable.

This command is used for inserting and removing tracks related to the audio clips displayed in the sequencer. It can also be used to modify the track state, for example, to lock or mute a track.

Return value

None

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

Keywords

shot, audio, sequencer, track

Flags

insertTrack, lock, mute, numTracks, removeEmptyTracks, removeTrack, solo, swapTracks, title, track
Long name (short name) Argument types Properties
-insertTrack(-it) uint create
This flag is used to insert a new empty track at the track index specified. Indices are 1-based.
-lock(-l) boolean createqueryedit
This flag specifies whether all audio clips on the same track as the specified audio node are to be locked at their current location and track.
-mute(-m) boolean createqueryedit
This flag specifies whether all audio clips on the same track as the specified audio node are to be muted or not.
-numTracks(-nt) uint query
To query the number of audio tracks
-removeEmptyTracks(-ret) create
This flag is used to remove all tracks that have no clips.
-removeTrack(-rt) uint create
This flag is used to remove the track with the specified index. The track must have no clips on it before it can be removed.
-solo(-so) boolean createqueryedit
This flag specifies whether all audio clips on the same track as the specified audio node are to be soloed or not.
-swapTracks(-st) uint uint create
This flag is used to swap the contents of two specified tracks. Indices are 1-based.
-title(-t) string createqueryedit
This flag specifies the title for the track.
-track(-tr) uint createqueryedit
Specify the track on which to operate by using the track's trackNumber.

In query mode, this flag needs a value.


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


// Move the audio clip named "audio2" to track 3
//
audioTrack -track 3 audio2;

// Lock the track containing the audio clip named "audio1"
//
audioTrack -lock 1 audio1;

// Remove any empty tracks
//
audioTrack -removeEmptyTracks;

// query the track index of the audio clip named "audio1"
//
audioTrack -q -track audio1;