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