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=a0e22ed86a0df64143edb095e07295a014b32c88;hp=628992bba431f3e95bf3963a53d35aa3d08e403e;hpb=265dfeb97b0a5da55c2dfa2ac96666c7e2a5164e;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 628992bba..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,7 +23,7 @@ a list of others. You can use advanced TUI commands performing these operations independently from each other: \par -geompy.MakeFuseList(theShapesList, checkSelfInte), where \em theShapesList is +geompy.MakeFuseList(theShapesList, checkSelfInte, rmExtraEdges), where \em theShapesList is the list of shapes for Fuse operation; \par geompy.MakeCommonList(theShapesList, checkSelfInte), where \em theShapesList is @@ -44,14 +44,14 @@ operation. \par 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, checkSelfInte), 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, checkSelfInte), where \em Shape1 is the first @@ -60,12 +60,29 @@ argument and \em Shape2 is the second argument of Common operation; 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 tells whether arguments should be checked for -self-intersection prior to an operation. Its default value is \em False which +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 these shapes are +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".