Salome HOME
Merge remote branch 'origin/akl/22379'
[modules/geom.git] / doc / salome / gui / GEOM / input / fuse_operation.doc
index df13c732e94fd22158646628922b06e603064669..e0a31b777c2a457f41675b66fbc0525bf8ee1495 100644 (file)
@@ -2,11 +2,40 @@
 
 \page fuse_operation_page Fuse
 
-To produce a \b Fuse operation in the <b>Main Menu</b> select
-<b>Operations - > Boolean - > Fuse</b>. 
+\b Fuse operation creates one shape from a list of shapes.
 
-This operation creates one shape from two shapes.
-The \b Result will be any \b GEOM_Object.
+To produce it, select in the Main Menu <b>Operations - > Boolean - > Fuse</b>.
+
+\image html bool1.png "Fuse dialog"
+
+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 <b>Objects</b> to be fused.
+- Activate the corresponding check-box if you wish to <b> Detect Self-intersections </b>.
+- Activate the corresponding check-box if you wish to <b> remove extra edges </b>.
+- Activate \ref restore_presentation_parameters_page "Advanced options" if required.
+- Press "Apply" or "Apply & Close" button to get the result (GEOM_Object).
+
+\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 <b>TUI Command:</b> 
+
+<em>geompy.MakeFuseList(theShapesList, checkSelfInte, rmExtraEdges)</em>
+
+<b>Arguments:</b> Name + a list of shapes + an optional flag for
+self-intersection check + an optional flag to remove extra edges.
+
+There is also a special <b>TUI Command</b> for \b Fuse operation on two shapes  :
+
+<em>geompy.MakeFuse(s1, s2, checkSelfInte, rmExtraEdges)</em>
+
+<b>Arguments:</b> Name + 2 shapes + an optional flag for self-intersection
+check + an optional flag to remove extra edges.
 
 <b>Example:</b>
 
@@ -14,24 +43,17 @@ The \b Result will be any \b GEOM_Object.
 
 \image html fusesn2.png "The resulting fuse"
 
-<b>TUI Command:</b> <em>geompy.MakeFuse(s1, s2)</em>\n
-<b>Arguments:</b> Name + 2 shapes.\n
-<b>Advanced option:</b>
-\ref restore_presentation_parameters_page "Set presentation parameters and sub-shapes from arguments".
-
-\image html bool1.png
-
-Our <b>TUI Scripts</b> provide you with useful examples of the use of 
+Our <b>TUI Scripts</b> provide you with useful examples of the use of
 \ref tui_fuse "Boolean Operations".
 
 <b> More details </b>
-<ul>
-  <li>For a detailed description of the Boolean operations please refer to
-<a href="SALOME_BOA_PA.pdf">this document</a>. 
+
+Please, refer to <a href="SALOME_BOA_PA.pdf">this document</a> 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.</li>
-  <li>Perhaps you also ask yourself : \ref partition_explanation "What is the difference between partition, compounds and fuse operation ?"</li>
-</ul>
+major limitations of these operations.
+
+Perhaps you also ask yourself : \ref partition_explanation "What is the difference between partition, compounds and fuse operation ?"
 
 */