Salome HOME
0022618: [CEA 1062] Define the transparency by default in the preferences
[modules/geom.git] / doc / salome / gui / GEOM / input / managing_dimensions.doc
index 83c1df9fbf2c77d0dd8a1d2cf44f9f4b523412ed..13187978b13a5370dccb9a231fd43d0d8e21aad9 100644 (file)
@@ -2,63 +2,72 @@
 \r
 \page managing_dimensions_page Manage Dimensions\r
 \r
-\image html dimensions_preview.png\r
-\r
-Dimensions of sub-elements can be measured for a geometrical object representing a shape. \r
-There are three types of dimensions available\r
-<ul>\r
-<li>Length.</li>\r
-<li>Diameter.</li>\r
-<li>Angle.</li>\r
-</ul>\r
-\r
-Measurement units and group of presentation attributes for the measurement dimensions can be seen and changed from the \ref geometry_preferences_page "geometry preference dialog".\r
+<b> Manage Dimensions </b> functionality allows showing in the viewer the measured dimensions of sub-elements of a geometrical object (shape). \r
 \r
-The application entities, representing the dimensions, are associated with the geometrical object for which its elements are measured. The dimensions follow their associated object on show/hide, transformation and deletion operations.\r
+\image html dimensions_preview.png\r
 \r
-Each dimension instance has its <i>local visibility</i> flag intended for showing/hiding it among other dimensions of the associated object.\r
+It can be accessed from the main menu via <b>Measures -> Dimensions -> Manage Dimensions </b>\r
 \r
 \image html manage_dimensions.png\r
 \r
-This dialog allows managing list of dimensions for the selected geometrical object.\r
-It shows the list and provides dimension creation and removal, modification of name and visibility, along with the interactive modification of dimension's geometrical properties.\r
+<b>List of Dimensions</b>\r
 \r
-The list view groups dimension objects by their type: "Distances", "Diameters", "Angles". This view allows selection of the dimensions and lets user to change the dimension's name and visibility.\r
+This dialog provides the list of dimensions shown in the view for the selected geometrical <b>Object</b>. The list items are sorted by  dimension type: <b>Distance</b>, <b>Diameter</b> and <b>Angle</b>. \r
 \r
-The buttons located at the right side of the dialog have the following purposes:\r
+It is possible to show/hide a dimension in the view by checking on/off the box to the left of its name. \r
+\r
+The buttons to the right of the list provide the following operations:\r
 <ul>\r
-<li>"Add" - opens \ref add_dimension_page "Add Dimension" dialog for interactive specification of a new dimension for the selected object.</li>\r
-<li>"Remove" - removes selected instance of dimension.</li>\r
-<li>"Show All" / "Hide All" - turn on/off local visibility flags of all dimensions presented in the list.</li>\r
+<li>"Add" - opens \ref add_dimension_page "Add Dimension" dialog to define a new fly-out.</li>\r
+<li>"Remove" - removes the selected item from the list.</li>\r
+<li>"Show All" / "Hide All" - shows/hides all dimensions existing in the list.</li>\r
 </ul>\r
 \r
-\image html interact_with_dimensions.png\r
+<b>Add a Dimension</b>\r
+\r
+To add a new dimension to the object presentation, click <b>Add</b> button in the <b>Manage Dimensions</b> dialog.  \r
 \r
-Geometrical properties of the selected dimension become interactively editable in viewer.\r
-When hovering with mouse, the element of dimension become highlighted.\r
-This means that the element is ready for interactive operations.\r
+\image html add_dimension.png\r
 \r
-The following interactive operations are allowed:\r
+The following dimensions can be shown:\r
+\r
+<ul>\r
+<li> <b>Length.</b> There are three possible types of length dimensions: \r
 <ul>\r
-<li>Modification of flyout length. By dragging the flyout with left mouse button the user is allowed to change its length without changing its plane (direction).</li>\r
-<li>Modification of flyout length & plane (direction). If dimension is viewed at least slightly from side, then dragging the flyout with holding <i>ctrl</i> key additionally enables modification of the flyout plane.</li>\r
-<li>Modification of label alignment. By dragging the label the user is allowed to change its alignment. </li>\r
+<li> <b>Edge length</b> - shows the length of the edge selected in the viewer. Only line edges, i.e. line segments built on two points are accepted. </li>\r
+<li> <b>Two points </b> - shows the distance between two points selected in the viewer.</li>\r
+<li> <b>Parallel edges</b> - shows the distance between two parallel line edges.</li>\r
 </ul>\r
+</li>\r
+\r
+<li> <b>Diameter </b> of an an arc, a circular edge or face, a sphere, a cylinder, a cone or a  torus.</li> \r
+\r
+<li> <b>Angle.</b> The angle dimension can be defined in one of two possible ways :  </li>\r
 \r
-The following horizontally aligned positions can be specified:\r
 <ul>\r
-<li>Left. Label is located outside of the left flyout line.</li>\r
-<li>Right. Label is located outside of the right flyout line.</li>\r
-<li>Center. Label is centered among of the flyout lines.</li>\r
+<li>By selecting <b>Two edges</b> located in the same plane.</li>\r
+<li>By selecting <b>Three points</b>. The second point is in the corner of the angle.</li>\r
+</ul>\r
 </ul>\r
 \r
-The following vertically aligned positions can be specified:\r
+<b>Modification of Dimension properties</b>\r
+\r
+The default properties of dimension text and line, such as font color, line width, measurement units, etc. can be defined from the \ref geometry_preferences_page "Geometry preferences".\r
+\r
+It is also possible to change the geometrical properties of the selected dimension interactively in the viewer. \r
+\r
+When hovering with mouse, the text and line become highlighted, which means that the dimension is ready for interactive operations.\r
+\r
+\image html interact_with_dimensions.png\r
+\r
+The following operations are possible:\r
 <ul>\r
-<li>On flyout line. The label is located at the side of flyout line, which is farther from the measured geometry.</li>\r
-<li>Under flyout line. The label is located at the side of flyout line, which is closer to the measured geometry.</li>\r
-<li>In center of flyout line.</li>\r
+<li>To change the fly-out of a dimension text without changing its plane (direction), drag it by mouse with left mouse button pressed.</li>\r
+<li>To change both the fly-out and the plane (direction) of a dimension text, drag the flyout by mouse with both <i>ctrl</i> key and additionally enables modification of the flyout plane.</li>\r
+<li>To modify the location of the dimension text correspondingly to the dimension line, drag it by mouse. The text can be aligned horizontally or vertically and located on the line, under it or in its center.</li>\r
 </ul>\r
 \r
-All of the modifications to the dimensions, until applied, are temporary. The "Apply" and "Apply and Close" buttons save the changes.\r
+All modifications of the dimensions are temporary. The "Apply" and "Apply and Close" buttons save the changes.\r
+\r
 \r
 */\r