src/SketchPlugin/doc/rotationFeature.rst

   1 .. _sketchAngularCopy:
   2
   3 Angular copy
   4 ============
   5
   6 Angular copy operation creates one or multiple copies of the sketch entities by rotation relative to a specified center point.
   7
   8 To create an Angular copy in the active Sketch:
   9
  10 #. select in the Main Menu *Sketch - > Angular copy* item  or
  11 #. click **Angular copy** button in Sketch toolbar:
  12
  13 .. image:: images/rotate.png
  14    :align: center
  15
  16 .. centered::
  17    **Angular copy**  button
  18
  19 Property panel:
  20
  21 .. image:: images/Rotation_panel.png
  22   :align: center
  23
  24 .. centered::
  25    Angular copy
  26
  27 Input fields:
  28
  29 - **Segments** is the list of segments (lines, circles, arcs) selected in the view;
  30 - **Center of rotation** is the center point selected in the view;
  31 - **Full angle/Single angle** option:
  32
  33   .. image:: images/angle_up_full_32x32.png
  34      :align: left
  35   **Full angle**: angle step of rotation is equal to the defined angle divided by the number of copies (total number minus one).
  36
  37   .. image:: images/angle_up_full_32x32.png
  38      :align: left
  39   **Single angle**: angle step of rotation is equal to the defined angle.
  40
  41 - **Angle** is the angle of rotation.
  42 - **Reversed** defines rotation direction. If checked - in a clockwise direction, otherwise - in a counterclockwise direction.
  43 - **Total number of objects** is the total number of objects including the original one.
  44
  45
  46 **TUI Command**: *Sketch_1.addRotation(Objects, CenterPoint, Angle, NumberOfObjects, FullValue, Reversed)*
  47
  48 **Arguments**:   list of objects + center point + angle + number of objects + full value flag + reversed flag
  49
  50 Result
  51 """"""
  52
  53 Created Angular copy appears in the view.
  54
  55 | The original and an angular copy objects are marked with a special sign.
  56 | Copy objects are drawn with a thinner line.
  57
  58 .. image:: images/Rotation_res.png
  59            :align: center
  60
  61 .. centered::
  62    Created angular copy
  63
  64 **See Also** a sample TUI Script of :ref:`tui_create_rotation` operation.