[Bf-docboard-svn] bf-manual: [9943] trunk/blender_docs/manual/render/shader_nodes: Update OptiX OSL limitations with notes on AO and Bevel

[Alaska]

Revision: 9943
          https://developer.blender.org/rBM9943
Author:   Alaska
Date:     2023-02-07 05:53:17 +0100 (Tue, 07 Feb 2023)
Log Message:
-----------
Update OptiX OSL limitations with notes on AO and Bevel

The Ambient Occlusion and Bevel nodes do not work while using OptiX OSL
This is because they rely on tracing addition rays that OSL currently
does not support with the OptiX backend.

See {T104082}

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

Modified Paths:
--------------
    trunk/blender_docs/manual/render/shader_nodes/input/ao.rst
    trunk/blender_docs/manual/render/shader_nodes/input/bevel.rst
    trunk/blender_docs/manual/render/shader_nodes/osl.rst

Modified: trunk/blender_docs/manual/render/shader_nodes/input/ao.rst
===================================================================
--- trunk/blender_docs/manual/render/shader_nodes/input/ao.rst	2023-02-07 04:08:58 UTC (rev 9942)
+++ trunk/blender_docs/manual/render/shader_nodes/input/ao.rst	2023-02-07 04:53:17 UTC (rev 9943)
@@ -18,12 +18,13 @@
 .. note::
 
    :guilabel:`Cycles Only`
-   The Ambient Occlusion node will not produce a valid result on objects that are either a
-   :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>` or
-   :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>` while the scene contains
-   a active :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`,
-   :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>`, and
-   :ref:`Shadow Caustic Light<bpy.types.CyclesLightSettings.is_caustics_light>`.
+    The Ambient Occlusion node will not produce a valid result when:
+     - The object is either a :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`
+       or :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>` while the scene
+       contains an active :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`,
+       :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>`, and
+       :ref:`Shadow Caustic Light<bpy.types.CyclesLightSettings.is_caustics_light>`.
+     - :doc:`/render/shader_nodes/osl` is active while using the OptiX rendering backend.
 
 Inputs
 ======

Modified: trunk/blender_docs/manual/render/shader_nodes/input/bevel.rst
===================================================================
--- trunk/blender_docs/manual/render/shader_nodes/input/bevel.rst	2023-02-07 04:08:58 UTC (rev 9942)
+++ trunk/blender_docs/manual/render/shader_nodes/input/bevel.rst	2023-02-07 04:53:17 UTC (rev 9943)
@@ -22,12 +22,13 @@
 
 .. note::
 
-   The Bevel node will not produce a valid result on objects that are either a
-   :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>` or
-   :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>` while the scene contains
-   a active :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`,
-   :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>`, and
-   :ref:`Shadow Caustic Light<bpy.types.CyclesLightSettings.is_caustics_light>`.
+    The Bevel node will not produce a valid result when:
+     - The object is either a :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`
+       or :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>` while the scene
+       contains an active :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`,
+       :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>`, and
+       :ref:`Shadow Caustic Light<bpy.types.CyclesLightSettings.is_caustics_light>`.
+     - :doc:`/render/shader_nodes/osl` is active while using the OptiX rendering backend.
 
 
 Inputs

Modified: trunk/blender_docs/manual/render/shader_nodes/osl.rst
===================================================================
--- trunk/blender_docs/manual/render/shader_nodes/osl.rst	2023-02-07 04:08:58 UTC (rev 9942)
+++ trunk/blender_docs/manual/render/shader_nodes/osl.rst	2023-02-07 04:53:17 UTC (rev 9943)
@@ -20,7 +20,9 @@
    - Texture lookups require OSL to be able to determine a constant image file path for each
      texture call.
    - Some noise functions are not available. Examples include *Cell*, *Simplex*, and *Gabor*.
-   - The :ref:`trace <render-shader-nodes-osl-trace>` function can't be used.
+   - The :ref:`trace <render-shader-nodes-osl-trace>` function is not functional. 
+     As a result of this, the :ref:`Ambient Occlusion <bpy.types.ShaderNodeAmbientOcclusion>`
+     and :ref:`Bevel <bpy.types.ShaderNodeBevel>` nodes do not work.
 
 
 .. _bpy.types.ShaderNodeScript: