This pages presents the Iray renderer available in the 3D view panel, which offers interactive path tracing for photorealistic rendering with CPU and/or GPU acceleration (Nvidia GPUs only).


Iray is a highly interactive and intuitive physically based rendering technology that generates photorealistic imagery by simulating the physical behaviour of light and materials. Learn more on the Nvidia Iray webpage.

As the 3D View uses Iray's progressive renderer, an image is produced as soon as at least one sample has been performed on each pixel. The image is automatically updated as sampling iterations are performed, resulting in an initial rough image becoming cleaner on each iteration.

The renderer is available in the 3D view panel: open the Renderer menu and select the Iray option to switch the renderer used in that 3D view panel to Iray.
Switching to the Iray renderer changes the available options in some of the 3D view menus. These changes are explained in the 3D view section below.

By default, progressive rendering starts as soon as the Iray renderer is selected. The rendering process will run until one of these conditions is met:

  • The maximum number of samples are performed
  • The rendering time limit is met

See the Renderer section of this page to learn more about tweaking these conditions.

Only one Iray rendering instance can be run at any time.
This means when a 3D view panel uses this renderer, the Renderer menu is disabled in other 3D view panels and these default to the OpenGL renderer.

Material: Medieval castle wall by Mark Foreman available in our Substance 3D assets library

3D view options


Select the Edit option in the Scene menu to find scene properties specific to Iray in the Properties panel.

  • Is enabled: When set to False, the object is hidden and no longer contributes to the scene

Display component

  • Is visible: When set to False, the object is hidden yet still contributes to the scene – i.e. reflecting light, absorbing light and projecting shadows

Mesh display component

  • Subdivision
    • Method: The method used to procedurally subdivide the mesh into finer geometry
      • None: No subdivision is applied
      • Parametric: Subdivides the mesh into 4^x triangles where x is the value specified by this parameter
      • Length: Subdivides the mesh until all edges have a length (in object space) below the value specified by the Minimum length parameter
    • Minimum length: Subdivides the mesh until all edges have a length below this specified value in object space (only applies to the Length method)
    • Number: The number of subdivision iterations which should be applied to the mesh (only applies to the Parametric method)

Subdividing the mesh increases its processing time exponentially before and during the render. We suggest being conservative with the values input.
Be careful about using high Number values for the Parametric method, and low Minimum length values for the Length method.


Since Iray relies on the MDL shading model developed by NVIDIA, available materials for scene materials are replaced with the MDL library loaded by Designer. This library is built using the following sources:

For a deeper look into the MDL shading model, check out the MDL Handbook, written and maintainted by NVIDIA.

The cumulative list of loaded MDL materials is availabe in the Materials menu, under any of the listed materials' submenu as shown in the image on the right.

Additionally, if an MDL graph is loaded in Designer, it can be applied to any material in the Scene. At that point, it is added to the list of available MDL materials.

When loading an MDL graph, the 3D view renderer is automatically switched to Iray to load and apply it.

Other notable options in this menu are:

  • Select the Edit option to access the MDL's exposed inputs in the Properties panel and tweak the material as required
  • The Load... option lets you manually load any MDL file to be added to the cumulative list and applied in the scene
  • The Export Preset... option opens the Export MDL Material Preset dialog, which lets you export a preset MDL file using the current settings applied in the 3D View

List of available MDL shaders (vMaterials installed)


The main difference between OpenGL and Iray regarding camera settings is how depth of field is managed. Indeed, Iray being a physically-accurate renderer, depth of field occurs "naturally" depending on the camera's aperture.

The following couple of parameters are available in the camera properties when the Iray renderer is selected:

  • Focus distance: the distance from the camera of the focal point – i.e. where the image is at its sharpest
  • Aperture diameter: the value driving the camera's aperture. The lower the value, the sharper the image elements are before and after the focal point – in simpler terms, this value controls the strength of the depth of field effect


Open the Environment menu and select the Edit option to display the environment properties in the Properties panel.

The following properties are available:


  • Dome type: sets the objects enclosing the scene, which the environment texture is projected on
    • Infinite sphere: infinite spherical environment
    • Ground: infinite spherical environment, but with a textured ground plane
    • Sphere: finite size sphere-shaped dome of custom radius
    • Sphere with ground: finite size sphere-shaped dome with custom radius where the lower part of the environment is projected onto the plane dividing upper and lower parts of the sphere
    • Box with ground: finite size box-shaped dome of custom width, height and length where the lower part of the environment is projected onto the plane dividing upper and lower parts of the box
  • Rotation angle: controls the angle of rotation of the dome around the Y axis
  • Radius: the radius of the sphere (only applies to the Sphere and Sphere with ground dome types)
  • Width: the width of the box (only applies to the Box with ground dome type)
  • Height: the height of the box (only applies to the Box with ground dome type)
  • Length: the length of the box (only applies to the Box with ground dome type)
  • Visualize: enables a false-color overlay of the finite size environment geometry. This can be used to align the geometry with the projection of the captured environment map (only applies to the Sphere, Sphere with ground and Box with ground dome types)

