[Bf-docboard-svn] bf-manual: [8888] trunk/blender_docs/manual: Geometry Nodes: Initial merge by distance node

[Hans Goudey]

Revision: 8888
          https://developer.blender.org/rBM8888
Author:   HooglyBoogly
Date:     2022-01-27 00:09:49 +0100 (Thu, 27 Jan 2022)
Log Message:
-----------
Geometry Nodes: Initial merge by distance node

Also fix a copy and paste error in the weld modifier page.

rBec1b0c2014a8b91c27bc5478ffa1ca74b63c64e9
rB0ec94d5359d732c5ed819379d601ab2124798079

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
    trunk/blender_docs/manual/modeling/modifiers/generate/weld.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_node.png
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_points.png
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/merge_by_distance.rst

Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_node.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_node.png	2022-01-26 22:36:40 UTC (rev 8887)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_node.png	2022-01-26 23:09:49 UTC (rev 8888)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_node.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_merge-by-distance_points.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_points.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_points.png	2022-01-26 22:36:40 UTC (rev 8887)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_points.png	2022-01-26 23:09:49 UTC (rev 8888)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_merge-by-distance_points.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/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst	2022-01-26 22:36:40 UTC (rev 8887)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst	2022-01-26 23:09:49 UTC (rev 8888)
@@ -14,6 +14,7 @@
    geometry_proximity.rst
    geometry_to_instance.rst
    join_geometry.rst
+   merge_by_distance.rst
    raycast.rst
    separate_components.rst
    separate_geometry.rst

Added: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/merge_by_distance.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/merge_by_distance.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/merge_by_distance.rst	2022-01-26 23:09:49 UTC (rev 8888)
@@ -0,0 +1,58 @@
+.. index:: Geometry Nodes; Merge by Distance
+.. _bpy.types.GeometryNodeMergeByDistance:
+
+**********************
+Merge by Distance Node
+**********************
+
+.. figure:: /images/modeling_geometry-nodes_geometry_merge-by-distance_node.png
+   :align: right
+
+   The Merge by Distance node.
+
+The *Merge by Distance* node merges selected mesh vertices or point cloud points within a given distance,
+merging surrounding geometry where necessary. This operation is similar to the :ref:`bpy.ops.mesh.remove_doubles`
+operator or the :doc:`/modeling/modifiers/generate/weld`.
+
+
+Inputs
+======
+
+Geometry
+   Standard geometry input.
+
+Selection
+   Boolean field that is true for parts of the geometry to be deleted.
+   Unselected points will be completely unsed for the operation--
+   they will not be merged into other points, and no points will merge into them either.
+
+   .. tip::
+
+      When possible, using the selection input can be a simple way to speed up the node,
+      since searching for nearby points is a relatively expensive operation that gets even
+      more expensive when more points are involved.
+
+Distance
+    The distance to use for searching for nearby points.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Output
+======
+
+Geometry
+   Standard geometry output.
+
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_geometry_merge-by-distance_points.png
+   :align: center
+
+   Using the selection input to only merge some of the points in a point cloud.


Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/merge_by_distance.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/modifiers/generate/weld.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/generate/weld.rst	2022-01-26 22:36:40 UTC (rev 8887)
+++ trunk/blender_docs/manual/modeling/modifiers/generate/weld.rst	2022-01-26 23:09:49 UTC (rev 8888)
@@ -36,6 +36,6 @@
 
    Invert ``<->``
       Inverts the influence of the selected vertex group, meaning that the group
-      now represents vertices that will not be deformed by the modifier.
+      now represents vertices that will not be merged by the modifier.
 
       The setting reverses the weight values of the group.