1 .. |bool_common.icon| image:: images/bool_common.png
7 Common feature implements a Boolean operation for extraction of a common part from a set of selected shapes.
9 To perform a Common operation in the active part:
11 #. select in the Main Menu *Features - > Common* item or
12 #. click |bool_common.icon| **Common** button in the toolbar
14 There are 2 options for creation of a Common:
16 .. image:: images/bool_common_simple.png
20 **Simple** common part between all selected objects.
22 .. image:: images/bool_common_advanced.png
26 **Advanced** common part for each object between this object and all tools.
28 --------------------------------------------------------------------------------
33 .. image:: images/boolean_common_simple_property_panel.png
39 - **Objects** contains a list of objects selected in the Object Browser or in the Viewer.
40 If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be ignored.
41 - **See preview** button shows a result of the operation.
45 .. py:function:: model.addCommon(Part_doc, objects)
47 :param part: The current part object
48 :param list: A list of objects.
49 :return: Created object
54 The Result of the operation will be a shape which is a common for all selected shapes:
56 .. image:: images/CreatedCommon.png
62 **See Also** a sample TUI Script of :ref:`tui_create_common` operation.
67 .. image:: images/boolean_common_advanced_property_panel.png
73 - **Objects** contains a list of objects selected in the Object Browser or in the Viewer.
74 If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be cut from
75 other objects (to avoid self-intersection) and added to the result.
76 - **Tools** contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects.
77 If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be ignored.
78 - **See preview** button shows a result of the operation.
82 .. py:function:: model.addCommon(Part_doc, objects, tools)
84 :param part: The current part object
85 :param list: A list of objects.
86 :param list: A list of tools.
87 :return: Created object
92 For each selected object, the common part between this object and all tools will be found:
94 .. image:: images/boolean_common_result.png
100 **See Also** a sample TUI Script of :ref:`tui_create_common` operation.