pymel.core.system.dgdirty

dgdirty(*args, **kwargs)

The dgdirtycommand 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.

Flags:

Long name (short name)		Argument Types	Properties
allPlugs (a)		bool
	Ignore the selected or specified objects and dirty (or clean) all plugs.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.
clean (c)		bool
	If this flag is set then the attributes are cleaned. Otherwise they are set to dirty.
verbose (v)		bool
	Prints out all of the plugs being set dirty on stdout.

Derived from mel command maya.cmds.dgdirty

Example:

import pymel.core as pm

# Set everything in the entire scene dirty
#
pm.dgdirty(a=True);

# Set all connected plugs dirty on "myNode"
#
pm.dgdirty( 'myNode' )
# Result: 5
# 5 plugs were set dirty

#  Set all connected plugs dirty on "locator1"
pm.dgdirty( 'locator1' )
# Result: 0
# 0 plugs were connected so no dirty message was sent

# Set myNode.tx dirty
pm.select( 'myNode.tx' )
pm.dgdirty()
# Result: 1