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 **Fuzzy Parameter** defines the additional tolerance value used to eliminate tiny results.
  27
  28 **Apply** button creates a union shape.
  29
  30 **Cancel** button cancels the operation.
  31
  32 **TUI Command**:
  33
  34 .. py:function:: model.addUnion(Part_doc, objects, fuzzy)
  35
  36     :param part: The current part object.
  37     :param objects: A list of objects.
  38     :param real: Additional tolerance used to eliminate tiny results (optional).
  39     :return: Result object.
  40
  41 Result
  42 """"""
  43
  44 The Result of the operation will be a shape which is a union of selected objects:
  45
  46 .. figure:: images/CreatedUnion.png
  47    :align: center
  48
  49    **Union created**
  50
  51 **See Also** a sample TUI Script of :ref:`tui_create_union` operation.