[Bf-docboard-svn] bf-manual: [8549] branches/blender-3.0-release/blender_docs/manual: Geometry Nodes: Fields transfer attribute node

[Hans Goudey]

Revision: 8549
          https://developer.blender.org/rBM8549
Author:   HooglyBoogly
Date:     2021-10-28 04:03:38 +0200 (Thu, 28 Oct 2021)
Log Message:
-----------
Geometry Nodes: Fields transfer attribute node

rB76f386a37a9cf1

Modified Paths:
--------------
    branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst

Added Paths:
-----------
    branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_example.png
    branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_node.png
    branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst

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

Index: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_example.png
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_example.png	2021-10-27 23:37:35 UTC (rev 8548)
+++ branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_example.png	2021-10-28 02:03:38 UTC (rev 8549)

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

Index: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_node.png
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_node.png	2021-10-27 23:37:35 UTC (rev 8548)
+++ branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_node.png	2021-10-28 02:03:38 UTC (rev 8549)

Property changes on: branches/blender-3.0-release/blender_docs/manual/images/modeling_geometry-nodes_attribute_transfer-attribute_node.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/modeling/geometry_nodes/attribute/index.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst	2021-10-27 23:37:35 UTC (rev 8548)
+++ branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst	2021-10-28 02:03:38 UTC (rev 8549)
@@ -10,3 +10,4 @@
 
    attribute_statistic.rst
    capture_attribute.rst
+   transfer_attribute.rst

Added: branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst	                        (rev 0)
+++ branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst	2021-10-28 02:03:38 UTC (rev 8549)
@@ -0,0 +1,83 @@
+.. index:: Geometry Nodes; Transfer Attribute
+.. _bpy.types.GeometryNodeTransferAttribute:
+
+***********************
+Transfer Attribute Node
+***********************
+
+.. figure:: /images/modeling_geometry-nodes_attribute_transfer-attribute_node.png
+   :align: center
+
+   Transfer Attribute node.
+
+The *Transfer Attribute* node retrieves values from a target geometry and provides them as a field,
+so they can be used anywhere.
+
+
+Inputs
+======
+
+Target
+   The geometry to retrieve the attribute from.
+
+Attribute
+   A field to evaluate on the *Target* geometry for use with the transfer method.
+
+Source Position
+   The position to start from when finding the closest location on the target mesh or point cloud.
+   Used in the *Nearest Face Interpolated* and *Nearest* modes. By default, this is the same as
+   if the :doc:`/modeling/geometry_nodes/input/position` was connected.
+
+Index
+   Which index to use when retrieving the data from the input field in *Index* mode.
+   By default, the :doc:`/modeling/geometry_nodes/input/index` is connected, meaning that
+   the data from the source attribute is copied directly to the output. However, a different
+   index can be connected, resulting in a "shuffling" of the values. 
+   Indices that are either too large or below 0 are clamped.
+
+   .. tip::
+      To retrieve a single attribute value instead of a field, a single integer input
+      or the :doc:`/modeling/geometry_nodes/input/integer` can be connected to this socket.
+
+
+Properties
+==========
+
+Domain
+   Domain that the attribute is transferred from, or in other words, the attribute domain used
+   to evaluate the *Attribute* input. For example, it is possible to transfer a point attribute
+   from one geometry to the face domain of another geometry.
+
+Mapping
+   How elements from the destination geometry are mapped to the output.
+
+   :Index:
+      Copy the attribute data from the value at the input index.
+      In thise mode, the target 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.
+
+   :Nearest Face Interpolated:
+      Transfer the attribute from the nearest point from anywhere on the surface.
+      Non-face attributes are interpolated across the surface (edge attributes are not supported yet).
+      Loose points and edges are ignored.
+   
+   :Nearest:
+      Transfer the attribute from the nearest element (with a domain chosen by the *Domain* input).
+      No interpolation is done.
+
+
+Outputs
+=======
+
+Attribute
+   The data retrieved from the *Target* geometry, mapped based on the node's settings and inputs.
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_attribute_transfer-attribute_example.png
+   :align: center
+
+   Transferring the position of vertices from a different object's geometry,
+   assuming that they have the same number of points.


Property changes on: branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property