Time Configuration Dialog

The following methods get and set options in the Time Configuration dialog:

getKeyStepsPos()

setKeyStepsPos <boolean>

Get and set whether to jump to next position key when Key Mode Toggle is on.

 

getKeyStepsRot()

setKeyStepsRot <boolean>

Get and set whether to jump to next rotation key when Key Mode Toggle is on.

 

getKeyStepsScale()

setKeyStepsScale <boolean>

Get and set whether to jump to next scale key when Key Mode Toggle is on.

 

getKeyStepsSelOnly()

setKeyStepsSelOnly <boolean>

Get and set whether to use Selected Objects Only when Key Mode Toggle is on.

 

getKeyStepsUseTrans()

setKeyStepsUseTrans <boolean>

Get and set whether to Use Current Transform when Key Mode Toggle is on.

 

The following 3ds Max system global variables are applicable to the Time Configuration dialog:

 

animationRange

Lets you get and set an Interval value that defines the start and end frames of the Active Time Segment. It contains the values set in the Time Configuration dialog>Animation>Start Time and End Time and displayed by the Active Time Segment option in the Time Output group of controls in the Render Scene Dialog.

The start and end values of the animationRange interval can be read individually using animationRange.start and animationRange.end. They cannot be set separately though - the complete interval has to be assigned to the animationRange variable.

Examples:

animationRange --Get the current animation range

(interval 0f 100f)

animationRange = interval 10 50 --Set range to frames 10 to 50

(interval 10f 50f)

animationRange.start --Get the start frame of the range

10f

animationRange.end --Get the end frame of the range

50f

--To change the end frame of the interval only:

animationRange = interval animationRange.start 90f

(interval 10f 90f)

 

frameRate

Lets you get and set an Integer value that defines the current scene frame rate in frames-per-second. It contains the corresponding value set in the Time Configuration dialog.

 

playActiveOnly

Lets you get and set whether to playback the active viewport only. It contains the corresponding value set in the Time Configuration dialog. A Boolean value - true if Active Viewport Only is on, false if off.

 

realTimePlayback

Lets you get and set whether to playback in real time mode. It contains the corresponding value set in the Time Configuration dialog. A Boolean value - true if Real Time is on, false if off.

 

timeConfiguration.playActiveOnly

Lets you get and set whether to playback the active viewport only. It contains the corresponding value set in the Time Configuration dialog. A Boolean value - true if Active Viewport Only is on, false if off.

 

timeConfiguration.playbackSpeed

Get/set the viewport playback speed as an indexed <integer>. The valid values for the integer are: 1 - 1/4x, 2 - 1/2x, 3 - 1x, 4 - 2x, 5 - 4x.

 

timeConfiguration.realTimePlayback

Lets you get and set whether to playback in real time mode. It contains the corresponding value set in the Time Configuration dialog. A Boolean value - true if Real Time is on, false if off.

 

timeConfiguration.playbackLoop

Get/set whether to loop the viewport playback. Corresponds to the Loop checkbox in the Time Configuration dialog. Only used when timeConfiguration.realTimePlayback is set to true. Available in 3ds Max 8 and higher.

 

timeConfiguration.useTrackBar

Lets you get and set the state of the Time Configuration dialog 'Key Steps / Use TrackBar' check box. A Boolean Value - true if checked, false if not.