mental_ray_renderer : RendererClass

mental_ray_renderer - superclass: RendererClass; super-superclass:MAXWrapper - classID: #(1492548972, 1338981315)

This class represents the mental ray renderer. It lets you construct an instance of the mental_ray_renderer class to be assigned to the Current, Production and Material Editor renderers using the renderers structure.

NOTE: Unsupported feature.

Constructor

mental_ray_renderer ...

Properties

<mental_ray_renderer>.AlphaSpatialContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.AlphaTemporalContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.Autovolume BooleanClass default: false -- boolean

 

<mental_ray_renderer>.BlueSpatialContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.BlueTemporalContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.BoxFilterHeight Float default: 1.0 -- float

 

<mental_ray_renderer>.BoxFilterWidth Float default: 1.0 -- float

 

<mental_ray_renderer>.BSPDepth Integer default: 40 -- integer

 

<mental_ray_renderer>.BSPSize Integer default: 10 -- integer

 

<mental_ray_renderer>.Camera_Lens_Shader UndefinedClass default: undefined

 

<mental_ray_renderer>.Camera_Output_Shader UndefinedClass default: undefined

 

<mental_ray_renderer>.Camera_Volume_Shader UndefinedClass default: undefined

 

<mental_ray_renderer>.CausticAccuracy Integer default: 100 -- integer

 

<mental_ray_renderer>.CausticRadius Float default: 1.0 -- float

 

<mental_ray_renderer>.CausticsEnable BooleanClass default: false -- boolean

 

<mental_ray_renderer>.CausticsFilter Integer default: 0 -- integer

 

<mental_ray_renderer>.Conserve_Memory BooleanClass default: false -- boolean

 

<mental_ray_renderer>.Contour_Contrast_Shader Contour_Contrast_Function_Levels__contour default: DefaultContourContrastShader:Contour Contrast Function Levels (contour) -- SubAnim

 

mental_ray_renderer.Contour_Contrast_Shader - superclass: textureMap; super-superclass:material - 10:0 - classID: #(2004031007, -2112913332)

<mental_ray_renderer>.Contour_Output_Shader Contour_Composite__contour default: DefaultContourOutputShader:Contour Composite (contour) -- SubAnim

 

mental_ray_renderer.Contour_Output_Shader - superclass: textureMap; super-superclass:material - 4:0 - classID: #(2004031007, 1963608696)

<mental_ray_renderer>.Contour_Store_Shader Contour_Store_Function__contour default: DefaultContourStoreShader:Contour Store Function (contour) -- SubAnim

 

mental_ray_renderer.Contour_Store_Shader - superclass: textureMap; super-superclass:material - 11:0 - classID: #(2004031007, -1957461970)

<mental_ray_renderer>.DepthOfFieldEnable BooleanClass default: false -- boolean

 

<mental_ray_renderer>.DepthOfFieldMode Integer default: 0 -- integer

 

<mental_ray_renderer>.DiagnosticBSPMethod Integer default: 0 -- integer

 

<mental_ray_renderer>.DiagnosticGridMethod Integer default: 0 -- integer

 

<mental_ray_renderer>.DiagnosticGridSize Float default: 1.0 -- float

 

<mental_ray_renderer>.DiagnosticMode Integer default: 0 -- integer

 

<mental_ray_renderer>.DiagnosticPhotonMethod Integer default: 0 -- integer

 

<mental_ray_renderer>.DiagnosticsEnabled BooleanClass default: false -- boolean

 

<mental_ray_renderer>.DistributedEnable BooleanClass default: false -- boolean

 

<mental_ray_renderer>.Edge_Length Float default: 2.0 -- float

 

<mental_ray_renderer>.Enable_Camera_Lens_Shader BooleanClass default: true -- boolean

 

<mental_ray_renderer>.Enable_Camera_Output_Shader BooleanClass default: true -- boolean

 

<mental_ray_renderer>.Enable_Camera_Volume_Shader BooleanClass default: true -- boolean

 

<mental_ray_renderer>.EnableContours BooleanClass default: false -- boolean

 

