Go to: Synopsis. Return value. Keywords. Flags. Python examples.
cacheFileCombine([cacheIndex=boolean], [channelName=string], [connectCache=string], [keepWeights=boolean], [layerNode=boolean], [nextAvailable=boolean], [object=string], [objectIndex=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
cacheFileCombine is undoable, queryable, and editable.
Creates a cacheBlend node that can be used to combine, layer or blend multiple cacheFiles for a given object.
|string||Name of created cache layer node(s)|
In query mode, return type is based on queried flag.
cache, file, disk, blend
cacheIndex, channelName, connectCache, keepWeights, layerNode, nextAvailable, object, objectIndex
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.
import maya.cmds as cmds
# Create a cacheBlend node so that additional caches can be added to
# the shape. This will attach the existing cacheFile on the shape
# to the new cacheBlend node.
cmds.select( 'cachedShape', r=True )
newBlend = cmds.cacheFileCombine()
# attach an additional cacheFile to the cacheBlend node
cmds.cacheFileCombine( newBlend, e=True, cc='cacheFile2' )
# query the index of the newly connected cache
cmds.cacheFileCombine( newBlend, cc='cacheFile2', query=True, cacheIndex=True )
# When more than one object is driven by the caches connected
# to the cacheBlend node, the -channelName and -objectIndex flags can be
# used to control which is connected.
# Query the objectIndex for the armShape geometry driven by cacheBlend3:
index = cmds.cacheFileCombine('cacheBlend3' ,object='armShape', query=True, objectIndex=True)
# Connect another cache up to drive the armShape
cmds.cacheFileCombine( 'cacheBlend3', channelName='myChannel', objectIndex=index, e=True, cc='cacheFile2' )