Salome HOME
Join modifications from branch BR_DEBUG_3_2_0b1
[modules/geom.git] / doc / salome / gui / GEOM / newentity_blocks.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>Blocks</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-size:14pt; font-weight:bold; }\r
18 img_whs2 { border:none; float:none; width:30px; height:30px; border-style:none; }\r
19 ul.whs3 { list-style:disc; }\r
20 img_whs4 { border:none; width:23px; height:22px; border-style:none; }\r
21 p.whs5 { font-size:12pt; }\r
22 p.whs6 { font-size:12pt; font-style:italic; font-weight:normal; }\r
23 table.whs7 { x-cell-content-align:top; width:66.515%; border-spacing:0px; }\r
24 col.whs8 { width:32.996%; }\r
25 col.whs9 { width:33.052%; }\r
26 col.whs10 { width:33.952%; }\r
27 tr.whs11 { x-cell-content-align:top; }\r
28 td.whs12 { width:32.996%; padding-right:10px; padding-left:10px; border-right-style:none; border-left-style:none; border-top-style:none; border-bottom-style:none; }\r
29 img_whs13 { border:none; width:312px; height:410px; float:none; border-style:none; }\r
30 td.whs14 { width:33.052%; padding-right:10px; padding-left:10px; border-right-style:none; border-top-style:none; border-bottom-style:none; }\r
31 td.whs15 { width:33.952%; padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; }\r
32 p.whs16 { font-weight:bold; }\r
33 p.whs17 { margin-left:40px; }\r
34 img_whs18 { border:none; width:250px; height:195px; border-style:none; }\r
35 img_whs19 { border:none; width:24px; height:22px; border-style:none; }\r
36 table.whs20 { x-cell-content-align:top; width:40.406%; border-spacing:0px; }\r
37 col.whs21 { width:49.761%; }\r
38 col.whs22 { width:50.239%; }\r
39 td.whs23 { width:49.761%; padding-right:10px; padding-left:10px; border-right-style:none; border-left-style:none; border-top-style:none; border-bottom-style:none; }\r
40 img_whs24 { border:none; width:312px; height:324px; float:none; border-style:none; }\r
41 td.whs25 { width:50.239%; padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; }\r
42 img_whs26 { border:none; width:312px; height:464px; float:none; border-style:none; }\r
43 td.whs27 { width:49.761%; padding-right:10px; padding-left:10px; border-left-style:none; border-right-style:none; border-bottom-style:none; }\r
44 td.whs28 { width:50.239%; padding-right:10px; padding-left:10px; border-right-style:none; border-bottom-style:none; }\r
45 p.whs29 { font-size:12pt; font-weight:bold; }\r
46 p.whs30 { font-size:12pt; font-weight:bold; margin-left:0px; }\r
47 img_whs31 { border:none; width:300px; height:234px; float:none; border-style:none; }\r
48 img_whs32 { border:none; width:251px; height:234px; border-style:none; }\r
49 p.whs33 { font-size:12pt; margin-left:40px; }\r
50 -->\r
51 </style><script type="text/javascript" language="JavaScript">\r
52 <!--\r
53 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))\r
54 {\r
55   var strNSS = "<style type='text/css'>";\r
56   strNSS += "p.whs30 {margin-left:1pt; }";\r
57   strNSS +="</style>";\r
58   document.write(strNSS);\r
59 }\r
60 //-->\r
61 </script>\r
62 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
63 <!--\r
64 function reDo() {\r
65   if (innerWidth != origWidth || innerHeight != origHeight)\r
66      location.reload();\r
67 }\r
68 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
69         origWidth = innerWidth;\r
70         origHeight = innerHeight;\r
71         onresize = reDo;\r
72 }\r
73 onerror = null; \r
74 //-->\r
75 </script>\r
76 <style type="text/css">\r
77 <!--\r
78 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
79 p.WebHelpNavBar { text-align:right; }\r
80 -->\r
81 </style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>\r
82 <script type="text/javascript" language="javascript" src="whver.js"></script>\r
83 <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>\r
84 <script type="text/javascript" language="javascript1.2" src="whutils.js"></script>\r
85 <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>\r
86 <script type="text/javascript" language="javascript1.2">\r
87 <!--\r
88 if (window.gbWhTopic)\r
89 {\r
90         if (window.setRelStartPage)\r
91         {\r
92         addTocInfo("Geometry module\nCreating geometrical objects\nBuilding by blocks");\r
93 addButton("show",BTN_IMG,"Show","","","","",0,0,"whd_show0.gif","whd_show2.gif","whd_show1.gif");\r
94 addButton("hide",BTN_IMG,"Hide","","","","",0,0,"whd_hide0.gif","whd_hide2.gif","whd_hide1.gif");\r
95 \r
96         }\r
97 \r
98 \r
99         if (window.setRelStartPage)\r
100         {\r
101         setRelStartPage("index.htm");\r
102 \r
103                 autoSync(1);\r
104                 sendSyncInfo();\r
105                 sendAveInfoOut();\r
106         }\r
107 \r
108 }\r
109 else\r
110         if (window.gbIE4)\r
111                 document.location.reload();\r
112 //-->\r
113 </script>\r
114 </head>\r
115 <body><script type="text/javascript" language="javascript1.2">\r
116 <!--\r
117 if (window.writeIntopicBar)\r
118         writeIntopicBar(4);\r
119 //-->\r
120 </script>\r
121 <h1>Building by blocks</h1>\r
122 \r
123 <p class="whs1"><span style="font-size: 14pt; font-weight: bold;"><font size=4 style="font-size:14pt;"><B>Introduction.</B></font></span></p>\r
124 \r
125 <p>&nbsp;</p>\r
126 \r
127 <p>Below are some general notions about blocks:</p>\r
128 \r
129 <p>&nbsp;</p>\r
130 \r
131 <p><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b style="font-weight: bold;"><img src="i_blue.jpg" x-maintain-ratio="TRUE" x-save-file="TRUE" x-save-method="compute-relative" width="30px" height="30px" border="0" class="img_whs2"></b></font></span>A block is a an elementary geometric solid that \r
132  has specific geometric constraints oriented for meshing. In the hexahedral \r
133  case, blocks have 6 faces and each face has 4 edges. &nbsp;</p>\r
134 \r
135 <p>&nbsp;</p>\r
136 \r
137 <p>Tetrahedral Block - is a block with constraints for tetrahedral meshing. \r
138  </p>\r
139 \r
140 <p>&nbsp;</p>\r
141 \r
142 <p>Hexahedral Block - is a block with constraints for hexahedral meshing.</p>\r
143 \r
144 <p>&nbsp;</p>\r
145 \r
146 <p>Block Compound - is a compound composed of blocks only.</p>\r
147 \r
148 <p>&nbsp;</p>\r
149 \r
150 <p>These functionalities are available from the main menu via <span style="font-style: italic;"><I>New \r
151  Entity / Blocks.</I></span></p>\r
152 \r
153 <p>&nbsp;</p>\r
154 \r
155 <ul type="disc" class="whs3">\r
156         \r
157         <li class=kadov-p><p><a href="#QuadrangleFace">Quadrangle face</a></p></li>\r
158         \r
159         <li class=kadov-p><p><a href="#HexahedralSolid">Hexahedral solid</a></p></li>\r
160 </ul>\r
161 \r
162 <p>&nbsp;</p>\r
163 \r
164 <p>&nbsp;</p>\r
165 \r
166 <p><a name=QuadrangleFace><img src="image29.gif" width="23px" height="22px" border="0" class="img_whs4"><span style="font-size: 14pt; font-weight: bold;"><font size=4 style="font-size:14pt;"><B>Quadrangle \r
167  face</B></font></span></a></p>\r
168 \r
169 <p>&nbsp;</p>\r
170 \r
171 <p class="whs5"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b style="font-weight: bold;">Description:</b> \r
172  Builds a face using the below mentioned arguments. This operation allows \r
173  to build a face bypassing the intermediate stage of building edges and \r
174  wires (in the case of building by 4 points) or wires (in the case of building \r
175  by 4 or 2 edges).</font></span></p>\r
176 \r
177 <p class="whs5">&nbsp;</p>\r
178 \r
179 <p class="whs5"><b><span style="font-size: 12pt; font-weight: normal;"><font size=3 style="font-size:12pt;">T</b><b>he</font></span><span \r
180  style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> Result </font></span><span style="font-size: 12pt; font-weight: normal;"><font size=3 style="font-size:12pt;">of \r
181  the operation will be a</font></span></b><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b> GEOM_Object</b></font></span><span \r
182  style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> (face).</font></span></p>\r
183 \r
184 <p class="whs5">&nbsp;</p>\r
185 \r
186 <p class="whs5"><b style="font-weight: bold;">TUI Command:</b></p>\r
187 \r
188 <ul type="disc" class="whs3">\r
189         \r
190         <li class=kadov-p><p class="whs6"><b style="font-weight: normal;">geompy.MakeQuad4Vertices(V1, \r
191  V2, V3, V4), <span style="font-style: normal;">where V1, V2, V3, V4 are \r
192  four vertices from which a face is constructed. Edges are created automatically.</span></b></p></li>\r
193         \r
194         <li class=kadov-p><p class="whs5"><span style="font-style: italic;"><I>geompy.MakeQuad2Edges(E1, \r
195  E2)</I></span>, where E1, E2 are edges from which the face is constructed, \r
196  two other edges are created automatically.</p></li>\r
197         \r
198         <li class=kadov-p><p class="whs5"><b style="font-weight: normal;"><span \r
199  style="font-style: italic;"><I>g</b>eompy.MakeQuad(E1, E2, E3, E4)</I></span>, \r
200  where E1, E2, E3, E4 are four edges from which the face is constructed.</p></li>\r
201 </ul>\r
202 \r
203 <p class="whs5">&nbsp;</p>\r
204 \r
205 <p class="whs5"><b style="font-weight: bold;">Arguments:</b> \r
206  </p>\r
207 \r
208 <ul type="disc" class="whs3">\r
209         \r
210         <li class=kadov-p><p class="whs5">Name + 4 Points, or</p></li>\r
211         \r
212         <li class=kadov-p><p class="whs5">Name + 2 Edges, or </p></li>\r
213         \r
214         <li class=kadov-p><p class="whs5">Name + 4 Edges.</p></li>\r
215 </ul>\r
216 \r
217 <p class="whs5">&nbsp;</p>\r
218 \r
219 <p class="whs5"><b style="font-weight: bold;">Dialog Box:</b></p>\r
220 \r
221 <table x-use-null-cells cellspacing="0" width="66.515%" class="whs7">\r
222 <col class="whs8">\r
223 <col class="whs9">\r
224 <col class="whs10">\r
225 \r
226 <tr valign="top" class="whs11">\r
227 <td width="32.996%" class="whs12">\r
228 <p><img src="pics/block1.png" x-maintain-ratio="TRUE" width="312px" height="410px" border="0" class="img_whs13"></td>\r
229 <td width="33.052%" class="whs14">\r
230 <p><img src="pics/block2.png" x-maintain-ratio="TRUE" width="312px" height="410px" border="0" class="img_whs13"></td>\r
231 <td width="33.952%" class="whs15">\r
232 <p><img src="pics/block3.png" x-maintain-ratio="TRUE" width="312px" height="410px" border="0" class="img_whs13"></td></tr>\r
233 </table>\r
234 \r
235 <p class="whs5">&nbsp;</p>\r
236 \r
237 <p>&nbsp;</p>\r
238 \r
239 <p class="whs16">Example:</p>\r
240 \r
241 <p class="whs16">&nbsp;</p>\r
242 \r
243 <p class="whs17"><img src="image185.jpg" width="250px" height="195px" border="0" class="img_whs18"> </p>\r
244 \r
245 <p>&nbsp;</p>\r
246 \r
247 <p>&nbsp;</p>\r
248 \r
249 <p><a name=HexahedralSolid><img src="image51.gif" width="24px" height="22px" border="0" class="img_whs19"> <span style="font-size: 14pt; font-weight: bold;"><font size=4 style="font-size:14pt;"><B>Hexahedral \r
250  solid</B></font></span></a></p>\r
251 \r
252 <p>&nbsp;</p>\r
253 \r
254 <p class="whs5"><b style="font-weight: bold;">Description:</b> \r
255  Builds a hexahedral solid. either of the below mentioned arguments. This \r
256  operation allows to build a solid bypassing the intermediate stage of \r
257  building a shell and 4 faces (in the case of building by 2 faces) or just \r
258  a shell (in the case of building by 6 faces).</p>\r
259 \r
260 <p class="whs5">&nbsp;</p>\r
261 \r
262 <p class="whs5"><b style="font-weight: bold;"><span style="font-weight: normal;">The</span> \r
263  Result<span style="font-weight: normal;"> of the operation will be a</span></b><b> \r
264  GEOM_Object</b> (solid).</p>\r
265 \r
266 <p>&nbsp;</p>\r
267 \r
268 <p class="whs5"><b style="font-weight: bold;">TUI Command:</b></p>\r
269 \r
270 <ul type="disc" class="whs3">\r
271         \r
272         <li class=kadov-p><p class="whs5"><span style="font-style: italic;"><I>geompy.MakeHexa2Faces(F1, \r
273  F2)</I></span><span style="font-style: italic;"><I>, where F1 and F2 are faces \r
274  from which the hexahedron is constructed, other four faces are created \r
275  automatically.</I></span></p></li>\r
276         \r
277         <li class=kadov-p><p class="whs5"><span style="font-style: italic;"><I>geompy.MakeHexa(F1, \r
278  F2, F3, F4, F5, F6)</I></span>, where F1 \96 F6 are six faces from which the \r
279  hexahedron is constructed.</p></li>\r
280 </ul>\r
281 \r
282 <p class="whs5">&nbsp;</p>\r
283 \r
284 <p class="whs5"><b style="font-weight: bold;">Arguments:</b> \r
285  </p>\r
286 \r
287 <ul type="disc" class="whs3">\r
288         \r
289         <li class=kadov-p><p class="whs5">Name + 2 Faces, or </p></li>\r
290         \r
291         <li class=kadov-p><p class="whs5">Name + 6 Faces.</p></li>\r
292 </ul>\r
293 \r
294 <p class="whs5">&nbsp;</p>\r
295 \r
296 <p class="whs5"><b style="font-weight: bold;">Dialog Box:</b></p>\r
297 \r
298 <p class="whs5">&nbsp;</p>\r
299 \r
300 <table x-use-null-cells cellspacing="0" width="40.406%" class="whs20">\r
301 <col class="whs21">\r
302 <col class="whs22">\r
303 \r
304 <tr valign="top" class="whs11">\r
305 <td width="49.761%" class="whs23">\r
306 <p class="whs5"><b style="font-weight: bold;">&nbsp;<img src="pics/block4.png" x-maintain-ratio="TRUE" width="312px" height="324px" border="0" class="img_whs24"></b></td>\r
307 <td width="50.239%" class="whs25">\r
308 <p><img src="pics/block5.png" x-maintain-ratio="TRUE" width="312px" height="464px" border="0" class="img_whs26"></td></tr>\r
309 \r
310 <tr valign="top" class="whs11">\r
311 <td colspan="1" rowspan="1" width="49.761%" class="whs27">\r
312 <p class="whs5">&nbsp;</td>\r
313 <td colspan="1" rowspan="1" width="50.239%" class="whs28">\r
314 <p>&nbsp;</td></tr>\r
315 </table>\r
316 \r
317 <p class="whs5">&nbsp;</p>\r
318 \r
319 <p class="whs29">Example:</p>\r
320 \r
321 <p class="whs29">&nbsp;</p>\r
322 \r
323 <p class="whs30"><img src="image180.jpg" x-maintain-ratio="TRUE" width="300px" height="234px" border="0" class="img_whs31"> &nbsp;&nbsp;&nbsp;<img src="image181.jpg" width="251px" height="234px" border="0" class="img_whs32"> &nbsp;</p>\r
324 \r
325 <p class="whs33"><b style="font-weight: bold;">&nbsp;&nbsp;&nbsp;</b>&nbsp;&nbsp;</p>\r
326 \r
327 <p class="whs5">Our <span style="font-weight: bold;"><B>TUI Scripts</B></span> \r
328  provide you with useful examples of <a href="building_by_blocks.htm">Building \r
329  by Blocks</a>. </p>\r
330 \r
331 <p>&nbsp;</p>\r
332 \r
333 <script type="text/javascript" language="javascript1.2">\r
334 <!--\r
335 if (window.writeIntopicBar)\r
336         writeIntopicBar(0);\r
337 //-->\r
338 </script>\r
339 </body>\r
340 </html>\r