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

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