3ds Max System Globals

The 3ds Max system global variables give you access to state information in the 3ds Max system.

Except where noted as read-only, you can both access and assign to the global variables.

A

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
activeGrid 

Contains the currently active grid. If the home grid is active, returns the value undefined .

You can assign a grid node object to this variable to make it the currently active grid.

See Viewport Grids.

You can also return to the home grid by setting activegrid = undefined .

   

ambientColor 

Lets you get and set a Color value that defines the global rendering environment (Rendering > Environment) ambient lighting color.

See Environment And Effects Dialog.

   

ambientColorController 

Lets you get and set a Controller value that defines the global rendering environment (Rendering > Environment) ambient lighting color controller.

See Environment And Effects Dialog.

   

animateMode

Gets or sets the current Auto Key Animation Mode.

   

animationRange 

Lets you get and set an Interval value that defines the start and end of the current active animation range.

This variable contains the corresponding values set in the Time Configuration dialog.

SeeTime Configuration Dialog.

   

animButtonEnabled 

A Boolean value that specifies whether the user can change the state of the Animate button.

If set to false , the user can not change the Animate button state.

If set to true , the user can change the Animate button state.

A script can change the state of the Animate button using animButtonState regardless of the animButtonEnabled value.

SeeTime Control.

   

animButtonState 

Lets you to get and set the state of the Animate button.

A Boolean value - true if Animate is on, false if Animate is off.

SeeTime Control.

   

autoBackup.enabled 

Get/set whether auto backup is enabled as a <boolean>.

   

autoBackup.time 

Get/set the time in minutes between auto backup as a <float>.

If the specified value is < 0.01 (the UI limit), the time is set to 0.01.

B

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
backgroundColor 

Lets you get and set a Color value that defines the global rendering environment (Rendering > Environment) background color.

See Environment And Effects Dialog.

   

backgroundColorController 

Lets you get and set a Controller value that defines the global rendering environment (Rendering > Environment) background color controller.

See Environment And Effects Dialog.

   

backgroundImageFileName 

Lets you get and set a String value that defines the viewport background image bitmap file name.

This variable contains the corresponding bitmap file name set in the Viewport Background dialog.

See Viewport Background Images.

C

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
cui.commandPanelOpen 

Lets you get and set whether the command panel is displayed.

A Boolean value - true if the command panel is displayed, false if not displayed.

SeeCommand Panels.

   

currentMaterialLibrary 

Contains a virtual array of materials and root level maps corresponding to the currently opened material library.

You can get library materials via array indexing and iterate over them in a for loop.

The array can be indexed by number, or by name or string to select by material name.

This variable is read-only. See MaterialLibrary Values.

D

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
displayGamma fileInGamma fileOutGamma 

Lets you get and set Float values that define the gamma preference settings.

They contain the corresponding values set in the Gamma tab of the Preferences dialog.

You could use these global variables to establish gamma for a MAXScript-created bitmap,

FOR EXAMPLE,

b = bitmap 320 240 gamma:displayGamma
render camera:c to:b

This would cause the rendered bitmap to display using the current displays gamma setting if used as a rollout bitmap or button image.

See also Interface: IDisplayGamma for Gamma-related properties and methods.

   

displaySafeFrames 

Lets you get and set whether Show Safe Frames is on for the active viewport.

A Boolean value - true if Show Safe Frames is on, false if off.

E

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
environmentMap 

Lets you get and set a TextureMap value that defines the global rendering environment (Rendering > Environment) environment map.

See Environment And Effects Dialog.

Also see the System Global Variable useEnvironmentMap for control over the on/off state of the environment map.

F

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
flyOffTime 

Lets you get and set an Integer value that defines the time in milliseconds the user must hold down on a flyout before the flyout is activated.

This variable contains the corresponding value set in the General tab of the Preferences dialog.

Same as the System Global Variable preferences.flyOffTime.

   

frameRate 

Lets you get and set an Integer value that defines the current scene frame rate in frames-per-second.

This variable contains the corresponding value set in the Time Configuration dialog.

See Time Configuration Dialog.

G

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
globalTracks 

Contains a MAXTVNode value that defines the top-level Global Tracks node in Track View.

This variable is read-only.

See Track View Nodes.

H

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
hardwareLockID 

Contains an Integer value that defines the 3ds Max hardware lock ID.

This variable is read-only.

   

