This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
UnigineEditor
Interface Overview
Assets Workflow
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Objects
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Global Illumination

This section contains settings related to global illumination including SSAO (screen-space ambient occlusion), SSGI (screen-space global illumination) and bent normals.

Screen Space Ray-Traced Global Illumination Settings

Lightmap Color The color multiplier for lightmaps.
Notice
Some light sources may be modified after the lightmap was baked. To make lighting in the scene consistent once again without any re-baking you can simply adjust the color multiplier for lightmaps. See the How-To video tutorial for additional information.
Preset Quality preset of Global Illumination.
  • Disabled — disables SSRTGI, Bent Normal, SSAO and SSGI
  • Low — low quality preset
  • Medium — medium quality preset
  • High — high quality preset
  • High + SSGI — high quality preset with SSGI enabled
  • Ultra — ultra quality preset
  • Ultra + SSGI — ultra quality preset with SSGI enabled
  • Extreme — extreme quality preset
  • Extreme + SSGI — extreme quality preset with SSGI enabled
  • Custom — adjust the feature's quality manually

SSRTGI Parameters#

The SSRTGI (Screen-Space Ray-Traced Global Illumination) technology is a set of screen-space ray tracing techniques with the real-time performance level. The technology doesn't require light baking, so every object can be freely moved. In other words, SSRTGI is real-time global illumination in the screen space.

The technique implements real ray-tracing through each pixel of the screen, with a given number of rays and a specified accuracy of obstacle detection (the accuracy is set by using steps). Such ray-tracing is used for Ambient Occlusion (SSAO) to make more realistic shadows between objects, for Bent Normals to smooth ambient lighting on edges, and for SSGI to recreate light reflections from the object's surfaces.

Notice
For the technique to take an effect, the SSRTGI (Screen Space Ray-Traced Global Illumination) feature must be enabled (Rendering -> Features -> SSRTGI).

SSRTGI Presets

Screen Space Ray-Traced Global Illumination Settings
Enabled Toggles SSRTGI on and off.
Preset Quality preset of SSRTGI.
  • Low — low quality preset
  • Medium — medium quality preset
  • High — high quality preset
  • Ultra — ultra quality preset
  • Extreme — extreme quality preset
  • Custom — adjust the feature's quality manually
Notice
Presets override user-defined custom settings. When any preset other than Custom is active, modification of the parameters via API has no effect. The parameter value set via the last API call shall be used only when the Custom preset is active. When checking the current parameter value via API you'll get the corresponding setting stored in the active preset (default or custom one).

Customizable Settings#

The following settings are available when the Custom preset is selected.

SSRTGI custom settings

SSRTGI Settings
Fast Tracing Toggles fast tracing for the SSRTGI on and off. This option dynamically changes the step size to obtain indirect illumination bounces using a low number of steps while keeping performance high. However, tiny objects may be ignored. Disabling this option improves quality, but significantly reduces performance.
Increased Accuracy Toggles increased accuracy of ray tracing for the SSRTGI on and off. This option reduces visual artifacts by increasing accuracy of the last step.
Resolution Resolution of the SSRTGI. This option significantly affects performance.
  • Quarter — quarter resolution
  • Half — half resolution (by default)
  • Full — full resolution
At low values, edges of objects become blurred.
Resolution Depth Resolution of the depth buffer used for SSRTGI calculation. This option significantly affects performance.
  • Quarter — quarter resolution (by default)
  • Half — half resolution
  • Full — full resolution
Notice
To gain performance, this option can be set to lower values while enabling the Increased Accuracy option.
Noise Step Intensity of the step noise used for SSRTGI calculation. This parameter is used to reduce the banding effect of tracing by using the noise: the higher is the value, the less pronounced the banding effect is.
Noise Ray Intensity of the ray noise used for SSRTGI calculation. This parameter is used to reduce the banding effect on the final image by using the noise: the higher is the value, the less pronounced the banding effect is.
Num Rays Number of rays of SSRTGI traced per pixel that are used to calculate the final image. Using more rays provides a more precise SSRTGI calculation and a smoother picture, however, it is more expensive.
Num Steps Number of steps of SSRTGI per ray used for trace calculation. The higher the value, the further the tracing is performed, resulting in wider gradients. However, this option significantly affects performance.
Step Size Size of the trace step used for SSRTGI calculation. The higher the value, the longer the trace is and the more accurate obstacles are accounted. Increasing the value results in smoother gradients on small objects. However, tiny objects may be missed. The lower the value, the more detailed tiny objects are.
Last update: 2021-04-29
Build: ()