+.. |arc.icon| image:: images/arc.png
Arc
===
To add a new Arc to the Sketch:
#. select in the Main Menu *Sketch - > Arc* item or
-#. click **Arc** button in Sketch toolbar:
+#. click |arc.icon| **Arc** button in Sketch toolbar:
-.. image:: images/arc.png
- :align: center
-
-.. centered::
- **Arc** button
-
-There are 3 algorithms for creation of an Arc:
+There are 4 algorithms for creation of an Arc:
-.. image:: images/arc_base_32x32.png
+.. figure:: images/arc_base_32x32.png
:align: left
+ :height: 24px
+
**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.
-.. image:: images/arc_3pt_32x32.png
+.. figure:: images/arc_3pt_32x32.png
:align: left
+ :height: 24px
+
**By three points** creates an arc segment passing from the start point to end point through another point on the circle.
-.. image:: images/arc_tang_32x32.png
+.. 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
""""""""""""""""""""""""
-.. image:: images/Arc_panel_base.png
+.. 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
- 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**: *Sketch_1.addArc(CenterX, CenterY, StartX, StartY, EndX, EndY, Inversed)*
+**TUI Command**:
+
+.. py:function:: Sketch_1.addArc(CenterX, CenterY, StartX, StartY, EndX, EndY, Inversed)
-**Arguments**: 7 values (coordinates of the center, the start, the end, inversed flag (if true - build arc from end to start)).
+ :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
"""""""""""""""
-.. image:: images/Arc_panel_3pt.png
+.. 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
- 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**: *Sketch_1.addArc(StartX, StartY, EndX, EndY, PassedX, PassedY)*
+**TUI Command**:
+
+.. py:function:: Sketch_1.addArc(StartX, StartY, EndX, EndY, PassedX, PassedY)
-**Arguments**: 6 values (coordinates of the start, end and passed points).
+ :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 point
-""""""""""""""""""""""""""
+By tangent point and end point
+""""""""""""""""""""""""""""""
-.. image:: images/Arc_panel_tang.png
+.. 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.
- 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**: *Sketch_1.addArc(TangetPoint, EndX, EndY, Inversed)*
+**TUI Command**:
-**Arguments**: 4 values (reference to tangent point, coordinates of end point, inversed flag (if true - build arc from end to start)).
+.. 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.
-.. image:: images/Arc_res.png
- :align: center
+.. figure:: images/Arc_res.png
+ :align: center
-.. centered::
- Circle created
+ Arc created
-**See Also** a sample TUI Script of :ref:`tui_create_arc` operation.
\ No newline at end of file
+**See Also** a sample TUI Script of :ref:`tui_create_arc` operation.
