Go to: Synopsis. Return value. Related. Flags. MEL examples.
isDirty [-connection] [-datablock]
string...
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)
|
|
|
|
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 //