iray String Options
The iray renderer introduced in 3ds Max 2012 provides some String Options accessible through the same mental_ray_string_options Core Interface used for the mental ray Strings Options featured for the first time in 3ds Max 2011. They can be used to provide some advanced settings not exposed to the standard iray renderer User Interface. For these options to work, the current renderer must be set to iray first. As with mental ray string options, these settings are temporary and will not be saved and loaded with the scene - you will have to re-enable them via MAXScript in the current session.
CPU Threads
Specifies the number of threads to use when rendering on the CPU.
If set to 0, the CPU will be disabled.
If not set, the default behavior is "use all available cores".
GPU Devices
Specifies the GPU devices to use as a string of zero-based Device IDs delimited by spaces, e.g. "0 2" means use the first and third devices (if available).
When not set, the default behavior is to "use no GPU devices".
Be careful not to set both the "iray threads" to 0 and the "iray devices" to "" as iray will have no devices to run on.
Background Color
Specifies the background color as a Point3 value representing RGB as floating point numbers in 0-1 range.
Environment Lighting
Specifies the Environment Lighting Resolution as an Integer.
Specifies whether to blur the Environment Lighting.
Environment Dome
iray features functionality to use a fake environment dome instead of the infinite environment provided by the environment shader. As this dome is of finite size, camera movements result in positional changes inside the dome and, therefore, the environment lookup changes. Note that the illumination is still computed from the original infinite environment.
Specifies the Environment Dome shape.
"infinite" - default if not specified, standard infinite environment lookup
"hemisphere" - sphere shaped dome where the lower hemisphere is projected on the plane dividing upper and lower hemisphere
Specifies the dome rotation axis.
When the dome mode is enabled, an additional "shadow catcher" ground plane can be specified. This transparent plane weights the environment lookup behind it using a progressive estimation of the amount of shadow (for direct light) the ground plane point would receive from the objects in the scene. It can then be used to catch shadows of an object, while the ground still is the environment lookup as specified by the dome settings. The ground plane is specifiied with the following options:
Specifies whether to use the Environment Dome Ground (Shadowcatcher).
Specifies the position of the Environment Dome Ground.
Specifies the glossiness of the Environment Dome Ground.
Specifies the reflectivity of the Environment Dome Ground as a Point3 value. A value of [0,0,0] will turn the reflectivity off, a value of [1,1,1] will make the ground fully reflective for all three color components, a value of [1,0,0] will tint the reflection into Red only and so on.
See Also
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.