pymel.core.animation.applyTake

static animation.applyTake(*args, **kwargs)

This command takes data in a device (refered to as a take) and converts it into a form that may be played back and reviewed. The take can either be imported through the readTake action, or recorded by the recordDevice action. The take is either converted into animation curves or if the -preview flag is used, into blendDevice nodes. The command looks for animation curves attached to the target attributes of a device attachment. If animation curves exist, the take is pasted over the existing curves. If the curves do not exist, new animation curves are created. If devices are not specified, all of the devices with take data and that are enabled for applyTake, will have their data applied. See also: recordDevice, enableDevice, readTake, writeTake

Flags:
Long name (short name) Argument Types Properties
channel (c) unicode ../../../_images/create.gif
 

This flag overrides the set channel enable value. If a channel is specified, it will be enabled. C: The default is all applyTake enabled channels for the device(s).

device (d) unicode ../../../_images/create.gif
 
Specifies which device contains the take. C: The default is all applyTake enabled devices.
filter (f) unicode ../../../_images/create.gif
 

This flag specifies the filters to use during the applyTake. If this flag is used multiple times, the ordering of the filters is from left to right. C: The default is no filters.

preview (p) bool ../../../_images/create.gif
 

Applies the take to blendDevice nodes attached to the target attributes connected to the device attachments. Animation curves attached to the attributes will not be altered, but for the time that preview data is defined, the preview data will be the data used during playback. C: The default is to not preview.

recurseChannel (rc) bool ../../../_images/create.gif
 
When this flag is used, the children of the channel(s) specified by -c/channel are also applied. C: The default is all of the enabled channels.
reset (r) bool ../../../_images/create.gif
 

Resets the blendDevice nodes affected by -preview. The preview data is removed and if animation curves exist, they are used during playback. Flag can have multiple arguments, passed either as a tuple or a list.

specifyChannel (sc) bool ../../../_images/create.gif
 

This flag is used with -c/channel flag. When used, applyTake will only work on the channels listed with the -c/channel flag. C: The default is all of the enabled channels.

startTime (st) time ../../../_images/create.gif
 

The default start time for a take is determined at record time. The startTime option sets the starting time of the take in the current animation units. C: The default is the first time stamp of the take. If a time stamp does not exist for the take, 0 is used.

Derived from mel command maya.cmds.applyTake

Example:

import pymel.core as pm

#    Apply all of the recorded data to param curves.
pm.applyTake()

#    Applies the takes from clock and ultra devices and starts the
#    data at anim time 100.
pm.applyTake( d=('clock', 'ultra'), st=100 )

#    Applies the take from the ultra device and uses the euler and
#    simplify filters.
pm.applyTake( d='ultra', f=('euler', 'simplify') )

#    Applies only the shoulder channel and all of its children.
pm.applyTake( d='ultra', c='shoulder', sc=True, rc=True )

Previous topic

pymel.core.animation.animView

Next topic

pymel.core.animation.autoKeyframe

Core

Core Modules

Other Modules

This Page