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.

affects all assignInputDevice and attachDeviceAttr actions for the named device
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.

Return value


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 createquery
specifies the device to change
enable(en) boolean createquery
enable (or disable) monitor/record/apply
monitor(m) boolean createquery
enables/disables visible update for the device (default)
record(rec) boolean createquery
enable/disable "recordDevice" device recording
apply(a) boolean createquery
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.

Python examples

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 )