doc/salome/gui/GEOM/input/working_with_groups.doc

   1 /*!
   2
   3 \page work_with_groups_page Working with groups
   4
   5 Creation and editing groups of subshapes of a geometrical object makes
   6 handling subshapes much easier. This functionality is available in OCC
   7 viewer only.
   8
   9 <br><h2>Create a group</h2>
  10
  11 \image html image56.gif
  12
  13 To create a group of subshapes of a geometrical object in the main
  14 menu select <b>New entity > Group > Create</b>
  15 \n The following menu will appear:
  16
  17 \image html geomcreategroup.png
  18
  19 In this Menu:
  20
  21 <ul>
  22 <li><b>Shape Type</b> radio button define the type of elements for the
  23 group (points, wires, faces, shells or solids).</li>
  24 <li><b>Group Name</b> - here you can enter the name of the group, by
  25 default, it is Group_n.</li>
  26 <li>Then, using the "Select" button, select the <b>Main Shape</b> (a
  27 geometrical object on which the group will be created). You can select
  28 the elements of your group in two ways: </li>
  29 <ul>
  30 <li>Clicking <b>Select Sub-Shapes</b> button you can select them
  31 manually in the 3D Viewer, and add to the group by clicking the \b Add
  32 button (keep down the Shift button on the keyboard to select several
  33 elements and add all them together). The indexes of the selected
  34 elements will be displayed in the list. To delete elements from the
  35 list, select them and click \b Remove button.</li>
  36 <li>Clicking <b>Select All</b> button you can add all object's
  37 elements of a certain type in the list of the elements of the
  38 group. To delete elements from the list, select them and click \b
  39 Remove button.</li>
  40 </ul>
  41 <li>Finally, confirm your selection by clicking \b OK (also closes the
  42 Menu) or \b Apply (leaves the Menu open for creation of other groups),
  43 or skip it by clicking \b Close button.</li>
  44 </ul>
  45
  46 \n The Result of the operation will be a \b GEOM_Object.
  47
  48 \n <b>TUI Command:</b> <em>geompy.CreateGroup(MainShape,
  49 ShapeType),</em> where MainShape is a shape for which the group is
  50 created, ShapeType is a type of shapes in the created group.
  51 \n <b>Arguments:</b> 1 Shape + Type of subshape.
  52
  53 <b>Example:</b>
  54
  55 \image html image193.jpg
  56
  57
  58 <br><h2>Edit a group</h2>
  59
  60 \image html image57.gif
  61
  62 To \b Edit an existing group in the main menu select <b>New entity >
  63 Group > Edit</b>. This menu is designed in the same way as the
  64 <b>Create a group</b> menu.
  65
  66 \n The \b Result of the operation will be a \b GEOM_Object.
  67
  68 \n <b>TUI Command:</b>
  69 <ul>
  70 <li><em>geompy.AddObject(Group, SubShapeID),</em> where Group is a
  71 group to which a sub shape has to be added, SubShapeID is an ID of the
  72 sub shape to be added to the group.</li>
  73 <li><em>geompy.RemoveObject(Group, SubShapeID),</em> where Group is a
  74 group from which a sub shape has to be removed, SubShapeID is an ID of
  75 the sub shape to be removed from the group.</li>
  76 <li><em>geompy.GetObjectIDs(Group),</em> where Group is a group for which its object's are returned.
  77 \n Returns: List of IDs.</li>
  78 </ul>
  79
  80 \n <b>Arguments:</b> 1 Shape + its subshapes.
  81
  82 \n <b>Dialog Box:</b>
  83
  84 \image html editgroup.png
  85
  86 Our <b>TUI Scripts</b> provide you with useful examples of
  87 \ref tui_working_with_groups_page "Working with Groups".
  88
  89 */