distanceFeature.rst
horizontalDistFeature.rst
verticalDistFeature.rst
+ lengthFeature.rst
angleFeature.rst
- coincedenceFeature.rst
- collinearFeature.rst
- equalFeature.rst
+ radiusFeature.rst
horizontalFeature.rst
- lengthFeature.rst
- middleFeature.rst
+ verticalFeature.rst
+ fixedFeature.rst
parallelFeature.rst
perpendicularFeature.rst
- radiusFeature.rst
- rigidFeature.rst
tangentFeature.rst
- verticalFeature.rst
+ coincedentFeature.rst
+ middleFeature.rst
+ equalFeature.rst
+ collinearFeature.rst
.. _sketch_operations:
--- /dev/null
+
+ .. _tui_create_angle:
+
+Create Angle constraint
+=======================
+
+.. literalinclude:: examples/angle.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/angle.py>`
--- /dev/null
+
+ .. _tui_create_coincident:
+
+Create Coincident constraint
+============================
+
+.. literalinclude:: examples/coincident.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/coincident.py>`
--- /dev/null
+
+ .. _tui_create_collinear:
+
+Create Collinear constraint
+===========================
+
+.. literalinclude:: examples/collinear.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/collinear.py>`
--- /dev/null
+
+ .. _tui_create_equal:
+
+Create Equal constraint
+=======================
+
+.. literalinclude:: examples/equal.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/equal.py>`
--- /dev/null
+
+ .. _tui_create_fixed:
+
+Create Fixed constraint
+=======================
+
+.. literalinclude:: examples/fixed.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/fixed.py>`
--- /dev/null
+
+ .. _tui_create_horizontal:
+
+Create Horizontal constraint
+============================
+
+.. literalinclude:: examples/horizontal.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/horizontal.py>`
--- /dev/null
+
+ .. _tui_create_length:
+
+Create Length constraint
+========================
+
+.. literalinclude:: examples/length.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/length.py>`
--- /dev/null
+
+ .. _tui_create_middle:
+
+Create Middle point constraint
+==============================
+
+.. literalinclude:: examples/middle.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/middle.py>`
--- /dev/null
+
+ .. _tui_create_parallel:
+
+Create Parallel constraint
+==========================
+
+.. literalinclude:: examples/parallel.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/parallel.py>`
--- /dev/null
+
+ .. _tui_create_perpendicular:
+
+Create Perpendicular constraint
+==========================
+
+.. literalinclude:: examples/perpendicular.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/perpendicular.py>`
--- /dev/null
+
+ .. _tui_create_radius:
+
+Create Radius constraint
+========================
+
+.. literalinclude:: examples/radius.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/radius.py>`
--- /dev/null
+
+ .. _tui_create_tangent:
+
+Create Tangent constraint
+=========================
+
+.. literalinclude:: examples/tangent.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/tangent.py>`
--- /dev/null
+
+ .. _tui_create_vertical:
+
+Create Vertical constraint
+==========================
+
+.. literalinclude:: examples/vertical.py
+ :linenos:
+ :language: python
+
+:download:`Download this script <examples/vertical.py>`
Angle constraint
================
+Angle constraint fixes angle between two lines.
-.. image:: images/Angle.png
- :align: center
+| Angle between two lines is thought of as an angle between two vectors.
+| So each line is treated as a vector with starting point equal to the line start point
+and terminal point equal to the line end point.
+
+To create Angle constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Angle* item or
+#. click **Angle** button in Sketch toolbar:
+
+.. image:: images/angle_constr.png
+ :align: center
+
+.. centered::
+ **Angle** button
+
+Property panel:
+
+.. image:: images/Angle_panel.png
+ :align: center
+
+Input fields:
+
+- **Line 1** is the first line selected in the view
+- **Line 2** is the second line selected in the view
+- **Value** is an angle between the lines, could be modified to set the desirable value
+- **Angle type** is a type of angle measurement
+ .. image:: images/angle_direct.png
+ :align: left
+ **Direct** is an angle type measured directly between two lines.
+
+ .. image:: images/angle_complementary.png
+ :align: left
+ **Complementary** zzzzzzzz.
+
+ .. image:: images/angle_backward.png
+ :align: left
+ **Backward** zzzzzzzz.
+- **Text location** is a position of the angle value label relating to angle line (in the view)
+ .. image:: images/location_left.png
+ :align: left
+ **Left** inserts text at the left of the angle line.
+
+ .. image:: images/location_automatic.png
+ :align: left
+ **Automatic** inserts text at the middle of the angle line if it has enough length, otherwise - to the left.
+
+ .. image:: images/location_right.png
+ :align: left
+ **Right** inserts text to the right of the angle line.
+
+When both lines are selected angle value is displayed in the property panel and in the view.
+
+When creating the constraint, after selection of two lines at the first time:
+
+- drag the angle presentation in the view to the desired position (by move mouse and click once)
+- set desirable angle value in the input field in the view and press **Enter** or just press **Enter** to keep the current angle
+
+.. image:: images/Angle_field_view.png
+ :align: center
.. centered::
- Create an angle constraint
+ Angle input in the view
+
+**TUI Command**:
+
+- *Sketch_1.setAngle(Line1, Line2, Value)*
+- *Sketch_1.setAngleComplementary(Line1, Line2, Value)*
+- *Sketch_1.setAngleBackward(Line1, Line2, Value)*
+
+**Arguments**: 2 lines + angle value
+
+Result
+""""""
+
+Created Angle appears in the view.
+
+.. image:: images/Angle_res.png
+ :align: center
+
+.. centered::
+ Angle created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_angle` operation.
\ No newline at end of file
+++ /dev/null
-
-Coincidence constraint
-======================
-
-
-.. image:: images/Coincident.png
- :align: center
-
-.. centered::
- Create a coincedence constraint
--- /dev/null
+
+Coincident constraint
+=====================
+
+Coincident constraint makes two points to be coincident, or one point to lie on a line or circumference of a circle (or an arc).
+
+To create Coincident in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Coincident* item or
+#. click **Coincident** button in Sketch toolbar:
+
+.. image:: images/coincedence.png
+ :align: center
+
+.. centered::
+ **Coincident** button
+
+Property panel:
+
+.. image:: images/Coincident_panel.png
+ :align: center
+
+Input fields:
+
+- **First object** is a point, a line, a circle or an arc selected in the view.
+- **Second object** is a point, a line, a circle or an arc selected in the view.
+
+Note that one of two objects should be a point (i.e. a point, a line or an arc end point, a center of a circle or an arc).
+
+After the objects are selected the point becomes yellow colored in the view.
+
+**TUI Command**: *Sketch_1.setCoincident(Object1, Object2)*
+
+**Arguments**: 2 objects (one of them is a point, the second one is a point, a circle, an arc or a line)
+
+Result
+""""""
+
+Created Coincident constraint appears in the view.
+
+.. image:: images/Coincident_res.png
+ :align: center
+
+.. centered::
+ Coincident constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_coincident` operation.
\ No newline at end of file
Collinear constraint
====================
+Collinear constraint makes to lines collinear.
-.. image:: images/Colinear.png
- :align: center
+To create Collinear in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Collinear* item or
+#. click **Collinear** button in Sketch toolbar:
+
+.. image:: images/collinear.png
+ :align: center
.. centered::
- Create a collinear constraint
+ **Collinear** button
+
+Property panel:
+
+.. image:: images/Collinear_panel.png
+ :align: center
+
+Input fields:
+
+- **First line** is the first line selected in the view.
+- **Second line** is the second line selected in the view.
+
+| After the lines are selected they becomes translated as to be collinear.
+| The lines are marked with the special sign.
+
+**TUI Command**: *Sketch_1.setCollinear(Line1, Line2)*
+
+**Arguments**: 2 line objects
+
+Result
+""""""
+
+Created Collinear constraint appears in the view.
+
+.. image:: images/Collinear_res.png
+ :align: center
+
+.. centered::
+ Collinear constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_collinear` operation.
Distance constraint
===================
-Distance can be defined between two objects such as point, line, line or arc end point, center of circle or arc.
+Distance constraint fixes distance between two objects.
+
+The constraint can be defined between such objects as point, line, line or arc end point, center of circle or arc.
To create Distance constraint in the active Sketch:
Input fields:
-- **First object** - the first object
-- **Second object** - the second object
-- **Value** - distance between the objects, could be modified to set the desirable value
-- **Text location** - position of the distance value label relating to extension line (in the view)
+- **First object** is the first object selected in the view
+- **Second object** is the second object selected in the view
+- **Value** is a distance between the objects, could be modified to set the desirable value
+- **Text location** is a position of the distance value label relating to extension line (in the view)
.. image:: images/location_left.png
:align: left
**Left** inserts text at the left of the distance extension line.
.. image:: images/location_right.png
:align: left
**Right** inserts text to the right of the distance extension line.
-- **Keep orientation** - fixes the relative position between selected objects
+- **Keep orientation** fixes the relative position between selected objects
-When the both objects are selected distance value is displayed in the property panel and in the view.
+When both objects are selected distance value is displayed in the property panel and in the view.
-When creating the constraint and the both objects are selected the first time:
+When creating the constraint, after selection of two objects at the first time:
- drag the distance presentation in the view to the desired position (by move mouse and click once)
- set desirable distance value in the input field in the view and press **Enter** or just press **Enter** to keep the current distance
Equal constraint
================
+| Equal constraint makes lines, circles or arcs of equal size.
+| Lines becomes of equal length, circles and arcs - of equal radius.
-.. image:: images/Equal.png
- :align: center
+To create Equal in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Equal* item or
+#. click **Equal** button in Sketch toolbar:
+
+.. image:: images/equal.png
+ :align: center
+
+.. centered::
+ **Equal** button
+
+Property panel:
+
+.. image:: images/Equal_panel.png
+ :align: center
+
+Input fields:
+
+- **First object** is a line, a circle or an arc selected in the view.
+- **Second object** is a line, a circle or an arc selected in the view.
+
+Note that a line could be equal to a line only, a circle - to a circle or an arc.
+
+| After the objects are selected the object sizes become equal.
+| The equal objects are marked with **=** sign.
+
+**TUI Command**: *Sketch_1.setEqual(Object1, Object2)*
+
+**Arguments**: 2 objects (2 lines, 2 arcs, 2 circles or circle and arc)
+
+Result
+""""""
+
+Created Equal constraint appears in the view.
+
+.. image:: images/Equal_res.png
+ :align: center
.. centered::
- Create an equal constraint
+ Equal constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_equal` operation.
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(55.1, 13.0, 6.42, 35.5)
+SketchLine_2 = Sketch_1.addLine(50.2, 22.4, 36.8, 58.8)
+SketchConstraintAngle_1 = Sketch_1.setAngle(SketchLine_2.result(), SketchLine_1.result(), 45)
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchCircle_1 = Sketch_1.addCircle(34, 28, 12)
+SketchLine_1 = Sketch_1.addLine(41, 45, 61, 72)
+SketchConstraintCoincidence_1 = Sketch_1.setCoincident(SketchCircle_1.results()[1], SketchLine_1.startPoint())
+model.do()
+model.end()
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(6, 25, 20, 40)
+SketchLine_2 = Sketch_1.addLine(44, 26, 80, 61)
+SketchConstraintCollinear_1 = Sketch_1.setCollinear(SketchLine_1.result(), SketchLine_2.result())
+model.do()
+model.end()
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchCircle_1 = Sketch_1.addCircle(27, 25, 5)
+SketchArc_1 = Sketch_1.addArc(55.58, 56.8, 70.53, 54.47, 65.76, 67.99, True)
+SketchConstraintEqual_1 = Sketch_1.setEqual(SketchCircle_1.results()[1], SketchArc_1.results()[1])
+model.do()
+model.end()
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchCircle_1 = Sketch_1.addCircle(38.7, 43.3, 29.29)
+SketchConstraintRigid_1 = Sketch_1.setFixed(SketchCircle_1.results()[1])
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(14.5, 16.0, 71.0, 62.0)
+SketchConstraintHorizontal_1 = Sketch_1.setHorizontal(SketchLine_1.result())
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(14.6, 14.2, 59.4, 61.9)
+SketchLine_1.result().setColor(225, 0, 0)
+SketchConstraintLength_1 = Sketch_1.setLength(SketchLine_1.result(), 65.5)
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchCircle_1 = Sketch_1.addCircle(16, 54, 10)
+SketchLine_1 = Sketch_1.addLine(10, 10, 80, 80)
+SketchConstraintMiddle_1 = Sketch_1.setMiddlePoint(SketchCircle_1.center(), SketchLine_1.result())
+model.do()
+model.end()
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(13, 58, 69, 75)
+SketchLine_2 = Sketch_1.addLine(12, 38, 73, 23)
+SketchConstraintParallel_1 = Sketch_1.setParallel(SketchLine_1.result(), SketchLine_2.result())
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(13, 58, 69, 75)
+SketchLine_2 = Sketch_1.addLine(12, 38, 73, 23)
+SketchConstraintParallel_1 = Sketch_1.setPerpendicular(SketchLine_1.result(), SketchLine_2.result())
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchCircle_1 = Sketch_1.addCircle(35, 50, 25)
+SketchConstraintRadius_1 = Sketch_1.setRadius(SketchCircle_1.results()[1], 25)
+model.do()
+model.end()
\ No newline at end of file
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchCircle_1 = Sketch_1.addCircle(30, 30, 15)
+SketchLine_1 = Sketch_1.addLine(10, 80, 80, 27)
+SketchConstraintTangent_1 = Sketch_1.setTangent(SketchCircle_1.results()[1], SketchLine_1.result())
+model.do()
+model.end()
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Sketch_1 = model.addSketch(Part_1_doc, model.defaultPlane("XOY"))
+SketchLine_1 = Sketch_1.addLine(15.5, 14.5, 71.0, 62.8)
+SketchConstraintVertical_1 = Sketch_1.setVertical(SketchLine_1.result())
+model.do()
+model.end()
--- /dev/null
+
+Fixed constraint
+================
+
+Fixed constraint fixes objects position and size.
+
+The constraint can be defined for such objects as point, line, line or arc end point, center of circle or arc, whole circle or arc.
+
+To create Fixed constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Fixed* item or
+#. click **Fixed** button in Sketch toolbar:
+
+.. image:: images/fixed.png
+ :align: center
+
+.. centered::
+ **Fixed** button
+
+Property panel:
+
+.. image:: images/Fixed_panel.png
+ :align: center
+
+Input fields:
+
+- **Object** is the object selected in the view.
+
+After the object is selected anchor sign will be added close to it in the view.
+
+Selection rules:
+
+- Selection of end point on the line, center of circle or arc - fixes only the selected point.
+- To fix the whole line the segment between endpoints should be selected.
+- To fix the whole circle or arc the circumference should be selected.
+
+**TUI Command**: *Sketch_1.setFixed(Object)*
+
+**Arguments**: 1 object
+
+Result
+""""""
+
+Created Fixed constraint appears in the view.
+
+.. image:: images/Fixed_res.png
+ :align: center
+
+.. centered::
+ Fixed constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_fixed` operation.
Horizontal distance constraint
==============================
-Horizontal Distance constraint fixes distance between two objects along the horizontal axis.
+Horizontal Distance constraint fixes distance between two points along the horizontal axis.
The constraint can be defined between two points such as point object, line or arc end point, center of circle or arc.
Input fields:
-- **First object** - the first object
-- **Second object** - the second object
-- **Value** - distance between the objects, could be modified to set the desirable value
-- **Text location** - position of the distance value label relating to extension line (in the view)
+- **First point** is the first point selected in the view
+- **Second point** is the second point selected in the view
+- **Value** is a distance between the objects, could be modified to set the desirable value
+- **Text location** is a position of the distance value label relating to extension line (in the view)
.. image:: images/location_left.png
:align: left
**Left** inserts text at the left of the distance extension line.
:align: left
**Right** inserts text to the right of the distance extension line.
-When the both objects are selected horizontal distance value is displayed in the property panel and in the view.
+When both objects are selected horizontal distance value is displayed in the property panel and in the view.
-When creating the constraint and the both objects are selected the first time:
+When creating the constraint, after selection of two objects at the first time:
- drag the horizontal distance presentation in the view to the desired position (by move mouse and click once)
- set desirable horizontal distance value in the input field in the view and press **Enter** or just press **Enter** to keep the current distance
Horizontal constraint
=====================
+Horizontal constraint fixes lines to lie parallel to the horizontal axis.
-.. image:: images/Horizontal.png
- :align: center
+To create Horizontal constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Horizontal* item or
+#. click **Horizontal** button in Sketch toolbar:
+
+.. image:: images/horisontal.png
+ :align: center
.. centered::
- Create a horizontal constaint
+ **Horizontal** button
+
+Property panel:
+
+.. image:: images/Horizontal_panel.png
+ :align: center
+
+Input fields:
+
+- **Line** is the line selected in the view.
+
+| After the line is selected it becomes parallel to the horizontal axis in the view.
+| **H** sign added above the line.
+
+**TUI Command**: *Sketch_1.setHorizontal(LineObject)*
+
+**Arguments**: 1 line object
+
+Result
+""""""
+
+Created Horizontal constraint appears in the view.
+
+.. image:: images/Horizontal_res.png
+ :align: center
+
+.. centered::
+ Horizontal constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_horizontal` operation.
\ No newline at end of file
Length constraint
=================
+Length constraint fixes length of lines such as standalone line or rectangle side.
-.. image:: images/Length.png
- :align: center
+To create Length constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Length* item or
+#. click **Length** button in Sketch toolbar:
+
+.. image:: images/length.png
+ :align: center
+
+.. centered::
+ **Length** button
+
+Property panel:
+
+.. image:: images/Length_panel.png
+ :align: center
+
+Input fields:
+
+- **Line** is the the line object selected in the view
+- **Value** is a line length, could be modified to set the desirable value
+- **Text location** is a position of the length value label relating to extension line (in the view)
+ .. image:: images/location_left.png
+ :align: left
+ **Left** inserts text at the left of the length extension line.
+
+ .. image:: images/location_automatic.png
+ :align: left
+ **Automatic** inserts text at the middle of the length extension line if it has enough length, otherwise - to the left.
+
+ .. image:: images/location_right.png
+ :align: left
+ **Right** inserts text to the right of the length extension line.
+
+When the line is selected length value is displayed in the property panel and in the view.
+
+When creating the constraint, after selection of a line at the first time:
+
+- drag the length presentation in the view to the desired position (by move mouse and click once)
+- set desirable length value in the input field in the view and press **Enter** or just press **Enter** to keep the current length
+
+.. image:: images/Length_field_view.png
+ :align: center
.. centered::
- Create a length constraint
+ Length input in the view
+
+**TUI Command**: *Sketch_1.setLength(LineObject, Value)*
+
+**Arguments**: line + length value
+
+Result
+""""""
+
+Created Length appears in the view.
+
+.. image:: images/Length_res.png
+ :align: center
+
+.. centered::
+ Length created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_length` operation.
-Middle constraint
-=================
+Middle point constraint
+=======================
+Middle point constraint makes one point to lie in the middle of a line.
-.. image:: images/MiddlePoint.png
- :align: center
+To create Middle point in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Middle point* item or
+#. click **Middle point** button in Sketch toolbar:
+
+.. image:: images/middlepoint.png
+ :align: center
+
+.. centered::
+ **Middle point** button
+
+Property panel:
+
+.. image:: images/Middlepoint_panel.png
+ :align: center
+
+Input fields:
+
+- **First object** is a point or a line selected in the view.
+- **Second object** is a point or a line selected in the view.
+
+Note that one of two objects should be a line and another one a point (i.e. a point, a line or an arc end point, a center of a circle or an arc).
+
+| After the objects are selected the point becomes located in the middle of the line.
+| The middle point are marked with the special sign.
+
+**TUI Command**: *Sketch_1.setMiddlePoint(Point, Line)*
+
+**Arguments**: 2 objects (the first is a point, the second one is a line)
+
+Result
+""""""
+
+Created Middle point constraint appears in the view.
+
+.. image:: images/Middlepoint_res.png
+ :align: center
.. centered::
- Create a middle constraint
+ Middle point constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_middle` operation.
Parallel constraint
===================
+Parallel constraint fixes two lines to lie parallel to one another.
-.. image:: images/Parallel.png
- :align: center
+To create Parallel in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Parallel* item or
+#. click **Parallel** button in Sketch toolbar:
+
+.. image:: images/parallel.png
+ :align: center
.. centered::
- Create a parallel constraint
+ **Parallel** button
+
+Property panel:
+
+.. image:: images/Parallel_panel.png
+ :align: center
+
+Input fields:
+
+- **First line** is the first line selected in the view.
+- **Second line** is the second line selected in the view.
+
+After the lines are selected **||** sign will be added to each of them in the view.
+
+**TUI Command**: *Sketch_1.setParallel(Line1, Line2)*
+
+**Arguments**: 2 line objects
+
+Result
+""""""
+
+Created Parallel constraint appears in the view.
+
+.. image:: images/Parallel_res.png
+ :align: center
+
+.. centered::
+ Parallel constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_parallel` operation.
\ No newline at end of file
Perpendicular constraint
========================
+Perpendicular constraint fixes two lines to lie at 90 degrees to one another.
-.. image:: images/Perpendicular.png
- :align: center
+To create Perpendicular in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Perpendicular* item or
+#. click **Perpendicular** button in Sketch toolbar:
+
+.. image:: images/perpendicular.png
+ :align: center
.. centered::
- Create a perpendicular constraint
+ **Perpendicular** button
+
+Property panel:
+
+.. image:: images/Perpendicular_panel.png
+ :align: center
+
+Input fields:
+
+- **First line** is the first line selected in the view.
+- **Second line** is the second line selected in the view.
+
+After the lines are selected the special sign will be added to each of them in the view.
+
+**TUI Command**: *Sketch_1.setPerpendicular(Line1, Line2)*
+
+**Arguments**: 2 line objects
+
+Result
+""""""
+
+Created Perpendicular constraint appears in the view.
+
+.. image:: images/Perpendicular_res.png
+ :align: center
+
+.. centered::
+ Perpendicular constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_perpendicular` operation.
Radius constraint
=================
+Radius constraint fixes radius of circle or arc.
-.. image:: images/Radius.png
- :align: center
+To create Radius constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Radius* item or
+#. click **Radius** button in Sketch toolbar:
+
+.. image:: images/radius_constr.png
+ :align: center
+
+.. centered::
+ **Radius** button
+
+Property panel:
+
+.. image:: images/Radius_panel.png
+ :align: center
+
+Input fields:
+
+- **Circle or Arc** is the circe or arc circumference selected in the view
+- **Value** is a radius of the selected object, could be modified to set the desirable value
+- **Text location** is a position of the radius value label relating to extension line (in the view)
+ .. image:: images/location_left.png
+ :align: left
+ **Left** inserts text at the left of the radius extension line.
+
+ .. image:: images/location_automatic.png
+ :align: left
+ **Automatic** inserts text at the middle of the radius extension line if it has enough length, otherwise - to the left.
+
+ .. image:: images/location_right.png
+ :align: left
+ **Right** inserts text to the right of the radius extension line.
+
+When circle or arc is selected radius value is displayed in the property panel and in the view.
+
+When creating the constraint, after selection of the circle or arc at the first time :
+
+- drag the radius presentation in the view to the desired position (by move mouse and click once)
+- set desirable radius value in the input field in the view and press **Enter** or just press **Enter** to keep the current radius
+
+.. image:: images/Radius_field_view.png
+ :align: center
.. centered::
- Create a radius constraint
+ Radius input in the view
+
+**TUI Command**: *Sketch_1.setRadius(CircleOrArc, Value)*
+
+**Arguments**: circle or arc circumference object + radius value
+
+Result
+""""""
+
+Created Radius appears in the view.
+
+.. image:: images/Radius_res.png
+ :align: center
+
+.. centered::
+ Radius created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_radius` operation.
+++ /dev/null
-
-Fixed constraint
-================
-
-
-.. image:: images/Fixed.png
- :align: center
-
-.. centered::
- Create a fixed constraint
Tangent constraint
==================
+Tangent constraint fixes a circle (or an arc) and a line so that a line is tangent to a circle (or an arc).
-.. image:: images/Tangent.png
- :align: center
+To create Tangent in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Tangent* item or
+#. click **Tangent** button in Sketch toolbar:
+
+.. image:: images/tangent.png
+ :align: center
+
+.. centered::
+ **Tangent** button
+
+Property panel:
+
+.. image:: images/Tangent_panel.png
+ :align: center
+
+Input fields:
+
+- **First object** is a line, a circle or an arc selected in the view.
+- **Second object** is a line, a circle or an arc selected in the view.
+
+Note that one of two objects should be a line.
+
+After the objects are selected the special sign will be added close to the tangency point in the view.
+
+**TUI Command**: *Sketch_1.setTangent(Line, CircleOrArc)*
+
+**Arguments**: 2 objects (the first is a line, the second one is a circle or an arc)
+
+Result
+""""""
+
+Created Tangent constraint appears in the view.
+
+.. image:: images/Tangent_res.png
+ :align: center
.. centered::
- Create a tangent constraint
+ Tangent constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_tangent` operation.
Vertical distance constraint
============================
-Vertical Distance constraint fixes distance between two objects along the vertical axis.
+Vertical Distance constraint fixes distance between two points along the vertical axis.
The constraint can be defined between two points such as point object, line or arc end point, center of circle or arc.
Input fields:
-- **First object** - the first object
-- **Second object** - the second object
-- **Value** - distance between the objects, could be modified to set the desirable value
-- **Text location** - position of the distance value label relating to extension line (in the view)
+- **First point** is the first point selected in the view
+- **Second point** is the second point selected in the view
+- **Value** is a distance between the objects, could be modified to set the desirable value
+- **Text location** is a position of the distance value label relating to extension line (in the view)
.. image:: images/location_left.png
:align: left
**Left** inserts text at the left of the distance extension line.
:align: left
**Right** inserts text to the right of the distance extension line.
-When the both objects are selected vertical distance value is displayed in the property panel and in the view.
+When both objects are selected vertical distance value is displayed in the property panel and in the view.
-When creating the constraint and the both objects are selected the first time:
+When creating the constraint, after selection of two objects at the first time:
- drag the Vertical distance presentation in the view to the desired position (by move mouse and click once)
- set desirable vertical distance value in the input field in the view and press **Enter** or just press **Enter** to keep the current distance
Vertical constraint
===================
+Vertical constraint fixes lines to lie parallel to the vertical axis.
-.. image:: images/Vertical.png
- :align: center
+To create Vertical constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Vertical* item or
+#. click **Vertical** button in Sketch toolbar:
+
+.. image:: images/vertical.png
+ :align: center
.. centered::
- Create a vertical constraint
+ **Vertical** button
+
+Property panel:
+
+.. image:: images/Vertical_panel.png
+ :align: center
+
+Input fields:
+
+- **Line** is the line selected in the view.
+
+| After the line is selected it becomes parallel to the vertical axis in the view.
+| **V** sign added above the line.
+
+**TUI Command**: *Sketch_1.setVertical(LineObject)*
+
+**Arguments**: 1 line object
+
+Result
+""""""
+
+Created Vertical constraint appears in the view.
+
+.. image:: images/Vertical_res.png
+ :align: center
+
+.. centered::
+ Vertical constraint created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_vertical` operation.
\ No newline at end of file
