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


readTake([angle=string], [device=string], [frequency=float], [linear=string], [noTime=boolean], [take=string])

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

readTake is undoable, NOT queryable, and NOT editable.

This action reads a take (.mov) file to a defined device.

See also: writeTake, applyTake

Return value



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


angle, device, frequency, linear, noTime, take
Long name (short name) Argument types Properties
device(d) string create
Specifies the device into which the take data is read. This is a required argument.
angle(a) string create
Sets the angular unit used in the take. Valid strings are "deg", "degree", "rad", and "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", and "mile".
C: The default is the current user linear unit.
take(t) string create
Reads the specified take file. It is safest to pass the full path to the flag.
noTime(nt) boolean create
Specifies if the take (.mov) file contains time stamps.
C: The default is to assume time stamps are part of the take file.
frequency(f) float create
The timestamp is ignored and the specified frequency is used. If timeStamp data is not in the .mov file, the -noTimestamp flag should also be used. This flag resample, instead the data is assumed to be at the specified frequency.
C: If the take file does not use time stamps, the default frequency is 60Hz.

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

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