Salome HOME
Join modifications from branch OCC_debug_for_3_2_0b1
[modules/geom.git] / doc / salome / gui / GEOM / groups.htm
1 <!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">\r
2 \r
3 <html>\r
4 \r
5 <head>\r
6 <title>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
10 <!--\r
11 if (navigator.appName !="Netscape")\r
12 {   document.write("<link rel='stylesheet' href='default.css'>");}\r
13 //-->\r
14 </script>\r
15 <style type="text/css">\r
16 <!--\r
17 p.whs1 { font-family:'Lucida Console' , monospace; }\r
18 -->\r
19 </style><script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
20 <!--\r
21 function reDo() {\r
22   if (innerWidth != origWidth || innerHeight != origHeight)\r
23      location.reload();\r
24 }\r
25 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
26         origWidth = innerWidth;\r
27         origHeight = innerHeight;\r
28         onresize = reDo;\r
29 }\r
30 onerror = null; \r
31 //-->\r
32 </script>\r
33 <style type="text/css">\r
34 <!--\r
35 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
36 -->\r
37 </style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>\r
38 <script type="text/javascript" language="javascript" src="whver.js"></script>\r
39 <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>\r
40 <script type="text/javascript" language="javascript1.2" src="whutils.js"></script>\r
41 <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>\r
42 </head>\r
43 <body><script type="text/javascript" language="javascript1.2">\r
44 <!--\r
45 if (window.gbWhTopic)\r
46 {\r
47         if (window.addTocInfo)\r
48         {\r
49         addTocInfo("Geometry module\nTUI Scripts\nCreating Geometric Objects\nWorking with Groups");\r
50 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");\r
51 \r
52         }\r
53         if (window.writeBtnStyle)\r
54                 writeBtnStyle();\r
55 \r
56         if (window.writeIntopicBar)\r
57                 writeIntopicBar(1);\r
58 \r
59         if (window.setRelStartPage)\r
60         {\r
61         setRelStartPage("geom.htm");\r
62 \r
63                 autoSync(1);\r
64                 sendSyncInfo();\r
65                 sendAveInfoOut();\r
66         }\r
67 }\r
68 else\r
69         if (window.gbIE4)\r
70                 document.location.reload();\r
71 //-->\r
72 </script>\r
73 <h1>Groups</h1>\r
74 \r
75 <h3>Creation of a group</h3>\r
76 \r
77 <p class="whs1">import geompy</p>\r
78 \r
79 <p class="whs1">import salome</p>\r
80 \r
81 <p class="whs1">gg = salome.ImportComponentGUI(&quot;GEOM&quot;)</p>\r
82 \r
83 <p>&nbsp;</p>\r
84 \r
85 <p># create two vertices</p>\r
86 \r
87 <p class="whs1">p0 = geompy.MakeVertex(0. \r
88  &nbsp;, 0. &nbsp;, \r
89  0. &nbsp;)</p>\r
90 \r
91 <p class="whs1">p200 = geompy.MakeVertex(200., \r
92  200., 200.)</p>\r
93 \r
94 <p>&nbsp;</p>\r
95 \r
96 <p># create a box from two points</p>\r
97 \r
98 <p class="whs1">Box = geompy.MakeBoxTwoPnt(p0, \r
99  p200)</p>\r
100 \r
101 <p>&nbsp;</p>\r
102 \r
103 <p># create a group from the faces of the box</p>\r
104 \r
105 <p class="whs1">group = geompy.CreateGroup(Box, \r
106  geompy.ShapeType[&quot;FACE&quot;])</p>\r
107 \r
108 <p>&nbsp;</p>\r
109 \r
110 <p># add objects to the group</p>\r
111 \r
112 <p class="whs1">SubFaceList = geompy.SubShapeAllSorted(Box, \r
113  geompy.ShapeType[&quot;FACE&quot;])</p>\r
114 \r
115 <p class="whs1">for i in [0, 3, 5] \r
116  :</p>\r
117 \r
118 <p class="whs1">&nbsp;&nbsp;&nbsp;&nbsp;FaceID \r
119  = geompy.GetSubShapeID(Box, SubFaceList[i])</p>\r
120 \r
121 <p class="whs1">&nbsp;&nbsp;&nbsp;&nbsp;geompy.AddObject(group, \r
122  FaceID)</p>\r
123 \r
124 <p>&nbsp;</p>\r
125 \r
126 <p># add all selected shapes from the list to the group </p>\r
127 \r
128 <p># (the program doesn't raise error, if some shapes are already included)</p>\r
129 \r
130 <p class="whs1">geompy.UnionList(group, \r
131  [SubFaceList[0], SubFaceList[2], SubFaceList[5]])</p>\r
132 \r
133 <p>&nbsp;</p>\r
134 \r
135 <p># remove an object from the group</p>\r
136 \r
137 <p class="whs1">geompy.RemoveObject(group, \r
138  FaceID)</p>\r
139 \r
140 <p>&nbsp;</p>\r
141 \r
142 <p># remove all selected shapes from the group </p>\r
143 \r
144 <p># (the program doesn't raise error, if some shapes are not included)</p>\r
145 \r
146 <p class="whs1">geompy.DifferenceList(group, \r
147  [SubFaceList[2], SubFaceList[3], SubFaceList[4]])</p>\r
148 \r
149 <p class="whs1">id_group1 = geompy.addToStudy(group, \r
150  &quot;Group1&quot;)</p>\r
151 \r
152 <p>&nbsp;</p>\r
153 \r
154 <p># display the contents of the group</p>\r
155 \r
156 <p class="whs1">gg.createAndDisplayGO(id_group1)</p>\r
157 \r
158 <p><span style="font-family: 'Lucida Console', monospace;">salome.sg.updateObjBrowser(1)</span> \r
159  </p>\r
160 \r
161 <h3>Adding an object to the group.</h3>\r
162 \r
163 <p class="whs1">import geompy</p>\r
164 \r
165 <p class="whs1">import salome</p>\r
166 \r
167 <p class="whs1">gg = salome.ImportComponentGUI(&quot;GEOM&quot;)</p>\r
168 \r
169 <p>&nbsp;</p>\r
170 \r
171 <p># create two vertices</p>\r
172 \r
173 <p class="whs1">p0 = geompy.MakeVertex(0. \r
174  &nbsp;, 0. &nbsp;, \r
175  0. &nbsp;)</p>\r
176 \r
177 <p class="whs1">p200 = geompy.MakeVertex(200., \r
178  200., 200.)</p>\r
179 \r
180 <p>&nbsp;</p>\r
181 \r
182 <p># create a box from two points</p>\r
183 \r
184 <p class="whs1">Box = geompy.MakeBoxTwoPnt(p0, \r
185  p200)</p>\r
186 \r
187 <p>&nbsp;</p>\r
188 \r
189 <p># create a group from the faces of the box</p>\r
190 \r
191 <p class="whs1">group = geompy.CreateGroup(Box, \r
192  geompy.ShapeType[&quot;FACE&quot;])</p>\r
193 \r
194 <p>&nbsp;</p>\r
195 \r
196 <p># add objects to the group</p>\r
197 \r
198 <p class="whs1">SubFaceList = geompy.SubShapeAllSorted(Box, \r
199  geompy.ShapeType[&quot;FACE&quot;])</p>\r
200 \r
201 <p class="whs1">for i in [0, 3, 5] \r
202  :</p>\r
203 \r
204 <p class="whs1">&nbsp;&nbsp;&nbsp;&nbsp;FaceID \r
205  = geompy.GetSubShapeID(Box, SubFaceList[i])</p>\r
206 \r
207 <p class="whs1">&nbsp;&nbsp;&nbsp;&nbsp;geompy.AddObject(group, \r
208  FaceID)</p>\r
209 \r
210 <p class="whs1">id_group1 = geompy.addToStudy(group, \r
211  &quot;Group1&quot;)</p>\r
212 \r
213 <p>&nbsp;</p>\r
214 \r
215 <p># display the contents of the group</p>\r
216 \r
217 <p class="whs1">gg.createAndDisplayGO(id_group1)</p>\r
218 \r
219 <p><span style="font-family: 'Lucida Console', monospace;">salome.sg.updateObjBrowser(1)</span> \r
220  </p>\r
221 \r
222 <p>&nbsp;</p>\r
223 \r
224 <h3>Removing an object from the group</h3>\r
225 \r
226 <p class="whs1">import geompy</p>\r
227 \r
228 <p class="whs1">import salome</p>\r
229 \r
230 <p class="whs1">gg = salome.ImportComponentGUI(&quot;GEOM&quot;)</p>\r
231 \r
232 <p>&nbsp;</p>\r
233 \r
234 <p># create two vertices</p>\r
235 \r
236 <p class="whs1">p0 = geompy.MakeVertex(0. \r
237  &nbsp;, 0. &nbsp;, \r
238  0. &nbsp;)</p>\r
239 \r
240 <p class="whs1">p200 = geompy.MakeVertex(200., \r
241  200., 200.)</p>\r
242 \r
243 <p>&nbsp;</p>\r
244 \r
245 <p># create a box from two points</p>\r
246 \r
247 <p class="whs1">Box = geompy.MakeBoxTwoPnt(p0, \r
248  p200)</p>\r
249 \r
250 <p>&nbsp;</p>\r
251 \r
252 <p># create a group from the faces of the box</p>\r
253 \r
254 <p class="whs1">group = geompy.CreateGroup(Box, \r
255  geompy.ShapeType[&quot;FACE&quot;])</p>\r
256 \r
257 <p>&nbsp;</p>\r
258 \r
259 <p># add objects to the group</p>\r
260 \r
261 <p class="whs1">SubFaceList = geompy.SubShapeAllSorted(Box, \r
262  geompy.ShapeType[&quot;FACE&quot;])</p>\r
263 \r
264 <p class="whs1">for i in [0, 3, 5] \r
265  :</p>\r
266 \r
267 <p class="whs1">&nbsp;&nbsp;&nbsp;&nbsp;FaceID \r
268  = geompy.GetSubShapeID(Box, SubFaceList[i])</p>\r
269 \r
270 <p class="whs1">&nbsp;&nbsp;&nbsp;&nbsp;geompy.AddObject(group, \r
271  FaceID)</p>\r
272 \r
273 <p>&nbsp;</p>\r
274 \r
275 <p># add all selected shapes from the list to the group </p>\r
276 \r
277 <p># (the program doesn't raise errors, if some shapes are already included)</p>\r
278 \r
279 <p class="whs1">geompy.UnionList(group, \r
280  [SubFaceList[0], SubFaceList[2], SubFaceList[5]])</p>\r
281 \r
282 <p>&nbsp;</p>\r
283 \r
284 <p># remove an object from the group</p>\r
285 \r
286 <p class="whs1">geompy.RemoveObject(group, \r
287  FaceID)</p>\r
288 \r
289 <p class="whs1">id_group1 = geompy.addToStudy(group, \r
290  &quot;Group1&quot;)</p>\r
291 \r
292 <p>&nbsp;</p>\r
293 \r
294 <p># display the contents of the group</p>\r
295 \r
296 <p class="whs1">gg.createAndDisplayGO(id_group1)</p>\r
297 \r
298 <p><span style="font-family: 'Lucida Console', monospace;">salome.sg.updateObjBrowser(1)</span> \r
299  </p>\r
300 \r
301 <p>&nbsp;</p>\r
302 \r
303 <p>&nbsp;</p>\r
304 \r
305 <p>&nbsp;</p>\r
306 \r
307 <p>&nbsp;</p>\r
308 \r
309 <p>&nbsp;</p>\r
310 \r
311 <p>&nbsp;</p>\r
312 \r
313 <p>&nbsp;</p>\r
314 \r
315 <script type="text/javascript" language="javascript1.2">\r
316 <!--\r
317 if (window.writeIntopicBar)\r
318         writeIntopicBar(0);\r
319 //-->\r
320 </script>\r
321 </body>\r
322 </html>\r