MAXScript Tools and Interaction with 3ds Max > Interacting with the 3ds Max User Interface > Render Scene Dialog >

# Render Scene Dialog

| Lighting And Rendering - Quick Navigation

Note

Changing the render scene dialog settings via MAXScript should be done with the actual render scene dialog in a closed state.

Leaving the dialog open will make the attempted MAXScript modifications non-sticky.

## Render Scene Dialog > Commong Tab:

Topic Navigation: |
Time Output
Area To Render
Output Size
Options
Advanced Lighting
Bitmap Proxies
Render Output
Pre- and Post-Render Scripts
Viewport, Lock, Render Presets

    renderer

In versions prior to 3ds Max 6, this global variable was used to switch between the draft and production renderers and test which one is active.

The draft renderer was retired in 3ds Max 6 and this variable now returns only #production for compatibility with older scripts.

### Render Scene Dialog > Common Parameters > Time Output Group:

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

Note

Changing the render scene dialog settings via MAXScript should be done with the actual render scene dialog in a closed state.

Leaving the dialog open will make the attempted MAXScript modifications non-sticky.

3ds Max System Global Variables:

    rendTimeType -- integer

Get/set the type of time range to be rendered.

Possible values are:

1 -Single frame.

2 -Active time segment ( animationRange ).

3 -User specified Range.

4 -User specified Frame pickup string (for example "1,3,5-12"). See rendPickupFrames below.

    rendNThFrame -- integer

Get/set the Every Nth Frame value. Minimum value is 1. Default is 1.

    rendStart -- time

Get/set the Start Time value. Used when rendTimeType is set to 3.

    rendEnd -- time

Get/set the End Time value. Used when rendTimeType is set to 3.

    rendFileNumberBase -- integer

Get/set the File Number Base value.

    rendPickupFrames -- string

Get/set the Frames string containing the user frames or sequences to render.

### Render Scene Dialog > Common Parameters > Area To Render

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

The following methods let you get and set the render type:

    getRenderType()

Gets the render type.

    setRenderType <name>

Setsthe render type.

The valid name values are:

#view | #selected | #region | #crop | #blowUp | #boxselected | #regionselected | #cropselected | #normal | #selection | #regionCrop .

#view and #normal are equivalent

#selected and #selection are equivalent

#crop and #regionCrop are equivalent.

### Render Scene Dialog > Common Parameters > Output Size Group

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

Note

Changing the render scene dialog settings via MAXScript should be done with the actual render scene dialog in a closed state.

Leaving the dialog open will make the attempted MAXScript modifications non-sticky.

3ds Max System Global Variables:

    renderWidth -- integer

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

    renderHeight -- integer

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

    renderPixelAspect -- float

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

Note that the Image Aspect is defined implicitly by the above values and is not directly exposed.

Methods:

    getRendApertureWidth()

Get the Aperture Width in millimeters for the current renderer.

    getRendImageAspect()

Get the Image Aspect Ratio for the current renderer.

    setRendApertureWidth <float>

Sets the Aperture Width in millimeters for the current renderer.

### Render Scene Dialog > Common Parameters > Options Group

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

Note

Changing the render scene dialog settings via MAXScript should be done with the actual render scene dialog in a closed state.

Leaving the dialog open will make the attempted MAXScript modifications non-sticky.

3ds Max System Global Variables:

    rendAtmosphere -- boolean

Get/set the renderer's uses atmospheric effects flag. TRUE = on; FALSE = off

    renderEffects -- boolean

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.

    renderDisplacements -- boolean

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.

    rendColorCheck -- boolean

Get/set the Video Color Check option.

    rendFieldRender -- boolean

Get/set the Render To Fields options.

    rendHidden -- boolean

Get/set the renderer's render hidden objects flag. TRUE = on; FALSE = off

    rendSimplifyAreaLights -- boolean

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

    rendForce2Side -- boolean

Get/set the renderer's force two-sided flag. TRUE = on; FALSE = off

    rendSuperBlack -- boolean

Get/set the renderer's super black flag. TRUE = on; FALSE = off

See also rendSuperBlackThresh

### Render Scene Dialog > Common Parameters > Advanced Lighting Group

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

These two options are exposed by properties of the Interface: RadiosityPreferences :

Properties:

RadiosityPreferences.useRadiosity

RadiosityPreferences.computeRadiosity

### Render Scene Dialog > Common Parameters > Bitmap Proxies Group

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

See Interface: BitmapProxyMgr for access to the Bitmap Proxies Manager.

### Render Scene Dialog > Common Parameters > Render Output Group

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

Note

Changing the render scene dialog settings via MAXScript should be done with the actual render scene dialog in a closed state.

Leaving the dialog open will make the attempted MAXScript modifications non-sticky.

3ds Max System Global Variables:

    rendSaveFile -- boolean

Get/set the state of the Save File option.

    rendOutputFilename-- string

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

It contains the corresponding value set in the Render Scene dialog.

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

    rendUseDevice -- boolean

Get/set the state of the renderer's use device flag. TRUE = on; FALSE = off

    rendShowVFB -- boolean

Get/set the state of the renderer's show virtual frame buffer flag. TRUE = on; FALSE = off

    rendUseNet -- boolean

Get/set the state of the renderer's use net flag. TRUE = on; FALSE = off

    skipRenderedFrames -- boolean

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.

### Render Scene Dialog > Common Parameters > Scripts

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

3ds Max System Global Variables:

    usePreRendScript (system BooleanClass)

Get/set the state of the Pre-Render > Enable checkbox.

    preRendScript (system String): ""

Get/set the file name of the Pre-Render script.

    usePostRendScript (system BooleanClass)

Get/set the state of the Post-Render > Enable checkbox.

    postRendScript (system String): ""

Get/set the file name of the Post-Render script.

### Render Scene Dialog > Viewport Index, Lock Button, Render Presets

| Back To Topic Navigation |  | Lighting And Rendering - Quick Navigation

    rendViewIndex -- integer

The index of the viewport to render when the Lock button is pressed ( rendUseActiveView is false )

The index numbers correspond to those used by the "viewport" functions, for example, viewport.activeViewport .

Available in 3ds Max 2009 and higher.

    rendUseActiveView -- boolean

Get/set the Lock button state.

When set to false , the Lock button is pressed and the viewport specified by rendViewIndex will be rendered regardless of which viewport is active.

When set to true , the Lock button is depressed and the active viewport will be rendered, disregarding the selection in the drop-down list.

Available in 3ds Max 2009 and higher.

    renderPresetMRUList -- array of string arrays

This property contains a list of render presets, matching the Render Dialog dropdown list.

This is an array of items, where each item is an array of two sub-items. The first sub-item is the display name of the render preset, the second item is the filename of the corresponding render preset file.

Available in 3ds Max 2009 and higher.

#### See Also

- Pre-Render Script Evaluation Order Changes in 3ds Max 2008

- renderSceneDialog

- ScanlineRender Struct

- Renderer Preferences

- Controlling the Renderer