SSAO

Enabled	The value indicating if the SSAO (Screen Space Ambient Occlusion) effect is enabled. Enabled by default. Console access: render_ssao
Preset	The currently used SSAO (Screen-Space Ambient Occlusion) preset. One of the following values: Simple Low (by default) Simple Medium Simple High Simple Ultra Raytracing Raytracing + Denoise Custom Console access: render_ssao_preset

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.

SSAO custom settings

Screen-Space Ambient Occlusion Settings

Intensity	The intensity of the SSAO (Screen Space Ambient Occlusion) for the scene. The intensity value affects brightness of shadows: by the minimum value of 0.0f, the ambient occlusion shadowing is the lightest. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_intensity
Intensity Lighted Side	The intensity of the SSAO (Screen Space Ambient Occlusion) for the scene object's lighted side. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_intensity_lighted_side
Intensity Reflection	The intensity of SSAO (Screen Space Ambient Occlusion) on reflections. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_intensity_reflection
Cavity	The value indicating if the cavity option for the SSAO (Screen Space Ambient Occlusion) effect is enabled. This option improves (sharpens) the look of junction contours at low resolutions, so it should be used for detail enhancement (small stones, bolts and so on). Notice When checking the parameter value via API, you'll get the corresponding setting stored in the active preset (default or custom one). Enabled by default. Console access: render_ssao_cavity
Cavity Intensity	The intensity of sharpening of contours for the cavity option. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_cavity_intensity
Cavity Radius	The size of junction contours area for the cavity option for the SSAO (Screen Space Ambient Occlusion) effect. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_cavity_radius
Color Clamping Intensity	The intensity of TAA color clamping at zero pixel velocity for the SSAO (Screen Space Ambient Occlusion) 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 SSAO Color Clamping Velocity Threshold, while higher values reduce ghosting effect, but increase flickering. Range of values: [0.0f, 1.0f]. The default value is 1.0f. Console access: render_ssao_color_clamping_intensity
Color Clamping Velocity	The sensitivity of TAA color clamping for the SSAO (Screen Space Ambient Occlusion) 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_ssao_color_clamping_velocity_threshold
Ray Tracing	The value indicating if ray tracing is used for SSAO (Screen Space Ambient Occlusion) calculation. When enabled, SSAO provides more realistic shadows between the objects. Notice Ray-traced SSAO calculation available only when the SSRTGI technique is enabled. Enabled by default. Console access: render_ssao_ray_tracing

The following parameters are available when Ray Tracing option is disabled:

Quality	The quality of SSAO (Screen Space Ambient Occlusion). Each quality uses the following number of samples: Low — 4 samples Medium — 8 samples High — 16 samples Ultra — 32 samples Option #2 is selected by default (see above). Console access: render_ssao_quality
Resolution	The resolution of SSAO (Screen Space Ambient Occlusion). One of the following values: Quarter - quarter resolution Half - half resolution (by default) Full - full resolution Console access: render_ssao_resolution
Noise	The value indicating if noise for the SSAO (Screen Space Ambient Occlusion) effect is enabled. This option reduces banding effect. Notice It is recommended to use noise with TAA enabled. Enabled by default. Console access: render_ssao_noise
Radius	The radius of SSAO (Screen Space Ambient Occlusion). The radius is the distance for each of the points in the world space, up to which they can shadow their neighboring points: By low values, each point can cast shadows only on the points in the close range. By high values, each point casts shadows on points at more distant locations. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_radius
SSAO Threshold	The threshold value for the SSAO (Screen Space Ambient Occlusion) effect. It limits SSAO in areas where information cannot be obtained. The higher the value, the less pronounced the effect is. Range of values: [0.0f, 1.0f]. The default value is 0.5f. Console access: render_ssao_threshold

Ray Tracing Options#

Ray-Traced Global Illumination Settings

These settings are available when the Ray Tracing option is enabled.

Ray Tracing Threshold	The threshold value for the ray-traced SSAO (Screen Space Ambient Occlusion). Ray-traced SSAO calculation is available only when the SSRTGI technique is enabled. Range of values: [0.0f, inf]. The default value is 1.0f. Console access: render_ssao_ray_tracing_threshold

Denoise Options#

Denoise	The value indicating if noise reduction for the ray-traced SSAO (Screen Space Ambient Occlusion) is enabled. This option reduces noise by using blur effect. Notice Ray-traced SSAO calculation is available only when the SSRTGI technique is enabled. Enabled by default. Console access: render_ssao_ray_tracing_denoise
Radius	The radius of the area to be affected by noise reduction for the SSAO (Screen Space Ambient Occlusion) effect. Range of values: [1, 3]. The default value is 1. Console access: render_ssao_denoise_radius
Quality	The noise reduction quality level for the SSAO (Screen-Space Ambient Occlusion) 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_ssao_denoise_quality
Intensity	The noise reduction intensity for the SSAO (Screen Space Ambient Occlusion) 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_ssao_denoise_intensity
Gaussian Sigma	The sigma parameter of Gaussian blur used for noise reduction for the SSAO (Screen Space Ambient Occlusion) 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_ssao_denoise_gaussian_sigma
Threshold	The threshold.threshold value for color difference of neighboring pixels used for noise reduction for the SSAO (Screen Space Ambient Occlusion) effect. The blur is applied when the color difference is less than the threshold value. Notice Setting too high values results in blurring the whole image. Range of values: [0.0f, 1.0f]. The default value is 0.1f. Console access: render_ssao_denoise_threshold

Last update: 2021-12-13

Help improve this article

Was this article helpful?

Report a problem related to this article

(or select a word/phrase and press Ctrl+Enter)