Render Scene Dialog

 

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.

The following methods get and set options in the Render Scene dialog:

 

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.

 

The following 3ds Max system global variables are applicable to the Render Scene dialog:

 

renderer

In versions prior 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.

 

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.

 

renderPixelAspect

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

 

rendSimplifyAreaLights

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

 

renderWidth

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

 

rendOutputFilename

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 is unchecked.

 

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.

Note:

The following globals should not be used if the Render Scene dialog is open. These globals do not update the dialog if it is open, and closing the dialog or rendering from the dialog will cause the displayed settings to be stored and used.

 

rendTimeType -- integer

Get/set the type of time range to be rendered. One of the following values:

 1 - A single frame.

 2 - The active time segment (animationRange).

 3 - The user specified range.

 4 - The user specified frame pickup string (for example "1,3,5-12").

 

rendStart -- time

Get/set the renderer's start time setting.

 

rendEnd -- time

Get/set the renderer's end time setting.

 

rendNThFrame -- integer

Get/set the renderer's 'n-th' frame setting. Minimum value = 1

 

rendShowVFB -- boolean

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

 

rendSaveFile -- boolean

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

 

rendUseDevice -- boolean

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

 

rendUseNet -- boolean

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

 

rendFieldRender -- boolean

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

 

rendColorCheck -- boolean

Get/set the renderer's color check flag. TRUE = on; FALSE = off

 

rendSuperBlack -- boolean

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

 

rendHidden -- boolean

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

 

rendForce2Side -- boolean

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

 

rendAtmosphere -- boolean

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

 

rendDitherTrue -- boolean

Get/set the renderer's dither true color flag. TRUE = on; FALSE = off

 

rendDither256 -- boolean

Get/set the renderer's dither 256 color flag. TRUE = on; FALSE = off

 

rendMultiThread -- boolean

Get/set the renderer's multi-threaded flag. TRUE = on; FALSE = off

 

rendNThSerial -- boolean

Get/set the output file sequencing nth serial numbering setting. TRUE = on; FALSE = off

 

rendVidCorrectMethod -- integer

Get/set the video color check method. One of the following values:

 1 = FLAG

 2 = SCALE_LUMA

 3 = SCALE_SAT

 

 

rendFieldOrder -- integer

Get/set the rendering field order. One of the following values:

 1 is Even

 2 is Odd

 

 

rendNTSC_PAL -- integer

Get/set the video color check NTSC or PAL setting. One of the following values:

 1 is NTSC

 2 is PAL

 

rendSuperBlackThresh -- integer

Get/set the super black threshold setting. Range 0 to 255.

 

rendFileNumberBase -- integer

Get/set the File Number Base in the 'Common Parameters' rollup of the Render Scene dialog.

 

rendPickupFrames -- string

Get/set the Frames string in the 'Common Parameters' rollup of the Render Scene dialog.

 

The following 3ds Max system global variables are applicable to the Renderer, but corresponds to the Gbuffer Layers Maximum Number parameter in the Rendering page of the Preference Settings dialog:

 

preferences.maximumGBufferLayers

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

 

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 renderer.

scanlineRender.antiAliasFilter

Lets you get and set the anti-aliasing filter. For a list of all of the anti-aliasing filters you can say:

showClass "*:filter*"

For example:

scanlineRender.antiAliasFilter = quadratic()

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

 

scanlineRender.antiAliasFilterSize

Contains a float value that defines the anti-aliasing filter size.

 

scanlineRender.enablePixelSampler

Lets you enables and disables global super sampling. A Boolean value - true if Disable all Samplers is off, false if on.

Note:

Changing the render scene dialog settings via the MAXcript 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.

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

getrendertype()

setrendertype <name>

Get/set the render type.

The valid name values are:

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

#view and #normal are equivalent, as are #selected and #selection, and #crop and #regionCrop.

See also

Default_Scanline_Renderer : RendererClass

renderSceneDialog

3ds Max Default Scanline Renderer Anti-Aliasing Filters