src/FeaturesPlugin/doc/fuseFeature.rst

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