Go to: Return value. Related commands. Flags. Examples.

Synopsis

isDirty [-d] [-c] <plug>

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).

Return value

boolean : Is the plug dirty? If more than one plug is given then it returns the logical "and" of all dirty states.

Related commands

isConnected, objExists, nodeType, objectType, attributeQuery, getClassification

Flags

connection, datablock

Long name (short name)[argument types]Properties
-datablock (-d) create
Check the datablock entry for the plug.
-connection (-c) create
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

Examples

  sphere -n sun;

  // Check connection of transform1.tx
  isDirty sun.tx;
  // Return: 1 //

  // Check datablock of transform1.tx
  isDirty -d sun.tx;
  // Return: 0 //

  // Check datablock and connection.
  // Returns logical "and" of both.
  isDirty -d -c sun.tx;
  // Return: 0 //