Salome HOME
21854: Add persistent dimensions
[modules/geom.git] / doc / salome / gui / GEOM / input / add_dimension.doc
1 /*! \r
2 \r
3 \page add_dimension_page Add Dimension\r
4 \r
5 \image html add_dimension.png\r
6 \r
7 The dialog is opened from \ref managing_dimensions_page "Manage Dimensions" dialog when "Add" button is clicked.\r
8 This dialog allows creating measurement dimension for the selected geometrical object.\r
9 The following types of dimensions can be constructed:\r
10 <ul>\r
11 <li>Length.</li>\r
12 <li>Diameter.</li>\r
13 <li>Angle.</li>\r
14 </ul>\r
15 \r
16 Being constructed, the dimension is positioned by application such that the user is able to see it from the most appropriate angle of view.\r
17 The application selects one of the best matching planes allowed for the dimension. If extending the dimension by increasing length of flyouts\r
18 make sense, then the application extends the flyouts for a default value specified on the \ref geometry_preferences_page "geometry preference dialog".\r
19 \r
20 Once constructed, the geometrical properties of dimension preview (flyout, plane) become interactively editable in OCC viewer.\r
21 For the description of interactive operations please refer to corresponding section at \ref managing_dimensions_page "Manage Dimensions" page.\r
22 \r
23 The legnth dimension can be constructed in three ways: as length on edge, as length between two points and as length between two parallel lines.\r
24 In order to construct the dimension, the selected geometry should met the following conditions:\r
25 <ul>\r
26 <li>Edge length - only the line edges are accepted. E.g. constructed from line segment, on two points.</li>\r
27 <li>Two points - any two points.</li>\r
28 <li>Parallel edges - only the parallel line edges are accepted.</li>\r
29 </ul>\r
30 \r
31 The diameter dimension can be constructed for the following geometry types:\r
32 <ul>\r
33 <li>Arc and circle. The selected geometry should be an arc, a circular edge or a circular face.</li>\r
34 <li>Sphere, cylinder, cone, torus.</li>\r
35 </ul>\r
36 \r
37 The angle dimension can be constructed in two ways: as angle between two edges, as angle by three points.\r
38 The following conditions should be met:\r
39 <ul>\r
40 <li>Two edges. The edges should be located in same plane.\r
41 <li>Three points. Any three points, with the second point being the center of the angle.\r
42 </ul>\r
43 \r
44 */\r