This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
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 Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
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
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
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 The value indicating if the SSR (Screen Space Reflections) effect is enabled. Enabled by default.
Console access: render_ssr (API control)
Preset The SSR (Screen-Space Reflections) preset used at the moment. One of the following values:
  • Low (by default)
  • Medium
  • High
  • Ultra
  • Extreme
  • Custom

Console access: render_ssr_preset (API control)
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 The value indicating if increased accuracy option is enabled for the SSR (Screen Space Reflections). This option reduces visual artifacts around objects, which can appear at a resolution that is lower than Full, by increasing accuracy of the last step. Enabled by default.
Console access: render_ssr_increased_accuracy (API control)
Fast Tracing The value indicating if fast tracing for the SSR (Screen Space Reflections) effect is enabled. 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. Enabled by default.
Console access: render_ssr_fast_tracing (API control)
Resolution The resolution of SSR (Screen Space Reflections). One of the following values:
  • Quarter - quarter resolution
  • Half - half resolution (by default)
  • Full - full resolution

Console access: render_ssr_resolution (API control)
Resolution Depth The resolution of the depth buffer used for SSR (Screen Space Reflections) calculation. It affects detailing of reflections of tiny objects.
Notice
To gain performance, this option can be set to lower values while enabling increased accuracy.
One of the following values:
  • Quarter - quarter resolution (by default)
  • Half - half resolution
  • Full - full resolution

Console access: render_ssr_resolution_depth (API control)
Resolution Color The resolution of the color buffer used for SSR (Screen Space Reflections) calculation. It significantly affects performance. One of the following values:
  • Quarter - quarter resolution (by default)
  • Half - half resolution
  • Full - full resolution

Console access: render_ssr_resolution_color (API control)
Num Rays The number of SSR rays per pixel that are used to calculate rough refrections. Using more rays provides more precise SSR roughness calculation, however, it is more expensive.
Range of values: [1, 64]. The default value is 4.
Console access: render_ssr_num_rays (API control)
Num Steps The number of SSR steps per ray that are used for trace calculation. The number of steps defines accuracy of reflections and causes a reasonable performance impact. The higher the value, the more accurate obstacles between objects are accounted.
Range of values: [1, 64]. The default value is 16.
Console access: render_ssr_num_steps (API control)
Step Size The size of the trace step used for SSR calculation. Higher values result in longer traces (however, tiny objects may become missing), lower values produce more detailed reflections of tiny objects.
Range of values: [0.0f, inf]. The default value is 0.5f.
Console access: render_ssr_step_size (API control)
Noise Step The intensity of the step noise used for SSR (Screen-Space Reflections) calculation. It is used to reduce the banding effect of tracing. Higher values make the banding effect less pronounced.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_ssr_noise_step (API control)
Noise Ray The intensity of the ray noise used for SSR (Screen-Space Reflections) calculation. It is used to reduce the banding effect on rough reflections. Higher values make the banding effect less pronounced.
Range of values: [0.0f, 1.0f]. The default value is 0.5f.
Console access: render_ssr_noise_ray (API control)
Visibility Roughness Min The minimum roughness value, starting from which the SSR (Screen-Space Reflections) effect begins to fade out. It allows reducing noise of reflections on rough materials.
Range of values: [0.0f, 1.0f]. The default value is 1.0f.
Console access: render_ssr_visibility_roughness_min (API control)
Visibility Roughness Max The maximum roughness value, starting from which the SSR (Screen-Space Reflections) effect is not rendered. It allows reducing noise of reflections on rough materials.
Range of values: [0.0f, 1.0f]. The default value is 1.0f.
Console access: render_ssr_visibility_roughness_max (API control)
Threshold The threshold used for SSR (Screen-Space Reflections) calculation to limit imitation of reflections in areas where SSR cannot get information. Higher values make the effect less pronounced.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_ssr_threshold (API control)
Threshold Occlusion The value that limits imitation of environment cubemap occlusion in areas where SSR (Screen-Space Reflections) cannot get information. Higher values make the effect less pronounced. 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.
Range of values: [0.0f, inf]. The default value is 1.0f.
Console access: render_ssr_threshold_occlusion (API control)
Normal Bias The bias value to which the ray starting position has been shifted along the normal vector. This value is used for SSR (Screen-Space Reflections) calculation. Can be adjusted to fine-tune reflections of small objects at far distances. Recommended for narrow FOV angles. To use this option, SSR should be enabled.
Range of values: [0.0f, 1.0f]. The default value is 1.0f.
Console access: render_ssr_normal_bias (API control)
View Bias The bias value to which the ray starting position has been shifted along the view vector. This value is used for SSR (Screen-Space Reflections) calculation. Can be adjusted to fine-tune reflections of small objects at far distances. Recommended for narrow FOV angles. To use this option, SSR should be enabled.
Range of values: [0.0f, 1.0f]. The default value is 1.0f.
Console access: render_ssr_view_bias (API control)
Color Clamping Intensity The intensity of TAA color clamping at zero pixel velocity for the SSR (Screen-Space Reflections) effect. 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 SSR Color Clamping Velocity Threshold, while higher values reduce ghosting effect, but increase flickering.
Range of values: [0.0f, 1.0f]. The default value is 0.0f.
Console access: render_ssr_color_clamping_intensity (API control)
Color Clamping Velocity The sensitivity of TAA color clamping for the SSR (Screen-Space Reflections) effect 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.
Range of values: [0.0f, inf]. The default value is 0.0f.
Console access: render_ssr_color_clamping_velocity_threshold (API control)

Denoise Options#

Denoise The value indicating if noise reduction for the SSR (Screen Space Reflections) effect is enabled.
Notice
Noise reduction is effective only for screen-space reflections on rough surfaces. Reflections on smooth surfaces (Roughness = 0) will not be affected.
Enabled by default.
Console access: render_ssr_denoise (API control)
Radius The radius of the area to be affected by noise reduction for the SSR (Screen-Space Reflections) effect.
Range of values: [1, 3]. The default value is 1.
Console access: render_ssr_denoise_radius (API control)
Quality The noise reduction quality level for the SSR (Screen-Space Reflections) effect defining the number of samples used. Higher values provide better reduction, but for a performance cost (choosing Medium is enough in most cases). One of the following values:
  • Low - low quality
  • Medium - medium quality (by default)
  • High - high quality
  • Ultra - ultra quality

Console access: render_ssr_denoise_quality (API control)
Intensity The noise reduction intensity for the SSR (Screen-Space Reflections) effect. Higher values provide a less noisy, but more blurred result.
Range of values: [0.0f, 1.0f]. The default value is 0.2f.
Console access: render_ssr_denoise_intensity (API control)
Gaussian Sigma The sigma parameter of Gaussian blur used for noise reduction for the SSR (Screen-Space Reflections) effect. This parameter controls the amount of blur applied.
Range of values: [0.0f, 100.0f]. The default value is 10.0f.
Console access: render_ssr_denoise_gaussian_sigma (API control)
Threshold The threshold value for color difference of neighboring pixels used for noise reduction for the SSR (Screen-Space Reflections) effect. Blur is applied when the color difference is less than the threshold value.
Notice
Setting too high values result in blurring the whole image.

Range of values: [0.0f, 1.0f]. The default value is 0.1f.
Console access: render_ssr_denoise_threshold (API control)
Last update: 2022-03-10
Build: ()