[Bf-docboard-svn] bf-manual: [8550] branches/blender-3.0-release/blender_docs/manual: Geometry Nodes: Add example and detail to capture attribute docs

[Hans Goudey]

Revision: 8550
          https://developer.blender.org/rBM8550
Author:   HooglyBoogly
Date:     2021-10-28 04:24:37 +0200 (Thu, 28 Oct 2021)
Log Message:
-----------
Geometry Nodes: Add example and detail to capture attribute docs

Modified Paths:
--------------
    branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_node.png
    branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst
    branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/point/set_point_radius.rst

Added Paths:
-----------
    branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_example.png

Added: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_example.png
===================================================================
(Binary files differ)

Index: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_example.png
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_example.png	2021-10-28 02:03:38 UTC (rev 8549)
+++ branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_example.png	2021-10-28 02:24:37 UTC (rev 8550)

Property changes on: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_example.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_capture-attribute_node.png
===================================================================
(Binary files differ)

Modified: branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst	2021-10-28 02:03:38 UTC (rev 8549)
+++ branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst	2021-10-28 02:24:37 UTC (rev 8550)
@@ -10,10 +10,19 @@
 
    Capture Attribute node.
 
-The *Capture Attribute* node stores the result of a field on a geometry, and outputs the data as a node socket
-so it can be used by other nodes.
+The *Capture Attribute* node stores the result of a field on a geometry, 
+and outputs the data as a node socket so it can be used by other nodes.
 
+The result is stored on the geometry just like a regular attribute with
+a name, but instead of referencing it with a name, it is retrieved whenever
+the socket is connected to the input of a node. Later on when evaluating the node tree,
+the attribute will be removed automatically if it is no longer used.
 
+This node is essential because field input nodes like the :doc:`/modeling/geometry_nodes/input/radius`
+work in the context of the node they are connected to, meaning that in order to pass data like ``radius``
+to a geometry that doesn't have radius, an explicit node link with the output of this node must be used.
+
+
 Inputs
 ======
 
@@ -38,3 +47,19 @@
 
 Attribute
    The result of the evaluated field, stored on the geometry.
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_attribute_capture-attribute_example.png
+
+Here, a noise texture is evaluated in along the path of the curve in 1 dimension
+and rendered with a shader. The capture node is essential because the output of the 
+:doc:`/modeling/geometry_nodes/curve/curve_to_mesh` does not have "Curve Parameter",
+so the :doc:`/modeling/geometry_nodes/curve/curve_parameter` must be evaluated while
+the geometry is still a curve.
+
+Internally, after the noise texture is evaluated on the curve, it is automatically
+copied to the mesh result of the curve to mesh node. This means that anywhere *Attribute*
+output of this node can be connected along the same stream of geometry nodes, the
+internal attribute will be available.
\ No newline at end of file

Modified: branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/point/set_point_radius.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/point/set_point_radius.rst	2021-10-28 02:03:38 UTC (rev 8549)
+++ branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/point/set_point_radius.rst	2021-10-28 02:24:37 UTC (rev 8550)
@@ -11,9 +11,10 @@
    The Set Point Radius node.
 
 The *Set Point Radius* node controls the size each selected point cloud point should display with in the viewport.
-The input node for this data is the :doc:`Radius </modeling/geometry_nodes/input/radius>` node.
 
+The input node for this data is the :doc:`/modeling/geometry_nodes/input/radius`.
 
+
 Inputs
 ======