X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fusing_boolean_operations.doc;h=02a30251d246b12be9d52b9451f964e300c99f73;hb=69b2ec02a2002731ceaf0597fa9f4dd9cd57dc91;hp=84301523e8c22a91f813a962cec133b2cd82abfe;hpb=af323ccd1d47fe27b941822a729014c33859acfe;p=modules%2Fgeom.git
diff --git a/doc/salome/gui/GEOM/input/using_boolean_operations.doc b/doc/salome/gui/GEOM/input/using_boolean_operations.doc
index 84301523e..02a30251d 100644
--- a/doc/salome/gui/GEOM/input/using_boolean_operations.doc
+++ b/doc/salome/gui/GEOM/input/using_boolean_operations.doc
@@ -2,10 +2,10 @@
\page using_boolean_operations_page Boolean Operations
-For detail description of the Boolean operations please refer to
+For a detailed description of Boolean operations refer to
this document.
It provides a general review of the Partition and Boolean
-operations algorithms, describes the usage methodology and highlighs
+operations algorithms, describes the usage methodology and highlights
major limitations of these operations.
You can use the following boolean operations for construction of more
@@ -23,17 +23,17 @@ a list of others.
You can use advanced TUI commands performing these operations
independently from each other:
\par
-geompy.MakeFuseList(theShapesList), where \em theShapesList is
+geompy.MakeFuseList(theShapesList, checkSelfInte, rmExtraEdges), where \em theShapesList is
the list of shapes for Fuse operation;
\par
-geompy.MakeCommonList(theShapesList), where \em theShapesList is
+geompy.MakeCommonList(theShapesList, checkSelfInte), where \em theShapesList is
the list of shapes for Common operation;
\par
-geompy.MakeCutList(theMainShape, theShapesList), where \em
+geompy.MakeCutList(theMainShape, theShapesList, checkSelfInte), where \em
theMainShape is the object of the operation and \em theShapesList is
the list of tools for Cut operation;
\par
-geompy.MakeSection(Shape1, Shape2), where \em Shape1 is the first
+geompy.MakeSection(Shape1, Shape2, checkSelfInte), where \em Shape1 is the first
argument and \em Shape2 is the second argument of Section operation;
@@ -42,24 +42,48 @@ with only two arguments. There is a general TUI command covering these
operations, which can be used alongside with separate commands for each
operation.
\par
-geompy.MakeBoolean(Shape1, Shape2, Operation), where \em
+geompy.MakeBoolean(Shape1, Shape2, Operation, checkSelfInte), where \em
Shape1 is the first argument and \em Shape2 is the second argument of
-Boolean operation, \em Operation is a type of the Boolean operation (1
+a Boolean operation, \em Operation is the type of a Boolean operation (1
— Common, 2 — Cut, 3 — Fuse, 4 — Section).
Besides, you can use advanced TUI commands performing these operations
independently from each other:
\par
-geompy.MakeFuse(Shape1, Shape2), where \em Shape1 is the first
+geompy.MakeFuse(Shape1, Shape2, checkSelfInte, rmExtraEdges), where \em Shape1 is the first
argument and \em Shape2 is the second argument of Fuse operation;
\par
-geompy.MakeCommon(Shape1, Shape2), where \em Shape1 is the first
+geompy.MakeCommon(Shape1, Shape2, checkSelfInte), where \em Shape1 is the first
argument and \em Shape2 is the second argument of Common operation;
\par
-geompy.MakeCut(Shape1, Shape2), where \em Shape1 is the first
+geompy.MakeCut(Shape1, Shape2, checkSelfInte), where \em Shape1 is the first
argument and \em Shape2 is the second argument of Cut operation;
+The flag \em checkSelfInte indicates whether the arguments should be checked for
+self-intersection prior to an operation. Its default value is \em False, which
+means that there is no need to check it. This option is provided to ensure that
+an operation is performed on not self-intersected shapes as they are
+not valid for boolean operations.
+
+\note This algorithm does not find all types of self-intersections. It is tuned
+ to detect vertex/vertex, vertex/edge, edge/edge, vertex/face and edge/face
+ intersections. Face/face intersections detection is switched off as it
+ is a time-consuming operation that gives an impact on performance. To find
+ all self-intersections use \ref check_self_intersections_page
+ "Detect Self-intersection tool".
+
+The flag \em rmExtraEdges is used for \em MakeFuseList and \em MakeFuse
+operations only. It indicates if Remove Extra Edges operation should be
+performed during the operation. Its default value is \em False, which
+means that there is no need to do it.
+
+\note \em rmExtraEdges is not available for \em MakeBoolean call with
+ operation type 3 (Fuse). \em MakeBoolean operation doesn't perform
+ Remove Extra Edges. So the call geompy.MakeBoolean(Shape1, Shape2,
+ 3, checkSelfInte) is equivalent to geompy.MakeFuse(Shape1,
+ Shape2, checkSelfInte, False).
+
Our TUI Scripts provide you with useful examples of the use of
\ref tui_boolean_operations_page "Boolean Operations".