1 .. |bool_common.icon| image:: images/bool_common.png
9 Common feature implements a Boolean operation for extraction of a common part from a set of selected shapes.
11 To perform a Common operation in the active part:
13 #. select in the Main Menu *Features - > Common* item or
14 #. click |bool_common.icon| **Common** button in the toolbar
16 There are 2 options for creation of a Common:
18 .. figure:: images/bool_common_simple.png
22 **Simple** common part between all selected objects.
24 .. figure:: images/bool_common_advanced.png
28 **Advanced** common part for each object between this object and all tools.
30 --------------------------------------------------------------------------------
35 .. figure:: images/boolean_common_simple_property_panel.png
40 - **Objects** contains a list of objects selected in the Object Browser or in the Viewer.
41 If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be ignored.
42 - **Fuzzy Parameter** defines the additional tolerance value used to eliminate tiny results.
43 - **See preview** button shows a result of the operation.
47 .. py:function:: model.addCommon(Part_doc, objects, fuzzy)
49 :param part: The current part object
50 :param list: A list of objects.
51 :param real: Additional tolerance used to eliminate tiny results (optional).
52 :return: Created object
57 The Result of the operation will be a shape which is a common for all selected shapes:
59 .. figure:: images/CreatedCommon.png
64 **See Also** a sample TUI Script of :ref:`tui_create_common` operation.
69 .. figure:: images/boolean_common_advanced_property_panel.png
74 - **Objects** contains a list of objects selected in the Object Browser or in the Viewer.
75 If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be cut from
76 other objects (to avoid self-intersection) and added to the result.
77 - **Tools** contains a list of objects selected in the Object Browser or in the Viewer, which will be intersected with tool objects.
78 If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be ignored.
79 - **Fuzzy Parameter** defines the additional tolerance value used to eliminate tiny results.
80 - **See preview** button shows a result of the operation.
82 Any kind of shape is supported as an object or a tool of Common. Moreover, constructions planes can be selected as tools.
86 .. py:function:: model.addCommon(Part_doc, objects, tools, fuzzy)
88 :param part: The current part object
89 :param list: A list of objects.
90 :param list: A list of tools.
91 :param real: Additional tolerance used to eliminate tiny results (optional).
92 :return: Created object
97 For each selected object, the common part between this object and all tools will be found:
99 .. figure:: images/boolean_common_result.png
104 **See Also** a sample TUI Script of :ref:`tui_create_common` operation.