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


writeTake([angle=string], [device=string], [linear=string], [noTime=boolean], [precision=int], [take=string], [virtualDevice=string])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

writeTake is undoable, NOT queryable, and NOT editable.

This action writes a take from a device with recorded data to a take (.mov) file. The writeTake action can also write the virtual definition of a device.

See also: recordDevice, readTake, defineVirtualDevice

Return value



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


angle, device, linear, noTime, precision, take, virtualDevice
Long name (short name) Argument types Properties
device(d) string create
Specifies the device that contains the take. This is a required argument. If the device does not contain a take, the action will fail.
take(t) string create
Write out the take to a file with the specified name.
precision(pre) int create
Sets the number of digits to the right of the decimal place in the take file.
C: The default is 6.
virtualDevice(vd) string create
Writes out the virtual device definition to a mel script with the specified file name.
noTime(nt) boolean create
The take (.mov) file will not contain time stamps.
C: The default is to put time stamps in the take file.
angle(a) string create
Sets the angular unit used in the take. Valid strings are [deg|degree|rad|radian].
C: The default is the current user angular unit.
linear(l) string create
Sets the linear unit used in the take. Valid strings are [mm|millimeter|cm|centimeter|m|meter|km|kilometer|in|inch|ft|foot|yd|yard|mi|mile]
C: The default is the current user linear unit.

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

#    Record data from the clock device and write out the virtual
#    device definition and take file.
cmds.recordDevice( device='clock' )
cmds.recordDevice( device='clock', stop=True )
cmds.writeTake( device='clock', take='clock.mov', virtualDevice='virtualClock.mel' )

#    Read the virtualClock and virtualClock take data.
cmds.readTake( device='virtualClock', take='clock.mov' )