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
None
applyTake, defineDataServer, defineVirtualDevice, enableDevice, filter, movIn, movOut, readTake, recordDevice
angle, device, linear, noTime, precision, take, virtualDevice
| Long name (short name) |
Argument types |
Properties |
|
angle(a)
|
string
|
|
|
Sets the angular unit used in the take.
Valid strings are [deg|degree|rad|radian].
C: The default is the current user angular unit.
|
|
device(d)
|
string
|
|
|
Specifies the device that contains the take. This is a required
argument. If the device does not contain a take, the action will
fail.
|
|
linear(l)
|
string
|
|
|
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.
|
|
noTime(nt)
|
boolean
|
|
|
The take (.mov) file will not contain time stamps.
C: The default is to put time stamps in the take file.
|
|
precision(pre)
|
int
|
|
|
Sets the number of digits to the right of the decimal place in
the take file.
C: The default is 6.
|
|
take(t)
|
string
|
|
|
Write out the take to a file with the specified name.
|
|
virtualDevice(vd)
|
string
|
|
|
Writes out the virtual device definition to a mel script with the
specified file name.
|
|
|
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.
|
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.
maya.mel.eval("virtualClock")
cmds.readTake( device='virtualClock', take='clock.mov' )