src/SketchPlugin/doc/angleFeature.rst

   1 .. |angle_constr.icon|    image:: images/angle_constr.png
   2
   3 Angle constraint
   4 ================
   5
   6 Angle constraint fixes the angle between two lines.
   7
   8 | Angle between two lines is seen as an angle between two vectors.
   9 | Each line is treated as a vector with start and end points equal to those of the line.
  10
  11 To create an Angle constraint in the active Sketch:
  12
  13 #. select in the Main Menu *Sketch - > Angle* item  or
  14 #. click |angle_constr.icon| **Angle** button in Sketch toolbar:
  15
  16 Property panel:
  17
  18 .. image:: images/Angle_panel.png
  19    :align: center
  20
  21 Input fields:
  22
  23 - **Line 1** is the first line selected in the view;
  24 - **Line 2** is the second line selected in the view;
  25 - **Value** is an angle between the lines, can be modified to set the desirable value;
  26 - **Angle type** is a type of angle measurement:
  27    .. image:: images/angle_direct.png
  28       :align: left
  29    **Direct** is the least angle between two lines;
  30
  31    .. image:: images/angle_complementary.png
  32       :align: left
  33    **Complementary** is 180°- Direct angle between two lines;
  34
  35    .. image:: images/angle_backward.png
  36       :align: left
  37    **Backward** is 360°- Direct angle between two lines.
  38 - **Text location** is the position of the angle value label relatively to the angle line (in the view):
  39    .. image:: images/location_left.png
  40       :align: left
  41    **Left** inserts text to the left of the angle line;
  42
  43    .. image:: images/location_automatic.png
  44       :align: left
  45    **Automatic** inserts text it the middle of the angle line if it has enough length, otherwise - to the left;
  46
  47    .. image:: images/location_right.png
  48       :align: left
  49    **Right** inserts text to the right of the angle line.
  50
  51 When both lines are selected, the angle value is displayed in the property panel and in the view.
  52
  53 When creating the constraint, after selection of two lines at the first time:
  54
  55 - drag the angle presentation in the view to the desired position and click once;
  56 - set desirable angle value in the input field in the view and press **Enter** or just press **Enter** to keep the current angle
  57
  58 .. image:: images/Angle_field_view.png
  59    :align: center
  60
  61 .. centered::
  62    Angle input in the view
  63
  64 **TUI Commands**:
  65
  66 .. py:function:: Sketch_1.setAngle(Line1, Line2, Value)
  67 .. py:function:: Sketch_1.setAngleComplementary(Line1, Line2, Value)
  68 .. py:function:: Sketch_1.setAngleBackward(Line1, Line2, Value)
  69
  70     :param object: Line 1.
  71     :param object: Line 2.
  72     :param real: Value.
  73     :return: Result object.
  74
  75 Result
  76 """"""
  77
  78 Created Angle appears in the view.
  79
  80 .. image:: images/Angle_res.png
  81            :align: center
  82
  83 .. centered::
  84    Angle created
  85
  86 **See Also** a sample TUI Script of :ref:`tui_create_angle` operation.