2 .. |rotation.icon| image:: images/rotation.png
7 **Rotation** feature makes rotation of a selected shape.
9 To create a Rotation in the active part:
11 #. select in the Main Menu *Part - > Rotation* item or
12 #. click |rotation.icon| **Rotation** button in the toolbar
14 Two rotation algorithms are:
16 .. image:: images/rotation_axis_32x32.png
22 .. image:: images/rotation_3pt_32x32.png
26 by center and 2 points
28 --------------------------------------------------------------------------------
30 Rotation by axis and angle
31 --------------------------
33 .. image:: images/Rotation1.png
37 Rotation by axis and angle property panel
41 - **Main objects** panel contains shapes to be rotated. Shapes are selected in 3D OCC viewer or object browser;
42 - **Axis** defines the axis of rotation. The vector is an edge or axis selected in 3D OCC viewer or object browser;
43 - **Angle** defines the angle by which the object is rotated.
47 .. py:function:: model.addRotation(Part_doc, [shape], axis, angle)
49 :param part: The current part object.
50 :param list: A list of shapes in format *model.selection(TYPE, shape)*.
51 :param object: An axis in format *model.selection(TYPE, shape)*.
52 :param real: An angle.
53 :return: Rotated object.
58 Result of operation is a rotated initial shape.
60 .. image:: images/rotation_axis.png
64 Rotation by axis and angle
66 **See Also** a sample TUI Script of :ref:`tui_rotation_axis` operation.
68 Rotation by center and points
69 -----------------------------
71 .. image:: images/Rotation2.png
75 Rotation by center and 2 points property panel
79 - **Main objects** panel contains shapes to be rotated. Shapes are selected in 3D OCC viewer or object browser;
80 - **Center point**, **Start point**, **End point** define 3 points or vertices selected in 3D OCC viewer or object browser. Rotation axis will pass through the **Center point** and will be orthogonal to a plane defined by three points. Rotation Angle is the angle between two vectors directed from the **Center point** to **Start point** and **End point**.
84 .. py:function:: model.addRotation(Part_doc, [shape], point1, point2, point3)*
86 :param part: The current part object.
87 :param list: A list of shapes in format *model.selection(TYPE, shape)*.
88 :param object: An axis in format *model.selection(TYPE, shape)*.
89 :param object: Center vertex.
90 :param object: Start vertex.
91 :param object: End vertex.
92 :return: Rotated object.
97 Result of operation is a rotated initial shape.
99 .. image:: images/rotation_3points.png
103 Rotation by center and 2 points
105 **See Also** a sample TUI Script of :ref:`tui_rotation_3points` operation.