Salome HOME
0020654: [CEA 386] GetType() function
[modules/geom.git] / doc / salome / gui / GEOM / input / building_by_blocks.doc
1 /*!
2
3 \page build_by_blocks_page Building by blocks
4
5 <h2>Introduction</h2>
6
7 Below are some general notions about blocks:
8
9 A block is a an elementary geometric solid that has specific
10 geometric constraints oriented for meshing. In the hexahedral case,
11 blocks have 6 faces and each face has 4 edges.
12
13 Tetrahedral Block - is a block with constraints for tetrahedral
14 meshing.
15
16 Hexahedral Block - is a block with constraints for hexahedral meshing.
17
18 Block Compound - is a compound composed of blocks only.
19
20 These functionalities are available from the main menu via <em>New
21 Entity / Blocks</em>.
22
23 <ul>
24 <li>\ref quad_face_anchor "Quadrangle face"</li>
25 <li>\ref hexa_solid_anchor "Hexahedral solid"</li>
26 </ul>
27
28 <br>
29 \anchor quad_face_anchor
30 <h2>Quadrangle face</h2>
31
32 \n <b>Description:</b> Builds a face using the below mentioned
33 arguments. This operation allows to build a face bypassing the
34 intermediate stage of building edges and wires (in the case of
35 building by 4 points) or wires (in the case of building by 4 or 2
36 edges).
37
38 \n The \b Result of the operation will be a \b GEOM_Object (face).
39
40 \n <b>TUI Command:</b>
41 <ul>
42 <li><em>geompy.MakeQuad4Vertices(V1, V2, V3, V4),</em> where V1, V2,
43 V3, V4 are four vertices from which a face is constructed. Edges are
44 created automatically.</li>
45 <li><em>geompy.MakeQuad2Edges(E1, E2),</em> where E1, E2 are edges from
46 which the face is constructed, two other edges are created
47 automatically.</li>
48 <li><em>geompy.MakeQuad(E1, E2, E3, E4),</em> where E1, E2, E3, E4 are
49 four edges from which the face is constructed.</li>
50 </ul>
51
52 <b>Arguments:</b>
53 <ul>
54 <li>Name + 4 Points, or</li>
55 <li>Name + 2 Edges, or</li>
56 <li>Name + 4 Edges.</li>
57 </ul>
58
59 \n <b>Dialog Box:</b>
60
61 \image html block1.png
62
63 \image html block2.png
64
65 \image html block3.png
66
67 \n <b>Example:</b>
68 \image html image185.png "Quadrangle face built by blocks"
69
70
71 <br><br>
72 \anchor hexa_solid_anchor
73 <h2>Hexahedral solid</h2>
74
75 \n <b>Description:</b> Builds a hexahedral solid. either of the below
76 mentioned arguments. This operation allows to build a solid bypassing
77 the intermediate stage of building a shell and 4 faces (in the case of
78 building by 2 faces) or just a shell (in the case of building by 6
79 faces).
80
81 \n The \b Result of the operation will be a \b GEOM_Object (solid).
82
83 \n <b>TUI Command:</b>
84 <ul>
85 <li><em>geompy.MakeHexa2Faces(F1, F2),</em> where F1 and F2 are faces
86 from which the hexahedron is constructed, other four faces are created
87 automatically.</li>
88 <li><em>geompy.MakeHexa(F1, F2, F3, F4, F5, F6),</em> where F1 &mdash; F6 are six faces from which the hexahedron is constructed.</li>
89 </ul>
90
91 \n <b>Arguments:</b>
92 <ul>
93 <li>Name + 2 Faces, or</li>
94 <li>Name + 6 Faces.</li>
95 </ul>
96
97 \n <b>Dialog Box:</b>
98
99 \image html block4.png
100
101
102
103 \image html block5.png
104
105 \n <b>Example:</b>
106
107 \image html image180.png
108 <center>Hexahedral Solid built on the base of six Faces</center>
109
110 \image html image181.png
111 <center>Hexahedral Solid built on the base of two Faces</center>
112
113
114 The created blocks can be processed with  \ref blocks_operations_page "Operations on Blocks".
115
116 Our <b>TUI Scripts</b> provide you with useful examples of
117 \ref tui_building_by_blocks_page "Building by Blocks".
118
119 */