[Bf-docboard-svn] bf-manual: [7501] trunk/blender_docs/manual: Geometry Nodes: Point separate and attribute compare nodes
Hans Goudey
noreply at blender.org
Thu Dec 17 20:06:22 CET 2020
Revision: 7501
https://developer.blender.org/rBM7501
Author: HooglyBoogly
Date: 2020-12-17 20:06:22 +0100 (Thu, 17 Dec 2020)
Log Message:
-----------
Geometry Nodes: Point separate and attribute compare nodes
48ddb94a26611a27d24ec02c2275b4f1fe27f87f
More information might be useful on these pages, as well as an example image possibly, but with
this commit they contain the basics.
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/modifiers/nodes/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute_compare.png
trunk/blender_docs/manual/images/modeling_modifiers_nodes_point_separate.png
trunk/blender_docs/manual/modeling/modifiers/nodes/attribute/attribute_compare.rst
trunk/blender_docs/manual/modeling/modifiers/nodes/point/point_separate.rst
Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute_compare.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute_compare.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute_compare.png 2020-12-17 13:38:59 UTC (rev 7500)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute_compare.png 2020-12-17 19:06:22 UTC (rev 7501)
Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_attribute_compare.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_modifiers_nodes_point_separate.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_modifiers_nodes_point_separate.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_modifiers_nodes_point_separate.png 2020-12-17 13:38:59 UTC (rev 7500)
+++ trunk/blender_docs/manual/images/modeling_modifiers_nodes_point_separate.png 2020-12-17 19:06:22 UTC (rev 7501)
Property changes on: trunk/blender_docs/manual/images/modeling_modifiers_nodes_point_separate.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/modifiers/nodes/attribute/attribute_compare.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/nodes/attribute/attribute_compare.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/modifiers/nodes/attribute/attribute_compare.rst 2020-12-17 19:06:22 UTC (rev 7501)
@@ -0,0 +1,53 @@
+.. index:: Nodes; Point Separate
+.. _bpy.types.GeometryNodeAttributeCompare:
+
+*****************
+Attribute Compare
+*****************
+
+This node reads two input attributes as floats and allows for basic element-wise comparison operations.
+Like the :doc:`Attribute Math </modeling/modifiers/nodes/attribute/attribute_math>` node, it is also
+possible to switch to using single values for inputs. This node can be combined with the
+:doc:`Point Separate </modeling/modifiers/nodes/point/point_separate>` node for more flexibility
+for which points to separate out.
+
+
+.. figure:: /images/modeling_modifiers_nodes_attribute_compare.png
+
+ The attribute compare node.
+
+Inputs
+======
+
+Geometry
+ The geometry that is modified.
+
+A
+ The first input to the math operation.
+ Depending on the *Type* input, this is either an attribute name or an input of the specified data type.
+
+B
+ The second input to the math operation.
+ Depending on the *Type* input, this is either an attribute name or an input of the specified data type.
+
+Epsilon
+ For the *Equal* and *Not Equal* operations, this value is used as a threshold for deciding whether
+ two inputs are equal.
+
+Result
+ Name of the attribute where the computed result it stored.
+ If an attribute with this name does not exist yet, a new attribute with a boolean data type is added.
+ If it does exist, the values of the existing attribute are overridden.
+
+Properties
+==========
+
+Operation
+ The math function to execute.
+
+ .. note::
+ For operations besides "Equal" and "Not Equal", the input attributes are converted implicitly
+ to the float data type. For the equality operations on vectors, the distance between the vector inputs are used.
+
+Type A / Type B
+ Contols whether to use an attribute or a single value of the specified data type as an input.
Property changes on: trunk/blender_docs/manual/modeling/modifiers/nodes/attribute/attribute_compare.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/modifiers/nodes/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/nodes/index.rst 2020-12-17 13:38:59 UTC (rev 7500)
+++ trunk/blender_docs/manual/modeling/modifiers/nodes/index.rst 2020-12-17 19:06:22 UTC (rev 7501)
@@ -18,6 +18,7 @@
.. toctree::
:maxdepth: 1
+ attribute/attribute_compare.rst
attribute/attribute_fill.rst
attribute/attribute_math.rst
attribute/attribute_mix.rst
@@ -81,8 +82,9 @@
.. toctree::
:maxdepth: 1
+ point/point_distribute.rst
point/point_instance.rst
- point/point_distribute.rst
+ point/point_separate.rst
Utilities
Added: trunk/blender_docs/manual/modeling/modifiers/nodes/point/point_separate.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/nodes/point/point_separate.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/modifiers/nodes/point/point_separate.rst 2020-12-17 19:06:22 UTC (rev 7501)
@@ -0,0 +1,48 @@
+.. index:: Nodes; Point Separate
+.. _bpy.types.GeometryNodePointSeparate:
+
+**************
+Point Separate
+**************
+
+The *Point Separate* produces two output geometries. Based on the *threshold* and the input *attribute*,
+the point cloud component of the input geometry is split between the two outputs.
+
+.. figure:: /images/modeling_modifiers_nodes_point_separate.png
+
+ The Point Separate node.
+
+.. Don't show this yet because there are no other data types in the geometry socket at this point.
+.. .. note::
+
+.. Every other data type in the geometry besides the point cloud will be moved to both of the
+.. outputs unchanged. For example, if the geometry contains a mesh component, the same mesh will
+.. be moved to both outputs, unaffected by the split.
+
+.. tip::
+
+ This node can be combined with the
+ :doc:`Attribute Compare </modeling/modifiers/nodes/attribute/attribute_compare>`
+ node for more precise control of which points are separated to a given output geometry.
+
+
+
+Inputs
+=======
+
+Mask
+ The name of the attribute used to calculate which geometry output each point will belong to.
+ Any value of "true" will move to the second output, and any value of "false" will move the point
+ to the first output.
+
+ If the attribute has any data type besides boolean, the value will be implicitly converted, so a
+ value of exactly zero is false, and any other value is true.
+
+Outputs
+=======
+
+Geometry 1
+ Points with a mask attribute value of "true" will be moved to the first input.
+
+Geometry 2
+ Points with a mask attribute value of "false" will be moved to the first input.
\ No newline at end of file
Property changes on: trunk/blender_docs/manual/modeling/modifiers/nodes/point/point_separate.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
More information about the Bf-docboard-svn
mailing list