Go to: Synopsis. Return value. Related.
Flags. Python
examples.
applyTake([channel=string], [device=string], [filter=string], [preview=boolean], [recurseChannel=boolean], [reset=boolean], [specifyChannel=boolean], [startTime=time])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
applyTake is undoable, NOT queryable, and NOT
editable.
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
None
defineDataServer, defineVirtualDevice, enableDevice, filter, movIn, movOut, readTake,
recordDevice, writeTake
channel, device, filter,
preview, recurseChannel, reset, specifyChannel, startTime
| Long name (short name) |
Argument types |
Properties |
device(d) |
string |
  |
|
Specifies which device contains the take.
C: The default is all applyTake enabled devices. |
|
startTime(st) |
time |
|
|
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. |
|
channel(c) |
string |
|
|
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). |
|
specifyChannel(sc) |
boolean |
|
|
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. |
|
recurseChannel(rc) |
boolean |
|
|
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. |
|
filter(f) |
string |
|
|
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) |
boolean |
|
|
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. |
|
reset(r) |
boolean |
|
|
Resets the blendDevice nodes affected by -preview. The preview
data is removed and if animation curves exist, they are used during
playback. |
|
| 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
# Apply all of the recorded data to param curves.
cmds.applyTake()
# Applies the takes from clock and ultra devices and starts the
# data at anim time 100.
cmds.applyTake( d=('clock', 'ultra'), st=100 )
# Applies the take from the ultra device and uses the euler and
# simplify filters.
cmds.applyTake( d='ultra', f=('euler', 'simplify') )
# Applies only the shoulder channel and all of its children.
cmds.applyTake( d='ultra', c='shoulder', sc=True, rc=True )