For finite size domes, all scene geometry should be enclosed within the dome.

Dome ground 
The following parameters apply to the GroundSphere with ground and Box with ground dome types:

  • Ground: enables the ground plane
  • Position: the position of the origin of the finite dome (also applies to the Sphere dome type)
  • Reflectivity: the opacity and tint of the ground reflection, where black means the reflection is not visible
  • Glossiness: the glossiness of the ground reflection
  • Shadow intensity: the opacity of the shadow cast on the ground
  • Texture scale: controls the size of the environment texture projection on the ground (also applies to the Sphere dome type)
Place the cursor over any of the images on the right and leave it still for a few seconds to see what environment property the image demonstrates.

Environment rotationEnvironment ground options

Environment sphere radiusEnvironment box dimensions


These options display a text overlay on top of the rendered image with useful information regarding the render.

  • Elapsed time: The duration of the render in seconds. This timer and the rendering process will both stop when one of the ending conditions are met
  • Iterations: The number of sampling iterations performed. This counter and the rendering process will both stop when one of the ending conditions are met
  • Rendering method: The rendering pathway used. For most purposes on a local machine, Photoreal is used
  • Resolution: The effective rendering resolution. If the Use window resolution option in the camera properties is set to False, the ratio of the image is automatically adjusted to match the resolution ratio
  • Scene stats: A list of statistics related to the rendered scene, which includes triangles count, and materials count among other data


Open the Renderer menu and select the Edit option to display the renderer properties in the Properties panel.

Progressive rendering

  • Min samples: The minimum number of samples per pixel to compute before considering criteria to stop progressive rendering
  • Max samples: If this number of samples per pixel has been rendered, then stop progressive rendering automatically 
  • Max time (seconds): Time in seconds after which progressive rendering should terminate automatically
  • Caustic sampler enabled: Augment the default sampler with a dedicated caustic sampler. Caustics are a result of light passing through a non-opaque object, thus is required only if an MDL material supporting translucency is applied on any object in the scene

    The caustic sampler performs best under the following conditions:

    • The scene geometry is (mostly) in view
    • The caustics are (mostly) in view
    • The scene is positioned on top of a groundplane or large surface
  • Firefly filter enabled: enable the firefly filter, which uses a predefined algorithm to remove fireflies in the computed image as rendering progresses. Fireflies are visual artifacts where isolated pixels in an image which are noticeably brighter than their neighbours, and are a result of unsufficient ray samples to accurately determine the distribution of light
  • Post denoiser
    The Iray renderer uses the NVIDIA Optix AI-Accelerated denoiser algorithm for iterative high-quality denoising of the image as it is being rendered.

    The Optix AI-Accelerated denoiser is only available for NVIDIA GPUs.
    Enabling the denoiser may consume significant memory and performance.

    • Enabled: enables a predefined denoising algorithm to be triggered at a set rendering iteration, and be active until the end of the render
    • Start iteration: If the denoiser is enabled, this option sets the iteration at which the denoising process starts. This can prevent the denoiser's performance overhead from impacting interactivity, for example, when moving the camera. Additionally, the first few iterations are often not suitable as input for the denoiser due to insufficient convergence, leading to unsatisfactory results.
Place the cursor over any of the images on the right and leave it still for a few seconds to see what rendering property the image demonstrates.

Material: Thick glass MDL available in the MDL Core definitions by NVIDIA

Hardware acceleration

The Iray renderer offers hardware acceleration on NVIDIA GPUs exclusively, which offers the following benefits:

You may select the hardware which should be used by Iray for rendering in the 3D View section of the Preferences window, as shown in the image on the right.

When a supported GPU is detected, it is listed in this section, is automatically selected by default and the CPU is unselected. Any manual change overrides this automatic behaviour so your custom changes are saved for future sessions.

If a supported GPU is detected and listed, we strongly recommend leaving the CPU unselected as using the CPU for Iray rendering has a significant impact on the overall performance and responsiveness of the application.

GPU hardware acceleration uses the NVIDIA CUDA technology. Make sure your graphics driver is up-to-date for the best compatibility and reliability. Find the most recent driver for your NVIDIA GPU here.
For multi-GPUs configurations, it is recommended to disable SLI and select only one GPU for the best reliability.

Iray hardware preferences