[Bf-docboard-svn] bf-manual: [9795] trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst: Cycles: add light tree setting

[Brecht Van Lommel]

Revision: 9795
          https://developer.blender.org/rBM9795
Author:   brecht
Date:     2022-12-12 18:47:03 +0100 (Mon, 12 Dec 2022)
Log Message:
-----------
Cycles: add light tree setting

Contributed by Alaska with changes by Brecht.

Differential Revision: https://developer.blender.org/D16697

Modified Paths:
--------------
    trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst

Modified: trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst
===================================================================
--- trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst	2022-12-12 17:36:48 UTC (rev 9794)
+++ trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst	2022-12-12 17:47:03 UTC (rev 9795)
@@ -186,6 +186,17 @@
 Lights
 ======
 
+.. _bpy.types.CyclesRenderSettings.use_light_tree:
+
+Light Tree
+   Use a light tree to more effectively sample lights in the scene, taking into account
+   distance and estimated intensity.
+   This can significantly reduce noise, at the cost of a somewhat longer render time per sample.
+
+   Certain lighting properties are not accounted for in the light tree. This include custom
+   fallof, ray visibility, and complex shader node setups including textures.
+   This can result in an increase in noise in some scenes that make use of these features.
+
 .. _bpy.types.CyclesRenderSettings.light_sampling_threshold:
 
 Light Threshold