doc/salome/gui/SMESH/input/reorient_faces.doc

   1 /*!
   2
   3 \page reorient_faces_page Reorient faces
   4
   5 \n This operation allows changing orientation of faces two ways.
   6 <ol>
   7 <li> To reorient a set of neighboring faces by defining the desired
   8   orientation by a vector. <br> Since the direction of face normals in
   9   the set can be even opposite, it is necessary to specify a control
  10   face whose normal will be compared with the vector. This face can be
  11   either <ul>
  12     <li> found by proximity to a given point or </li>
  13     <li> specified explicitly. </li>
  14 </ul> </li>
  15 <li> To reorient faces with relation to adjacent volumes. </li>
  16 </ol>
  17
  18 Orientation of a face is changed by reverting the order of its nodes.
  19
  20 <em>To change orientation of faces:</em>
  21 <ol>
  22 <li>In the \b Modification menu select <b>Reorient faces</b>
  23   item or click <em>Reorient faces</em> button in the toolbar.
  24
  25 <center>
  26 \image html reorient_faces_face.png
  27 <em>"Reorient faces" button</em>
  28 </center>
  29
  30 The following dialog box will appear:
  31
  32 <center>
  33 \image html reorient_2d_point.png "First mode: to reorient adjacent faces according to a vector. The control face is found by point."
  34 <br>
  35 \image html reorient_2d_face.png "Second mode: to reorient adjacent faces according to a vector. The control face is explicitly given."
  36 <br>
  37 \image html reorient_2d_volume.png "Third mode: to reorient faces with relation to adjacent volumes."
  38 </center>
  39
  40 <li>In this dialog
  41 <ul>
  42 <li>Specify either of the tree operation modes.</li>
  43 <li>Select the \b Object (mesh, sub-mesh or group)
  44   containing faces to reorient, in the Object Browser or in the 3D
  45   Viewer.</li>
  46 <li>To reorient according to vector: <ul>
  47     <li>Specify the coordinates of the \b Point by which the control face
  48       will be found or the control \b Face itself. You can easy specify the \b
  49       Point by either picking a node in the 3D Viewer or selecting a vertex
  50       in the Object Browser. It is possible to pick the \b Face by mouse in
  51       the 3D Viewer or enter its ID.</li>
  52     <li>Set up the \b Direction vector to be compared with the normal of the
  53       control face. If you pick a node in the 3D Viewer then the \b Direction
  54       vector will go from the coordinate system origin to the selected node.
  55       If you pick two nodes (holding Shift button) then the \b Direction vector
  56       will go from the first to the second node.</li> </ul> </li>
  57 <li>To reorient according to volumes: <ul>
  58     <li>Select an object (mesh, sub-mesh or group) containing
  59       reference \b Volumes, in the Object Browser or in the 3D
  60       Viewer.</li>
  61     <li>Specify whether face normals should point outside or inside
  62       the reference volumes using <b>Face normal outside volume</b>
  63       check-box.</li></ul> </li>
  64 </ul>
  65 </li>
  66
  67 <li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
  68 </ol>
  69
  70 <br><b>See Also</b> a sample TUI Script of a
  71 \ref tui_reorient_faces "Reorient faces" operation.
  72
  73 */