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