pymel.core.system.dgdirty

static system.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 ../../../_images/create.gif
 

Ignore the selected or specified objects and dirty (or clean) all plugs. Flag can have multiple arguments, passed either as a tuple or a list.

clean (c) bool ../../../_images/create.gif
 
If this flag is set then the attributes are cleaned. Otherwise they are set to dirty.
verbose (v) bool ../../../_images/create.gif
 
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

Previous topic

pymel.core.system.dgInfo

Next topic

pymel.core.system.dgeval

Core

Core Modules

Other Modules

This Page