[Bf-docboard-svn] bf-manual: [8534] trunk/blender_docs/manual: Geometry Nodes: Complete geometry proximity page with examples

[Hans Goudey]

Revision: 8534
          https://developer.blender.org/rBM8534
Author:   HooglyBoogly
Date:     2021-10-27 07:01:08 +0200 (Wed, 27 Oct 2021)
Log Message:
-----------
Geometry Nodes: Complete geometry proximity page with examples

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_proximity.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_example.png
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_modes.png

Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_example.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_example.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_example.png	2021-10-27 05:00:33 UTC (rev 8533)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_example.png	2021-10-27 05:01:08 UTC (rev 8534)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_example.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_modes.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_modes.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_modes.png	2021-10-27 05:00:33 UTC (rev 8533)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_modes.png	2021-10-27 05:01:08 UTC (rev 8534)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry-proximity_modes.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_proximity.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_proximity.rst	2021-10-27 05:00:33 UTC (rev 8533)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_proximity.rst	2021-10-27 05:01:08 UTC (rev 8534)
@@ -7,13 +7,17 @@
 
 
 .. figure:: /images/modeling_geometry-nodes_geometry_geometry-proximity_node.png
-   :align: right
+   :align: center
 
    The Geometry Proximity node.
 
-The *Geometry Proximity* node finds the closest location on the target.
+The *Geometry Proximity* node finds the closest location on the target geometry.
 
+.. tip::
 
+   The :doc:`/modeling/geometry_nodes/utilities/map_range` is often helpful to use with the distance
+   output of this node to create a falloff with a maximum distance.
+
 Inputs
 ======
 
@@ -26,17 +30,39 @@
 Properties
 ==========
 
-Target Geometry
-   :Points: Calculate the proximity to the target's points (faster than the other modes).
-   :Edges: Calculate the proximity to the target's edges.
-   :Faces: Calculate the proximity to the target's faces.
+Target Element
+   :Faces:
+      Calculate the closest point anywhere on the faces of the target's mesh geometry.
+   :Edges:
+      Calculate the closest point anywhere on the edges of the target's mesh geometry.
+   :Points:
+      Calculate the closest point or vertex on the target geometry. This mode is usually the fastest.
+      This mode works for both point cloud and mesh geometry, the other modes only work for meshes.
 
-
 Outputs
 =======
 
 Position
-   Closest location in the target.
+   Closest location on the surface of the target mesh, or the closest point in the target point cloud
+   in *Points* mode.
 
 Distance
    Distance (as floating-point value) from the source position to the closest location in the target.
+
+
+Examples
+========
+
+The different modes of the node: faces, edges and points.
+In this example the geometry nodes modifier is added on the larget plane.
+Note that the larger plane is subdivided and the smaller plane is not.
+
+.. figure:: /images/modeling_geometry-nodes_geometry-proximity_modes.png
+   :align: center
+
+   The three target element modes: faces, edges, and points
+
+.. figure:: /images/modeling_geometry-nodes_geometry-proximity_example.png
+   :align: center
+
+   Points distributed on a sphere used as a target for a distance used in a shader.