geom/doc/salome/gui/GEOM/input/section_operation.doc

/*!

\page section_operation_page Intersection

\b Intersection operation creates a vertex, an edge, a wire or a compound
of them representing the intersection of two shapes.

To produce it, select in the main menu <b>Operations - > Boolean - > Intersection</b>

\image html neo-section.png "Intersection 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 intersecting <b>Objects</b>.
- Activate the corresponding check-box if you wish to <b> Detect Self-intersections</b>. If a self-intersection detected the operation fails.
- 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 (VERTEX, EDGE, WIRE or COMPOUND).

\note This dialog supports navigation through the selectable objects (in OCC 3D viewer only):
- Scroll mouse wheel with pressed \em Ctrl key or press \em "S", \em "P" keys when input focus is
in the viewer to navigate between selectable objects.
- Press left mouse button to select an appropriate object to the dialog box.
.
For more details, please refer to the \em "Functionality common for OCC and VTK viewers" chapter
of the GUI module's documentation.

This operation can be performed using a <b>TUI Command:</b> 

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

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

<b>Example:</b>

\image html fusesn1.png "The initial shapes"

\image html sectionsn.png "The resulting object"

Our <b>TUI Scripts</b> provide you with useful examples of the use of
\ref tui_section "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.

*/