<mental_ray_renderer>.EnableShadowMaps BooleanClass default: true -- boolean

 

<mental_ray_renderer>.Export_ASCII BooleanClass default: true -- boolean

 

<mental_ray_renderer>.Export_Filename String default: """" -- string

 

<mental_ray_renderer>.Export_On_Render BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FarFocus Float default: 110.0 -- float

 

<mental_ray_renderer>.filter Integer default: 0 -- integer

 

<mental_ray_renderer>.FinalGatherAccuracy Integer default: 1000 -- integer

 

<mental_ray_renderer>.FinalGatherFalloff BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FinalGatherFalloffStart Float default: 0.0 -- float

 

<mental_ray_renderer>.FinalGatherFalloffStop Float default: 0.0 -- float

 

<mental_ray_renderer>.FinalGatherFilename String default: "" -- string

 

<mental_ray_renderer>.FinalGatherPreview BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FinalGatherRadius Float default: 1.0 -- float

 

<mental_ray_renderer>.FinalGatherRebuild BooleanClass default: true -- boolean

 

<mental_ray_renderer>.FinalGatherReflectionDepth Integer default: 5 -- integer

 

<mental_ray_renderer>.FinalGatherRefractionDepth Integer default: 5 -- integer

 

<mental_ray_renderer>.FinalGatherTraceDepth Integer default: 5 -- integer

 

<mental_ray_renderer>.FinalGatherMinRadius_View Float default: 0.5 -- float

 

<mental_ray_renderer>.FinalGatherRadius_View Float default: 5.0 -- float

 

<mental_ray_renderer>.FinalGatherView BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FocusPlane Float default: 100.0 -- float

 

<mental_ray_renderer>.fStop Float default: 1.0 -- float

 

<mental_ray_renderer>.GaussFilterHeight Float default: 3.0 -- float

 

<mental_ray_renderer>.GaussFilterWidth Float default: 3.0 -- float

 

<mental_ray_renderer>.GIMaximumReflections Integer default: 5 -- integer

 

<mental_ray_renderer>.GIMaximumRefractions Integer default: 5 -- integer

 

<mental_ray_renderer>.GIMaximumTraceDepth Integer default: 5 -- integer

 

<mental_ray_renderer>.GlobalIllumAccuracy Integer default: 500 -- integer

 

<mental_ray_renderer>.GlobalIllumEnable BooleanClass default: false -- boolean

 

<mental_ray_renderer>.GlobalIllumRadius Float default: 1.0 -- float

 

<mental_ray_renderer>.GlobalLightCausticPhotons Integer default: 10000 -- integer

 

<mental_ray_renderer>.GlobalLightDecay Float default: 2.0 -- float

 

<mental_ray_renderer>.GlobalLightGIPhotons Integer default: 10000 -- integer

 

<mental_ray_renderer>.GreenSpatialContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.GreenTemporalContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.Jitter BooleanClass default: false -- boolean

 

<mental_ray_renderer>.Kernel Float default: 1.1 -- float

 

<mental_ray_renderer>.LanczosFilterHeight Float default: 4.0 -- float

 

<mental_ray_renderer>.LanczosFilterWidth Float default: 4.0 -- float

 

<mental_ray_renderer>.LocalBitmaps BooleanClass default: false -- boolean

 

<mental_ray_renderer>.LockSamples BooleanClass default: true -- boolean

 

<mental_ray_renderer>.Max_Displace Float default: 100.0 -- float

 

<mental_ray_renderer>.Max_Level Integer default: 6 -- integer

 

<mental_ray_renderer>.MaximumReflections Integer default: 6 -- integer

 

<mental_ray_renderer>.MaximumRefractions Integer default: 6 -- integer

 

<mental_ray_renderer>.MaximumSamples Integer default: 1 -- integer

 

<mental_ray_renderer>.MaximumTraceDepth Integer default: 6 -- integer

 

<mental_ray_renderer>.Memory_Limit Integer default: 1536 -- integer

 

<mental_ray_renderer>.MinimumSamples Integer default: -1 -- integer

 

<mental_ray_renderer>.MitchellFilterHeight Float default: 4.0 -- float

 

<mental_ray_renderer>.MitchellFilterWidth Float default: 4.0 -- float

 

<mental_ray_renderer>.MotionBlurEnable BooleanClass default: false -- boolean

 

<mental_ray_renderer>.MotionBlurShadowMapsEnable BooleanClass default: true -- boolean

 

<mental_ray_renderer>.NearFocus Float default: 90.0 -- float

 

<mental_ray_renderer>.OverrideIIObjProps BooleanClass default: false -- boolean

 

<mental_ray_renderer>.PhotonMapFile String default: """" -- string

 

