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

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