Quicksilver_Hardware_Renderer : RendererClass
 
 
 
Quicksilver_Hardware_Renderer - superclass: RendererClass; super-superclass:MAXWrapper - 26:26 - classID: #(268839321, 1854680990)
 

   

Lighting And Rendering - Quick Navigation

This class represents the Quicksilver Hardware Renderer introduced in 3ds Max 2011 and enhanced in 3ds Max 2012 to use the Nitrous Graphics System.

It lets you construct an instance of the Quicksilver_Hardware_Renderer class to be assigned to the Current, Production and Material Editor renderers using the renderers structure.

The QuicksliverHardware Renderer can not be assigned as the ActiveShade renderer.

Constructor

Quicksilver_Hardware_Renderer ...

EXAMPLE

--Assign a Quicksilver Hardware Renderer class instance to the current renderer:
renderers.current = Quicksilver_Hardware_Renderer ()
--> Quicksilver_Hardware_Renderer:Hardware_Renderer
 

Topic Navigation Links:

 

   

Rendering Duration per Frame
Visual Style
Lighting
Shadows
Reflections
Depth of Field
Hardware Shaders Cache Folder

Quicksilver_Hardware_Renderer interfaces:

Interface: IQuicksilverRenderer

"Rendering Duration per Frame" group of controls

Properties:

<Quicksilver_Hardware_Renderer>.RenderingMode     Name    default: #iterations   --  enum

NEW in 3ds Max 2012: Get/set the state of the Rendering Mode radio buttons.

Possible values are:

#time - the Per-Frame Duration in seconds will be controlled by the .RenderingTime value.

#iterations (default) - the number of iterations specified by the .RenderingIterations property will be performed, resulting in variable Per-Frame Duration depending on the complexity of each frame.

   

<Quicksilver_Hardware_Renderer>.RenderingTime     Integer    default: 10   --  integer

NEW in 3ds Max 2012: Get/set the rendering duration in seconds.

This value will be used when the .RenderingMode is set to #time.

Valid range is from 1 to 3540, default value is 10.

Note

Note that the User Interface exposes this value as two spinners - Minutes and Seconds.

The Seconds spinner cannot be set to 0 to avoid the entering of 0 Minutes 0 Seconds.

Thus setting the .RenderingTime value to 120 via MAXScript will result in 2 Minutes and 1 Second and not 2 Minutes 0 Seconds, and the internal value will be stored as121 seconds!

   

<Quicksilver_Hardware_Renderer>.RenderingIterations     Integer    default: 256   --  integer

NEW in 3ds Max 2012: Get/set the number of iterations to perform when the .RenderingMode property is set to #iterations

This is the number of iterative refinement steps performed by the Nitrous Graphics system introduced in 3ds Max 2012.

Min. value is 1, Max. value is 4096, Default is 256.

   

   

"Visual Style" group of controls

Similar properties and methods are exposed by the NitrousGraphicsManager Interface for controlling the viewport Visual Style.

Properties:

<Quicksilver_Hardware_Renderer>.VisualStyle     Name    default: #Realistic   --  enum

