doc/gui/input/rotation.rst

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