doc/salome/gui/SMESH/input/rotation.doc

   1 /*!
   2
   3 \page rotation_page Rotation
   4
   5 \n This operation allows to rotate in space the mesh or
   6 some of its elements.
   7
   8 <em>To rotate the mesh:</em>
   9
  10 <ol>
  11 <li>From the \b Modification menu choose \b Transformation -> \b Rotation item  or click
  12 <em>"Rotation"</em> button in the toolbar.
  13
  14 \image html rotation_ico.png "Rotation button"
  15
  16 The following dialog will appear:
  17
  18 \image html rotation.png
  19
  20 </li>
  21
  22 <li>
  23 In this dialog:
  24 <ul>
  25 <li>specify the IDs of the elements which will be rotated:
  26
  27 <ul>
  28 <li><b>Select the whole mesh, submesh or group</b> activating this
  29 checkbox; or</li>
  30 <li>choose mesh elements with the mouse in the 3D Viewer. It is
  31 possible to select a whole area with a mouse frame; or</li>
  32 <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
  33 viewer; or</li>
  34 <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
  35 about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
  36 </ul>
  37 </li>
  38
  39 <li>specify the axis of rotation:
  40 <ul>
  41 <li>specify the cooordinates of the start \b Point of the vector of rotation;</li>
  42 <li>specify the \b Vector of rotation through the coordinates of its
  43 end point with respect to the coordinates of the start point;</li>
  44 </ul>
  45 </li>
  46 <li>specify the \b Angle of rotation </li>
  47
  48 <li>specify the conditions of rotation:
  49 <ul>
  50 <li>activate <b>Move elements</b> radio button to create  the source
  51 mesh (or elements) at the new location and erase it from the previous location;</li>
  52 <li>activate <b>Copy elements</b> radio button to create the source
  53 mesh (or elements) at the new location, but leave it at the previous
  54 location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
  55 <li>activate <b>Create as new mesh</b> radio button to leave the
  56 source mesh (or elements) at its previous location and create a new
  57 mesh at the new location, the new mesh appears in the Object Browser
  58 with the default name MeshName_rotated (it is possible to change this
  59 name in the adjacent box);</li>
  60 <li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
  61 </ul>
  62 </li>
  63
  64 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the
  65 operation.</li>
  66
  67 </ol>
  68
  69
  70 \image html rotation1.png "The initial mesh"
  71
  72 \image html rotation2.png "The rotated mesh"
  73
  74 <br><b>See Also</b> a sample TUI Script of a
  75 \ref tui_rotation "Rotation" operation.
  76
  77 */