Salome HOME
Correct documentation bugs, adapt for 'Read The Docs' theme (bos #18858)
[modules/shaper.git] / src / SketchPlugin / doc / tangentFeature.rst
index 2ddc42082ce77b32342992cf3135d3839dcbcc13..cbe200a3f683f305daa1484ab76968e103a999d3 100644 (file)
@@ -1,3 +1,46 @@
+.. |tangent.icon|    image:: images/Tangent.png
 
 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).
+
+To create a Tangent in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Tangent* item  or
+#. click |tangent.icon| **Tangent** button in Sketch toolbar:
+
+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, a special sign will be added close to the tangency point in the view.
+
+**TUI Command**:
+
+.. py:function:: Sketch_1.setTangent(Line, CircleOrArc)
+
+    :param object: A line.
+    :param object: A circle or an arc.
+    :return: Result object.
+
+Result
+""""""
+
+Created Tangent constraint appears in the view.
+
+.. image:: images/Tangent_res.png
+          :align: center
+
+.. centered::
+   Created tangent constraint
+
+**See Also** a sample TUI Script of :ref:`tui_create_tangent` operation.