[Bf-docboard-svn] bf-manual: [8432] trunk/blender_docs/manual/render: Further changes to the manual to reflect changes with Cycles-X

[Alaska]

Revision: 8432
          https://developer.blender.org/rBM8432
Author:   Alaska
Date:     2021-09-24 08:30:05 +0200 (Fri, 24 Sep 2021)
Log Message:
-----------
Further changes to the manual to reflect changes with Cycles-X

Adds links to the UI in Blender so selecting 'Open Online Manual' takes you to the correct page.

Added descriptions for features I missed in previous commits.

Modified Paths:
--------------
    trunk/blender_docs/manual/render/cycles/render_settings/light_paths.rst
    trunk/blender_docs/manual/render/cycles/render_settings/performance.rst
    trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst
    trunk/blender_docs/manual/render/layers/passes.rst

Modified: trunk/blender_docs/manual/render/cycles/render_settings/light_paths.rst
===================================================================
--- trunk/blender_docs/manual/render/cycles/render_settings/light_paths.rst	2021-09-23 16:33:04 UTC (rev 8431)
+++ trunk/blender_docs/manual/render/cycles/render_settings/light_paths.rst	2021-09-24 06:30:05 UTC (rev 8432)
@@ -202,7 +202,17 @@
 Render Bounces
    Number of bounces when rendering final renders.
 
+.. _bpy.types.WorldLighting.ao_factor:
+
+Factor
+   The strength of the ambient occlusion.
+
+.. _bpy.types.WorldLighting.distance:
+
 Distance
    Distance from shading point to trace rays. A shorter distance emphasizes nearby features,
    while longer distances make it also take objects farther away into account.
-   Note, this setting is stored per :doc:`/render/lights/world`.
+   
+   This option can also be overridden per object in the
+   :ref:`Object Properties <bpy.types.CyclesObjectSettings.ao_distance>`,
+   which is useful when you have both small and large scale objects in the same scene.

Modified: trunk/blender_docs/manual/render/cycles/render_settings/performance.rst
===================================================================
--- trunk/blender_docs/manual/render/cycles/render_settings/performance.rst	2021-09-23 16:33:04 UTC (rev 8431)
+++ trunk/blender_docs/manual/render/cycles/render_settings/performance.rst	2021-09-24 06:30:05 UTC (rev 8432)
@@ -32,11 +32,17 @@
 Tiles
 =====
 
-.. _bpy.types.RenderSettings.tile_x:
-.. _bpy.types.RenderSettings.tile_y:
+.. _bpy.types.RenderSettings.use_auto_tile:
 
+Auto Tiles
+   Enables or disables the use of tiles. Tiles are used to reduce memory usage while rendering high
+   resolution images.
+
+.. _bpy.types.RenderSettings.tile_size:
+
 Tile Size
-   This value is used to control the size of the tile used for rendering. Decreasing the size reduces memory usuage.
+   This value is used to control the size of the tile used for rendering. Decreasing the size reduces
+   memory usuage.
 
 
 Acceleration Structure

Modified: trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst
===================================================================
--- trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst	2021-09-23 16:33:04 UTC (rev 8431)
+++ trunk/blender_docs/manual/render/cycles/render_settings/sampling.rst	2021-09-24 06:30:05 UTC (rev 8432)
@@ -18,17 +18,26 @@
 both indirect light sampling (letting the ray follow the surface BSDF)
 and direct light sampling (picking a light source and tracing a ray towards it) are used.
 
-.. _bpy.types.CyclesRenderSettings.samples:
+.. _bpy.types.CyclesRenderSettings.preview_samples:
 
-Render
+Viewport Samples
+   Number of samples for viewport rendering. Setting this value to zero
+   enables indefinite sampling of the viewport.
+   
+   .. _bpy.types.CyclesRenderSettings.samples:
+
+Render Samples
    Number of paths to trace for each pixel in the final render. As more samples are taken,
    the solution becomes less noisy and more accurate.
 
-.. _bpy.types.CyclesRenderSettings.preview_samples:
+   .. _bpy.types.CyclesRenderSettings.time_limit:
 
-Viewport
-   Number of samples for viewport rendering. Setting this value to zero
-   enables indefinite sampling of the viewport.
+Time Limit
+   Renders scene until time limit or sample count is reached. When the time is 0,
+   the sample count is used to determine when the render stops.
+   
+   .. note:: The time limit does not include pre-render processing time, only render time. 
+   
 
 
 .. _bpy.types.CyclesRenderSettings.use_adaptive_sampling:
@@ -49,6 +58,7 @@
 and the renderer will automatically choose the appropriate amount of samples.
 
 .. _bpy.types.CyclesRenderSettings.adaptive_threshold:
+.. _bpy.types.CyclesRenderSettings.preview_adaptive_threshold:
 
 Noise Threshold
    The error threshold to decide whether to continue sampling a pixel or not.
@@ -56,6 +66,7 @@
    Setting it to exactly 0 lets Cycles guess an automatic value for it based on the total sample count.
 
 .. _bpy.types.CyclesRenderSettings.adaptive_min_samples:
+.. _bpy.types.CyclesRenderSettings.preview_adaptive_min_samples:
 
 Min Samples
    The minimum number of samples a pixel receives before adaptive sampling is applied.
@@ -108,6 +119,7 @@
    Sample to start :ref:`denoising <render-cycles-settings-viewport-denoising>` in the 3D Viewport.
 
 .. _bpy.types.CyclesRenderSettings.preview_denoising_input_passes:
+.. _bpy.types.CyclesRenderSettings.denoising_input_passes:
 
 Input Passes
    Controls which :doc:`Render Pass </render/layers/passes>` the denoiser should use as input,
@@ -120,6 +132,9 @@
    :Color + Albedo: Denoise the color and albedo data.
    :Color + Albedo + Normal: Denoise the color, albedo, and normal pass data.
 
+.. _bpy.types.CyclesRenderSettings.preview_denoising_prefilter:
+.. _bpy.types.CyclesRenderSettings.denoising_prefilter:
+
 Prefilter
    Controls whether or not prefiltering is applied to auxiliary passes (Albedo and Normal) for use when
    denoising.

Modified: trunk/blender_docs/manual/render/layers/passes.rst
===================================================================
--- trunk/blender_docs/manual/render/layers/passes.rst	2021-09-23 16:33:04 UTC (rev 8431)
+++ trunk/blender_docs/manual/render/layers/passes.rst	2021-09-24 06:30:05 UTC (rev 8432)
@@ -34,6 +34,8 @@
       Distance to visible surfaces, mapped to the 0.0 - 1.0 range.
       When enabled, settings are in :ref:`World tab <bpy.types.WorldMistSettings>`.
       This pass can be used in compositing to fade out objects that are farther away.
+   Position
+      World position of objects in the scene.
    Normal
       Surface normal used for shading.
    Vector