This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
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.

SSR

The section contains settings that control screen-space reflections (SSR).

Screen-space reflections settings

Enabled Toggles the SSR effect on and off.
Preset Quality preset of SSR.
  • 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.

Screen-space reflections custom settings

Screen-Space Reflections Settings
Increased Accuracy Toggles increased accuracy of ray tracing for the SSR effect on and off. This option reduces visual artifacts around objects, which can appear at low resolution (lower than full), by increasing accuracy of the last step.
Fast Tracing Toggles fast tracing for the SSR effect on and off. This mode makes it possible to obtain distant reflections using low number of steps while keeping performance high. However, tiny objects may not be reflected. Disabling this mode improves quality but significantly drops performance.
Resolution Resolution of the SSR:
  • Quarter — 1/4 resolution (by default)
  • Half — 1/2 resolution
  • Full — full resolution
Notice
Can be controlled by render_ssr_resolution console command.
Resolution Depth Resolution of the depth buffer used for SSR calculation. This option affects detailing of reflections of tiny objects.
  • Quarter — 1/4 resolution
  • Half — 1/2 resolution
  • Full — full resolution
Notice
To gain performance, this option can be set to lower values while enabling Increased Accuracy.
Resolution Color Resolution of the color buffer used for SSR calculation. This option significantly affects performance.
  • Quarter — 1/4 resolution (by default)
  • Half — 1/2 resolution
  • Full — full resolution
Num Rays Number of rays of SSR traced per pixel that are used to calculate rough refrections. Using more rays provides more precise SSR roughness calculation, however, it is more expensive.
Num Steps Number of steps of SSR per ray that are used for trace calculation. Defines accuracy of reflections and causes a reasonable performance impact. The higher the value, the more accurate obstacles between objects are accounted.
Step Size Size of the trace step used for SSR calculation. The higher the value, the longer the trace. However, tiny objects may be missed. The lower the value, the more detailed reflections of the tiny objects will be.
Noise Step Intensity of the step noise used for SSR calculation. This parameter is used to reduce the banding effect of tracing by using the noise.
Noise Ray Intensity of the ray noise used for SSR calculation. This parameter is used to reduce the banding effect on rough reflections by using the noise.
Visibility Roughness Min Minimum roughness value of the reflective material, at which the SSR effect is fully visible. Using this option together with Visibility Roughness Max allows reducing noise of reflections on rough materials.
Visibility Roughness Max Maximum roughness value of the reflective material, at which the SSR effect is not rendered. Using this option together with Visibility Roughness Min allows reducing noise of reflections on rough materials.
Threshold Limits imitation of reflections in areas where SSR cannot get information. The higher the value, the less this effect is.
Threshold Occlusion Limits imitation of environment cubemap occlusion in areas where SSR cannot get information. The higher the value, the less this effect is. This parameter is mainly used for indoor environment to correct false reflections on occluded areas (false reflections are replaced with black color). For outdoor environment higher values of this parameter are recommended.
Normal Bias Shifting of the ray starting position along the normal vector. Can be adjusted to fine-tune reflections of small objects at far distances. Recommended for narrow FOV angles.
View Bias Shifting of the ray starting position along the view vector. Can be adjusted to fine-tune reflections of small objects at far distances. Recommended for narrow FOV angles.
Color Clamping Intensity Intensity of TAA color clamping at zero pixel velocity:
  • lower values result in more accumulated frames combined, which reduces noise flickering, but increases ghosting effect (to reduce ghosting in this case you can use the Color Clamping Velocity parameter).
  • higher values up to 1 (default) reduce ghosting effect, but increase flickering
Color Clamping Velocity Sensitivity of TAA color clamping to pixel velocity change. This parameter is used to reduce ghosting effect for lower Color Clamping Intensity values: it automatically increases clamping intensity for higher velocities, and disables clamping for low velocity values.

Denoise Options#

Denoise Toggles noise reduction for the SSR effect on and off.
Notice
Noise reduction is effective only for screen-space reflections on rough surfaces. Reflections on smooth surfaces (Roughness = 0) will not be affected.
Radius Radius of the area to be affected by noise reduction.
Quality Noise reduction quality level defining the number of samples used:
  • Low — low quality
  • Medium — medium quality
  • High — high quality
  • Ultra — ultra quality
Higher values provide better reduction, but for a performance cost (choosing Medium is enough in most cases).
Intensity Noise reduction intensity: higher values provide a less noisy, but more blurred result.
Gaussian Sigma Sigma parameter of Gaussian blur used for noise reduction. This parameter controls the amount of blur applied.
Threshold Threshold value for color difference of neighboring pixels: blur is applied when the color difference is less than the threshold value.
Notice
Setting too high values result in blurring the whole image.
Last update: 2021-04-29
Build: ()