src/SketchPlugin/doc/angleFeature.rst

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