Go to: Synopsis. Return value. Related. Flags. Python examples.

Synopsis

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.

Return value

None

In query mode, return type is based on queried flag.

Related

applyTake, defineDataServer, defineVirtualDevice, filter, movIn, movOut, readTake, recordDevice, writeTake

Flags

apply, device, enable, monitor, record
Long name (short name) Argument types Properties
apply(a) boolean createquery
enable/disable "applyTake" for the specified channel(s)
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

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 )