pymel.core.system.audioTrack

audioTrack(*args, **kwargs)

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. In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name Argument Types Properties
insertTrack / it int ../../../_images/create.gif
  This flag is used to insert a new empty track at the track index specified. Indices are 1-based.
lock / l bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  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 bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies whether all audio clips on the same track as the specified audio node are to be muted or not.
numTracks / nt int ../../../_images/query.gif
  To query the number of audio tracks
removeEmptyTracks / ret bool ../../../_images/create.gif
  This flag is used to remove all tracks that have no clips.
removeTrack / rt int ../../../_images/create.gif
  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 bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies whether all audio clips on the same track as the specified audio node are to be soloed or not.
swapTracks / st int, int ../../../_images/create.gif
  This flag is used to swap the contents of two specified tracks. Indices are 1-based.
title / t unicode ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies the title for the track.
track / tr int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Specify the track on which to operate by using the track’s trackNumber. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.audioTrack

Example:

import pymel.core as pm

#  Move the audio clip named "audio2" to track 3
#
pm.audioTrack( 'audio2', track=3 )
# Lock the track containing the audio clip named "audio1"
#
pm.audioTrack( 'audio1', lock=True )
# Remove any empty tracks
#
pm.audioTrack(removeEmptyTracks=True)
# audioTrack -q -track audio1;
#
pm.audioTrack( 'audio1', q=True, track=True )