Go to: Synopsis. Return value. Related. Flags. MEL examples.
isDirty [-connection] [-datablock]
<plug>
isDirty is undoable, queryable, and editable.
The isDirty command is used to check if a plug is dirty.
connected in the dependency graph. 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.
In query mode, return type is based on queried flag.
attributeQuery, getClassification, isConnected, nodeType, objExists, objectType
connection, datablock
| Long name (short name) |
argument types |
Properties |
-datablock(-d)
|
|
|
|
Check the datablock entry for the plug.
|
|
-connection(-c)
|
|
|
|
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 be used more than once in a command
|
sphere -n sun;
// Check connection of sun.tx
isDirty sun.tx;
// Return: 0 //
// Check datablock of sun.tx
isDirty -d sun.tx;
// Return: 0 //
// Check datablock and connection.
// Returns logical "and" of both.
isDirty -d -c sun.tx;
// Return: 0 //