[Bf-docboard-svn] bf-manual: [9725] branches/blender-3.4-release/blender_docs/manual/render/cycles/render_settings/sampling.rst: Cycles: Add documentation for path guiding

[Brecht Van Lommel]

Revision: 9725
          https://developer.blender.org/rBM9725
Author:   brecht
Date:     2022-11-28 20:00:50 +0100 (Mon, 28 Nov 2022)
Log Message:
-----------
Cycles: Add documentation for path guiding

Contributed by Alaska.

Modified Paths:
--------------
    branches/blender-3.4-release/blender_docs/manual/render/cycles/gpu_rendering.rst
    branches/blender-3.4-release/blender_docs/manual/render/cycles/render_settings/sampling.rst

Property Changed:
----------------
    branches/blender-3.4-release/blender_docs/

Index: branches/blender-3.4-release/blender_docs
===================================================================
--- branches/blender-3.4-release/blender_docs	2022-11-27 21:08:33 UTC (rev 9724)
+++ branches/blender-3.4-release/blender_docs	2022-11-28 19:00:50 UTC (rev 9725)

Property changes on: branches/blender-3.4-release/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -1,6 +1,6 ##
 /branches/blender-2.92-release/blender_docs:7610-7921
 /branches/blender-2.93-release/blender_docs:7959-8113
 /branches/blender-3.0-release/blender_docs:8543-9034
-/branches/blender-3.1-release/blender_docs:8904-9230
+/branches/blender-3.1-release/blender_docs:8904-9238
 /branches/blender-3.2-release/blender_docs:9236-9417
 /branches/blender-3.3-release/blender_docs:9438-9611
\ No newline at end of property
Modified: branches/blender-3.4-release/blender_docs/manual/render/cycles/gpu_rendering.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/render/cycles/gpu_rendering.rst	2022-11-27 21:08:33 UTC (rev 9724)
+++ branches/blender-3.4-release/blender_docs/manual/render/cycles/gpu_rendering.rst	2022-11-28 19:00:50 UTC (rev 9725)
@@ -20,8 +20,10 @@
 Blender supports different technologies to render on the GPU depending on the particular GPU manufacturer
 and operating system.
 
-.. note:: With all GPU rendering technologies, :doc:`/render/shader_nodes/osl` is not supported.
+.. note::
 
+   :doc:`/render/shader_nodes/osl` and :ref:`path guiding <bpy.types.CyclesRenderSettings.use_guiding>`
+   are not supported when rendering on the GPU.
 
 CUDA -- NVIDIA
 --------------

Modified: branches/blender-3.4-release/blender_docs/manual/render/cycles/render_settings/sampling.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/render/cycles/render_settings/sampling.rst	2022-11-27 21:08:33 UTC (rev 9724)
+++ branches/blender-3.4-release/blender_docs/manual/render/cycles/render_settings/sampling.rst	2022-11-28 19:00:50 UTC (rev 9725)
@@ -147,6 +147,42 @@
       more detailed results than *Fast* with increased processing time.
 
 
+.. _bpy.types.CyclesRenderSettings.use_guiding:
+
+Path Guiding
+============
+
+Path guiding helps reduce noise in scenes where finding a path to light is difficult for
+regular path tracing, for example when a room is lit through a small door opening.
+Important light directions are learned over time, improving as more samples are taken.
+Guiding is supported for surfaces with diffuse BSDFs and volumes with isotropic
+and anisotropic scattering.
+
+.. note::
+
+   - Path guiding is only available when rendering on a CPU.
+
+   - While path guiding helps render caustics in some scenes, it is not designed for complex caustics
+     as they are harder to learn and guide.
+
+.. _bpy.types.CyclesRenderSettings.guiding_training_samples:
+
+Training Samples
+   The maximum number of samples to use for training. A value of 0 will keep training until
+   the end of the render. Usually 128 to 256 training samples is enough for accurate guiding.
+   Higher values can lead to a minor increases in guiding quality but with increased render times.
+
+.. _bpy.types.CyclesRenderSettings.use_surface_guiding:
+
+Surface
+   Enable path guiding for the diffuse component of surfaces.
+
+.. _bpy.types.CyclesRenderSettings.use_volume_guiding:
+
+Volume
+   Enable path guiding inside volumes.
+
+
 Advanced
 ========