/*!
\page common_operation_page Common
\b Common operation cuts the common part of a list of shapes and transforms it into an independent geometrical object.
To produce it, select in the main menu Operations - > Boolean - > Common.
\image html bool2.png "Common 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 Objects the common part which of should be found.
- Activate the corresponding check-box if you wish to Detect Self-intersections
- 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 TUI Command:
geompy.MakeCommonList(theShapesList, checkSelfInte)
Arguments: Name + a list of shapes + an optional flag for self-intersection check.
There is also a special TUI Command for the Common operation on two shapes :
geompy.MakeCommon(s1, s2, checkSelfInte)
Arguments: Name + 2 shapes + an optional flag for self-intersection check.
Example:
\image html fusesn1.png "The initial shapes"
\image html commonsn.png "The resulting object"
Our TUI Scripts provide you with useful examples of the use of
\ref tui_common "Boolean Operations".
More details
Please, refer to this document 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.
*/