Go to: Synopsis. Flags. Return value. Related. MEL examples.
dgdirty [-allPlugs] [-clean] [-verbose]
dgdirty is undoable, queryable, and editable.
The dgdirty command is used to force a dependency graph
dirty message on a node or plug. Used for debugging to find
evaluation problems. If no nodes are specified then the current
selection list is used.
allPlugs, clean, verbose
Long name (short name) |
[argument types] |
Properties |
-verbose(-v)
|
|
|
|
Prints out all of the plugs being set dirty on stdout.
|
|
-clean(-c)
|
|
|
|
If this flag is set then the attributes are cleaned. Otherwise
they are set to dirty.
|
|
-allPlugs(-a)
|
|
|
|
Ignore the selected or specified objects and dirty (or clean)
all plugs.
|
|
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
|
none
dgInfo, dgPerformance, dgdebug, dgeval, dgfootprint, dgstats
// Set everything in the entire scene dirty
//
dgdirty -a;
dgdirty myNode; // Set all connected plugs dirty on "myNode"
// Result: 5 // 5 plugs were set dirty
dgdirty locator1; // Set all connected plugs dirty on "locator1"
// Result: 0 // 0 plugs were connected so no dirty message was sent
select myNode.tx;
dgdirty; // Set myNode.tx dirty
// Result: 1