[Bf-docboard-svn] bf-manual: [9696] branches/blender-3.4-release/blender_docs/manual: Geometry Nodes: Split transfer attribute node
Hans Goudey
noreply at blender.org
Thu Nov 17 21:51:48 CET 2022
Revision: 9696
https://developer.blender.org/rBM9696
Author: HooglyBoogly
Date: 2022-11-17 21:51:47 +0100 (Thu, 17 Nov 2022)
Log Message:
-----------
Geometry Nodes: Split transfer attribute node
rBdedc679ecabb43e79b0160a7c64bbd616adfa829
Modified Paths:
--------------
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/fields.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst
Added Paths:
-----------
branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_index-example.png
branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_nearest-example.png
branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleIndex.webp
branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearest.webp
branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearestSurface.webp
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/geometry/sample_index.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/geometry/sample_nearest.rst
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_nearest_surface.rst
Removed Paths:
-------------
branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst
Added: branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_index-example.png
===================================================================
(Binary files differ)
Index: branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_index-example.png
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_index-example.png 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_index-example.png 2022-11-17 20:51:47 UTC (rev 9696)
Property changes on: branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_index-example.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_nearest-example.png
===================================================================
(Binary files differ)
Index: branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_nearest-example.png
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_nearest-example.png 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_nearest-example.png 2022-11-17 20:51:47 UTC (rev 9696)
Property changes on: branches/blender-3.4-release/blender_docs/manual/images/modeling_geometry-nodes_sample_nearest-example.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleIndex.webp
===================================================================
(Binary files differ)
Index: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleIndex.webp
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleIndex.webp 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleIndex.webp 2022-11-17 20:51:47 UTC (rev 9696)
Property changes on: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleIndex.webp
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/webp
\ No newline at end of property
Added: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearest.webp
===================================================================
(Binary files differ)
Index: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearest.webp
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearest.webp 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearest.webp 2022-11-17 20:51:47 UTC (rev 9696)
Property changes on: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearest.webp
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/webp
\ No newline at end of property
Added: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearestSurface.webp
===================================================================
(Binary files differ)
Index: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearestSurface.webp
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearestSurface.webp 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearestSurface.webp 2022-11-17 20:51:47 UTC (rev 9696)
Property changes on: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleNearestSurface.webp
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/webp
\ No newline at end of property
Modified: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst 2022-11-17 20:51:47 UTC (rev 9696)
@@ -11,6 +11,5 @@
attribute_statistic.rst
capture_attribute.rst
domain_size.rst
- transfer_attribute.rst
remove_named_attribute.rst
store_named_attribute.rst
Deleted: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attribute/transfer_attribute.rst 2022-11-17 20:51:47 UTC (rev 9696)
@@ -1,89 +0,0 @@
-.. index:: Geometry Nodes; Transfer Attribute
-.. _bpy.types.GeometryNodeAttributeTransfer:
-
-***********************
-Transfer Attribute Node
-***********************
-
-.. figure:: /images/node-types_GeometryNodeAttributeTransfer.webp
- :align: center
- :alt: Transfer Attribute node.
-
-The *Transfer Attribute* node retrieves values from a source geometry and provides them as a field,
-so they can be used anywhere.
-
-
-Inputs
-======
-
-Source
- The geometry to retrieve the attribute from.
-
- .. note::
-
- This node only supports instances in the source geometry when the *Mapping*
- method is set to *Index*.
-
-Attribute
- A field to evaluate on the *Source* geometry for use with the transfer method.
-
-Source Position
- The position to start from when finding the closest location on the source 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:`index </modeling/geometry_nodes/input/input_index>` is used, 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
- The :ref:`attribute domain <attribute-domains>` that the attribute is transferred from, or in other words,
- the domain used to evaluate the *Attribute* input. For example, it is possible to transfer data from the
- faces of one geometry to the points of another.
-
-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 this mode, the source geometry can consist of a mesh, point cloud, or curve. The matching
- 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.
- 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 *Source* 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.
Modified: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst 2022-11-17 20:09:39 UTC (rev 9695)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst 2022-11-17 20:51:47 UTC (rev 9696)
@@ -56,10 +56,11 @@
Anonymous attributes are still stored on the geometry like other attributes, and they are even
automatically interpolated when the geometry changes with other nodes, except for a few cases.
-So generally, if the node link is still accessible, the attribute it references will be too.
-However, anonymous attributes cannot be connected to a completely separate geometry
-that was not created from their source. To transfer attributes between separate geometries,
-the :doc:`/modeling/geometry_nodes/attribute/transfer_attribute` can be used.
+So generally, if the node link is still accessible, the attribute it references will be available
+too. However, anonymous attributes cannot be connected to a completely separate geometry
+that was created from a different source. To transfer attributes between separate geometries,
+the :doc:`/modeling/geometry_nodes/geometry/sample_index` or other similar nodes like the
+:doc:`/modeling/geometry_nodes/mesh/sample_nearest_surface` can be used.
.. _attribute-data-types:
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list