[Bf-docboard-svn] bf-manual: [8875] trunk/blender_docs: Geometry Nodes: Generalized Compare Node
Hans Goudey
noreply at blender.org
Wed Jan 26 00:35:33 CET 2022
Revision: 8875
https://developer.blender.org/rBM8875
Author: HooglyBoogly
Date: 2022-01-26 00:35:32 +0100 (Wed, 26 Jan 2022)
Log Message:
-----------
Geometry Nodes: Generalized Compare Node
Also redirect the removed "compare floats" page to the
page for the compare node.
rB17578408434fafd2463ed253eebb5cb1412a6c67
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/separate_geometry.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst
trunk/blender_docs/resources/.htaccess
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_direction.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_node.png
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare.rst
Removed Paths:
-------------
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_floats.rst
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_direction.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_direction.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_direction.png 2022-01-25 22:16:18 UTC (rev 8874)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_direction.png 2022-01-25 23:35:32 UTC (rev 8875)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_direction.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_utilities_compare_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_node.png 2022-01-25 22:16:18 UTC (rev 8874)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_node.png 2022-01-25 23:35:32 UTC (rev 8875)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_compare_node.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/separate_geometry.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/separate_geometry.rst 2022-01-25 22:16:18 UTC (rev 8874)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/separate_geometry.rst 2022-01-25 23:35:32 UTC (rev 8875)
@@ -15,8 +15,7 @@
.. tip::
- This node can be combined with
- the :doc:`Compare Floats </modeling/geometry_nodes/utilities/compare_floats>` node
+ This node can be combined with the :doc:`/modeling/geometry_nodes/utilities/compare`
for a more precise control of which parts are separated to a given output geometry.
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare.rst (from rev 8874, trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_floats.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare.rst 2022-01-25 23:35:32 UTC (rev 8875)
@@ -0,0 +1,84 @@
+.. index:: Geometry Nodes; Compare
+.. _bpy.types.FunctionNodeCompare:
+
+************
+Compare Node
+************
+
+.. figure:: /images/modeling_geometry-nodes_utilities_compare_node.png
+ :align: center
+
+ Compare Node.
+
+The *Compare* node takes two inputs and does an operation to determine whether they are similar.
+The node can work on all generic data types, and has modes for vectors that contain more complex
+comparisons, which can help to reduce the number of necessary nodes, and make a node tree more readable.
+
+
+Inputs
+======
+
+A, B
+ Standard value inputs of the selected type.
+C
+ Compared against the dot product of two input vectors in when the *Mode* property is set to *Dot Product*.
+Epsilon
+ This value is used as a threshold for still considering the two inputs as equal
+ for the Equal and Not Equal operations.
+
+
+Properties
+==========
+
+Mode
+ :Element-Wise:
+ Compare each axis of the input vectors separately, and output true only when the result is true
+ for each axis.
+ :Length:
+ Compare the length of the two input vectors.
+ :Average:
+ Compare the average of the elements of the input vectors. This is the same as the implicit
+ conversion used when setting the node's data type to *Float*.
+ :Dot Product:
+ Compare the dot product of the two vectors with the separate *C* input, using the selected operation.
+ The dot product outputs a single value that says how much the two vectors "agree".
+ :Direction:
+ Compare the angle between the two vectors with the separate *Angle* input, using the selected operation.
+ The vectors are normalized, so their length does not matter.
+
+Operation
+ :Less Than:
+ True when the first input is smaller than second input.
+ :Less Than or Equal:
+ True when the first input is smaller than the second input or equal.
+ :Greater Than:
+ True when the first input is greater than the second input.
+ :Greater Than or Equal:
+ True when the first input is greater than the second input or equal.
+ :Equal:
+ True when both the difference between the two inputs is smaller than the *Epsilon* input.
+ :Not Equal:
+ True when both the difference between the two inputs is larger than the *Epsilon* input.
+ :Brighter:
+ True when the first color input is brighter than the second.
+ :Darker:
+ True when the first color input is darker than the second.
+
+
+Output
+======
+
+Result
+ Standard Boolean output.
+
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_utilities_compare_direction.png
+ :align: center
+
+Here, the compare node is used with the *Direction* mode to compare the direction of the
+sphere's :doc:`face normals </modeling/geometry_nodes/input/normal>` to the "direction"
+of the cube object's location. Anywhere that the directions are less than 32.9 degrees apart,
+the faces will be selected, and deleted.
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_floats.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_floats.rst 2022-01-25 22:16:18 UTC (rev 8874)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_floats.rst 2022-01-25 23:35:32 UTC (rev 8875)
@@ -1,42 +0,0 @@
-.. index:: Geometry Nodes; Compare Floats
-.. _bpy.types.FunctionNodeCompareFloats:
-
-*******************
-Compare Floats Node
-*******************
-
-.. figure:: /images/modeling_geometry-nodes_utilities_float-compare_node.png
- :align: right
-
- Compare Floats Node.
-
-The *Compare Floats* node takes two inputs and does a math comparison between them.
-
-
-Inputs
-======
-
-A, B
- Standard float value input.
-Epsilon
- This value is used as a threshold for still considering the two inputs as equal
- for the Equal and Not Equal operations.
-
-
-Properties
-==========
-
-Mode
- :Less Than: True if A is smaller than B.
- :Less than or Equal: True if A is smaller or equal to B.
- :Greater Than: True if A is bigger than B.
- :Greater than or Equal: True if A is bigger or equal to B.
- :Equal: True if A and B are the same.
- :Not Equal: True if A and B are different.
-
-
-Output
-======
-
-Result
- Standard Boolean output.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst 2022-01-25 22:16:18 UTC (rev 8874)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst 2022-01-25 23:35:32 UTC (rev 8875)
@@ -11,7 +11,7 @@
align_euler_to_vector.rst
boolean_math.rst
clamp.rst
- compare_floats.rst
+ compare.rst
float_curve.rst
float_to_integer.rst
map_range.rst
Modified: trunk/blender_docs/resources/.htaccess
===================================================================
--- trunk/blender_docs/resources/.htaccess 2022-01-25 22:16:18 UTC (rev 8874)
+++ trunk/blender_docs/resources/.htaccess 2022-01-25 23:35:32 UTC (rev 8875)
@@ -2,3 +2,4 @@
ErrorDocument 404 /manual/en/3.1/404.html
RedirectMatch \"^/manual/en/3.1/addons/import_export/io_(.*)\" \"/manual/en/3.1/addons/import_export/$1\"
RedirectMatch \"^/manual/{lang}/{version}/modeling/geometry_nodes/curve/curve_parameter.html\" \"/manual/{lang}/{version}/modeling/geometry_nodes/curve/spline_parameter.html\"
+RedirectMatch \"^/manual/{lang}/{version}/modeling/geometry_nodes/utilities/compare_floats.html\" \"/manual/{lang}/{version}/modeling/geometry_nodes/utilities/compare.html\"
More information about the Bf-docboard-svn
mailing list