Go to: Synopsis. Return value. Keywords. Flags. Python examples.
clearCache([allNodes=boolean], [computed=boolean], [dirty=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
clearCache is NOT undoable, NOT queryable, and NOT editable.
Even though dependency graph values are computed or dirty they may still
occupy space temporarily within the nodes. This command goes in to all of
the data that can be regenerated if required and removes it from the caches (datablocks), thus clearing up space in memory.
| int | Number of items removed from caches |
dependency, graph, cache, optimize, performance, memory
allNodes, computed, dirty
| Long name (short name) |
Argument types |
Properties |
allNodes(all)
|
boolean
|
|
|
If toggled then all nodes in the graph are cleared. Otherwise only those
nodes that are selected are cleared.
|
|
computed(c)
|
boolean
|
|
|
If toggled then remove all data that is computable. (Warning: If the data
is requested for redraw then the recompute will immediately fill the data
back in.)
|
|
dirty(d)
|
boolean
|
|
|
If toggled then remove all heavy data that is dirty.
|
|
|
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
# Clear one node's datablock cache
cmds.clearCache( 'node' )
# Clear caches in all dependency graph nodes
cmds.clearCache( all=True )