Sets the play range to include the frame range specified.
Use this command in the Script Editor to set the playRange of your scene to a subset of the current range.
playRange is very useful for trimming the working range of your animation file without losing any of the data. When you reset a playRange, the data that lies outside of the new range will still remain in the file if saved as a .vdf. Upon export to another format, only the playRange is exported.
The playRange command is not undoable.
SMPTE times must be surrounded by quotes
Playback control
playRange inTime outTime[-r] [-start] [-end] [-save] [-restore] |
| Name | Type | Required | Comments |
|---|---|---|---|
inTime | yes | Start frame integer , required unless -end option is specified | |
outTime | yes | End frame integer, required unless the -start option is specified |
| Name | Flag arguments | Argument type | Exclusive to | Comments |
|---|---|---|---|---|
r | 0 | — | — | Set range relative to start/end of current play range |
start | 0 | — | end | Sets the playRange start to the current frame |
end | 0 | — | start | Sets the playRange end to the current frame |
save | 0 | — | restore | Save current play range before applying play range changes. Can be restored by next playRange -restore call. |
restore | 0 | — | save | Restore the last saved play range before applying play range changes. |
void
playRange -save; playRange 340 345; playRange -restore; // This sequence of commands saves the current play range, // then sets it to a new range; enabling you to restore // the original range at any time. // set start of play Range to 50 playRange -start 50; // set end of play Range to 200 playRange -end 200; |