X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Freorient_faces.doc;h=96072cf4392471d858d77d177900d9ef75f6c979;hb=11bba48d41633960431c5ead19671abae3cf1d98;hp=f637aecfda4556086ce5331232250123bde52a0e;hpb=bd4e115a78b52e3fbc016e5e30bb0e19b2a9e7d6;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/reorient_faces.doc b/doc/salome/gui/SMESH/input/reorient_faces.doc
index f637aecfd..96072cf43 100644
--- a/doc/salome/gui/SMESH/input/reorient_faces.doc
+++ b/doc/salome/gui/SMESH/input/reorient_faces.doc
@@ -1,61 +1,96 @@
/*!
-\page reorient_faces_page Reorient faces by vector
+\page reorient_faces_page Orient 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 fixing the orientation of a set of faces in
+the following ways:
+
+- The required orientation of a set of neighboring faces can be defined
+ by a vector giving the direction of a normal to a certain face.
+ Since the direction of face normals in the set can be even opposite,
+ it is necessary to specify a \a control face, the normal to which
+ will be compared with the vector. This face can be either:
+
+ - found by proximity to a given point, or
+ - specified explicitly.
+
+
+- Alternatively, the faces can be oriented relatively to the adjacent volumes.
+
-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.
-To change orientation of faces:
+To set orientation of faces:
-- In the \b Modification menu select the Reorient faces by
- vector item or click Reorient faces by
- vector button in the toolbar.
+
- In the \b Modification menu select Reorient faces
+ item or click Reorient faces button in the toolbar.
\image html reorient_faces_face.png
-"Reorient faces by vector" button
+"Reorient faces" button
+
+
+- In the "Reorient faces" dialog box
-The following dialog box will appear:
+
+- Select the \b Object (mesh, sub-mesh or group)
+ containing faces to reorient, in the Object Browser or in the 3D
+ Viewer.
+- To reorient by direction of the face normal:
+
+ - Specify the coordinates of the \b Point by which the control face
+ will be found. You can specify the \b Point by picking a
+ node in the 3D Viewer or selecting a vertex in the Object
+ Browser.
+ - Set up the \b Direction vector to be compared with the normal of the
+ control face. There are following options:
+ - adjust vector components directly;
+ - select a vertex in the Object Browser or a node in the 3D
+ Viewer; their coordinates will define vector components;
+ - pick two nodes (holding Shift button), the \b Direction vector
+ will go from the first to the second node.
+
+
+
+
-\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."
+
+
+
+
+- In the second mode it is possible to pick the \b Face by mouse in the 3D Viewer or directly input the \b Face ID in the corresponding field.
+
+
+\image html reorient_2d_face.png "The orientation of adjacent faces is chosen according to a vector. The control face is explicitly given."
-
- In this dialog
-
-- Specify a way of selection of the control face: by point or
- explicitely.
-- Select an \b Object containing faces to reorient, either in the Object
- Browser or in the 3D Viewer; it can be either
- - group of faces,
- - sub-mesh of faces or
- - mesh.
-
-- 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.
-- 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.
-
+- In the third mode, the faces can be reoriented according to volumes:
+
+ - Select an object (mesh, sub-mesh or group) containing
+ reference \b Volumes, in the Object Browser or in the 3D
+ Viewer.
+ - Specify whether face normals should point outside or inside
+ the reference volumes using Face normal outside volume
+ check-box.
+
+
+
+
+\image html reorient_2d_volume.png "The orientation of faces is chosen relatively to adjacent volumes."
+
+
+
+
+
- Click the \b Apply or Apply and Close button to confirm the operation.
See Also a sample TUI Script of a
-\ref tui_reorient_faces "Reorient faces by vector" operation.
+\ref tui_reorient_faces "Reorient faces" operation.
*/