1 <!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">
\r
6 <title>Working with groups</title>
\r
7 <meta http-equiv="content-type" content="text/html; charset=windows-1252">
\r
8 <meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">
\r
9 <link rel="stylesheet" href="default_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">
\r
11 if (navigator.appName !="Netscape")
\r
12 { document.write("<link rel='stylesheet' href='default.css'>");}
\r
15 <style type="text/css">
\r
17 img_whs1 { border:none; width:24px; height:22px; border-style:none; }
\r
18 p.whs2 { font-size:12pt; }
\r
19 p.whs3 { font-size:12pt; font-weight:bold; margin-left:40px; }
\r
20 img_whs4 { border:none; width:312px; height:379px; float:none; border-style:none; }
\r
21 p.whs5 { font-size:12pt; margin-left:0px; font-weight:normal; }
\r
22 ul.whs6 { list-style:disc; }
\r
23 img_whs7 { border:none; width:50px; height:31px; border-style:none; }
\r
24 p.whs8 { font-size:12pt; margin-left:48px; }
\r
25 p.whs9 { font-size:12pt; margin-left:0px; }
\r
26 p.whs10 { font-size:12pt; font-weight:bold; }
\r
27 p.whs11 { font-size:12pt; margin-left:40px; }
\r
28 img_whs12 { border:none; width:250px; height:307px; border-style:none; }
\r
29 img_whs13 { border:none; width:22px; height:22px; border-style:none; }
\r
30 p.whs14 { font-size:12pt; margin-left:40px; font-weight:bold; }
\r
32 </style><script type="text/javascript" language="JavaScript">
\r
34 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
\r
36 var strNSS = "<style type='text/css'>";
\r
37 strNSS += "p.whs5 {margin-left:1pt; }";
\r
38 strNSS += "p.whs9 {margin-left:1pt; }";
\r
39 strNSS +="</style>";
\r
40 document.write(strNSS);
\r
44 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
\r
47 if (innerWidth != origWidth || innerHeight != origHeight)
\r
50 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
\r
51 origWidth = innerWidth;
\r
52 origHeight = innerHeight;
\r
58 <style type="text/css">
\r
60 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
\r
62 </style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
\r
63 <script type="text/javascript" language="javascript" src="whver.js"></script>
\r
64 <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
\r
65 <script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
\r
66 <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
\r
68 <body><script type="text/javascript" language="javascript1.2">
\r
70 if (window.gbWhTopic)
\r
72 if (window.addTocInfo)
\r
74 addTocInfo("GEOM module\nCreating geometrical objects\nWorking with groups");
\r
75 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");
\r
78 if (window.writeBtnStyle)
\r
81 if (window.writeIntopicBar)
\r
84 if (window.setRelStartPage)
\r
86 setRelStartPage("geom.htm");
\r
95 document.location.reload();
\r
98 <h1>Working with groups</h1>
\r
100 <p>The <span style="font-style: italic;"><I>Salome</I></span> platform offers
\r
101 such a useful functionality as creation and editing groups of subshapes
\r
102 of a geometrical object which makes handling subshapes much easier. However
\r
103 the functionality is available in the OCC viewer only.</p>
\r
107 <p><img src="image56.gif" width="24px" height="22px" border="0" class="img_whs1"> <span style="font-weight: bold; font-size: 14pt;"><font size=4 style="font-size:14pt;"><B>Create
\r
108 a group</B></font></span></p>
\r
112 <p class="whs2">To create a group of subshapes of a geometrical
\r
113 object in the main menu select <span style="font-weight: bold;"><B>New entity
\r
114 > Group > Create</B></span>. </p>
\r
116 <p class="whs2">The following menu will appear. </p>
\r
118 <p class="whs2"> </p>
\r
120 <p class="whs3"><b style="font-weight: bold;"><img src="pics/creategroup.png" x-maintain-ratio="TRUE" width="312px" height="379px" border="0" class="img_whs4"></b></p>
\r
122 <p class="whs3"> </p>
\r
124 <p class="whs5">In this Menu: </p>
\r
126 <p class="whs5"> </p>
\r
128 <ul type="disc" class="whs6">
\r
130 <li class=kadov-p><p class="whs5"><span style="font-weight: bold;"><B>Shape
\r
131 Type</B></span> radio button define the type of elements for the group (points,
\r
132 lines, planes or shapes). </p></li>
\r
134 <li class=kadov-p><p class="whs5"><span style="font-weight: bold;"><B>Group
\r
135 Name</B></span> - here you can enter the name of the group, by default, it
\r
136 is Group_n.</p></li>
\r
138 <li class=kadov-p><p class="whs5">Then, using the <img src="image28.gif" width="50px" height="31px" border="0" class="img_whs7"> button, select the <span style="font-weight: bold;"><B>Main
\r
139 Shape</B></span> (a geometrical object on which the group will be created).
\r
140 You can select the elements of your group in two ways:</p></li>
\r
142 <li class=kadov-p><p class="whs8">Clicking
\r
143 <span style="font-weight: bold;"><B>Select Sub-Shapes</B></span> button you can
\r
144 select them manually in the 3D Viewer, and add to the group by clicking
\r
145 the <span style="font-weight: bold;"><B>Add</B></span> button (keep down the
\r
146 Shift button on the keyboard to select several elements and add all them
\r
147 together). The indexes of the selected elements will be displayed in the
\r
148 list. To delete elements from the list, select them and click <span style="font-weight: bold;"><B>Remove</B></span>
\r
149 button. </p></li>
\r
151 <li class=kadov-p><p class="whs8">Clicking
\r
152 <span style="font-weight: bold;"><B>Select All</B></span> button you can add
\r
153 all object's elements of a certain type in the list of the elements of
\r
154 the group. To delete elements from the list, select them and click <span
\r
155 style="font-weight: bold;"><B>Remove</B></span> button. </p></li>
\r
157 <li class=kadov-p><p class="whs9">Finally,
\r
158 confirm your selection by clicking <span style="font-weight: bold;"><B>OK
\r
159 </B></span>(also closes the Menu) or <span style="font-weight: bold;"><B>Apply</B></span>
\r
160 (leaves the Menu open for creation of other groups), or skip it by clicking
\r
161 <span style="font-weight: bold;"><B>Close</B></span> button. </p></li>
\r
164 <p class="whs2"> </p>
\r
166 <p class="whs2"><b><span style="font-weight: normal;">The</span>
\r
167 Result <span style="font-weight: normal;">of the operation will be a</span></b><b>
\r
168 GEOM_Object<span style="font-weight: normal;">.</span></b></p>
\r
170 <p class="whs2"> </p>
\r
172 <p class="whs2"><b style="font-weight: bold;">TUI Command:</b><i>
\r
173 </i><span style="font-style: italic;"><I>geompy.CreateGroup(MainShape, ShapeType)</I></span>,
\r
174 where MainShape is a shape for which the group is created, ShapeType is
\r
175 a type of shapes in the created group.</p>
\r
177 <p class="whs2"> </p>
\r
179 <p class="whs2"><b style="font-weight: bold;">Arguments:</b>
\r
180 1 Shape + Type of subshape.</p>
\r
182 <p class="whs2"> </p>
\r
184 <p class="whs10">Example:</p>
\r
186 <p class="whs10"> </p>
\r
188 <p class="whs11"><img src="image193.jpg" width="250px" height="307px" border="0" class="img_whs12"></p>
\r
190 <p class="whs2"> </p>
\r
192 <p class="whs2"> </p>
\r
194 <p class="whs2"> </p>
\r
196 <p class="whs2"><img src="image57.gif" width="22px" height="22px" border="0" class="img_whs13"> <span style="font-weight: bold; font-size: 14pt;"><font size=4 style="font-size:14pt;"><B>Edit
\r
197 a group</B></font></span></p>
\r
199 <p class="whs2"> </p>
\r
201 <p class="whs2">To<span style="font-weight: bold;"><B> Edit </B></span>an
\r
202 existing group in the main menu select <span style="font-weight: bold;"><B>New
\r
203 entity > Group > Edit</B></span>. This menu is designed in the same
\r
204 way as the <span style="font-weight: bold;"><B>Create a group</B></span> menu.
\r
207 <p class="whs2"> </p>
\r
209 <p class="whs2"><b><span style="font-weight: normal;">The</span>
\r
210 Result <span style="font-weight: normal;">of the operation will be a</span></b><b>
\r
211 GEOM_Object<span style="font-weight: normal;">.</span></b></p>
\r
215 <p class="whs2"><b style="font-weight: bold;">TUI Command:</b><i>
\r
218 <ul type="disc" class="whs6">
\r
220 <li class=kadov-p><p class="whs2"><i><span style="font-style: italic;"><I>g</i>eompy.AddObject(Group,
\r
221 SubShapeID)</I></span>, where Group is a group to which a sub shape has to
\r
222 be added, SubShapeID is an ID of the sub shape to be added to the group</p></li>
\r
224 <li class=kadov-p><p class="whs2"><span style="font-style: italic;"><I>geompy.RemoveObject(Group,
\r
225 SubShapeID)</I></span>, where Group is a group from which a sub shape has
\r
226 to be removed, SubShapeID is an ID of the sub shape to be removed from
\r
229 <li class=kadov-p><p class="whs2"><span style="font-style: italic;"><I>geompy.GetObjectIDs(Group)</I></span>,
\r
230 where Group is a group for which its object ID
\92s are returned. </p></li>
\r
233 <p class="whs11"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">Returns:
\r
234 List of IDs.</font></span></p>
\r
236 <p class="whs2"> </p>
\r
238 <p class="whs2"><b style="font-weight: bold;">Arguments:</b>
\r
239 1 Shape + its subshapes.</p>
\r
241 <p class="whs2"> </p>
\r
243 <p class="whs2"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
245 <p class="whs2"> </p>
\r
247 <p class="whs14"><b style="font-weight: bold;"><img src="pics/editgroup.png" x-maintain-ratio="TRUE" width="312px" height="379px" border="0" class="img_whs4"></b></p>
\r
249 <p class="whs14"> </p>
\r
251 <p class="whs2">Our <span style="font-weight: bold;"><B>TUI Scripts</B></span>
\r
252 provide you with useful examples of <a href="working_with_groups.htm">Working
\r
253 with Groups</a>. </p>
\r
257 <script type="text/javascript" language="javascript1.2">
\r
259 if (window.writeIntopicBar)
\r
260 writeIntopicBar(0);
\r