VisualStyle enums: { #Realistic | #Shaded | #Facets | #ConsistentColors | #HiddenLine | #Wireframe | #BoundingBox | #Ink | #ColorInk | #Acrylic | #Tech | #Graphite | #ColorPencil | #Pastel }

NEW in 3ds Max 2012: Get/set the rendering visual style.

   

<Quicksilver_Hardware_Renderer>.EdgedFaces     BooleanClass    default: false   --  bool

NEW in 3ds Max 2012: Get/set the state of the Edged Faces checkbox.

   

<Quicksilver_Hardware_Renderer>.TextureEnabled     BooleanClass    default: true   --  bool

NEW in 3ds Max 2012: Get/set the state of the "Textures" checkbox.

When set to true (default), textures will be rendered.

When set to false, textures will be ignored.

   

<Quicksilver_Hardware_Renderer>.TransparencyEnabled     BooleanClass    default: true   --  bool

Enable/Disable the calculation of transparency.

Default value is false.

   

Methods:

<string by value><Quicksilver_Hardware_Renderer>.GetNPRParameterInfo()

NEW in 3ds Max 2012: Returns information about the parameters exposed by the current visual style.

   

<integer><Quicksilver_Hardware_Renderer>.GetNPRParameterCount()

NEW in 3ds Max 2012: Returns the number of parameters exposed by the current visual style.

   

<string by value><Quicksilver_Hardware_Renderer>.GetNPRParameterName <integer>index

NEW in 3ds Max 2012: Returns the name of the indexed parameter. The index is zero-based.

   

<enum><Quicksilver_Hardware_Renderer>.GetNPRParameterType <integer>index

GetNPRParameterType enums: { #Unknown | #Bool | #Int | #Float | #Float4 | #String }

NEW in 3ds Max 2012: Returns the type of the indexed parameter. The index is zero-based.

   

Accessing Boolean Parameters

<bool><Quicksilver_Hardware_Renderer>.GetNPRBool <string>name

NEW in 3ds Max 2012: Returns the value of the named boolean parameter.

   

<void><Quicksilver_Hardware_Renderer>.SetNPRBool <string>name <boolean>value

NEW in 3ds Max 2012: Sets the value of the named boolean parameter to the boolean value passed as second argument.

   

Accessing String Parameters

<string by value><Quicksilver_Hardware_Renderer>.GetNPRString <string>name

NEW in 3ds Max 2012: Returns the value of the named string parameter.

   

<void><Quicksilver_Hardware_Renderer>.SetNPRString <string>name <string>value

NEW in 3ds Max 2012: Sets the value of the named string parameter to the string value passed as second argument.

   

Accessing Integer Parameters

<integer><Quicksilver_Hardware_Renderer>.GetNPRInt <string>name

NEW in 3ds Max 2012: Returns the value of the named integer parameter.

   

<void><Quicksilver_Hardware_Renderer>.SetNPRInt <string>name <integer>value

NEW in 3ds Max 2012: Sets the value of the named integer parameter to the Integer value passed as second argument.

   

<integer><Quicksilver_Hardware_Renderer>.GetNPRMinInt <string>name

NEW in 3ds Max 2012: Returns the minimum range value of the named integer parameter.

   

<integer><Quicksilver_Hardware_Renderer>.GetNPRMaxInt <string>name

NEW in 3ds Max 2012: Returns the maximum range value of the named integer parameter.

   

Accessing Float Parameters

<float><Quicksilver_Hardware_Renderer>.GetNPRFloat <string>name

NEW in 3ds Max 2012: Returns the value of the named float parameter.

   

<void><Quicksilver_Hardware_Renderer>.SetNPRFloat <string>name <float>value

NEW in 3ds Max 2012: Sets the value of the named float parameter to the Float value passed as second argument.

   

<float><Quicksilver_Hardware_Renderer>.GetNPRMinFloat <string>name

NEW in 3ds Max 2012: Returns the minimum range value of the named float parameter.

   

<float><Quicksilver_Hardware_Renderer>.GetNPRMaxFloat <string>name

NEW in 3ds Max 2012: Returns the maximum range value of the named float parameter.

   

Accessing Float4 Parameters

<point4><Quicksilver_Hardware_Renderer>.GetNPRFloat4 <string>name

NEW in 3ds Max 2012: Returns the Point4 value of the named float4 parameter.

   

<void><Quicksilver_Hardware_Renderer>.SetNPRFloat4 <string>name <point4>value

NEW in 3ds Max 2012: Sets the value of the named float4 parameter to the Point4 value passed as second argument.

   

<point4><Quicksilver_Hardware_Renderer>.GetNPRMinFloat4 <string>name

NEW in 3ds Max 2012: Returns the minimum range value of the named float4 parameter.

   

<point4><Quicksilver_Hardware_Renderer>.GetNPRMaxFloat4 <string>name

NEW in 3ds Max 2012: Returns the maximum range value of the named float4 parameter.

   

<void><Quicksilver_Hardware_Renderer>.ShowNPRParameters()

NEW in 3ds Max 2012: For future use.

   

"Lighting" group of controls

Properties:

<Quicksilver_Hardware_Renderer>.UseDefaultLights     BooleanClass    default: false   --  bool

Get/set whether to use the Default Lights (true) or the Scene lights (false).

Default value is false.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationEnabled     BooleanClass    default: false   --  bool

Enable/Disable Indirect Illumination calculations.

Default value is false.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationMultiplier     Float    default: 1.0   --  float

Get/set the Indirect Illumination Multiplier value.

Valid values are between 0.0 and 3.0

Default value is 1.0.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationSampleArea     Float    default: 100.0   --  float

NEW in 3ds Max 2012: Get/set the Indirect Illumination Sample area value.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationLODEnabled     BooleanClass    default: false   --  bool

NEW in 3ds Max 2012: Get/set the state of the Indirect Illumination Level Of Detail option.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationShadowEnabled     BooleanClass    default: false   --  bool

Enable/Disable Indirect Illumination Shadows.

Default value is false.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationShadowRange     Integer    default: 8   --  integer

Get/set the Indirect Illumination Shadow Range value.

Valid values are between 1 and 32.

Default value is 8.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationShadowSize     Integer    default: 256   --  integer

Get/set the Indirect Illumination Shadow Size value.

Valid values are between 32 and 2048.

Default value is 256.

   

<Quicksilver_Hardware_Renderer>.IndirectIlluminationRSMSize     Integer    default: 256   --  integer

Get/set the Indirect Illumination RSM Size value.

Valid values are between 32 and 2048.

Default value is 256.

   

"Shadows" group of controls

Properties:

<Quicksilver_Hardware_Renderer>.UseShadows     BooleanClass    default: true   --  bool

Get/set whether to use shadows.

Default value is true.

   

<Quicksilver_Hardware_Renderer>.SoftShadowMultiplier     Float    default: 1.0   --  float

Get/set the Soft Shadows Multiplier value.

Default value is 1.0.

   

<Quicksilver_Hardware_Renderer>.AmbientOcclusionEnabled     BooleanClass    default: false   --  bool

Enable/Disable Ambient Occlusion.

Default value is false.

   

<Quicksilver_Hardware_Renderer>.AmbientOcclusionIntensity     Float    default: 1.0   --  float

Get/set the Ambient Occlusion Intensity value.

Valid range is 0.0 to 2.0.

Default value is 1.0.

   

<Quicksilver_Hardware_Renderer>.AmbientOcclusionRadius     Float    default: 10.0   --  float

Get/set the Ambient Occlusion Radius value.

Valid range is 0.0 to 200.0.

Default value is 10.0.

   

"Reflections" group of controls

Properties:

<Quicksilver_Hardware_Renderer>.ReflectionsEnabled     BooleanClass    default: true   --  bool

Enable/Disable the calculation of reflections.

Default value is true.

   

"Depth Of Field" group of controls

Properties:

<Quicksilver_Hardware_Renderer>.DepthOfFieldEnabled     BooleanClass    default: true   --  bool

Enable/Disable Depth Of Field calculations.

Default value is true.

   

<Quicksilver_Hardware_Renderer>.DepthOfFieldMode     Name    default: #camera   --  enum

Get/set the Depth Of Field mode.

Possible values are:

#Camera - (default) -uses the Camera's Depth Of Field settings.

#Override - uses the renderer's Override settings (NearPlane, FarPlane, FocalPlane).

   

<Quicksilver_Hardware_Renderer>.FocalPlane     Float    default: 100.0   --  float

Get/set the Override Depth Of Field Focal Plane value.

Default is 100.0.

Used only when .DepthOfFieldMode is set to #Override.

   

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

NEW in 3ds Max 2012: Get/set the Depth Of Field fStop value.

   

"Hardware Shaders Cache Folder" group of controls

Properties:

<Quicksilver_Hardware_Renderer>.UseShaderCacheFileSystem     BooleanClass    default: true   --  bool

Enable/disable the use of the Hardware Shaders Cache File system.

Default value is true.

   

Methods:

<void><Quicksilver_Hardware_Renderer>.ForceSaveShaderCacheFile()

Forces the saving of the Shader Cache File.

   

Update Render Setup Dialog

Methods:

<void><Quicksilver_Hardware_Renderer>.CommitParameters()

Commits all changes to the Renderer's UI.

   

<void><Quicksilver_Hardware_Renderer>.UpdateUI()

Updates the Renderer's UI to reflect changes made using MAXScript.

   

<void><Quicksilver_Hardware_Renderer>.RunUnitTests()

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

   

Features Removed from 3ds Max 2012

Image Precision (Antialiasing)

<Quicksilver_Hardware_Renderer>.HardwareSamplingQuality: enum : Read|Write 

HardwareSamplingQuality enums: {#None|#2X|#4X|#8X}

Get/set the Hardware Sampling Quality. This controls the anti-aliasing quality performed by the graphics hardware.

Default value is #None.

   

<Quicksilver_Hardware_Renderer>.SoftwareSamplingQuality: enum : Read|Write 

SoftwareSamplingQuality enums: {#None|#4X|#16X}

Get/set the Software Sampling Quality. This controls the anti-aliasing quality performed by the CPU in addition to the hardware anti-aliasing.

Default value is #None.

Lighting - Indirect Illumination

<Quicksilver_Hardware_Renderer>.IndirectIlluminationSamples: float : Read|Write|Validated by Range: 0.001 to 1.0

Get/set the Indirect Illumination Samples value.

Valid values are between 0.001 and 1.0

Default value is 1.0.

   

Transparency / Reflections

<Quicksilver_Hardware_Renderer>.TransparencyMode: enum : Read|Write 

TransparencyMode enums: {#Simple|#Best}

Get/set the transparency mode.

Default value is #Simple.

   

Depth Of Field

<Quicksilver_Hardware_Renderer>.NearPlane: float : Read|Write

Get/set the Override Depth Of Field Near Plane value.

Default is 90.0.

Used only when .DepthOfFieldMode is set to #Override.

   

<Quicksilver_Hardware_Renderer>.FarPlane: float : Read|Write

Get/set the Override Depth Of Field Far Plane value.

Default is 110.0.

Used only when .DepthOfFieldMode is set to #Override.

   

Other Properties (Not Exposed To The UI)

<Quicksilver_Hardware_Renderer>.LightingMode : enum : Read|Write 

LightingMode enums: {#Deferred| #Forward}

Get/set the Lighting mode.

Default value is #Deferred

   

<Quicksilver_Hardware_Renderer>.ShadingMode : enum : Read|Write 

ShadingMode enums: {#Luminance| #Illuminance}

Get/set the Shading mode.

Default value is #Luminance.

   

See Also