Go to: Synopsis. Return value. Related. Flags. Python examples.

Synopsis

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.

Return value

None

Related

dgInfo, dgeval

Flags

allPlugs, clean, verbose
Long name (short name) Argument types Properties
verbose(v) boolean create
Prints out all of the plugs being set dirty on stdout.
clean(c) boolean create
If this flag is set then the attributes are cleaned. Otherwise they are set to dirty.
allPlugs(a) boolean create
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.

Python examples

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