Salome HOME
Cosmetics. Move XML files to the separate folder inside a corresponding project in VS.
[modules/shaper.git] / src / SketchPlugin / doc / arcFeature.rst
index a830d1874576b59fed4fbfda1ebb98c241b9cea3..1abd7ecd97e35360c967fafbd398b1b51463bb54 100644 (file)
+.. |arc.icon|    image:: images/arc.png
 
 Arc
 ===
 
+Arc feature creates an arc segment in the current Sketch.
 
-.. image:: images/Arc1.png
-  :align: center
+To add a new Arc to the Sketch:
 
-.. centered::
-  Create arc by center and two points
+#. select in the Main Menu *Sketch - > Arc* item  or
+#. click |arc.icon| **Arc** button in Sketch toolbar:
 
+There are 4 algorithms for creation of an Arc:
 
-.. image:: images/Arc2.png
-  :align: center
+.. figure:: images/arc_base_32x32.png
+   :align: left
+   :height: 24px
 
-.. centered::
-  Create arc by three points
+**By center and two points** creates an arc segment with the given center passing from the start point to the end point on the circle.
 
+.. figure:: images/arc_3pt_32x32.png
+   :align: left
+   :height: 24px
 
-.. image:: images/Arc3.png
-  :align: center
+**By three points** creates an arc segment passing from the start point to end point through another point on the circle.
 
-.. centered::
-  Create arc as tangent to an edge
+.. figure:: images/arc_tang_32x32.png
+   :align: left
+   :height: 24px
+
+**By tangent point and end point** creates an arc segment with the tangent point and the end point.
+
+.. figure:: images/arc_perp_32x32.png
+   :align: left
+   :height: 24px
+
+**By point on perpendicular line and end point** creates an arc segment perpendicular to a straight line with the start point, connected with boundary of this line, and the end point.
+
+-------------------------------------------------------------------------------------------
+
+By center and two points
+""""""""""""""""""""""""
+
+.. figure:: images/Arc_panel_base.png
+   :align: center
+
+Click in the view once to set the center point, then move the mouse and click a second time to set the start point
+and finally move the mouse and click a third time to set the last passed point.
+
+- When entering a center or start point by selecting either a point or a segment, a Coincident constraint is created.
+- When entering an end point by selecting a segment, a Coincident constraint is created.
+- When entering an end point, only segments are selectable.
+
+**TUI Command**:
+
+.. py:function:: Sketch_1.addArc(CenterX, CenterY, StartX, StartY, EndX, EndY, Inversed)
+
+    :param real: Center X.
+    :param real: Center Y.
+    :param real: Start X.
+    :param real: Start Y.
+    :param real: End X.
+    :param real: End Y.
+    :param boolean: Is inversed.
+    :return: Result object.
+
+By three points
+"""""""""""""""
+
+.. figure:: images/Arc_panel_3pt.png
+   :align: center
+
+Click in the view once to set the start point, then move the mouse and click a second time to set the end point
+and finally move the mouse and click a third time to set the passed point.
+
+- When entering a start or end point by selecting either a point or a segment, a Coincident constraint is created.
+- When entering a passing point by selecting a point, a Coincident constraint is created.
+- When entering a passing point by selecting a segment, a Tangent constraint is created.
+
+**TUI Command**:
+
+.. py:function:: Sketch_1.addArc(StartX, StartY, EndX, EndY, PassedX, PassedY)
+
+    :param real: Start X.
+    :param real: Start Y.
+    :param real: End X.
+    :param real: End Y.
+    :param real: Passed X.
+    :param real: Passed Y.
+    :return: Result object.
+
+By tangent point and end point
+""""""""""""""""""""""""""""""
+
+.. figure:: images/Arc_panel_tang.png
+   :align: center
+
+Select a point on segment in the view to set the tangent point, then move the mouse and click to set the end point.
+The tangent point by itself is a start point. The edge on which it lies will be tangent to the arc.
+
+- When entering a tangent point by selecting a point on segment, a Tangent constraint is created.
+- When entering an end point by selecting a segment, a Coincident constraint is created.
+- When entering an end point, only segments are selectable.
+
+**TUI Command**:
+
+.. py:function:: Sketch_1.addArc(TangentPoint, EndX, EndY, Inversed)
+
+    :param object: Tangent Point.
+    :param real: End X.
+    :param real: End Y.
+    :param boolean: Is inversed.
+    :return: Result object.
+
+By point on perpendicular line and end point
+""""""""""""""""""""""""""""""""""""""""""""
+
+.. figure:: images/Arc_panel_perp.png
+   :align: center
+
+Select a point on a straight segment in the view to set the start point, then move the mouse and click to set the end point.
+The edge on which the start point lies will be perpendicular to the arc (the center of the arc is lying on the edge).
+
+- When entering a start point by selecting a point on segment, a Perpendicular constraint is created.
+- When entering an end point by selecting a segment, a Coincident constraint is created.
+- When entering an end point, only segments are selectable.
+
+**TUI Command**:
+
+.. py:function:: Sketch_1.addArc(StartPoint, EndX, EndY, Inversed, True)
+
+    :param object: Start Point.
+    :param real: End X.
+    :param real: End Y.
+    :param boolean: Is inversed.
+    :param boolean: Arc is perpendicular (always True).
+    :return: Result object.
+
+Result
+""""""
+
+Created arc appears in the view.
+
+.. figure:: images/Arc_res.png
+   :align: center
+
+   Arc created
+
+**See Also** a sample TUI Script of :ref:`tui_create_arc` operation.