Lights
This section contains lights-related settings, such as lens flares effect, batching and interleaved rendering parameters as well as per-object limits for forward rendering pass.
Lights Settings
| Deferred Lights |
The value indicating if rendering of lights is enabled. Enabled by default.
Console access: render_lights_enabled (API control) |
|---|---|
| Lens Flares |
The value indicating if rendering of per-light lens flares is enabled. Enabled by default.
Console access: render_lights_lens_flares (API control) |
Batching Options#
| Max Per Batch |
The maximum number of lights rendered by a tile per batch call.
With lights batching optimization, omni lights divided into tiles are rendered in batches: each tile renders the specified number of lights per batch. It allows decreasing the number of DIP calls and increasing performance. The optimization works only for omni lights with point shape and without shadows. 0 disables batching optimization. Range of values: [32, 1024]. The default value is 1024. Console access: render_lights_max_per_batch (API control) |
|---|---|
| Tile Grid Size |
The number of grid tiles per axis for tiled rendering optimization. During this optimization, the screen space is divided into tiles that render lights in batches. The optimization works only for omni lights with point shape and without shadows. Range of values: [1, 32]. The default value is 8. Console access: render_lights_tile_grid_size (API control) |
Interleaved Rendering Options#
| Enabled |
The value indicating if interleaved mode for rendering lights during the deferred pass is enabled. When enabled, lights are rendered in half resolution with subsequent reconstruction of neighboring pixels using the data from previous frames. This mode requires a high framerate (60+ FPS), otherwise anti-aliasing quality reduces and ghosting effect becomes more pronounced. Recommended for relatively static scenes which contain a lot of light sources and do not have a lot of reflective surfaces (in case of small number of light sources may reduce performance). Disabled by default.
Console access: render_lights_interleaved (API control) |
|---|---|
| Samples |
The interleaved rendering mode defining the number of pixels to be skipped when rendering lights during the deferred pass with subsequent reconstruction of neighboring pixels using the data from previous frames.
Console access: render_lights_interleaved_samples (API control) |
| Color Clamping |
The color clamping mode to be used for interleaved lights rendering mode. This mode is used to reduce ghosting effect: higher values increase clamping intensity but may cause flickering on rippled reflective surfaces (as this mode is not so good at the object's edges). When disabled, shadows and reflections have a lag as they are several frames behind.
One of the following values:
Console access: render_lights_interleaved_color_clamping (API control) |
| Catmull Resampling |
The value indicating if the Catmull-Rom resampling for interleaved lights rendering mode is enabled. This mode allows you to reduce image blurring when the camera moves forward/backward. Disabled by default.
Console access: render_lights_interleaved_catmull_resampling (API control) |
Forward Per-Object Limits#
| Ambient |
The value indicating if the transparent ambient pass is rendered.
Notice
Enabled by default.
This option takes effect only when the forward rendering pass is used for transparent objects rendering. Console access: render_transparent_ambient (API control) |
|---|---|
| Lights |
The value indicating if the transparent light pass is rendered.
Notice
Enabled by default.
This option takes effect only when the forward rendering pass is used for transparent objects rendering. Console access: render_transparent_light (API control) |
| Multiple Environment Probes |
The value indicating if the transparent multiple environment probes pass is rendered. Notice Enabled by default.
This method takes effect only when the forward rendering pass is used for transparent objects rendering. Console access: render_transparent_multiple_env_probes (API control) |
| World |
The maximum number of World lights per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 World lights per object. Range of values: [0, 128]. The default value is 4. Console access: render_lights_forward_per_object_world (API control) |
| Omni |
The maximum number of Omni lights per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Omni lights per object. Range of values: [0, 128]. The default value is 4. Console access: render_lights_forward_per_object_omni (API control) |
| Proj |
The maximum number of Projected lights per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Projected lights per object. Range of values: [0, 128]. The default value is 4. Console access: render_lights_forward_per_object_proj (API control) |
| Environment Probe |
The maximum number of Environment Probes per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Voxel Probes per object. Range of values: [0, 128]. The default value is 4. Console access: render_lights_forward_per_object_env (API control) |
| Voxel Probe |
The maximum number of Voxel Probes per object (available only for materials rendered in the forward rendering pass). You should set the nonzero value to increase performance: it is not recommended to use more than 4 Voxel Probes per object. Range of values: [0, 128]. The default value is 4. Console access: render_lights_forward_per_object_voxel (API control) |
Last update:
2022-10-10
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)