src/FeaturesPlugin/doc/angularCopyFeature.rst

   1 .. _featureAngularCopy:
   2
   3 Angular copy
   4 ============
   5
   6 The feature **Angular copy** makes a compound of several rotated shapes basing on the initial shape.
   7
   8 To create Angular copy in the active part:
   9
  10 #. select in the Main Menu *Part - > Angular copy* item  or
  11 #. click **Angular copy** button in the toolbar
  12
  13 .. image:: images/multirotation.png
  14    :align: center
  15
  16 .. centered::
  17    **Angular copy** button
  18
  19 The following property panel appears.
  20
  21 .. image:: images/angularcopy.png
  22   :align: center
  23
  24 .. centered::
  25   Angular copy property panel
  26
  27 Input fields:
  28
  29 - **Main objects** panel contains shapes to be rotated. Shapes are selected in 3D OCC viewer or object browser;
  30 - **Vector of rotation**  defines the axis of rotation. Vector is edge, axis selected in 3D OCC viewer or object browser;
  31 - **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;
  32 - **Nb. Copies** defines the number of rotated shape copies in the resulting compound. If **Nb. Copies** = 1, the result contains only the initial shape.
  33
  34 **TUI Command**:  *model.addMultiRotation(Part_doc, [shape], axis, step, Nb)*
  35
  36 **Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + axis in format *model.selection(TYPE, shape)*+ real (step value) + integer (Nb. Copies).
  37
  38 Result
  39 """"""
  40 Result of cylinder rotation is compound.
  41
  42 .. image:: images/angularcopycyl.png
  43    :align: center
  44
  45 .. centered::
  46    Angular copy
  47
  48 **See Also** a sample TUI Script of a :ref:`tui_create_angularcopy` operation.