X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Freorient_faces.doc;h=20346a9dc54510ae63e1972d6557928c5c2d8d5b;hp=f637aecfda4556086ce5331232250123bde52a0e;hb=324d433f277a1ec6552c93db878504f447f8fbad;hpb=bd4e115a78b52e3fbc016e5e30bb0e19b2a9e7d6

diff --git a/doc/salome/gui/SMESH/input/reorient_faces.doc b/doc/salome/gui/SMESH/input/reorient_faces.doc
index f637aecfd..20346a9dc 100644
--- a/doc/salome/gui/SMESH/input/reorient_faces.doc
+++ b/doc/salome/gui/SMESH/input/reorient_faces.doc
@@ -1,61 +1,93 @@
 /*!
 
-\page reorient_faces_page Reorient faces by vector
+\page reorient_faces_page Reorient faces
 
-\n This operation allows changing orientation of a set of neighboring
-faces. The desired orientation is defined by a vector. Since direction
-of face normals in the set can be even opposite, it is necessary to
-specify a control face whose normal will be compared with the vector. This
-face can be specified either explicitly or can be found by closeness to
-a given point.
+\n This operation allows changing the orientation of a set faces in the following ways:
+<ul>
+<li>The new orientation of a set of neighboring faces can be defined  
+  by a vector. <br> Since the direction of face normals in
+  the set can be even opposite, it is necessary to specify a control
+  face, the normal to which will be compared with the vector. This face can be
+  either:
+  <ul>
+    <li>found by proximity to a given point, or</li> 
+    <li>specified explicitly.</li> 
+  </ul>
+</li>
+<li>Alternatively, the faces can be oriented relatively to the adjacent volumes.</li>
+</ul>
 
-Orientation of a face is changed by reverting the order of its nodes.
+The orientation of a face is changed by reverting the order of its nodes.
 
 <em>To change orientation of faces:</em>
 <ol>
-<li>In the \b Modification menu select the <b>Reorient faces by
-    vector</b> item or click <em>Reorient faces by
-    vector</em> button in the toolbar.
+<li>In the \b Modification menu select <b>Reorient faces</b>
+  item or click <em>Reorient faces</em> button in the toolbar.
 
 <center>
 \image html reorient_faces_face.png
-<em>"Reorient faces by vector" button</em>
+<em>"Reorient faces" button</em>
 </center>
+</li>
+
+<li>In the "Reorient faces" dialog box
 
-The following dialog box will appear:
+<ul>
+<li>Select the \b Object (mesh, sub-mesh or group)
+  containing faces to reorient, in the Object Browser or in the 3D
+  Viewer.</li>
 
+<li>To reorient according to vector:
+    <ul>
+    <li>Specify the coordinates of the \b Point by which the control face
+      will be found. You can easy specify the \b
+      Point by either picking a node in the 3D Viewer or selecting a vertex
+      in the Object Browser. It is possible to pick the \b Face by mouse in
+      the 3D Viewer or enter its ID.</li>
+    <li>Set up the \b Direction vector to be compared with the normal of the
+      control face. If you pick a node in the 3D Viewer then the \b Direction
+      vector will go from the coordinate system origin to the selected node.
+      If you pick two nodes (holding Shift button) then the \b Direction vector
+      will go from the first to the second node.</li>
+    </ul>
+
+<br>
 <center>
-\image html reorient_2d_point.png
-\image html reorient_2d_face.png
+\image html reorient_2d_point.png "The orientation of adjacent faces is chosen according to a vector. The control face is found by point."
+</center>
+
+</li>
+
+<li>In the second mode it is possible to directly input the \b Face ID in the corresponding field.
+
+<center>
+\image html reorient_2d_face.png "The orientation of adjacent faces is chosen according to a vector. The control face is explicitly given."
 </center>
 
-<li>In this dialog
-<ul>
-<li>Specify a way of selection of the control face: by point or
-  explicitely.</li>
-<li>Select an \b Object containing faces to reorient, either in the Object
-  Browser or in the 3D Viewer; it can be either <ul>
-    <li>group of faces,</li>
-    <li>sub-mesh of faces or</li>
-    <li>mesh.</li>
-    </ul></li>
-<li>Specify either coordinates of a \b Point by which the control face
-  will be found or the control \b Face it-self. You can easy specify the \b
-  Point by either picking a node in the 3D Viewer or by selecting a vertex
-  in the Object Browser. The \b Face can be either picked by mouse in
-  the 3D Viewer or its ID can be entered by typing.</li>
-<li>Set up a \b Direction to be compared with the normal of the
-  control face. You can either pick a node in the 3D Viewer then a \b Direction
-  from the coordinate system origin to the selected node will be set,
-  or you can pick two nodes (holding Shift button) then a \b Direction
-  from the first to the second node will be set.</li>
-</ul>
 </li>
 
+<li>In the third mode, the faces can be reoriented according to volumes:
+    <ul>
+    <li>Select an object (mesh, sub-mesh or group) containing
+      reference \b Volumes, in the Object Browser or in the 3D
+      Viewer.</li>
+    <li>Specify whether face normals should point outside or inside
+      the reference volumes using <b>Face normal outside volume</b>
+      check-box.</li>
+    </ul>
+
+<br>
+<center>
+\image html reorient_2d_volume.png "The orientation of faces is chosen with relation to adjacent volumes."
+</center>
+
+</li>
+</ul>
+
 <li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
 </ol>
 
 <br><b>See Also</b> a sample TUI Script of a
-\ref tui_reorient_faces "Reorient faces by vector" operation. 
+\ref tui_reorient_faces "Reorient faces" operation. 
 
 */