src/SketchPlugin/doc/rotationFeature.rst

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