Go to: Synopsis. Return value. Related. Flags. Python examples.
dgdirty([allPlugs=boolean], [clean=boolean], [verbose=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
dgdirty is undoable, NOT queryable, and NOT 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.
None
dgInfo, dgeval
allPlugs, clean, verbose
| Long name (short name) |
Argument types |
Properties |
verbose(v)
|
boolean
|
|
|
Prints out all of the plugs being set dirty on stdout.
|
|
clean(c)
|
boolean
|
|
|
If this flag is set then the attributes are cleaned. Otherwise
they are set to dirty.
|
|
allPlugs(a)
|
boolean
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# Set everything in the entire scene dirty
#
cmds.dgdirty(a=True);
# Set all connected plugs dirty on "myNode"
#
cmds.dgdirty( 'myNode' )
# Result: 5
# 5 plugs were set dirty
# Set all connected plugs dirty on "locator1"
cmds.dgdirty( 'locator1' )
# Result: 0
# 0 plugs were connected so no dirty message was sent
# Set myNode.tx dirty
cmds.select( 'myNode.tx' )
cmds.dgdirty()
# Result: 1