Go to: Synopsis. Return value. Related. Flags. Python examples.
enableDevice([apply=boolean], [device=string], [enable=boolean], [monitor=boolean], [record=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
enableDevice is undoable, queryable, and NOT editable.
Sets (or queries) the device enable state for actions involving the device.
- -monitor
- affects all assignInputDevice and attachDeviceAttr actions for
the named device
- -record
- controls if the device is recorded (by default) by a recordDevice
action
- -apply channelName [channelName ... ]
- controls if data from the device channel is applied (by default)
by applyTake to the param curves attached to the named channel.
Disabling a channel for applyTake cause applyTake to ignore
the enable state of all "child" channels -- treating them as disabled.
None
In query mode, return type is based on queried flag.
applyTake, defineDataServer, defineVirtualDevice, filter, movIn, movOut, readTake, recordDevice, writeTake
apply, device, enable, monitor, record
| Long name (short name) |
Argument types |
Properties |
device(d)
|
string
|
 
|
|
specifies the device to change
|
|
enable(en)
|
boolean
|
|
|
enable (or disable) monitor/record/apply
|
|
monitor(m)
|
boolean
|
|
|
enables/disables visible update for the device (default)
|
|
record(rec)
|
boolean
|
|
|
enable/disable "recordDevice" device recording
|
|
apply(a)
|
boolean
|
|
|
enable/disable "applyTake" for the specified channel(s)
|
|
|
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
# Enables all assignInputDevice and attachDeviceAttr actions for the
# device named "clock"
cmds.enableDevice( enable=True, d='clock' )
# Stops applyTake (with no arguments) from updating param curves
# attached to the minutes and hours channels of device named "clock"
cmds.enableDevice( 'minutes', 'hours', enable=False, d='clock', apply=True )