Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

playbackOptions [-animationEndTime time] [-animationStartTime time] [-blockingAnim boolean] [-by float] [-framesPerSecond] [-loop string] [-maxPlaybackSpeed float] [-maxTime time] [-minTime time] [-playbackSpeed float] [-selectionEndTime time] [-selectionStartTime time] [-selectionVisible boolean] [-stepKeyLoop boolean] [-stepLoop boolean] [-view string]

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, the -selectionStartTime/selectionEndTime/selectionVisible or the -by value are undoable.

Return value

stringor float Query of edited option.

In query mode, return type is based on queried flag.

Flags

animationEndTime, animationStartTime, blockingAnim, by, framesPerSecond, loop, maxPlaybackSpeed, maxTime, minTime, playbackSpeed, selectionEndTime, selectionStartTime, selectionVisible, stepKeyLoop, stepLoop, view
Long name (short name) Argument types Properties
-animationEndTime(-aet) time createqueryedit
Sets the end time of the animation. Query returns a float.
-animationStartTime(-ast) time createqueryedit
Sets the start time of the animation. Query returns a float.
-blockingAnim(-ba) boolean createquery
All tangents playback as stepped so that animation can be viewed in pure pose-to-pose form
-by(-by) float createqueryedit
Increment between times viewed during playback. (Default 1.0)
-framesPerSecond(-fps) createquery
Queries the actual playback rate. Query returns a float.
-loop(-l) string createqueryedit
Controls if and how playback repeats. Valid values are "once," "continuous," and "oscillate." Query returns string.
-maxPlaybackSpeed(-mps) float createqueryedit
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.
-maxTime(-max) time createqueryedit
Sets the end of the playback time range. Query returns a float.
-minTime(-min) time createqueryedit
Sets the start of the playback time range. Query returns a float.
-playbackSpeed(-ps) float createqueryedit
Sets the desired playback speed. Query returns a float.
-selectionEndTime(-set) time createqueryedit
Sets the end time of the selection. Query returns a float.
-selectionStartTime(-sst) time createqueryedit
Sets the start time of the selection. Query returns a float.
-selectionVisible(-sv) boolean createqueryedit
Sets the selection visibility. Query returns current visibility.
-stepKeyLoop(-skl)
2025.3
 boolean createquery
Turns on/off looping back to the start or end of the play range for step forward/backward one key.
-stepLoop(-slp) boolean createquery
Turns on/off looping back to the start or end of the play range for step forward/backward one frame.
-view(-v) string createqueryedit
Controls how many modelling views update during playback. Valid values are "all" and "active". Query returns a string.
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 be used more than once in a command.

MEL examples

playbackOptions -loop continuous;
playbackOptions -minTime 0sec -maxTime 1sec;
playbackOptions -selectionStartTime 0sec -selectionEndTime 1sec;
playbackOptions -selectionVisible 0;

// Playback every 2nd frame
//
playbackOptions -by 2;