MAXScript Tools and Interaction with 3ds Max > Interacting with the 3ds Max User Interface > Time Control >

# 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

A System Global variable which 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

A System Global variable which 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 timeConfiguration.playActiveOnly

A System Global variable which 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

A System Global variable which lets you get and 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.

    realTimePlayback timeConfiguration.realTimePlayback

A System Global variable which 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

A System Global variable which lets you get and set whether to loop the viewport playback.

Corresponds to the Loop checkbox in the Time Configuration dialog.

Only used when time Configuration .realTimePlayback is set to true .

Available in 3ds Max 8 and higher.

    timeConfiguration.useTrackBar

A System Global variable which 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.