Softimage SDK Programmer's Guide > Working with the SDK > Animation >

# Playback Controls

Controls are fundamentally a set of parameters that control how the user moves around in the timeline and how the scene is played back. This set of parameters is contained in the Play Control property set (its scripting name is PlayControl). Some of the most useful parameters include:

- Current: Contains the current frame number (see Getting and Changing the Current Frame).

- In and Out: Contains the first and last frame numbers (see Moving Around in the Timeline).

- Loop: True for continuous playback (looping).

- Step: Sets the interval at which frames are played back in the viewport. A value of 2 causes the viewports to display only every second frame in the viewport during playback.

- Format and Rate: Control the frame rate for the PAL, NTSC, Film, and HDTV formats (see Controlling the Frame Rate and Format for more information).

- KeepFrameTiming: Determines whether to save fcurve keys in frames (relative) or seconds (absolute).

- OnFrameChangeCommand: Allows you to run simple VBScript code each time the frame changes (see Running Commands During Playback at Each Frame Change for more information).

- SequencerIn and SequencerOut: Contains the first and last frame numbers in the Sequencer Timeline. The Camera Sequencer feature introduces a second timeline (Sequencer Time) in Softimage to playback the original scene in another timing while keeping the original animation. See the Softimage user's guide for more information about the Camera Sequencer.
- CurrentSequencer: Contains the current frame number in the Sequencer Timeline.

Note

PlayControl does not have a special class implemented in the object model or C++ API. Most functionality is available through scripting commands, but you can also access it in the object model and the C++ API like any other Property or Property object, which is demonstrated in Accessing the PlayControl Property Set.

#### Topics in this section

- Accessing the PlayControl Property Set
- Getting and Changing the Current Frame
- Moving Around in the Timeline
- Starting the Playback in Any Direction
- Changing the PlayControl Options
- Controlling the Frame Rate and Format
- Running Commands During Playback at Each Frame Change