doc/salome/gui/GEOM/input/cut_operation.doc

   1 /*!
   2
   3 \page cut_operation_page Cut
   4
   5 \b Cut operation cuts a shape with a list of other shapes.
   6
   7 To produce it, select in the main menu <b>Operations - > Boolean - > Cut</b>
   8
   9 \image html bool3.png "Cut dialog"
  10
  11 In this dialog:
  12 - Input or accept the default \b Name of the resulting shape.
  13 - Click the arrow button and select in the Object Browser or in the Viewer the <b>Main Object</b>, which will be cut by tool objects.
  14 - Select the <b>Tool objects</b>, which will cut the main object.
  15 - Activate the corresponding check-box if you wish to <b> Detect Self-intersections </b>.
  16 - Activate \ref restore_presentation_parameters_page "Advanced options" if required.
  17 - Press "Apply" or "Apply & Close" button to get the result (GEOM_Object).
  18
  19 \note This algorithm does not 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 use \ref check_self_intersections_page
  24       "Detect Self-intersection tool".
  25
  26 This operation can be performed using a <b>TUI Command:</b>
  27
  28 <em>geompy.MakeCutList(theMainShape, theShapesList, checkSelfInte)</em>
  29
  30 <b>Arguments:</b> Name + a main shape + a list of other shapes + an optional flag for self-intersection check.
  31
  32 There is also a special <b>TUI Command:</b> for the Cut operation on two shapes (object and tool) :
  33
  34 <em>geompy.MakeCut(s1, s2, checkSelfInte)</em>
  35
  36 <b>Arguments:</b> Name + the object + the tool + an optional flag for self-intersection check.
  37
  38 <b>Example:</b>
  39
  40 \image html fusesn1.png "The initial shapes"
  41
  42 \image html cutsn.png "The resulting object"
  43
  44 Our <b>TUI Scripts</b> provide you with useful examples of the use of
  45 \ref tui_cut "Boolean Operations".
  46
  47 <b> More details </b>
  48
  49 Please refer to <a href="SALOME_BOA_PA.pdf">this document</a> for a detailed description of Boolean operations.
  50 It provides a general review of the Partition and Boolean
  51 operations algorithms, describes the usage methodology and highlights
  52 major limitations of these operations.
  53
  54 */