2008-03-07 12:45:34 +05:00
|
|
|
/*!
|
|
|
|
|
|
|
|
|
|
\page common_operation_page Common
|
|
|
|
|
|
2013-12-18 20:23:59 +06:00
|
|
|
\b Common operation cuts the common part of a list of shapes and transforms it into an independent geometrical object.
|
2008-03-07 12:45:34 +05:00
|
|
|
|
2013-12-18 20:23:59 +06:00
|
|
|
To produce it, select in the main menu <b>Operations - > Boolean - > Common</b>.
|
2013-05-23 12:42:48 +06:00
|
|
|
|
2013-12-18 20:23:59 +06:00
|
|
|
\image html bool2.png "Common dialog"
|
2012-08-09 13:58:02 +06:00
|
|
|
|
2013-12-18 20:23:59 +06:00
|
|
|
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> the common part which of should be found.
|
|
|
|
|
- Activate the corresponding check-box if you wish to <b> Detect Self-intersections </b>
|
2024-03-09 03:36:58 +05:00
|
|
|
- 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.
|
2013-12-18 20:23:59 +06:00
|
|
|
- Activate \ref restore_presentation_parameters_page "Advanced options" if required.
|
|
|
|
|
- Press "Apply" or "Apply & Close" button to get the result (GEOM_Object).
|
2008-03-07 12:45:34 +05:00
|
|
|
|
2013-10-16 17:22:29 +06:00
|
|
|
|
2013-12-18 20:23:59 +06:00
|
|
|
\note This algorithm does not find all types of self-intersections. It is tuned
|
2013-11-27 14:27:46 +06:00
|
|
|
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
|
2013-12-18 20:23:59 +06:00
|
|
|
all self-intersections use \ref check_self_intersections_page
|
2013-11-27 14:27:46 +06:00
|
|
|
"Detect Self-intersection tool".
|
2013-12-18 20:23:59 +06:00
|
|
|
|
|
|
|
|
|
|
|
|
|
This operation can be performed using a <b>TUI Command:</b>
|
|
|
|
|
|
2024-03-09 03:36:58 +05:00
|
|
|
<em>geompy.MakeCommonList(theShapesList, checkSelfInte, name, fuzzyParam)</em>
|
2013-12-18 20:23:59 +06:00
|
|
|
|
2024-03-09 03:36:58 +05:00
|
|
|
<b>Arguments:</b> a list of shapes + an optional flag for self-intersection check + an optional name + an optional fuzzy parameter.
|
2013-12-18 20:23:59 +06:00
|
|
|
|
|
|
|
|
There is also a special <b>TUI Command</b> for the Common operation on two shapes :
|
2013-11-27 14:27:46 +06:00
|
|
|
|
2024-03-09 03:36:58 +05:00
|
|
|
<em>geompy.MakeCommon(s1, s2, checkSelfInte, name, fuzzyParam)</em>
|
2013-05-23 12:42:48 +06:00
|
|
|
|
2024-03-09 03:36:58 +05:00
|
|
|
<b>Arguments:</b> 2 shapes + an optional flag for self-intersection check + an optional name + an optional fuzzy parameter.
|
2008-03-07 12:45:34 +05:00
|
|
|
|
2012-08-09 13:58:02 +06:00
|
|
|
<b>Example:</b>
|
2008-03-07 12:45:34 +05:00
|
|
|
|
2009-02-13 17:16:39 +05:00
|
|
|
\image html fusesn1.png "The initial shapes"
|
2008-03-07 12:45:34 +05:00
|
|
|
|
2013-10-16 17:22:29 +06:00
|
|
|
\image html commonsn.png "The resulting object"
|
2008-03-07 12:45:34 +05:00
|
|
|
|
|
|
|
|
Our <b>TUI Scripts</b> provide you with useful examples of the use of
|
|
|
|
|
\ref tui_common "Boolean Operations".
|
|
|
|
|
|
2013-05-23 12:42:48 +06:00
|
|
|
<b> More details </b>
|
|
|
|
|
|
2013-12-18 20:23:59 +06:00
|
|
|
Please, refer to <a href="SALOME_BOA_PA.pdf">this document</a> for a detailed description of Boolean operations.
|
2013-05-23 12:42:48 +06:00
|
|
|
It provides a general review of the Partition and Boolean
|
|
|
|
|
operations algorithms, describes the usage methodology and highlights
|
|
|
|
|
major limitations of these operations.
|
|
|
|
|
|
2008-03-07 12:45:34 +05:00
|
|
|
*/
|
