Skip to content

Commit 407f583

Browse files
committed
Document VoxelGI static baking ignoring custom shaders and some properties
1 parent f908cdc commit 407f583

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

tutorials/3d/global_illumination/using_voxel_gi.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,22 @@ There are 3 global illumination modes available for meshes:
121121
This option is much slower compared to **Static**. Only use the **Dynamic**
122122
global illumination mode on large meshes that will change significantly during gameplay.
123123

124+
.. note::
125+
126+
For meshes with the **Static** bake mode, the VoxelGI baking system is not able
127+
to make use of custom shaders. These will be considered to be pure black,
128+
only acting as light blockers. You can make custom shaders taken into account
129+
by using the **Dynamic** bake mode for these objects, but this has a performance cost.
130+
131+
For BaseMaterial3D, some properties are currently ignored during baking. This can
132+
impact visuals if the material's albedo or emission texture was designed around
133+
a certain UV mapping:
134+
135+
- **UV1 > Offset**
136+
- **UV1 > Scale**
137+
- **UV1 > Triplanar**
138+
- **Emission > On UV2**
139+
124140
Additionally, there are 3 bake modes available for lights
125141
(DirectionalLight3D, OmniLight3D and SpotLight3D):
126142

0 commit comments

Comments
 (0)