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

Synopsis

recordDevice [-cleanup] [-data] [-device string] [-duration int] [-playback boolean] [-state boolean] [-wait]

recordDevice is undoable, queryable, and NOT editable.

Starts and stops server side device recording. The data is recorded at the device rate. Once recorded, the data may be brought into Maya with the applyTake command.

See also: enableDevice, applyTake, readTake, writeTake

Return value

None

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

Related

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

Flags

cleanup, data, device, duration, playback, state, wait
Long name (short name) Argument types Properties
-cleanup(-c) create
Removes the recorded data from the device.
-data(-da) query
Specifies if the device has recorded data. If the device is recording at the time of query, the flag will return false.
Q: When queried, this flag returns an int.
-device(-d) string createmultiuse
Specifies which device(s) to start record recording. The listed device(s) will start recording regardless of their record enable state.
C: The default is to start recording all devices that are record enabled.
-duration(-dr) int createquery
Duration (in seconds) of the recording. When the duration expires, the device will still be in a recording state and must be told to stop recording.
C: The default is 60.
Q: When queried, this flag returns an int.
-playback(-p) boolean createquery
If any attribute is connected to an animation curve, the animation curve will play back while recording the device(s) including any animation curves attached to attributes being recorded.
C: The default is false.
Q: When queried, this flag returns an int.
-state(-st) boolean createquery
Start or stop device recording.
C: The default is true.
Q: When queried, this flag returns an int.
-wait(-w) create
If -p/playback specified, wait until playback completion before returning control to the user. This flag is ignored if -p is not used.
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.

MEL examples

//    Record the clock device for 30 seconds and apply the data.
//
recordDevice -device clock -duration 30;
system("sleep 30");
recordDevice -device clock -state false;
applyTake -device clock;