X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Ffuse_operation.doc;h=e0a31b777c2a457f41675b66fbc0525bf8ee1495;hb=97d9c2c6b1eb1b8c37b74e9409ebdb89c42c8c27;hp=ece199c5c3832c75a4bfce791340b69ceb37a126;hpb=392885c1a8d50369708bbe5e6b44033ed8b8ba51;p=modules%2Fgeom.git
diff --git a/doc/salome/gui/GEOM/input/fuse_operation.doc b/doc/salome/gui/GEOM/input/fuse_operation.doc
index ece199c5c..e0a31b777 100644
--- a/doc/salome/gui/GEOM/input/fuse_operation.doc
+++ b/doc/salome/gui/GEOM/input/fuse_operation.doc
@@ -2,26 +2,58 @@
\page fuse_operation_page Fuse
-\n To produce a \b Fuse operation in the Main Menu select
-Operations - > Boolean - > Fuse
+\b Fuse operation creates one shape from a list of shapes.
-\n This operation creates a shape from two shapes.
+To produce it, select in the Main Menu Operations - > Boolean - > Fuse.
-\n The \b Result will be any \b GEOM_Object.
-\n TUI Command: geompy.MakeFuse(s1, s2)
-\n Arguments: Name + 2 shapes.
-\n Advanced option:
- \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+\image html bool1.png "Fuse dialog"
-\image html bool1.png
+In this dialog:
+- Input or accept the default \b Name of the resulting shape.
+- Click the arrow button and select in the Object Browser or in the Viewer the Objects to be fused.
+- Activate the corresponding check-box if you wish to Detect Self-intersections .
+- Activate the corresponding check-box if you wish to remove extra edges .
+- Activate \ref restore_presentation_parameters_page "Advanced options" if required.
+- Press "Apply" or "Apply & Close" button to get the result (GEOM_Object).
-\n Example:
+\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".
+
+This operation can be performed using a TUI Command:
+
+geompy.MakeFuseList(theShapesList, checkSelfInte, rmExtraEdges)
+
+Arguments: Name + a list of shapes + an optional flag for
+self-intersection check + an optional flag to remove extra edges.
+
+There is also a special TUI Command for \b Fuse operation on two shapes :
+
+geompy.MakeFuse(s1, s2, checkSelfInte, rmExtraEdges)
+
+Arguments: Name + 2 shapes + an optional flag for self-intersection
+check + an optional flag to remove extra edges.
+
+Example:
\image html fusesn1.png "The initial shapes"
\image html fusesn2.png "The resulting fuse"
-Our TUI Scripts provide you with useful examples of the use of
+Our TUI Scripts provide you with useful examples of the use of
\ref tui_fuse "Boolean Operations".
+ More details
+
+Please, refer to this document for a detailed description of Boolean operations.
+
+It provides a general review of the Partition and Boolean
+operations algorithms, describes the usage methodology and highlights
+major limitations of these operations.
+
+Perhaps you also ask yourself : \ref partition_explanation "What is the difference between partition, compounds and fuse operation ?"
+
*/