Skip to content

Commit 09078cf

Browse files
committed
Document limit of VoxelGI and LightmapGI instances that can be rendered
1 parent 1390e58 commit 09078cf

File tree

2 files changed

+20
-1
lines changed

2 files changed

+20
-1
lines changed

tutorials/3d/global_illumination/using_lightmap_gi.rst

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,6 @@ imported 3D scenes will also speed up baking significantly. However, this will
381381
require you to reimport all lightmapped 3D scenes before you can bake lightmaps
382382
again.
383383

384-
385384
.. _doc_using_lightmap_gi_denoising:
386385

387386
Denoising
@@ -527,3 +526,12 @@ in Base64.
527526
The generated EXR file can be viewed and even edited using an image editor
528527
to perform post-processing if needed. However, keep in mind that changes to
529528
the EXR file will be lost when baking lightmaps again.
529+
530+
Reducing LightmapGI artifacts
531+
-----------------------------
532+
533+
If you notice LightmapGI nodes popping in and out of existence as the camera
534+
moves, this is most likely because the engine is rendering too many LightmapGI
535+
instances at once. Godot is limited to rendering 8 LightmapGI nodes at once,
536+
which means up to 8 instances can be in the camera view before some of them will
537+
start flickering.

tutorials/3d/global_illumination/using_voxel_gi.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,3 +193,14 @@ in your level geometry. This can be remedied in several ways:
193193
- To combat artifacts that can appear on reflective surfaces, try increasing
194194
**Bias** and/or **Normal Bias** in the VoxelGIData resource as described above.
195195
Do not increase these values too high, or light leaking will become more pronounced.
196+
197+
If you notice VoxelGI nodes popping in and out of existence as the camera moves,
198+
this is most likely because the engine is rendering too many VoxelGI instances
199+
at once. Godot is limited to rendering 8 VoxelGI nodes at once, which means up
200+
to 8 instances can be in the camera view before some of them will start
201+
flickering.
202+
203+
Additionally, for performance reasons, Godot can only blend between 2 VoxelGI
204+
nodes at a given pixel on the screen. If you have more than 2 VoxelGI nodes
205+
overlapping, global illumination may appear to flicker as the camera moves or
206+
rotates.

0 commit comments

Comments
 (0)