Go to: Synopsis. Return value. Flags. Python examples.
playbackOptions([animationEndTime=time], [animationStartTime=time], [blockingAnim=boolean], [by=float], [framesPerSecond=boolean], [loop=string], [maxPlaybackSpeed=float], [maxTime=time], [minTime=time], [playbackSpeed=float], [view=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
playbackOptions is undoable, queryable, and editable.
This command sets/queries certain values associated
with playback: looping style, start/end times, etc.
Only commands modifying the -minTime/maxTime,
the -animationStartTime/animationEndTime, or the -by
value are undoable.
| string | or float
Query of edited option. |
In query mode, return type is based on queried flag.
animationEndTime, animationStartTime, blockingAnim, by, framesPerSecond, loop, maxPlaybackSpeed, maxTime, minTime, playbackSpeed, view
| Long name (short name) |
Argument types |
Properties |
loop(l)
|
string
|
  
|
|
Controls if and how playback repeats. Valid values are
"once," "continuous," and "oscillate." Query returns string.
|
|
minTime(min)
|
time
|
|
|
Sets the start of the playback time range. Query returns a float.
|
|
maxTime(max)
|
time
|
|
|
Sets the end of the playback time range. Query returns a float.
|
|
animationStartTime(ast)
|
time
|
|
|
Sets the start time of the animation. Query returns a float.
|
|
animationEndTime(aet)
|
time
|
|
|
Sets the end time of the animation. Query returns a float.
|
|
playbackSpeed(ps)
|
float
|
|
|
Sets the desired playback speed. Query returns a float.
|
|
maxPlaybackSpeed(mps)
|
float
|
|
|
Sets the desired maximum playback speed. Query returns a float. The
maxPlaybackSpeed is only used by Maya when your playbackSpeed is 0
(play every frame). The maxPlaybackSpeed will clamp the maximum
playback rate to prevent it from going more than a certain amount. A
maxPlaybackSpeed of 0 will give free (unclamped) playback.
|
|
framesPerSecond(fps)
|
boolean
|
|
|
Queries the actual playback rate. Query returns a float.
|
|
view(v)
|
string
|
|
|
Controls how many modelling views update during playback.
Valid values are "all" and "active". Query returns a string.
|
|
by(by)
|
float
|
|
|
Increment between times viewed during playback. (Default 1.0)
|
|
blockingAnim(ba)
|
boolean
|
|
|
All tangents playback as stepped so that animation can be viewed in pure pose-to-pose form
|
|
|
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
cmds.playbackOptions( loop='continuous' )
cmds.playbackOptions( minTime='0sec', maxTime='1sec' )
# Playback every 2nd frame
#
cmds.playbackOptions( by=2 )