/*!

\page fuse_operation_page Fuse

\b Fuse operation creates one shape from a list of shapes.

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 the corresponding check-box if you wish to use a <b> fuzzy parameter </b>.  
  If activated, you can define the fuzzy tolerance in the <b> fuzzy parameter </b> input box.
- 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, name, fuzzyParam)</em>

<b>Arguments:</b> a list of shapes + an optional flag for self-intersection
check + an optional flag to remove extra edges + an optional name + an optional fuzzy parameter.

There is also a special <b>TUI Command</b> for \b Fuse operation on two shapes  :

<em>geompy.MakeFuse(s1, s2, checkSelfInte, rmExtraEdges, name, fuzzyParam)</em>

<b>Arguments:</b> 2 shapes + an optional flag for self-intersection
check + an optional flag to remove extra edges + an optional name + an optional fuzzy parameter.

<b>Example:</b>

\image html fusesn1.png "The initial shapes"

\image html fusesn2.png "The resulting fuse"

Our <b>TUI Scripts</b> provide you with useful examples of the use of
\ref tui_fuse "Boolean Operations".

<b> More details </b>

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.

Perhaps you also ask yourself : \ref partition_explanation "What is the difference between partition, compounds and fuse operation ?"

*/