<mental_ray_renderer>.PhotonMapRebuild BooleanClass default: true -- boolean

 

<mental_ray_renderer>.RaytraceEnable BooleanClass default: true -- boolean

 

<mental_ray_renderer>.RedSpatialContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.RedTemporalContrast Float default: 0.05 -- float

 

<mental_ray_renderer>.Render_Element_Final_Pass BooleanClass default: false -- boolean

 

<mental_ray_renderer>.ScanlineEnable BooleanClass default: true -- boolean

 

<mental_ray_renderer>.ScanlineMethod Integer default: 0 -- integer

 

<mental_ray_renderer>.ScanlineMethod Integer default: 0 -- integer

 

<mental_ray_renderer>.Segments Integer default: 1 -- integer

 

<mental_ray_renderer>.ShadowMethod Integer default: 0 -- integer

 

<mental_ray_renderer>.ShadowsEnable BooleanClass default: true -- boolean

 

<mental_ray_renderer>.Shutter Float default: 1.0 -- float

 

<mental_ray_renderer>.SlavesOnly BooleanClass default: false -- boolean

 

<mental_ray_renderer>.TaskOrder Integer default: 0 -- integer

 

<mental_ray_renderer>.TaskSize Integer default: 48 -- integer

 

<mental_ray_renderer>.TriangleFilterHeight Float default: 2.0 -- float

 

<mental_ray_renderer>.TriangleFilterWidth Float default: 2.0 -- float

 

<mental_ray_renderer>.Use_Placeholders BooleanClass default: false -- boolean

 

<mental_ray_renderer>.UseCausticRadius BooleanClass default: false -- boolean

 

<mental_ray_renderer>.UseFinalGatherFile BooleanClass default: false -- boolean

 

<mental_ray_renderer>.UseFinalGatherRadius BooleanClass default: false -- boolean

 

<mental_ray_renderer>.UseGlobalIllumRadius BooleanClass default: false -- boolean

 

<mental_ray_renderer>.UseVolumeRadius BooleanClass default: false -- boolean

 

<mental_ray_renderer>.view BooleanClass default: true -- boolean

 

<mental_ray_renderer>.VolumeAccuracy Integer default: 100 -- integer

 

<mental_ray_renderer>.VolumeRadius Float default: 1.0 -- float

 

The following properties have been added in 3ds Max 7:

 

<mental_ray_renderer>.CausticOpaqueShadows BooleanClass default: true -- boolean

 

<mental_ray_renderer>.FinalGatherEnable2 BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FinalGatherFastLookups BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FinalGatherFilter Integer default: 1 -- integer

 

<mental_ray_renderer>.GlobalLightEnergyMultiplier Float default: 1.0 -- float

 

<mental_ray_renderer>.Incremental_Echo BooleanClass default: false -- boolean

 

<mental_ray_renderer>.mental_ray_Manages_Maps BooleanClass default: false -- boolean

 

<mental_ray_renderer>.MotionBlurAllObjects BooleanClass default: true -- boolean

 

<mental_ray_renderer>.PhotonMapFilename String default: "" -- string

 

<mental_ray_renderer>.PhotonMapUseFile BooleanClass default: false -- boolean

 

<mental_ray_renderer>.RapidCollectRate Integer default: 0 -- integer

 

<mental_ray_renderer>.RapidMotionResample Integer default: 1 -- integer

 

