From: nds <nds@opencascade.com>
Date: Thu, 17 Nov 2016 10:58:01 +0000 (+0300)
Subject: Help page for annotation correction.
X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=c85f9d007ccc7f8fb2a122784b9830352be2d9ba;p=modules%2Fgeom.git

Help page for annotation correction.
---

diff --git a/doc/salome/gui/GEOM/input/annotation.doc b/doc/salome/gui/GEOM/input/annotation.doc
index d85bfe48f..589e9fc53 100644
--- a/doc/salome/gui/GEOM/input/annotation.doc
+++ b/doc/salome/gui/GEOM/input/annotation.doc
@@ -3,33 +3,17 @@
 \page annotation_page Shape annotation
 
 <b> Annotation </b> functionality allows showing in the viewer special user-defined text label connected to corresponding part of a CAD model with a line.
+Annotation text is always parallel to the screen and horizontal. It is is not zoomed or rotated when a 3D scene is zoomed or rotated by the user.
+The annotation text is defined using UTF-8 encoding and thus support any Unicode characters.
 
-\image html annotation_preview.png
-
-Shape annotation behavior are summarized below:
+There are several algorithms for the annotation position calculation during the scene manipulations (panning, zooming, rotation):
 <ul>
-  <li>Annotation text is always parallel to the screen and horizontal.</li>
-  <li>Annotation text is not zoomed or rotated when a 3D scene is zoomed or rotated by the user.</li>
-  <li>The user is able to modify the font, the style, the color and the size of the annotation text and the color, the width and the style of the connection line applied to all annotations.
-It can be accessed from the main menu via <b>File -> Preferences</b>. The Shape annotations group on Geometry Settings pane contains controls for it.
-  </li>
-  <li>The annotation text is defined using UTF-8 encoding and thus support any Unicode characters.</li>
-  <li>Position of an annotation in a 3D view is defined by dragging it with the mouse.</li>
-  <li>There are several algorithms for the annotation position calculation during the scene manipulations (panning, zooming, rotation):</li>
-  <ul>
-    <li> Algorithm 1: an annotation has fixed position in 2D screen coordinates (fixed screen position mode). In this mode, the annotations are always visible (appear as “topmost objects”), never hidden by the (annotated) geometry.</li>
-    <li>Algorithm 2: an annotation has fixed position in 3D model space, this position is projected onto the screen just as normal point coordinates. In this mode, some annotations may be invisible depending on the camera (position, orientation, zoom).</li>
-  </ul>
-  <li>Annotations appear in an Annotations sub-tree in Text Browser.</li>
-  <li>All annotations may be shown/hidden in a 3D view using corresponded popup menu on Annotations item in Text Browser.</li>
-  <li>Annotations of a shape may be shown/hidden in a 3D view using corresponded popup menu on the shape item in Object Browser.</li>
-  <li>Annotation is logically connected to the shape:</li>
-  <ul>
-    <li>Selection of an annotation will highlight corresponding shape/subshape in 3D view.</li>
-    <li>When the shape is deleted, the annotation will be also deleted.</li>
-  </ul>
+  <li>Algorithm 1: an annotation has fixed position in 2D screen coordinates (fixed screen position mode). In this mode, the annotations are always visible (appear as topmost objects), never hidden by the (annotated) geometry.</li>
+  <li>Algorithm 2: an annotation has fixed position in 3D model space, this position is projected onto the screen just as normal point coordinates. In this mode, some annotations may be invisible depending on the camera (position, orientation, zoom).</li>
 </ul>
 
+\image html annotation_preview.png
+
 It can be accessed from the main menu via <b>Inspection -> Annotation </b>
 
 \image html annotation.png "Create Annotation dialog"
@@ -46,6 +30,10 @@ In this dialog you can:
   <li>Dragging of annotation presentation in 3D view to select an appropriate position.
 </ul>
 
+Annotations appear in an Annotations sub-tree in Text Browser.</li>
+All annotations may be shown/hidden in a 3D view using corresponded popup menu on Annotations item in Text Browser.
+Annotations of a shape may be shown/hidden in a 3D view using corresponded popup menu on the shape item in Object Browser.
+
 The foolowing context menu commands are provided for annotation object in Text Browser:
 <ul>
   <li><b>Edit</b> allows modifying the annotation text, the positioning algorithm and the annotation position.</li>
@@ -56,5 +44,13 @@ The foolowing context menu commands are provided for annotation object in Text B
 <b>Edit</b> and <b>Delete</b> actions are also available in View 3d for selected annotation object/s.
 
 Synchronization of selection between 3D view and Text browser is available. That means that selection of annotation in 3D view will select this annotation in Text browser and vice versa.
+Annotation is logically connected to the shape:
+<ul>
+  <li>Selection of an annotation will highlight corresponding shape/subshape in 3D view.</li>
+  <li>When the shape is deleted, the annotation will be also deleted.</li>
+</ul>
+
+The user is able to modify the font, the style, the color and the size of the annotation text and the color, the width and the style of the connection line applied to all annotations.
+It can be accessed from the main menu via <b>File -> Preferences</b>. The Shape annotations group on Geometry Settings pane contains controls for it.
 
 */