Page History

...

In this chapter we'll cover the main settings plugins in plugins in V-Ray. These include SettingsOutput, SettingsRTEngine, SettingsUnitsInfo, SettingsDMCSampler, SettingsDR, SettingsImageSampler, SettingsDMCGI, SettingsIrradianceMap, SettingsLightCache and SettingsColorMapping.

A general note on settings plugins: when you create a new Renderer object there are no instances of them, so you will need to create them before changing parameters. If you start rendering the AppSDK will create a SettingsOutput and if the render mode is Interactive it will create SettingsRTEngine. On the other hand, if you're loading a scene from file, it will have instances of most (but not all) settings plugins and settings plugins and you need to use them. This is because every time V-Ray exports a vrscene file it automatically writes out the settings even if they are at default values.

Starting with version 1.09 nightly builds after June 14th 2016, the VRayRenderer class includes the method setImprovedDefaultSettings(). It creates (if necessary) some settings plugin instances and sets several parameters to values different from the plugin defaults. These values match the defaults used in our main products, such as V-Ray for 3dsMax and Maya. The plugin defaults couldn't be changed for compatibility reasons (keep old scenes working as they were). But the UI default values have changed over time. Many of the parameters and respective values that are set by setImprovedDefaultSettings() are mentioned in the paragraphs below. These are just good initial values. Feel free to use them or not, or to overwrite some of them, for example reducing quality to get faster renders.

...

The progressive sampler produces whole images iteratively, refining them with each pass. The other samplers work on small "buckets" and only return an image when it is complete.

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/tKaKvWqTFlw?rel=0" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

...

Most filters have just one size parameter for the kernel radius. Catmull-Rom has no parameters. The available filter plugins are:

...

To apply a filter, just create an instance of one of those plugins. You can use only one at a time. Note: We already covered filters in the topic "Antialiasing Filters".

Anchor
SettingsDMCSampler SettingsDMCSampler

DMC sampler

We recommend leaving the parameters of of SettingsDMCSampler at their default values, with the exception of use_local_subdivs. Set this to 0, so that only the global subdivs settings are used.

Anchor
SettingsGI SettingsGI

Global illumination

...

By default global illumination (GI) is disabled in an empty scene (with the exception of GPU mode where you can't disable GI). You need to set SettingsGI::on to 1 to enable tracing of secondary rays. Any photorealistic render needs GI, so apart from some kind of debuggingof debugging, you will always want to enable GI.

...

The Irradiance map is configured through through SettingsIrradianceMap. 

The main two parameters are:

...

The Light cache is configured through through SettingsLightCache. 

There are a lot of parameters for fine tuning and fixing specific problems but the main parameter is:

...

You can also add scene-wide volumetric effects through the environment_volume list.

A special case is the Sun-Sky system. V-Ray has a special procedural texture, TexSky, for these environment slots that is coupled with SunLight. The color of the environment depends on the position of the Sun.

...

Although the name doesn't hint at it, the CameraPhysical plugin plugin is a settings plugin (singleton). It modifies the way camera rays are shot for effects like DoF (depth of field) and distortion and how they are integrated into the image - exposure. The position and orientation of the camera is still defined by RenderView. Many of the parameters are exactly the same as on a real world DSLR or video/movie camera. 

We will only add a few things here:

...

This is controlled by SettingsColorMapping.  

The default values when you create a SettingsColorMapping plugin are different from the recommended values in 3dsMax and Maya for legacy reasons. These are the values you should use for new scenes:

...