Salome HOME
Task #3016: 3.2 To add a mode «through all» for features RevolutionCut and RevolutionFuse
[modules/shaper.git] / src / FeaturesPlugin / doc / removeSubShapesFeature.rst
index a8f1d440d19aedd3c7c47632cdd870e312ffa9f7..d3e7fc9c0dffc5b9ee7077424793e020760ff7dc 100644 (file)
@@ -1,10 +1,74 @@
+.. |remove_subshapes_btn.icon|    image:: images/remove_subshapes_btn.png
 
-Remove sub-shapes
+Remove Sub-Shapes
 =================
 
+Remove Sub-Shapes allows removing sub shapes from wires, shells, compsolids and compounds.
+
+To Remove Sub-Shapes in the active part:
+
+#. select in the Main Menu *Features - > Remove Sub-Shapes* item  or
+#. click |remove_subshapes_btn.icon| **Remove Sub-Shapes** button in the toolbar
+
+The following property panel will be opened:
 
 .. image:: images/RemoveSubShapes.png
   :align: center
 
 .. centered::
-  Remove sub-shapes
+  Remove Sub-Shapes
+
+- **Shape** shape from which sub-shapes should be removed. Only wires, shells, compsolids or compounds are allowed for selection.
+
+There are 2 options for removing sub-shapes:
+
+.. image:: images/remove_subshapes_32x32.png
+   :align: left
+**By removing** allows selecting sub-shapes to be removed.
+
+- **Sub-Shapes to remove** the list of sub-shapes which should be removed.
+
+**TUI Command**:
+
+.. py:function:: model.addRemoveSubShapes(Part_1_doc, object)
+
+    :param part: The current part object.
+    :param object: The object.
+    :return: Created object.
+
+.. py:function:: Remove_SubShapes_1.setSubShapesToRemove(subShapes)
+
+    :param list: A list of objects.
+
+
+.. image:: images/keep_subshapes_32x32.png
+   :align: left
+**By keeping** allows select sub-shapes to be kept.
+
+- **Sub-Shapes to keep** the list of sub-shapes which should be kept.
+
+**TUI Command**:
+
+.. py:function:: model.addRemoveSubShapes(Part_1_doc, object)
+
+    :param part: The current part object.
+    :param object: The object.
+    :return: Created object.
+
+.. py:function:: Remove_SubShapes_1.setSubShapesToKeep(subShapes)
+
+    :param list: A list of sub-shapes to keep.
+
+
+Result
+""""""
+
+The Result of the operation will be a shape without removed sub-shapes:
+
+.. image:: images/remove_subshapes_result.png
+          :align: center
+
+.. centered::
+   **Remove Sub-Shapes**
+
+**See Also** a sample TUI Script of :ref:`tui_create_remove_subshapes` operation.