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 desired orientation of a set of neighboring faces can be defined
   9   by a vector giving a desired direction of a normal of 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 either 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 either 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 with relation 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 */