Interface: mental_ray_string_options

Interfaces > Core Interfaces > mental_ray_string_options

The mental_ray_Strings_options Core Interface introduced in 3ds Max 2011 lets you toggle rendering options and set parameters not yet available in the UI.

This Interface allows for evaluation of mental ray features before they are officially exposed for regular usage.

The string options can be set and cleared through MAXScript.
Once set, an option affects all mental ray renders until cleared, or until 3ds Max is shut down.
The options are not saved with the .MAX scene file.

See here for a list of String Options supported by mental ray.

Interface: mental_ray_string_options

Properties:

mental_ray_string_options.numOptions : integer : Read

Get the number of option items currently set.

Methods:

<void>mental_ray_string_options.AddOption <string>string <fpvalue>option index:<index>   

index default value: 0

Takes a string, a value, and an optional index.

If the optional index: parameter is specified, the existing option item with that index is replaced, otherwise a new option is added.

<void>mental_ray_string_options.RemoveOption <index>index

Takes an index, and removes the corresponding option item.

<String by value>mental_ray_string_options.GetOptionString <index>index

Returns the string of the option item with the given index.

<fpvalue by value>mental_ray_string_options.GetOptionValue <index>index

Returns the value of the option item with the given index.

EXAMPLE

Here's an example of how to print all current option items:

m = mental_ray_string_options
for i = 1 to m.numOptions do
format "Option %: % = %\n" i (m.GetOptionString i) (m.GetOptionValue i)

For more information and complete example scripts showing the use of String Options to access Progressive Rendering mode, Irradiance Particles, Importons and Force Final Gather mode, please see mental ray String Options.

Interface: mental_ray_string_options

See Also