src/CollectionPlugin/doc/groupShapeFeature.rst

   1 .. |group_shape.icon|    image:: images/group_shape.png
   2
   3 Group Shape
   4 ==============
   5
   6 Group shape produces a new shape from union of all the elements of the selected groups.
   7 To create a Group Shape in the active part:
   8
   9 #. select in the Main Menu *Features - > Group Shape* item  or
  10 #. click |group_shape.icon| **Group Shape** button in the toolbar:
  11
  12 The following property panel appears.
  13
  14 .. figure:: images/group_shape_property_panel.png
  15   :align: center
  16
  17   Create a group shape operation
  18
  19 Input fields:
  20
  21 - **Name** defines the name of the group, by default, it is **GroupShape_n**.
  22 - The list of selected groups of the same type.  Multiple selection can be done manually in OCC 3D Viewer by mouse click with Shift button pressed or by rectangle selection. To delete entities from the list, select them and call pop-up menu *Delete* item.
  23
  24 Note, that operation is valid only for the groups of the same type.
  25
  26 **TUI Command**:
  27
  28 .. py:function:: model.addGroupShape(Part_1_doc,
  29                                        [model.selection("COMPOUND", "Group_1"), model.selection("COMPOUND", "Group_2")])
  30
  31     :param part: The current part object
  32     :param list: A list of selected groups
  33     :return: Created shape.
  34
  35
  36 **See Also** a sample TUI Script of :ref:`tui_create_group_shape` operation.