Go to: Synopsis. Return value. Related. Flags. Python examples.
isDirty(
string...
, [connection=boolean], [datablock=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
isDirty is undoable, NOT queryable, and NOT editable.
The isDirty command is used to check if a plug is dirty. The
return value is 0 if it is not and 1 if it is. If more than one plug
is specified then the result is the logical "or" of all objects
(ie. returns 1 if *any* of the plugs are dirty).
| boolean | Is the plug dirty? If more than one plug is given then it returns the
logical "and" of all dirty states. |
attributeQuery, getClassification, isConnected, nodeType, objExists, objectType
connection, datablock
| Long name (short name) |
Argument types |
Properties |
datablock(d)
|
boolean
|
|
|
Check the datablock entry for the plug.
|
|
connection(c)
|
boolean
|
|
|
Check the connection of the plug (default).
|
|
|
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
cmds.sphere( n='sun' )
# Check connection of sun.tx
cmds.isDirty( 'sun.tx' )
# Return: 0 #
# Check datablock of sun.tx
cmds.isDirty( 'sun.tx', d=True )
# Return: 0 #
# Check datablock and connection.
# Returns logical "and" of both.
cmds.isDirty( 'sun.tx', d=True, c=True )
# Return: 0 #