src/FeaturesPlugin/doc/unionFeature.rst

   1 .. |union_btn.icon|    image:: images/union_btn.png
   2
   3 .. _featureUnion:
   4
   5 Union
   6 =====
   7
   8 **Caution**. This operation is obsolete. Fuse operation should be used instead.
   9
  10 Union feature implements a Boolean operation for creation of a union of selected objects.
  11
  12 To create a Union in the active part:
  13
  14 #. select in the Main Menu *Features - > Union* item  or
  15 #. click |union_btn.icon| **Union** button in the toolbar
  16
  17 The following property panel will be opened:
  18
  19 .. figure:: images/Union.png
  20    :align: center
  21
  22    **Union operation**
  23
  24 Here it is necessary to select some objects. Only faces with shared edges or solids with shared faces are allowed for selection.
  25
  26 **Apply** button creates a union shape.
  27
  28 **Cancel** button cancels the operation.
  29
  30 **TUI Command**:
  31
  32 .. py:function:: model.addUnion(Part_doc, objects)
  33
  34     :param part: The current part object.
  35     :param objects: A list of objects.
  36     :return: Result object.
  37
  38 Result
  39 """"""
  40
  41 The Result of the operation will be a shape which is a union of selected objects:
  42
  43 .. figure:: images/CreatedUnion.png
  44    :align: center
  45
  46    **Union created**
  47
  48 **See Also** a sample TUI Script of :ref:`tui_create_union` operation.