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
	This flag is used to insert a new empty track at the track index specified.
lock / l		bool
	This flag specifies whether shots on a track are to be locked or not.
mute / m		bool
	This flag specifies whether shots on a track are to be muted or not.
numTracks / nt		int
	To query the number of tracks
removeEmptyTracks / ret		bool
	This flag is used to remove all tracks that have no clips.
removeTrack / rt		int
	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
	This flag specifies whether shots on a track are to be muted or not (unlike mute, this disregards soloing).
solo / so		bool
	This flag specifies whether shots on a track are to be soloed or not.
swapTracks / st		int, int
	This flag is used to swap the contents of two specified tracks.
title / t		unicode
	This flag specifies the title for the track.
track / tr		int
	Specify the track on which to operate by using the track’s trackNumber.
unsolo / uso		bool
	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 )