1 .. |distance.icon| image:: images/distance.png
6 Distance constraint fixes the distance between two objects.
8 The constraint can be defined between such objects as point, line, line or arc end point, center of circle or arc.
10 To create a Distance constraint in the active Sketch:
12 #. select in the Main Menu *Sketch - > Distance* item or
13 #. click |distance.icon| **Distance** button in Sketch toolbar:
17 .. image:: images/Distance_panel.png
22 - **First object** is the first object selected in the view;
23 - **Second object** is the second object selected in the view;
24 - **Value** is a distance between the objects, can be modified to set the desirable value;
25 - **Text location** is a position of the distance value label relating to extension line (in the view):
26 .. image:: images/location_left.png
28 **Left** inserts text to the left of the distance extension line;
30 .. image:: images/location_automatic.png
32 **Automatic** inserts text in the middle of the distance extension line if it has enough length, otherwise - to the left;
34 .. image:: images/location_right.png
36 **Right** inserts text to the right of the distance extension line;
37 - **Keep orientation** fixes the relative position between selected objects.
39 When both objects are selected, the distance value is displayed in the property panel and in the view.
41 When creating a constraint after selection of two objects for the first time:
43 - drag the distance presentation in the view to the desired position and click once;
44 - set the desirable distance value in the input field and press **Enter** or just press **Enter** to keep the current distance.
46 .. image:: images/Distance_field_view.png
50 Distance input in the view
54 .. py:function:: Sketch_1.setDistance(FirstObject, SecondObject, Value, KeepOrientation)
56 :param object: First object.
57 :param object: Second object.
59 :param boolean: Keep orientation flag.
60 :return: Result object.
65 Created Distance appears in the view.
67 .. image:: images/Distance_res.png
73 **See Also** a sample TUI Script of :ref:`tui_create_distance` operation.