From ee2b1d0d4a9096d37fd5469830043212f9e48cb3 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Thu, 11 Sep 2025 16:56:03 +0200
Subject: [PATCH] Document the interaction between Light3D cull mask and
 GI/volumetric fog

(cherry picked from commit 9317c8eb23562c4fb44dc0108c1cd97bd5301cc3)
---
 doc/classes/Light3D.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/classes/Light3D.xml b/doc/classes/Light3D.xml
index 4878599dbd5..82923befbcf 100644
--- a/doc/classes/Light3D.xml
+++ b/doc/classes/Light3D.xml
@@ -68,6 +68,7 @@
 		</member>
 		<member name="light_cull_mask" type="int" setter="set_cull_mask" getter="get_cull_mask" default="4294967295">
 			The light will affect objects in the selected layers.
+			[b]Note:[/b] The light cull mask is ignored by [VoxelGI], SDFGI, [LightmapGI], and volumetric fog. These will always render lights in a way that ignores the cull mask. See also [member VisualInstance3D.layers].
 		</member>
 		<member name="light_energy" type="float" setter="set_param" getter="get_param" default="1.0">
 			The light's strength multiplier (this is not a physical unit). For [OmniLight3D] and [SpotLight3D], changing this value will only change the light color's intensity, not the light's radius.