[Bf-docboard-svn] bf-manual: [8574] trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst: Update Manual for Scrambling Distance Patchs

[Alaska]

Revision: 8574
          https://developer.blender.org/rBM8574
Author:   Alaska
Date:     2021-11-03 11:10:04 +0100 (Wed, 03 Nov 2021)
Log Message:
-----------
Update Manual for Scrambling Distance Patchs

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	2021-11-03 09:14:30 UTC (rev 8573)
+++ trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst	2021-11-03 10:10:04 UTC (rev 8574)
@@ -182,6 +182,33 @@
       See `this Pixar paper <https://graphics.pixar.com/library/ProgressiveMultiJitteredSampling/paper.pdf>`__
       for more information.
 
+.. _bpy.types.CyclesRenderSettings.scrambling_distance:
+
+Scrambling Distance
+   Controls the correlation between pixels by limiting the maximum deviation of the sample values between pixels.
+   Lowering the *Scrambling Distance* increases the correlation, which reduces noise, but can cause noticeable
+   visual artifacts unless the *Sample Count* is set relatively high. Lowering *Scrambling Distance* generally leads
+   to better rendering performance when rendering with a GPU.
+   
+   .. note:: *Scrambling Distance* can not be enabled while *Adaptive Sampling* is enabled.
+
+   .. _bpy.types.CyclesRenderSettings.adaptive_scrambling_distance:
+
+   Adaptive Scrambling Distance
+      Automatically picks a *Scrambling Distance* value based on your current *Sample Count* that provides the benefits
+      of *Scrambling Distace* while keeping artifacts at a minimum. 
+      
+      .. note::
+      
+         *Scrambling Distance* can still be adjusted while *Adaptive Scrambling Distance* is enabled. In this situation
+         *Scrambling Distance* behaves like a modifier for the *Adaptive Scrambling Distance* value.
+
+   .. _bpy.types.CyclesRenderSettings.preview_scrambling_distance:
+
+   Viewport Scrambling Distance
+      Allows other `Scrambling Distance` settings to impact viewport rendering.
+
+
 .. _bpy.types.CyclesRenderSettings.min_light_bounces:
 
 Min Light Bounces