Controlling the Frame Rate and Format

The playback frame rate and format (The speed at which frames are displayed) are used only for the playback interaction in Softimage. These playback options take the default settings made in the Output Format property, but you can change them as required for playback without affecting the default frame format and rate set for the scene.

There are four standard frame rate formats described by the numerical value contained in the Format parameter. Specifying the custom frame rate format allows the user to define a non-standard frame rate in the Rate parameter value:

Format parameter value	Description	Rate parameter value (frames per second)
7	FILM format	24 fps
8	PAL format	25 fps
10	NTSC format	29.97 fps
11	Custom format	frame rate defined by user
19	HDTV format	30 fps

Tip

The Format parameter values correspond to the siDefaultTimeFormat enum, but these are the values that are logged when using the SetValue command.

These can be accessed directly via the GetValue and SetValue commands (as discussed in Accessing Parameter Values Directly) or through the Parameter or Parameter object, as demonstrated in the examples below.

JScript Example: Finding the Current Frame Rate

// JScript (command access)
var format = GetValue( "PlayControl.Format" );		
var results = "Current frame: ";

switch (format) {
	case 10 : results += " NTSC (29.97 fps)"; break;
	case 8 : results += " PAL (25 fps)"; break;
	case 7 : results += " FILM (24 fps)"; break;
	case 19 : results += " HDTV (30 fps)"; break;
	case 11 : results += " Custom (User ticks per second)";
	default : results = "Unknown format!";
}
Application.LogMessage( results );

// Expected results:
//INFO : Current frame:  FILM (24 fps)

Python Example: Setting a Custom Frame Rate

# Python (command access)
app = Application
app.SetValue( "PlayControl.Format", 11 # switch to custom format 
app.SetValue( "PlayControl.Rate", 10 )# set rate to 10 frames per second

C++ Example: Changing the Current Frame Rate

// Get the current project
Application app;
Project prj = app.GetActiveProject();

// The PlayControl property set is stored with scene data under the project
CRefArray proplist = prj.GetProperties();
Property playctrl( proplist.GetItem(L"Play Control") );

// Switch to PAL format (25 frames per second)
playctrl.PutParameterValue( L"Format", 8.0 );