[Bf-docboard-svn] bf-manual: [7809] trunk/blender_docs/manual: Add page for Attribute Proximity node

Victor-Louis De Gusseme noreply at blender.org
Mon Mar 8 21:35:39 CET 2021


Revision: 7809
          https://developer.blender.org/rBM7809
Author:   victorlouis
Date:     2021-03-08 21:35:39 +0100 (Mon, 08 Mar 2021)
Log Message:
-----------
Add page for Attribute Proximity node

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-edges.png
    trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-faces.png
    trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png
    trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-points.png
    trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity.png
    trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_proximity.rst

Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-edges.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-edges.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-edges.png	2021-03-08 19:27:16 UTC (rev 7808)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-edges.png	2021-03-08 20:35:39 UTC (rev 7809)

Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-edges.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-faces.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-faces.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-faces.png	2021-03-08 19:27:16 UTC (rev 7808)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-faces.png	2021-03-08 20:35:39 UTC (rev 7809)

Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-faces.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png	2021-03-08 19:27:16 UTC (rev 7808)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png	2021-03-08 20:35:39 UTC (rev 7809)

Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-points.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-points.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-points.png	2021-03-08 19:27:16 UTC (rev 7808)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-points.png	2021-03-08 20:35:39 UTC (rev 7809)

Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity-points.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity.png	2021-03-08 19:27:16 UTC (rev 7808)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity.png	2021-03-08 20:35:39 UTC (rev 7809)

Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute-proximity.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_proximity.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_proximity.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_proximity.rst	2021-03-08 20:35:39 UTC (rev 7809)
@@ -0,0 +1,85 @@
+.. index:: Geometry Nodes; Attribute Proximity
+.. _bpy.types.GeometryNodeAttributeProximity:
+
+*******************
+Attribute Proximity
+*******************
+
+.. figure:: /images/modeling_modifiers_nodes_attribute-proximity.png
+   :align: right
+   :width: 200px
+
+   The Attribute Proximity node.
+
+For each point in the input geometry, this node finds the closest position on the target.
+Both the positions and the distances to them can be stored in attributes.
+
+Inputs
+======
+
+Geometry
+   Standard geometry input.
+
+Target
+   Standard geometry input.
+
+Distance
+   The name of the float attribute where the computed distance is stored. 
+   A new attribute with that name is added if it does not exist yet. 
+   If it does exist, the values of the existing attribute are overridden.
+
+Position
+   The name of the attribute where the computed location is stored. 
+   A new attribute with that name is added if it does not exist yet. 
+   If it does exist, the values of the existing attribute are overridden.
+
+
+Properties
+==========
+
+Target Geometry
+   Faces 
+      Calculate the closest point anywhere on the faces of the target geometry's mesh.
+   Edges 
+      Calculate the closest point anywhere on the edges of the target geometry's mesh.
+   Points
+      Calculate the closest point or vertex on the target geometry. This mode is usually fastest.
+
+Output
+======
+
+Geometry
+   Standard geometry output.
+
+
+Examples
+========
+The different modes of the node: faces, edges and points. 
+In this example the geometry nodes modifier is added on the plane.
+Note that the plane is subdivided and the cube is not. 
+
+.. figure:: /images/modeling_modifiers_nodes_attribute-proximity-faces.png
+   :align: left
+   :width: 205px
+
+   Target Geometry mode: Faces.
+
+.. figure:: /images/modeling_modifiers_nodes_attribute-proximity-edges.png
+   :align: left
+   :width: 205px
+
+   Target Geometry mode: Edges.
+
+.. figure:: /images/modeling_modifiers_nodes_attribute-proximity-points.png
+   :width: 205px
+
+   Target Geometry mode: Points.
+
+
+Be sure to set the mode to Points when the Target is a point cloud.
+
+.. figure:: /images/modeling_modifiers_nodes_attribute-proximity-pointcloud-target.png
+   :align: left
+   :width: 680px
+
+   Attribute Proximity node with a point cloud as Target.
\ No newline at end of file


Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_proximity.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst	2021-03-08 19:27:16 UTC (rev 7808)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst	2021-03-08 20:35:39 UTC (rev 7809)
@@ -12,6 +12,7 @@
    attribute_fill.rst
    attribute_math.rst
    attribute_mix.rst
+   attribute_proximity.rst
    attribute_randomize.rst
    attribute_sample_texture.rst
    attribute_vector_math.rst



More information about the Bf-docboard-svn mailing list