[Bf-docboard-svn] bf-manual: [7223] trunk/blender_docs/manual/modeling: Modeling: New Boolean Solver

[Aaron Carlisle]

Revision: 7223
          https://developer.blender.org/rBM7223
Author:   Blendify
Date:     2020-10-13 19:54:24 +0200 (Tue, 13 Oct 2020)
Log Message:
-----------
Modeling: New Boolean Solver

rB9e09b5c418c0a436e3c84ccf38c065527988b0a0

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_boolean.rst
    trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_knife.rst
    trunk/blender_docs/manual/modeling/modifiers/generate/booleans.rst

Modified: trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_boolean.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_boolean.rst	2020-10-13 17:23:24 UTC (rev 7222)
+++ trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_boolean.rst	2020-10-13 17:54:24 UTC (rev 7223)
@@ -16,14 +16,28 @@
 
 Boolean
    Difference, Union, Intersect
+
 Swap
    Changes the order of the operation.
-Merge Threshold
-   Tolerance for close faces to be considered touching.
-   It may be useful to increase this when some intersections aren't detected that should be and
-   when extra geometry is being created because edges aren't detected as overlapping.
 
-   .. warning::
+Solver
+   Algorithm used to calculate the boolean intersections.
 
-      A threshold approaching the size of faces may cause very slow calculation,
-      in general keep this value small.
+   Fast
+      Uses a mathematically simple solver which offers the best performance;
+      however, this solver lacks support for overlapping geometry.
+
+      Merge Threshold
+         Tolerance for close faces to be considered touching.
+         It may be useful to increase this when some intersections aren't detected that should be and
+         when extra geometry is being created because edges aren't detected as overlapping.
+
+         .. warning::
+
+            A threshold approaching the size of faces may cause very slow calculation,
+            in general keep this value small.
+
+   Exact
+      Uses a mathematically complex solver which offers the best results
+      and has full support for overlapping geometry;
+      however, this solver is much slower than the *Fast Solver*.

Modified: trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_knife.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_knife.rst	2020-10-13 17:23:24 UTC (rev 7222)
+++ trunk/blender_docs/manual/modeling/meshes/editing/face/intersect_knife.rst	2020-10-13 17:54:24 UTC (rev 7223)
@@ -19,6 +19,7 @@
       Operate between the selected and unselected geometry.
    Self Intersect
       Operate on the overlapping geometry of the mesh.
+
 Separate Mode
    All
       Splits the geometry at the new edge.
@@ -26,5 +27,25 @@
       Keep each side of the intersection separate without splitting the faces in half.
    Merge
       Merge all the geometry from the intersection.
-Merge Threshold
-   See Intersect (Boolean).
+
+Solver
+   Algorithm used to calculate the intersections.
+
+   Fast
+      Uses a mathematically simple solver which offers the best performance;
+      however, this solver lacks support for overlapping geometry.
+
+      Merge Threshold
+         Tolerance for close faces to be considered touching.
+         It may be useful to increase this when some intersections aren't detected that should be and
+         when extra geometry is being created because edges aren't detected as overlapping.
+
+         .. warning::
+
+            A threshold approaching the size of faces may cause very slow calculation,
+            in general keep this value small.
+
+   Exact
+      Uses a mathematically complex solver which offers the best results
+      and has full support for overlapping geometry;
+      however, this solver is much slower than the *Fast Solver*.

Modified: trunk/blender_docs/manual/modeling/modifiers/generate/booleans.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/generate/booleans.rst	2020-10-13 17:23:24 UTC (rev 7222)
+++ trunk/blender_docs/manual/modeling/modifiers/generate/booleans.rst	2020-10-13 17:54:24 UTC (rev 7223)
@@ -52,5 +52,19 @@
 Object
    The name of the target mesh object.
 
-Overlap Threshold
-   Maximum distance between two faces to consider them as overlapping.
+Solver
+   Algorithm used to calculate the boolean intersections.
+
+   Fast
+      Uses a mathematically simple solver which offers the best performance;
+      however, this solver lacks support for overlapping geometry.
+
+      Overlap Threshold
+         Maximum distance between two faces to consider them as overlapping.
+         This helps solve the limitation of this solver,
+         if the boolean result seems unexpected try using the exact solver.
+
+   Exact
+      Uses a mathematically complex solver which offers the best results
+      and has full support for overlapping geometry;
+      however, this solver is much slower than the *Fast Solver*.