X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FFeaturesPlugin%2Fdoc%2FrotationFeature.rst;h=1739cd9194ba4a7c461f64f0984fe4656df13ba9;hb=7417054f9f86129249fdfd652f804183484986ee;hp=ff0380d0c23e36acaf11f7e89830a04900ae5fba;hpb=547a3952b37fe76f0d4e031a7d8a943ac6a45bb5;p=modules%2Fshaper.git

diff --git a/src/FeaturesPlugin/doc/rotationFeature.rst b/src/FeaturesPlugin/doc/rotationFeature.rst
index ff0380d0c..1739cd919 100644
--- a/src/FeaturesPlugin/doc/rotationFeature.rst
+++ b/src/FeaturesPlugin/doc/rotationFeature.rst
@@ -1,17 +1,90 @@
+.. _featureRotation:
 
 Rotation
 ========
 
+**Rotation** feature makes rotation of a selected shape.
+
+To create a Rotation in the active part:
+
+#. select in the Main Menu *Part - > Rotation* item  or
+#. click **Rotation** button in the toolbar
+
+.. image:: images/rotation.png      
+   :align: center
+
+.. centered::
+   **Rotation** button 
+
+Two rotation algorithms are:
+
+  .. image:: images/rotation_axis_32x32.png      
+    :align: left
+  by axis and angle 
+
+  .. image:: images/rotation_3pt_32x32.png    
+    :align: left
+  by center and 2 points
+
+Rotation by axis and angle
+--------------------------
 
 .. image:: images/Rotation1.png
   :align: center
 
 .. centered::
-  Rotation by axis and angle
+  Rotation by axis and angle property panel
+
+Input fields:
+
+- **Main objects** panel contains shapes to be rotated. Shapes are selected in 3D OCC viewer or object browser;
+- **Axis** defines the axis of rotation. The vector is an edge or axis selected in 3D OCC viewer or object browser;
+- **Angle** defines the angle by which the object is rotated. 
+
+**TUI Command**:  *model.addRotation(Part_doc, [shape], axis, angle)*
+
+**Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + axis in format *model.selection(TYPE, shape)*+ real (angle value).
+
+Result
+""""""
+
+Result of operation is a rotated initial shape.
 
+.. image:: images/rotation_axis.png
+   :align: center
+
+.. centered::
+   Rotation by axis and angle
+
+**See Also** a sample TUI Script of :ref:`tui_rotation_axis` operation.
+
+Rotation by center and points
+-----------------------------
 
 .. image:: images/Rotation2.png
   :align: center
 
 .. centered::
-  Rotation by center and points
+  Rotation by center and 2 points property panel
+
+Input fields:
+
+- **Main objects** panel contains shapes to be rotated. Shapes are selected in 3D OCC viewer or object browser;
+- **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**.  
+
+**TUI Command**:  *model.addRotation(Part_doc, [shape], point1, point2, point3)*
+
+**Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + 3 points in format *model.selection(TYPE, shape)*.
+
+Result
+""""""
+
+Result of operation is a rotated initial shape.
+
+.. image:: images/rotation_3points.png
+   :align: center
+
+.. centered::
+   Rotation by center and 2 points
+
+**See Also** a sample TUI Script of :ref:`tui_rotation_3points` operation.
\ No newline at end of file