<mental_ray_renderer>.ShadowMapFilename String default: "" -- string

 

<mental_ray_renderer>.ShadowMapRebuild BooleanClass default: true -- boolean

 

<mental_ray_renderer>.UseShadowMapFile BooleanClass default: false -- boolean

 

<mental_ray_renderer>.FinalGatherMinRadius Float default: 0.1 -- float

 

<mental_ray_renderer>.GridDepth Integer default: 2 -- integer

 

<mental_ray_renderer>.GridResolution Integer default: 0 -- integer

 

<mental_ray_renderer>.GridSize2 Integer default: 128 -- integer

 

<mental_ray_renderer>.RaytraceMethod Integer default: 0 -- integer

The following properties have been added in 3ds Max 8:

 

<mental_ray_renderer>.FinalGatherBounces Integer default: 0 -- integer

Get/set the Max.Bounces value in the Trace Depth group of controls in the Final Gather rollout of the Indirect Illumination tab.

<mental_ray_renderer>.RapidShadingSamples Float default: 1.0 -- float

Get/set the Shades per Pixel value in the Scanline group of controls in the Rendering Algorithms rollout of the Renderer tab.

<mental_ray_renderer>.Smooth BooleanClass default: true -- boolean

Enable/disable the Smoothing option in the Displacement (Global Settings) group of controls in the Shadows & Displacement rollout of the Renderer tab.

<mental_ray_renderer>.Enable_Material_Override BooleanClass default: false -- boolean

Controls the state of the Enable checkbox in the Material Override group of controls in the Translator Options rollout of the Processing tab. When set to true, the material assigned to the .Override_Material property will be used to override all scene materials.

<mental_ray_renderer>.Override_Material UndefinedClass default: undefined

Get/Set the Override Material assigned through the Material Override group of controls in the Translator Options rollout of the Processing tab. When the .Enable_Material_Override property is set to true, this material will be used to override all scene materials.

<mental_ray_renderer>.MotionBlurOffset Float default: 0.0 -- float

Get/Set the Shutter Offset value found in the Motion Blur group of controls in the Camera Effects rollout of the Renderer tab.

<mental_ray_renderer>.FrameBufferType Integer default: 0 -- integer

Controls the Frame Buffer type set by the drop-down list in the Options group of controls in the Sampling Quality rollout of the Renderer tab.

Possible values are:

0 - Integer (16 bits per channel)

1 - Floating-Point (32 bits per channel)

The following properties have been added in 3ds Max 9:

<mental_ray_renderer>.LastTotalNonRenderTime_ms : integer

new.gif NEW in 3ds Max 9: The time, in milliseconds, spent by the translator outside of rendering. The accounts for everything the translator does outside of the command that starts the mental ray render. If placeholders are being used, then geometry translation time will not be included in this value; only placeholder setup time will be accounted for.

<mental_ray_renderer>.LastTotalGeomTranslationTime_ms : integer

new.gif NEW in 3ds Max 9: The time, in milliseconds, spent translating geometry. If placeholders are OFF, this is a subset of LastTotalNonRenderTime_ms; if placeholders are ON, this time accounts for both placeholder setup (mostly bounding boxes calculations) and placeholder geometry translation.

The translator outputs the statistics as information messages in the mental ray message window.

Here is a sample:

MSG 0.0 info : Total non-render time: 71.3281 s.

MSG 0.0 info : Total geometry translation time: 3.5781 s.

MSG 0.0 info : Total number of entities translated: 7884.

 

mental_ray_renderer interfaces:

Interface: IMtlRender_Compability_Renderer

Properties:

Methods:

Actions:

 

 

Example:

RendererClass.classes

#(Default_Scanline_Renderer, VUE_File_Renderer, mental_ray_renderer, Missing_Renderer)

renderers.current = mental_ray_renderer()

mental_ray_renderer:mental_ray_renderer

See also

Default_Scanline_Renderer : RendererClass

VUE_File_Renderer : RendererClass

Renderers

Render Scene Dialog

renderSceneDialog

Interface: mental_ray_Preferences