src/FeaturesPlugin/doc/fuseFeature.rst

   1 .. |bool_fuse.icon|    image:: images/bool_fuse.png
   2    :height: 16px
   3
   4 Fuse
   5 ====
   6
   7 Fuse feature implements a Boolean operation for fusion of a set of main objects with a set of tool objects.
   8
   9 To perform Fuse in the active part:
  10
  11 #. select in the Main Menu *Features - > Fuse* item  or
  12 #. click |bool_fuse.icon| **Fuse** button in the toolbar
  13
  14 There are 2 options for creation of a Fuse:
  15
  16 .. image:: images/bool_fuse_simple.png
  17    :align: left
  18    :height: 24px
  19
  20 **Simple** simply fuses selected objects.
  21
  22 .. image:: images/bool_fuse_advanced.png
  23    :align: left
  24    :height: 24px
  25
  26 **Advanced** fuse with additional functionality for subshapes of compsolids/compounds.
  27
  28 --------------------------------------------------------------------------------
  29
  30 Simple
  31 ------
  32
  33 .. image:: images/boolean_fuse_simple_property_panel.png
  34    :align: center
  35
  36 .. centered::
  37    **Simple**
  38
  39 - **Objects** - contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects.
  40   If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be ignored.
  41 - **Remove intersection edges** -  if enabled, edges that lie on the same surface will be removed.
  42 - **See preview** - button shows a result of the operation.
  43
  44 **TUI Command**:
  45
  46 .. py:function:: model.addFuse(Part_doc, objects, isRemoveEdges)
  47
  48     :param part: The current part object.
  49     :param list: A list of objects.
  50     :param boolean: Remove edges flag (optional).
  51     :return: Created object.
  52
  53 Result
  54 """"""
  55
  56 The Result of the operation will be a single shape which is a fuse of selected objects:
  57
  58 .. image:: images/CreatedFuse.png
  59            :align: center
  60
  61 .. centered::
  62    **Fuse created**
  63
  64 **See Also** a sample TUI Script of :ref:`tui_create_fuse` operation.
  65
  66 Advanced
  67 --------
  68
  69 .. image:: images/boolean_fuse_advanced_property_panel.png
  70    :align: center
  71
  72 .. centered::
  73    **Advanced**
  74
  75 - **Objects** - contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects.
  76   If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be cut from
  77   other objects (to avoid self intersection) and added to the result.
  78 - **Tools** - contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects.
  79   If a subshape that belongs to a compsolid/compound was selected, other shapes of this compsolid/compound will be ignored.
  80 - **Remove intersection edges** - if enabled, edges that lie on the same surface will be removed.
  81 - **See preview** - button shows a result of the operation.
  82
  83 **TUI Command**:
  84
  85 .. py:function:: model.addFuse(Part_doc, objects, tools, isRemoveEdges)
  86
  87     :param part: The current part object.
  88     :param list: A list of objects.
  89     :param list: A list of tools.
  90     :param boolean: Remove edges flag (optional).
  91     :return: Created object.
  92
  93 Result
  94 """"""
  95
  96 The Result of the operation will be a single shape which is a fuse of selected objects and tools:
  97
  98 .. image:: images/boolean_fuse_result.png
  99            :align: center
 100
 101 .. centered::
 102    **Fuse created**
 103
 104 **See Also** a sample TUI Script of :ref:`tui_create_fuse` operation.