pymel.core.animation.recordDevice¶

recordDevice(*args, **kwargs)¶

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 In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name		Argument Types	Properties
cleanup / c		bool
	Removes the recorded data from the device.
data / da		bool
	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		unicode
	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
	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		bool
	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		bool
	Start or stop device recording. C: The default is true. Q: When queried, this flag returns an int.
wait / w		bool
	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 have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.recordDevice

Example:

import pymel.core as pm

#    Record the clock device for 30 seconds and apply the data.
#
import time
pm.recordDevice( device='clock', duration=30 )
time.sleep( 30 )
pm.recordDevice( device='clock', state=False )
pm.applyTake( device='clock' )