src/BuildPlugin/doc/subShapesFeature.rst

   1 .. |feature_subshapes.icon|    image:: images/feature_subshapes.png
   2
   3 Sub-shapes
   4 ==========
   5
   6 The feature **Sub-shapes** modifies the selected entity by creating a non-manifold topology. It gives the possibility to:
   7
   8 * add/remove vertices lying on edges of a wire;
   9 * add/remove edges and vertices lying on a face.
  10
  11 To create Sub-shapes in the active part:
  12
  13 #. select in the Main Menu *Build - > Sub-shapes* item  or
  14 #. click |feature_subshapes.icon| **Sub-shapes** button in the toolbar
  15
  16 The following property panel appears.
  17
  18 .. figure:: images/SubShapes.png
  19   :align: center
  20
  21   Sub-shapes property panel
  22
  23 Input fields:
  24
  25 - **Shape** panel contains the shape to be modified. The shape is selected in 3D OCC viewer or object browser. For today it has to be a wire or a face;
  26 - **Sub-shapes** panel contains the list of sub-shapes which are already included into result. A sub-shape can be deleted from the list or the list can be extended with new shapes selected in the view.
  27
  28 **TUI Command**:
  29
  30 .. py:function:: model.addSubShapes(Part_doc, shape, sub-shapes)
  31
  32     :param part: The current part object.
  33     :param object: A shape in format *model.selection(TYPE, shape)*.
  34     :param list: A list of sub-shapes in format *model.selection(TYPE, subshape)*.
  35     :return: Result object.
  36
  37 Result
  38 """"""
  39 The result replaces the original shape with its copy with added/removed sub-shapes.
  40
  41 .. figure:: images/CreateSubShapes.png
  42    :align: center
  43
  44    Sub-shapes
  45
  46 **See Also** a sample TUI Script of :ref:`tui_create_subshape` operation.
  47
  48
  49
  50