Salome HOME
Task 3.8. Extrusion to any face
[modules/shaper.git] / src / FeaturesPlugin / doc / angularCopyFeature.rst
index 3d3fec12cc63bce0506b0874427d487fdf66a821..30b708628cbbf14bd9f8ce809e925c6019bc7c1d 100644 (file)
@@ -1,10 +1,48 @@
+.. _featureAngularCopy:
 
 Angular copy
 ============
 
+The feature **Angular copy** makes a compound of several rotated shapes basing on the initial shape. 
 
-.. image:: images/AngularCopy.png
+To create an Angular copy in the active part:
+
+#. select in the Main Menu *Part - > Angular copy* item  or
+#. click **Angular copy** button in the toolbar
+
+.. image:: images/multirotation.png  
+   :align: center
+
+.. centered::
+   **Angular copy** button 
+
+The following property panel appears.
+
+.. image:: images/angularcopy.png
   :align: center
 
 .. centered::
-  Angular copy definition
+  Angular copy property panel
+
+Input fields:
+
+- **Main objects** panel contains shapes to be rotated. The shapes are selected in 3D OCC viewer or object browser;
+- **Vector of rotation**  defines the axis of rotation. The vector of rotation is an edge, axis selected in 3D OCC viewer or object browser;
+- **Angular Step** check-box turns on/off definition of the angle by which the object is rotated. By default (if the checkbox is not checked), **Angular Step** = 2 * PI / NbTimes;
+- **Nb. Copies** defines the number of rotated shape copies in the resulting compound. If **Nb. Copies** = 1, the result contains only the initial shape.
+
+**TUI Command**:  *model.addMultiRotation(Part_doc, [shape], axis, step, Nb)*
+
+**Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + axis in format *model.selection(TYPE, shape)*+ real (step value) + integer (Nb. Copies).
+
+Result
+""""""
+Result of cylinder rotation is a compound.
+
+.. image:: images/angularcopycyl.png
+   :align: center
+
+.. centered::
+   Angular copy
+
+**See Also** a sample TUI Script of :ref:`tui_create_angularcopy` operation.