hotspotAngleSeparation 

Contains a Float value that defines the Hot Spot/FallOff Angle Separation value.

This variable contains the corresponding value set in the Rendering tab of the Preferences dialog.

This variable is read-only.

K

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
keyboard.shiftPressed keyboard.controlPressed keyboard.altPressed keyboard.escPressed 

These read-only variables access the current state of the keyboard Shift, Control, Alt and Escape keys.

They return true or false depending on the pressed state of the key at the time the variable is read.

L

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
lightLevel 

Lets you get and set a Float value that defines the global rendering environment (Rendering > Environment) Global Lighting Tint Level.

See Environment And Effects Dialog.

   

lightLevelController 

Lets you get and set a Controller value that defines the global rendering environment (Rendering > Environment) Global Lighting Tint Level controller.

See Environment And Effects Dialog.

   

lightTintColor 

Lets you get and set a Color value that defines the global rendering environment (Rendering > Environment) Global Lighting Tint color.

See Environment And Effects Dialog.

   

lightTintColorController 

Lets you get and set a Controller value that defines the global rendering environment (Rendering > Environment) Global Lighting Tint color controller.

See Environment And Effects Dialog.

   

listener 

Read only system global - listener edit window <WindowStream> value.

   

localTime 

Contains a String value that defines the current local date and time.

This variable is read-only.

An example of the value stored in localtime is:

s = localTime
"4/14/97 10:24:57 AM"

The format of this string is controlled by the date format selected in the main Windows Regional Settings control panel.

See also Local and Universal Time.

   

logsystem.quietmode 

Lets you get and set whether error logging quiet mode is enabled.

A Boolean value set to true when you do not want error messages from the renderer to bring up dialog boxes.

If set to false , error messages from the renderer will bring up dialog boxes.

3ds Max sets the corresponding internal variable to true during network rendering to suppress error messages such as the "Missing Maps" and "Missing Map Coordinates" dialogs.

If this variable is set to true and the renderer generates an error message, the renderer will exit.

After setting quiet mode, do not forget to clear it when you are done, since the user will not see any error messages from the renderer while quiet mode is enabled.

See also logsystem_struct for log system related methods.

M

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
macroRecorder 

Read-only system global - represents the Macro Recorder edit window <WindowStream> value.

   

manipulateMode 

Get/set the 3ds Max manipulate mode.

When true , manipulate mode is active.

See also the topic Scripted Manipulators for details.

   

maxFileName 

Contains a String value that defines the file name for the currently open scene.

This variable is read-only.

See How do I get the file name of the current scene? FAQ entry as well as 3ds Max File Loading and Saving.

   

maxFilePath 

Contains a String value that defines the directory path for the currently open scene.

This variable is read-only.

   

