doc/salome/gui/GEOM/input/fuse_operation.doc

   1 /*!
   2
   3 \page fuse_operation_page Fuse
   4
   5 To produce a \b Fuse operation in the <b>Main Menu</b> select
   6 <b>Operations - > Boolean - > Fuse</b>.
   7
   8 This operation creates one shape from a list of shapes.
   9
  10 The \b Result will be a \b GEOM_Object.
  11
  12 <b>TUI Command:</b> <em>geompy.MakeFuseList(theShapesList, checkSelfInte)</em>\n
  13 <b>Arguments:</b> Name + a list of shapes + an optional flag for self-intersection check.\n
  14 <b>Advanced option:</b>
  15 \ref restore_presentation_parameters_page "Set presentation parameters and sub-shapes from arguments".
  16
  17 \image html bool1.png "Fuse dialog"
  18
  19 \note This algorithm doesn't find all types of self-intersections. It is tuned
  20       to detect vertex/vertex, vertex/edge, edge/edge, vertex/face and edge/face
  21       intersections. Face/face intersections detection is switched off as it
  22       is a time-consuming operation that gives an impact on performance. To find
  23       all self-intersections please use \ref check_self_intersections_page
  24       "Detect Self-intersection tool".
  25
  26 For a particular case with two shapes to be fused there is the following TUI command:
  27
  28 <b>TUI Command:</b> <em>geompy.MakeFuse(s1, s2, checkSelfInte)</em>\n
  29 <b>Arguments:</b> Name + 2 shapes + an optional flag for self-intersection check.
  30
  31 <b>Example:</b>
  32
  33 \image html fusesn1.png "The initial shapes"
  34
  35 \image html fusesn2.png "The resulting fuse"
  36
  37 Our <b>TUI Scripts</b> provide you with useful examples of the use of
  38 \ref tui_fuse "Boolean Operations".
  39
  40 <b> More details </b>
  41 <ul>
  42   <li>For a detailed description of the Boolean operations please refer to
  43 <a href="SALOME_BOA_PA.pdf">this document</a>.
  44 It provides a general review of the Partition and Boolean
  45 operations algorithms, describes the usage methodology and highlights
  46 major limitations of these operations.</li>
  47   <li>Perhaps you also ask yourself : \ref partition_explanation "What is the difference between partition, compounds and fuse operation ?"</li>
  48 </ul>
  49
  50 */