pymel.core.animation.writeTake

writeTake(*args, **kwargs)

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

Dynamic library stub function

Flags:

Long Name / Short Name Argument Types Properties
angle / a unicode ../../../_images/create.gif
  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 unicode ../../../_images/create.gif
  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 unicode ../../../_images/create.gif
  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 bool ../../../_images/create.gif
  The take (.mov) file will not contain time stamps. C: The default is to put time stamps in the take file.
precision / pre int ../../../_images/create.gif
  Sets the number of digits to the right of the decimal place in the take file.C: The default is 6.
take / t unicode ../../../_images/create.gif
  Write out the take to a file with the specified name.
virtualDevice / vd unicode ../../../_images/create.gif
  Writes out the virtual device definition to a mel script with the specified file name. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.writeTake

Example:

import pymel.core as pm

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

#    Read the virtualClock and virtualClock take data.
maya.mel.eval("virtualClock")
pm.readTake( device='virtualClock', take='clock.mov' )