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

Synopsis

cacheFileTrack([insertTrack=uint], [lock=boolean], [mute=boolean], [removeEmptyTracks=boolean], [removeTrack=uint], [solo=boolean], [track=uint])

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

cacheFileTrack is undoable, queryable, and editable.

This command is used for inserting and removing tracks related to the caches displayed in the trax editor. 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

cache, file, disk, blend, trax, track

Flags

insertTrack, lock, mute, removeEmptyTracks, removeTrack, solo, track
Long name (short name) Argument types Properties
lock(l) boolean createqueryedit
This flag specifies whether clips on a track are to be locked or not.
solo(so) boolean createqueryedit
This flag specifies whether clips on a track are to be soloed or not.
mute(m) boolean createqueryedit
This flag specifies whether clips on a track are to be muted or not.
track(t) uint createqueryedit
Used to specify a new track index for a cache to be displayed. Track-indices are 1-based.
insertTrack(it) uint create
This flag is used to insert a new empty track at the track index specified.
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.
removeEmptyTracks(ret) boolean create
This flag is used to remove all tracks that have no clips.

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

# Move the cache clip named "cubeCache2" to track 3
#
cmds.cacheFileTrack( 'cubeCache2', track=3 )
# Lock the track containing the cache clip named "sphCache1"
#
cmds.cacheFileTrack( 'sphCache1', lock=True )
# Remove any empty cache tracks for the object "sphereShape1"
#
cmds.cacheFileTrack('sphereShape1',removeEmptyTracks=True)
# query the track index of the cache clip named "sphCache1"
#
cmds.cacheFileTrack( 'sphCache1', q=True, track=True )