pymel.core.system.shotTrack

shotTrack(*args, **kwargs)

This command is used for inserting and removing tracks related to the shots 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.
lock / l bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies whether shots on a track are to be locked or not.
mute / m bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies whether shots on a track are to be muted or not.
numTracks / nt int ../../../_images/query.gif
  To query the number of 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.
selfmute / sm bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies whether shots on a track are to be muted or not (unlike mute, this disregards soloing).
solo / so bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  This flag specifies whether shots on a track 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.
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.
unsolo / uso bool ../../../_images/query.gif
  This flag specifies whether shots on a track are to be unsoloed or not. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.shotTrack

Example:

import pymel.core as pm

#  Move the shot named "shot2" to track 3
#
pm.shotTrack( 'shot2', track=3 )
# Lock the track containing the shot named "shot1"
#
pm.shotTrack( 'shot1', lock=True )
# Remove any empty tracks
#
pm.shotTrack(removeEmptyTracks=True)
# shotTrack -q -track shot1;
#
pm.shotTrack( 'shot1', q=True, track=True )