pymel.core.general.condition¶

condition(*args, **kwargs)¶

This command creates a new named condition object whose true/false value is calculated by running a mel script. This new condition can then be used for dimming, or controlling other scripts, or whatever. In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name		Argument Types	Properties
delete / delete		bool
	Deletes the condition.
dependency / d		unicode
	Each -dependency flag specifies another condition that the new condition will be dependent on. When any of these conditions change, the new-state-script will run, and the state of this condition will be set accordingly. It is possible to define infinite loops, but they will be caught and handled correctly at run-time.
initialize / i		bool
	Initializes the condition, by forcing it to run its script as soon as it is created. If this flag is not specified, the script will not run until one of the dependencies is triggered.
script / s		unicode
	The script that determines the new state of the condition.
state / st		bool
	Sets the state of the condition. This can be used to create a manually triggered condition: you could create a condition without any dependencies and without a new-state-script. This condition would only change state in response to the -st/state flag. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.condition

Example:

import pymel.core as pm

#    Create a new condition, called "UndoNorRedo", which is true if
#    and only if undo is not available and redo is not available:

def isUndoNorRedo() :
        return not pm.isTrue('UndoAvailable') and not pm.isTrue('RedoAvailable')

pm.condition('UndoNorRedo', initialize=True, d=['UndoAvailable', 'RedoAvailable'], s='isUndoNorRedo')

# Try out the new condition
#
if pm.isTrue('UndoNorRedo') :
        print 'Neither undo nor redo is available'
else :
        print 'Undo or redo is available'

pm.condition('UndoNorRedo', delete=True)