doc/salome/gui/SMESH/input/translation.doc

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