src/FeaturesPlugin/doc/recoverFeature.rst

   1 .. |recover.icon|    image:: images/recover.png
   2
   3 Recover
   4 =======
   5
   6 **Recover** feature restores some objects used in previous operations.
   7
   8 To recover in the active part:
   9
  10 #. select in the Main Menu *Features - > Recover* item or
  11 #. click |recover.icon| **Recover** button in the toolbar
  12
  13 The feature has the following options:
  14
  15 .. image:: images/recover_default_32x32.png
  16    :align: left
  17    :height: 24px
  18
  19 restore only the objects used in the operation
  20
  21 .. image:: images/recover_compound_32x32.png
  22    :align: left
  23    :height: 24px
  24
  25 restore full compound/compsolid if the operation used one or more of its sub-shapes
  26
  27 --------------------------------------------------------------------------------
  28
  29 Recover objects
  30 ---------------
  31
  32 .. image:: images/recover_mode_default.png
  33    :align: center
  34
  35 .. centered::
  36    Recover objects used in operation
  37
  38 - **Feature** field contains one of the previous operations;
  39 - **List of recovered** objects contains all the shapes used in the operation. Need to enable checkbox to restore a shape.
  40
  41 **TUI Command**:
  42
  43 .. py:function:: model.addRecover(Part_doc, feature, [recovering_results])
  44
  45     :param part: The current part object.
  46     :param string: The name of the feature.
  47     :param list: A list of results used in the feature.
  48     :return: Created object.
  49
  50 Result
  51 """"""
  52
  53 Result of restoring the shape used in Split operation in compsolid is a single solid.
  54
  55 .. image:: images/recover_res_default.png
  56    :align: center
  57
  58 .. centered::
  59    Recover a solid
  60
  61 **See also** a sample TUI script of ref:`tui_recover_default` operation.
  62
  63
  64 Recover top-level objects
  65 -------------------------
  66
  67 .. image:: images/recover_mode_compound.png
  68    :align: center
  69
  70 .. centered::
  71    Recover top-level compounds/compsolids of objects used in operation
  72
  73 - **Feature** field contains one of the previous operations;
  74 - **List of recovered** objects contains all top-level shapes (compounds/compsolids) of the shapes used in the operation. Need to enable checkbox to restore a shape.
  75
  76 **TUI Command**:
  77
  78 .. py:function:: model.addRecover(Part_doc, feature, [recovering_results], True)
  79
  80     :param part: The current part object.
  81     :param string: The name of the feature.
  82     :param list: A list of results used in the feature.
  83     :param boolean: *True* to specify restoring compounds.
  84     :return: Created object.
  85
  86 Result
  87 """"""
  88
  89 Result of restoring the shape used in Split operation in compsolid is a full compsolid.
  90
  91 .. image:: images/recover_res_compound.png
  92    :align: center
  93
  94 .. centered::
  95    Recover a compsolid
  96
  97 **See also** a sample TUI script of ref:`tui_recover_compound` operation.