Description

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

Functional area

Playback control

Command syntax

Syntax

playRange inTime outTime[-r] [-start] [-end] [-save] [-restore]

Arguments

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

Flags

Name	Argument type	Exclusive to	Comments
`r`	—	—	Set range relative to start/end of current play range
`start`	—	end	Sets the playRange start to the current frame
`end`	—	start	Sets the playRange end to the current frame
`save`	—	restore	Save current play range before applying play range changes. Can be restored by next `playRange -restore` call.
`restore`	—	save	Restore the last saved play range before applying play range changes.

Return value

void

Examples

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;

Shogun 1.11 Documentation

playRange