From 832066dc999681bf648b6b9cb86acf5206fe0188 Mon Sep 17 00:00:00 2001 From: lucas-santos-f <162367088+lucas-santos-f@users.noreply.github.com> Date: Wed, 28 Oct 2026 22:43:59 +0000 Subject: [PATCH] Document Sketch.arc overloads Describe the arguments of the three arc forms, in particular the start angle and angular span of the center/radius form. Fixes #1663 --- cadquery/sketch.py | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/cadquery/sketch.py b/cadquery/sketch.py index d1db09107..77d4703c9 100644 --- a/cadquery/sketch.py +++ b/cadquery/sketch.py @@ -862,6 +862,8 @@ def arc( ) -> T: """ Construct an arc. + + The arc starts at p1, passes through p2 and ends at p3. """ val = Edge.makeThreePointArc(Vector(p1), Vector(p2), Vector(p3)) @@ -876,6 +878,10 @@ def arc( tag: Optional[str] = None, forConstruction: bool = False, ) -> T: + """ + Construct an arc starting at the end of the last edge, passing through p2 + and ending at p3. + """ p1 = self._endPoint() val = Edge.makeThreePointArc(Vector(p1), Vector(p2), Vector(p3)) @@ -892,6 +898,15 @@ def arc( tag: Optional[str] = None, forConstruction: bool = False, ) -> T: + """ + Construct an arc from its center, radius and angles. + + :param c: Center. + :param r: Radius. + :param a: Start angle in degrees, measured counter-clockwise from the x axis. + :param da: Angle spanned by the arc in degrees, counter-clockwise if positive + and clockwise if negative. A full circle is made if ``abs(da) >= 360``. + """ if abs(da) >= 360: val = Edge.makeCircle(r, Vector(c), angle1=a, angle2=a, orientation=da > 0)