[Bf-docboard-svn] bf-manual: [8585] branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst: Geometry Nodes: Add special domain interpolation for selections

[Hans Goudey]

Revision: 8585
          https://developer.blender.org/rBM8585
Author:   HooglyBoogly
Date:     2021-11-03 22:42:49 +0100 (Wed, 03 Nov 2021)
Log Message:
-----------
Geometry Nodes: Add special domain interpolation for selections

rB5841f8656d9580d7b967d477b142f19364ec39b5

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

Modified: branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst	2021-11-03 21:14:30 UTC (rev 8584)
+++ branches/blender-3.0-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst	2021-11-03 21:42:49 UTC (rev 8585)
@@ -70,11 +70,96 @@
   An example is a UV map attribute.
 - **Spline** domain attributes are associated with a group of connected curve control points.
 
-.. note::
+Attributes are automatically interpolated to other domains. For example, when the 
+:doc:`/modeling/geometry_nodes/input/position` is connected to the selection input of
+the :doc:`/modeling/geometry_nodes/material/set_material` node, the values are interpolated
+from the *Point* domain to the *Face* domain. Normally, domain conversions use simple averages
+for values, but *Boolean* data type attributes have special rules for interpolation:
 
-   For point cloud objects, every attribute has the *point* domain.
+Boolean Domain Interpolation
+----------------------------
 
+.. list-table::
+   :header-rows: 1
+   :widths: 10 10 50
 
+   * - From
+     - To
+     - Conversion
+
+   * - Point
+     - Edge
+     - An edge is selected if both of its vertices were selected.
+
+   * - Point
+     - Face
+     - A face is selected if all of its vertices were selected too.
+
+   * - Point
+     - Corner
+     - Each corner's value is simply a copy of the value at its vertex.
+
+   * - Point
+     - Spline
+     - A spline is selected if all of its control points were selected.
+
+   * -
+     -
+     -
+
+   * - Edge
+     - Point
+     - A vertex is selected if any connected edge was selected.
+
+   * - Edge
+     - Face
+     - A face is selected if all of its edges are selected
+
+   * - Edge
+     - Corner
+     - A corner is selected if its two adjacent edges were selected.
+
+   * -
+     -
+     -
+
+   * - Face
+     - Point
+     - A vertex is selected if any of the connected faces were selected.
+
+   * - Face
+     - Edge
+     - An edge is selected if any connected face was selected.
+
+   * - Face
+     - Edge
+     - Each corner's value is simply a copy of the value at its face.
+
+   * -
+     -
+     -
+
+   * - Corner
+     - Point
+     - A vertex is selected if all connected face corners were selected and it is not a loose vertex.
+
+   * - Corner
+     - Edge
+     - An edge is selected if all corners on adjacent faces were selected.
+
+   * - Corner
+     - Face
+     - A face is selected if all of its corners were selected.
+
+   * -
+     -
+     -
+
+   * - Spline
+     - Point
+     - Each point's value is simply a copy of the corresponding spline's value.
+
+
 Attribute Data Types
 ====================