From: akl <alexander.kovalev@opencascade.com>
Date: Fri, 22 May 2015 10:28:25 +0000 (+0400)
Subject: Documentation for 22888: EDF 10437 GEOM: Dimensions improvements.
X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=refs%2Fheads%2Fakl%2F22888;p=modules%2Fgeom.git

Documentation for 22888: EDF 10437 GEOM: Dimensions improvements.
---

diff --git a/doc/salome/gui/GEOM/images/dimensions_tree_widget.png b/doc/salome/gui/GEOM/images/dimensions_tree_widget.png
new file mode 100644
index 000000000..eed9d435e
Binary files /dev/null and b/doc/salome/gui/GEOM/images/dimensions_tree_widget.png differ
diff --git a/doc/salome/gui/GEOM/images/pref15.png b/doc/salome/gui/GEOM/images/pref15.png
index d2b5966a6..0c4cc837c 100644
Binary files a/doc/salome/gui/GEOM/images/pref15.png and b/doc/salome/gui/GEOM/images/pref15.png differ
diff --git a/doc/salome/gui/GEOM/input/arranging_study_objects_page.doc b/doc/salome/gui/GEOM/input/arranging_study_objects_page.doc
index e496e02f2..b936d6002 100644
--- a/doc/salome/gui/GEOM/input/arranging_study_objects_page.doc
+++ b/doc/salome/gui/GEOM/input/arranging_study_objects_page.doc
@@ -70,5 +70,19 @@ used to create the selected object.
 - The table below lists \b Parameters used to create the
 selected object and their \b Values.
 
+\anchor dimensions_text_window
+<h2>Text Window</h2>
+Below Information window, there is \b Text
+window containing tree of geometric objects with created dimensions:
+
+\image html dimensions_tree_widget.png Text window
+
+As soon as some dimensions have been created and submitted using
+\ref managing_dimensions_page "Manage Dimensions tool", 
+they are shown in Text window tree as a child of corresponding parent shape.
+This tree provides a possibility to manage of dimensions visibility using <b>Show</b>/<b>Hide</b> context menu items or 
+by click on 'eye' icons in Text window.
+\note Hidden shapes and its dimensions are shown in Text tree, but disabled. Show/Hide operations are not applicable for these objects in such a case.
+
 */
 
diff --git a/doc/salome/gui/GEOM/input/geometry_preferences.doc b/doc/salome/gui/GEOM/input/geometry_preferences.doc
index 87bb9fc56..0bf5e2e8b 100644
--- a/doc/salome/gui/GEOM/input/geometry_preferences.doc
+++ b/doc/salome/gui/GEOM/input/geometry_preferences.doc
@@ -67,17 +67,26 @@ of values set in spin boxes.</li>
 </ul>
 </ul>
 
+\anchor dimensions_preferences
 <ul>
 <li><b>Dimensions (Measurements)</b> - a group of preferences controlling the presentation of dimensions.</li>
 <ul>
 <li><b>Color</b> - allows to define color for persistent dimension presentations.</li>
 <li><b>Line width</b> - allows to define pixel width of dimension lines.</li>
-<li><b>Font height</b> - allows to define height of dimension text.</li>
+<li><b>Font</b> - allows to define font family and height of dimension text. 
+By default Y14.5M-2009 font is set. It is a standard for the design language of geometric dimensioning. 
+But it is possible to select another font supported by OCCT. 
+Dimension's height is in pixels for 2D text and in model units for 3D text.</li>
 <li><b>Length of arrows</b> - allows to define length of dimension arrows.</li>
 <li><b>Length measurement units</b> - allows to define units of measurement for lengths dimensions.</li>
 <li><b>Angle measurement units</b> - allows to define units of measurement for angles dimensions.</li>
 <li><b>Show units of measurements</b> - when this option is on, the measurement units are added as prefix to value label of dimension.</li>
 <li><b>Default flyout length</b> - allows to define default flyout length used when creating the dimensions. The length can be interactively changed after creation by moving the flyouts.</li>
+<li><b>Use 3D text</b> - this option switches the dimension representation from default 2D to 3D: </li>
+<ul>
+<li>2D text is horizontal and parallel to the screen always.</li>
+<li>3D text takes place in plane of measurement and has constant orientation.</li>
+</ul>
 </ul>
 </ul>
 
diff --git a/doc/salome/gui/GEOM/input/managing_dimensions.doc b/doc/salome/gui/GEOM/input/managing_dimensions.doc
index 8b49f3ad1..0903c5e81 100644
--- a/doc/salome/gui/GEOM/input/managing_dimensions.doc
+++ b/doc/salome/gui/GEOM/input/managing_dimensions.doc
@@ -52,7 +52,7 @@ The following dimensions can be shown:
 
 <b>Modification of Dimension properties</b>
 
-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".
+The default properties of dimension text and line, such as font color, line width, measurement units, etc. can be defined from the \ref dimensions_preferences "Geometry preferences".
 
 It is also possible to change the geometrical properties of the selected dimension interactively in the viewer. 
 
@@ -69,5 +69,6 @@ The following operations are possible:
 
 All modifications of the dimensions are temporary. The "Apply" and "Apply and Close" buttons save the changes.
 
+If created dimensions are saved, then they are displayed in \ref dimensions_text_window "Text window" as a children of corresponding shapes.
 
 */