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

Synopsis

clearCache [-allNodes] [-computed] [-dirty]

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.

Return value

intNumber of items removed from caches

Keywords

dependency, graph, cache, optimize, performance, memory

Flags

allNodes, computed, dirty
Long name (short name) Argument types Properties
-allNodes(-all) create
If toggled then all nodes in the graph are cleared. Otherwise only those nodes that are selected are cleared.
-computed(-c) create
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) create
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 be used more than once in a command.

MEL examples

// Clear one nodes cache
clearCache node;

// Clear caches in all dependency graph nodes
clearCache -all;