maxOps.productAppID : enum : Read productAppID enums: {#none|#max|#viz|#gmax} 

The enum values returned are as follows:

#none -no ID

#max -3ds Max

#viz - Autodesk VIZ

#gmax -gmax

   

meditMaterials 

Contains a virtual array of materials and root level maps corresponding to the slots in the material editor.

You can access material editor materials and root level maps via array indexing and iterate over them in a for loop.

The array can be indexed by number to specify slot number or name or string to select by material and root level map name.

EXAMPLE

b=box()
b.material = meditMaterials[1]
meditMaterials["01 - Default"].diffuse = red
for m in meditMaterials do print m.diffuseMap
meditMaterials[1]=standard()
print meditMaterials.count-- number of slots

This variable is read-only, but the elements (the materials in the slots) are assignable.

See MaterialLibrary Values.

See Material Editor for methods for assigning materials and maps to the material editor slots.

N

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
numEffects

Contains an Integer value that defines the number of current render effects defined in the Rendering > Effects dialog list.

This variable is read-only.

SeeRenderEffect.

   

numAtmospherics 

Contains an Integer value that defines the number of atmospheric events, as shown in Rendering > Environment.

This variable is read-only.

See Environment And Effects Dialog.

   

numSubObjectLevels 

Lets you get the number of sub-object levels supported by the object or modifier currently selected in the modifier stack.

If the Modify panel is not open or no objects are selected, the global contains the value undefined . See Modify Panel.

NOTE:

The subObjectLevel and numSubObjectLevels system global variables return values other than 'undefined' if you are in the Motion panel.

At the top of the Motion panel there is a Selection Level/Sub-Object drop-down list. This is for Trajectory mode, and switches you in and out of Keys SO mode.

Because of this, the test (subobjectlevel != undefined) is not a valid test of whether you are in the Modify panel.

Instead, use the test (getCommandPanelTaskMode() == #modify) .

P

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
playActiveOnly 

Lets you get and set whether to playback the active viewport only.

This variable contains the corresponding value set in the Time Configuration dialog.

A Boolean value - true if Active Viewport Only is on, false if off. See Time Configuration Dialog.

   

preferences.autoKeyDefaultKeyOn 

NEW in 3ds Max 2017: This System Global variable controls whether a default key with the current value will be created when a controller with no keys is animated in Auto Key mode at a time different from the value set by preferences.autoKeyDefaultKeyTime.

Corresponds to the checkbox exposed in the Main Menu > Customize > Preferences > Animation > Auto Key Default Frame group of controls.

Default is True.

When set to False, a new key will be created only at the current time, and the original value of the controller will be lost.

NOTE:The maxOps interface has an option by the same name that has the same functionality.

 

preferences.autoKeyDefaultKeyTime 

 

NEW in 3ds Max 2017: This System Global variable controls the frame on which a default key with the current value will be created when a controller with no keys is animated in Auto Key mode at a different time.

Corresponds to the value spinner exposed in the Main Menu > Customize > Preferences > Animation > Auto Key Default Frame group of controls.

Default is 0.

The value can be set to any valid frame number.

Note that in versions prior to 3ds Max 2017, the default key time could only be set to 0 or 1.

NOTE:The maxOps interface has an option by the same name that has the same functionality.

preferences.constantReferenceSystem 

Lets you get and set whether to use the same coordinate system for the Move, Rotate, and Scale tools in the 3ds Max toolbar.

A Boolean value - true if Constant is on, false if off.

This variable matches the Constant check box in the General page of Customize > Preferences.

   

preferences.dontRepeatRefMsg 

A PRS animation controllers message notification system optimization was introduced in 3ds Max 6 and was enabled by default. It speeds up complex rigs using multiple animation controllers.

When set to true, the optimization is enabled and no redundant notifications are sent by the controllers.

When set to false, the animation system behaves as in 3ds Max 5 and earlier.

   

preferences.EnableOptimizeDependentNotifications 

NEW in 3ds Max 2017: For internal use only.

Related Methods:

<array>GetOptimizeDependentNotificationsStatistics() 

Returns the optimized dependent notification statistics as an array of two Integer64 values.

<void>ResetOptimizeDependentNotificationsStatistics()

Resets the statistics counters to zero.

   

preferences.flyOffTime 

Lets you get and set an Integer value that defines the time in milliseconds the user must hold down on a flyout before the flyout is activated.

This variable contains the corresponding value set in the General page of Customize > Preferences.

Same as the System Global Variable flyOffTime.

   

preferences.InvalidateTMOpt 

An optimization was introduced in 3ds Max 7 that checks to see if a node has already been invalidated before sending out notifications to it's dependents that it has been changed. It speeds up complex rigs, especially those that involve the new expose transform helper.

When set to true, the optimization is enabled and multiple notifications will not be sent out.

When set to false, the animation system behaves as in 3ds Max 6 and earlier.

It is true by default.

   

preferences.maximumGBufferLayers 

Lets you get and set an Integer value that specifies the maximum number of g-buffer layers generated during a render.

   

preferences.spinnerWrap 

Lets you get and set a Boolean value that defines whether cursor wrapping is limited to an area close to the spinner when you drag to adjust spinner value.

This variable contains the corresponding value set in the General page of Customize > Preferences.

   

preferences.spinnerPrecision 

This integer value defines the number of decimal digits displayed by spinners.

Corresponds to the Precision value in the Spinners group in Customize > Preferences > General.

   

preferences.spinnerSnap 

This float value defines the spinner snap value.

Corresponds to the Snap value in the Spinners group in Customize > Preferences > General.

   

preferences.useSpinnerSnap 

This Boolean value defines whether to use the spinner snap.

Corresponds to the Use Snap checkbox in the Spinners group in Customize > Preferences > General.

   

preferences.useLargeVertexDots 

Lets you get and set whether to use small or large dots when representing vertices as dots.

A Boolean value set to true if you when using dots to represent vertices and a large size is desired.

The value of this variable only has effect when UseVertexDots is set to true .

This variable contains the corresponding value set in the Viewports page of Customize > Preferences.

   

preferences.useTransformGizmos 

Lets you get and set whether to use the Transform Gizmos.

A Boolean value - true if on, false if off.

This variable contains the corresponding value set in the Viewports page of Customize > Preferences.

   

preferences.useVertexDots 

Lets you get and set whether to represent vertices as dots.

A Boolean value set to true when you want to use dots as the representation of the vertices in a mesh. If set to false , ticks will be used.

This variable contains the corresponding value set in the Viewports page of Customize > Preferences.

R

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
realTimePlayback 

Lets you get and set whether to playback in real time mode. This variable contains the corresponding value set in the Time Configuration dialog.

A Boolean value - true if Real Time is on, false if off.

See Time Configuration Dialog.

   

renderer 

In versions prior 3ds Max 6, this global variable was used to get and set the renderer type (#production or #draft).

The #draft renderer option has been removed from 3ds Max 6, making this variable obsolete.

It only accepts and returns #production now and is kept for backwards compatibility of scripts from earlier versions that might be checking this value.

   

renderDisplacements 

Lets you get and set whether to perform displacement mapping during a render.

A Boolean value - true if displacement mapping is to be performed, false if not.

   

renderEffects 

Lets you get and set whether to perform Render Effects after a scene render.

A Boolean value - true if Render Effects are to be performed, false if not.

   

renderHeight 

Lets you get and set an Integer value that defines the output size height for the active renderer.

This variable contains the corresponding value set in the Render Scene dialog.

See Render Scene Dialog.

   

renderPixelAspect 

Lets you get and set an Integer value that defines the output pixel aspect for the active renderer.

This variable contains the corresponding value set in the Render Scene dialog.

   

renderWidth 

Lets you get and set an Integer value that defines the output size width for the active renderer.

This variable contains the corresponding value set in the Render Scene dialog.

See Render Scene Dialog.

   

rendOutputFilename 

Lets you get and set a String value that defines the output file name for the active renderer.

This variable contains the corresponding value set in the Render Scene dialog.

If this global variable is set to "" the Save File check box in the Render Scene dialog is unchecked.

   

rendSimplifyAreaLights 

When set to true , area lights will be examined and converted to point light sources when appropriate.

NOTE:There is also an equally named parameter to the render() command to achieve this behavior.

   

rootNode 

Contains a Node value that defines the root node of the scene.

The root node does not physically exist in the scene, rather it is a special node that is the parent node of all nodes that are not linked to another node.

The scene objects can be enumerated by accessing the children property of the root node.

A run-time error is generated if you try to perform other node operations on the root node.

   

rootScene 

Represents the scene root in scripts and Macro Recorder output.

The subAnims of rootScene include the node hierarchy, the Material Editor, Track View, Scene Material Library etc.

See rootScene System Global Variable.

Available in 3ds Max 2011 and higher.

S

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
sceneMaterials 

Contains a virtual array of materials and root level maps corresponding to the materials and root level maps present in the scene.

You can get scene materials and root level maps via array indexing and iterate over them in a for loop.

The array can be indexed by number, or by name or string to select by material or root level map name.

This variable is read-only.

See MaterialLibrary Values.

   

scriptsPath 

Contains a String value that defines the full directory path to the current Scripts directory.

This variable is read-only.

   

selectionSets 

Contains a virtual array of all the current named node selection sets in the Named Selection Set drop-down list on the 3ds Max toolbar.

You can get named selection sets via array indexing and iterate over them in a for loop.

The array can be indexed by number, or by name or string to select by named selection sets.

You can change, add and delete Named Selection Sets by using the standard array methods on the selectionSets array.

SeeSelectionSetArray Values.

   

showEndResult 

Lets you get and set the state of the Show End Result Toggle icon in the Modify panel.

A Boolean Value - true if Show End Result is on, false if off. See Modify Panel.

   

skipRenderedFrames 

Lets you get and set whether to skip rendered frames during a render.

A Boolean Value - true if rendered frames are to be skipped, false if not.

   

sliderTime 

Lets you get and set a Time value that defines the time associated with the 3ds Max time slider.

SeeTime Control.

   

snapMode.active 

Lets you get and set a Boolean value defining the Snap toggle state - on ( true ) or off ( false ).

See Status Bar Buttons as well as the SnapMode struct topic.

 

   

snapMode.type 

Lets you get and set a Name value defining whether 2D ( #2D ), 2.5D ( #2_5D ), or 3D ( #3D ) is the current snap type.

See Status Bar Buttons as well as the SnapMode struct topic.

   

snapMode.snapPreviewRadius 

A System Global variable which lets you get and set the Snap Preview Radius value.

Default value is 30.

Available in 3ds Max 7 and higher.

Also see the SnapMode struct topic.

   

snapMode.snapRadius 

A System Global variable which lets you get and set the Snap Radius value.

Default value is 20.

Available in 3ds Max 7 and higher.

Also see the SnapMode struct topic.

   

snapMode.hilite 

A System Global which lets you get and set the color value of the Snap Marker.

Available in 3ds Max 7 and higher.

   

snapMode.markSize 

A System Global which lets you get and set the Snap Marker Size.

An integer value.

Available in 3ds Max 7 and higher.

   

snapMode.toFrozen 

A System Global which lets you get and set whether to snap to frozen objects.

A Boolean value.

Available in 3ds Max 7 and higher.

   

snapMode.axisConstraint 

A System Global which lets you get and set whether the snap should use axis constraints as Boolean value.

Corresponds to the checkbox in the "Grid and Snap Settings" dialog, Options tab.

Available in 3ds Max 7 and higher.

   

snapMode.displayRubberBand 

A System Global which lets you get and set whether to display rubber band as a Boolean value.

Corresponds to the checkbox in the "Grid and Snap Settings" dialog, Options tab.

Available in 3ds Max 7 and higher.

   

snapMode.useAxisCenterAsStartSnapPoint 

A System Global which lets you get and set the state of the "Use Axis Center As Start Snap Point" option as Boolean value.

Corresponds to the checkbox in the "Grid and Snap Settings" dialog, Options tab.

Available in 3ds Max 7 and higher up to3ds Max 2010.

Deprecated in 3ds Max 2011.

Attempting to access this property will result in:

-- Runtime error: Cannot set this snap option. It has been deprecated as of 3ds Max 2011.

   

snapMode.display 

A System Global which lets you get and set whether the Snap Marker is displayed.

A Boolean value.

Available in 3ds Max 7 and higher.

   

snapMode.strength 

A System Global which lets you get and set the Snap Strength as an integer value.

Available in 3ds Max 7 and higher.

   

snapMode.hit 

A System Global which contains true if the Marker is currently snapped to something, false if not snapped.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.node 

A System Global which contains the node currently being snapped to.

Contains undefined if not snapped to a node or if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.flags 

A System Global which contains the Snap System Flags as an integer.

Contains undefined if Snaps not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.hitPoint 

A System Global which contains the last Snap Point as Point3 coordinate in local coordinates of the node snapped to.

Contains undefined if Snaps are not active.

Read only.

Available in3ds Max 7 and higher.

   

snapMode.worldHitpoint 

A System Global which contains the last Snap Point as Point3 world coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.screenHitPoint 

A System Global which contains the last Snap Point as a Point3 screen coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.OKForRelativeSnap 

A System Global which contains true if at least one Snap Point has been recorded.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

 

   

snapMode.refPoint 

A System Global which contains the last Snap Point as point3 world coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.topRefPoint 

A System Global which contains the first snap point as point3 world coordinate.

Contains undefined if Snaps are not active.

Read only.

Available in 3ds Max 7 and higher.

   

snapMode.numOSnaps 

A System Global which contains the number of OSnaps as an integer.

Read only.

Currently there are 6 sets of OSnaps - see below of details.

Available in 3ds Max 7 and higher.

   

subObjectLevel 

Lets you get and set the sub-object level in the Modify panel if it is open. An Integer value of zero or greater up to the number of sub-object levels supported by the currently open modifier, typically in the order shown in the Sub-Object drop-down list.

A subObjectLevel of 0 means sub-object mode is off.

If the Modify panel is not open or sub-object level setting not permitted in the current modifier, the global contains the value undefined .

Use the numSubObjectLevels global variable to access the maximum valid subObjectlevel value.

See Modify Panel.

EXAMPLE

b=box()-- create a box
em=edit_mesh()-- create an Edit Mesh modifier
addModifier b em-- add edit mesh mod
max modify mode-- open mod panel
select b-- select object Box001
print subObjectLevel-- print the current subobject level
subObjectLevel = 2-- set sub-object level to Edge
NOTE:

The subObjectLevel and numSubObjectLevels system global variables return values other than 'undefined' if you are in the Motion panel.

At the top of the Motion panel, there is a Selection Level/Sub-Object drop-down. This is for Trajectory mode, and switches you in and out of Keys SO mode.

Because of this, the test (subobjectlevel != undefined) is not a valid test of whether you are in the Modify panel. Instead, use the test (getCommandPanelTaskMode() == #modify).

   

sysInfo.DesktopSize 

A read only variable to get the desktop size in pixels as a <point2> value.

See also System Information and getMAXWindowSize() under Miscellaneous Functions

   

sysInfo.DesktopBPP 

A read only variable to get the desktop color depth in bits per pixel as an <integer> value.

See also System Information.

   

sysInfo.MAXPriority 

Get/set the 3ds Max process priority as a <name> value. Valid priority values are #high , #normal , and #low .

See also System Information.

T

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
ticksPerFrame 

Lets you get and set an Integer value defining the system time resolution.

There are always 4800 ticks per second, this means that ticksPerFrame is dependent on the frames per second rate (ticksPerFrame * frameRate == 4800)

   

timeConfiguration.playActiveOnly 

Lets you get and set whether to playback the active viewport only.

This variable contains the corresponding value set in the Time Configuration dialog.

A Boolean value - true if Active Viewport Only is on, false if off.

See Time Configuration Dialog.

Same as playActiveOnly System Global.

   

timeConfiguration.realTimePlayback 

Lets you get and set whether to playback in real time mode.

This variable contains the corresponding value set in the Time Configuration dialog.

A Boolean value - true if Real Time is on, false if off.

See Time Configuration Dialog.

Same as realTimePlayback System Global.

   

timeConfiguration.PlaybackSpeed 

Lets you get and set the viewport playback speed mode.

SeeTime Configuration Dialog.

   

timeConfiguration.PlaybackLoop 

Get/set whether to loop the viewport playback. Only used when timeConfiguration . realTimePlayback is set to true.

See Time Configuration Dialog.

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.

See Time Configuration Dialog.

   

timeDisplayMode 

Lets you get and set whether to playback the Time Display mode. It contains the corresponding value set in the Time Configuration dialog as a Name value.

Available in 3ds Max 2008 and higher. Previously available in the Avguard DLX Extension

Possible values are #frames, #smpte, #frameTicks, #timeTicks.

   

toolmode.axisConstraints 

Get/set the 3ds Max axis constraints.

The axis constraints values are:

#X #Y #Z #XY #YZ #ZX 

See Main Toolbar.

   

toolmode.commandmode 

Get/set the 3ds Max command mode.

The value of the command mode is a <name> value if the command mode is a recognized command mode, otherwise the return value is an integer value.

The recognized command modes are:

   

#SELECT #MOVE #ROTATE #NUSCALE #USCALE #SQUASH #VIEWPORT #HIERARCHY #CREATE #MODIFY #MOTION #ANIMATION #CAMERA #NULL #DISPLAY #SPOTLIGHT #PICK 

When setting the 3ds Max command mode, only the following command modes are valid:

#SELECT #MOVE #ROTATE #NUSCALE #USCALE #SQUASH 

See Main Toolbar.

   

toolMode.coordSysNode 

A read/write variable containing a node value or undefined.

This variable reflects which node, if any, is the current reference coordinate system node.

Assignment to this variable must be a node value.

See Main Toolbar.

   

toolmode.commandmodeID 

Get the 3ds Max command mode as Integer ID.

Read-only.

Possible values are:

1 - Move

2 - Rotate

3 - Non-Uniform Scale

4 - Uniform Scale

5 - Squash Scale

6 - Select

See Main Toolbar.

   

trackbar.filter 

Lets you get and set the filter specifying which types of keys to show in the Trackbar.

A Name value - the valid values are: #all , #TMOnly , #currentTM , #object , and #mat .

   

trackbar.visible 

Lets you get and set whether the Trackbar is visible.

A Boolean value - true if the Trackbar is visible, false if invisible.

   

trackViewNodes 

Contains a MAXTVNode value that defines top-level World node in Track View.

This variable is read-only. See Track View Nodes.

U

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
units.DisplayType 

Get/set the current unit display type as a <name>.

Valid unit display types are:

#Generic #Metric #US #custom 

See Units Struct - Accessing System and Display Units.

   

units.MetricType 

Get/set the current metric unit display type as a <name>.

Valid metric unit display types are:

   

#Millimeters #Centimeters #Meters #Kilometers 

See Units Struct - Accessing System and Display Units.

   

units.USType 

Get/set the current US standard unit display type as a <name>.

Valid US standard unit display types are:

   

#Frac_In #Dec_In #Frac_Ft #Dec_Ft #Ft_Frac_In #Ft_Dec_In 

See Units Struct - Accessing System and Display Units.

   

units.USFrac 

Get/set the current US fraction display type as a <name>.

Valid US fraction display types are:

   

#Frac_1_1 #Frac_1_2 #Frac_1_4 #Frac_1_8 #Frac_1_10 #Frac_1_16 #Frac_1_32 #Frac_1_64 #Frac_1_100 

See Units Struct - Accessing System and Display Units.

   

units.CustomName 

Get/set the current custom unit name as a <string>

See Units Struct - Accessing System and Display Units.

   

units.CustomValue 

Get/set the current custom unit value as a <float>

See Units Struct - Accessing System and Display Units.

   

units.CustomUnit 

Get/set the current custom unit type as a <name>.

Valid custom unit display types are:

#Inches #Feet #Miles #Millimeters #Centimeters #Meters #Kilometers 

See Units Struct - Accessing System and Display Units.

   

units.SystemScale 

Get/set the current system unit scale value as a <float>.

This is the value shown in Customize Units Setup... > System Units Setup > System Units Scale group.

See Units Struct - Accessing System and Display Units.

   

units.SystemType 

Get/set the current system unit scale type as a <name>. This is the unit shown in Customize > Units Setup... > System Units Setup > System Units Scale group.

Valid system unit scale types are:

#Inches #Feet #Miles #Millimeters #Centimeters #Meters #Kilometers 

See Units Struct - Accessing System and Display Units.

   

useEnvironmentMap 

Lets you get and set the global rendering environment (Rendering > Environment) Use Map value. A Boolean value - true if Use Map is on, false if off. See Environment And Effects Dialog.

V

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline
videoPostTracks 

Contains a MAXTVNode value that defines the top-level Video Post Track View node.

This variable is read-only. See Track View Nodes.

   

viewport.activeViewport 

Lets you get and set the index of the active viewport.

See Accessing Active Viewport Info, Type, and Transforms.

   

viewport.numViews 

Contains the number of viewports in the current viewport layout.

This variable is read-only. See Accessing Active Viewport Info, Type, and Transforms.

Scanline Renderer Specific System Global Variables

Topic Navigation:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Scanline

The following 3ds Max system global variables are specific to 3ds Max’s default scanline A-Buffer renderer.

These variables return undefined if the current renderer is not 3ds Max’s default scanline A-Buffer renderer.

scanlineRender.antiAliasFilter 

Lets you get and set the anti-aliasing filter.

EXAMPLE

scanlineRender.antiAliasFilter = quadratic()

For a list of all of the anti-aliasing filters you can say:

EXAMPLE

showClass "*:filter*"
-->Area : filter {77912301,0}
-->Quadratic : filter {77912304,0}
-->cubic : filter {77912305,0}
-->Catmull_Rom : filter {77912306,0}
-->Blackman : filter {77912313,0}
-->Sharp_Quadratic : filter {77912314,0}
-->Video : filter {77912319,0}
-->Plate_Match_MAX_R2 : filter {7791231b,0}
-->Cook_Variable : filter {77912330,0}
-->Soften : filter {77912331,0}
-->Mitchell_Netravali : filter {77912350,0}
-->Blendfilter : filter {77912352,0}
-->Filter_kernel_plug_in_not_found : filter {ffffffff,0}
-->OK

The anti-aliasing filters and their parameters are described in 3ds Max Scanline A-Buffer Renderer Anti-Aliasing Filters.

   

scanlineRender.antiAliasFilterSize 

Contains a float value that defines the anti-aliasing filtersize.

   

scanlineRender.enablePixelSampler 

Lets you enables and disables global super sampling.

A Boolean value - true if Disable all Samplers is off , false if on.