[Bf-docboard-svn] bf-manual: [8887] trunk/blender_docs/manual: Geometry Nodes: new Field at Index node

[Hans Goudey]

Revision: 8887
          https://developer.blender.org/rBM8887
Author:   HooglyBoogly
Date:     2022-01-26 23:36:40 +0100 (Wed, 26 Jan 2022)
Log Message:
-----------
Geometry Nodes: new Field at Index node

Also improve the wording and add details to some related nodes.

rBb88a37a490fa9e344eb36fd0bdda6eb46218e99b

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst
    trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst
    trunk/blender_docs/manual/modeling/geometry_nodes/input/input_index.rst
    trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_geometry-nodes_field-at-index_node.png
    trunk/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst

Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_field-at-index_node.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_field-at-index_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_field-at-index_node.png	2022-01-26 20:53:22 UTC (rev 8886)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_field-at-index_node.png	2022-01-26 22:36:40 UTC (rev 8887)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_field-at-index_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst	2022-01-26 20:53:22 UTC (rev 8886)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst	2022-01-26 22:36:40 UTC (rev 8887)
@@ -60,8 +60,8 @@
    :Index:
       Copy the attribute data from the value at the input index.
       In this mode, the source geometry can consist of a mesh, point cloud, or curve. The matching
-      component type from the context will be chosen if possible, otherwise a component will be chosen
-      in that order.
+      component type from the :ref:`context <field-context>` will be chosen if possible,
+      otherwise a component will be chosen in that order.
 
    :Nearest Face Interpolated:
       Transfer the attribute from the nearest point from anywhere on the surface.

Modified: trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst	2022-01-26 20:53:22 UTC (rev 8886)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst	2022-01-26 22:36:40 UTC (rev 8887)
@@ -104,6 +104,7 @@
 the :doc:`/modeling/geometry_nodes/point/distribute_points_on_faces`,
 in the form of :ref:`anonymous-attributes`.
 
+.. _field-context:
 
 Field Context
 =============

Modified: trunk/blender_docs/manual/modeling/geometry_nodes/input/input_index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/input/input_index.rst	2022-01-26 20:53:22 UTC (rev 8886)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/input/input_index.rst	2022-01-26 22:36:40 UTC (rev 8887)
@@ -10,10 +10,10 @@
 
    Index node.
 
-The *Index* node gives an integer value indicating the position of each element in the list.
-This depends on the internal order of the data in the geometry, which is not necessarily
-visible in the 3D Viewport. However, the index value is visible in the left-most column in
-the :doc:`Spreadsheet Editor </editors/spreadsheet>`.
+The *Index* node gives an integer value indicating the position of each element in the list,
+starting at zero. This depends on the internal order of the data in the geometry, which is not
+necessarily visible in the 3D Viewport. However, the index value is visible in the left-most column 
+in the :doc:`Spreadsheet Editor </editors/spreadsheet>`.
 
 .. note::
    

Added: trunk/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst	2022-01-26 22:36:40 UTC (rev 8887)
@@ -0,0 +1,42 @@
+.. index:: Geometry Nodes; Field at Index
+.. _bpy.types.GeometryNodeFieldAtIndex:
+
+*******************
+Field at Index Node
+*******************
+
+.. figure:: /images/modeling_geometry-nodes_field-at-index_node.png
+   :align: right
+
+   Field at Index Node.
+
+The *Field at Index* node allows accessing data of other elements in the context geometry.
+It is similar to the :doc:`/modeling/geometry_nodes/attribute/transfer_attribute` in *Index*
+mode. The main difference is that this node does not require a geometry input, because the geometry
+from the :ref:`field context <field-context>` is used.
+
+
+Inputs
+======
+
+Index
+   The :doc:`index </modeling/geometry_nodes/input/input_index>` of the element in the selected domain
+   to retrieve data from, i.e. "the fourth face", or "the first control point".
+
+Value
+   The field to retrieve data from.
+
+
+Properties
+==========
+
+Domain
+   The :ref:`attribute domain <attribute-domains>` used for accumulation
+   and for evaluation of the *Value* input. If the 
+
+
+Output
+======
+
+Value
+   The value of the input field at the given index.


Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst	2022-01-26 20:53:22 UTC (rev 8886)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst	2022-01-26 22:36:40 UTC (rev 8887)
@@ -13,6 +13,7 @@
    boolean_math.rst
    clamp.rst
    compare.rst
+   field_at_index.rst
    float_curve.rst
    float_to_integer.rst
    map_range.rst