Adding 1D objects ConstrainedArcs & ConstrainedLines

gumyr · gumyr · commit 11a517fa2920 · 2026-02-26T11:06:25.000-05:00
diff --git a/docs/assets/constrained_arcs_example.svg b/docs/assets/constrained_arcs_example.svg
@@ -0,0 +1,19 @@
+<?xml version='1.0' encoding='utf-8'?>
+<svg width="100.09mm" height="74.42496mm" viewBox="-1.503375 -3.578497 7.50675 5.581872" version="1.1" xmlns="http://www.w3.org/2000/svg">
+  <g transform="scale(1,-1)" stroke-linecap="round">
+    <g fill="none" stroke="rgb(0,0,0)" stroke-width="0.00675">
+      <path d="M 5.590595,1.212439 A 6.0,6.0 0.0 0,1 -0.272937,3.474959" />
+      <path d="M -1.34373,1.333374 A 6.0,6.0 0.0 0,1 3.984405,-1.999939" />
+      <path d="M 3.724868,1.980985 A 6.0,6.0 0.0 0,1 0.910053,0.807606" />
+      <path d="M 1.499947,1.987394 A 6.0,6.0 0.0 0,1 2.250132,-0.968485" />
+      <path d="M 2.00006,-0.015505 A 6.0,6.0 0.0 0,1 1.333253,2.68734" />
+      <path d="M 0.25008,0.520994 A 6.0,6.0 0.0 0,1 2.81244,1.609255" />
+      <path d="M 2.481824,-1.301976 A 6.0,6.0 0.0 0,1 -0.414541,0.558419" />
+      <path d="M 0.904541,3.196581 A 6.0,6.0 0.0 0,1 4.130676,1.995726" />
+    </g>
+    <g fill="none" stroke="rgb(0,0,0)" stroke-width="0.00675" id="dashed" stroke-dasharray="0.081 0.1215">
+      <circle cx="4.0" cy="0.0" r="2.0" />
+      <circle cx="0.0" cy="2.0" r="1.5" />
+    </g>
+  </g>
+</svg>
diff --git a/docs/assets/constrained_lines_example.svg b/docs/assets/constrained_lines_example.svg
@@ -0,0 +1,15 @@
+<?xml version='1.0' encoding='utf-8'?>
+<svg width="100.09mm" height="73.423333mm" viewBox="-1.503375 -3.503375 7.50675 5.50675" version="1.1" xmlns="http://www.w3.org/2000/svg">
+  <g transform="scale(1,-1)" stroke-linecap="round">
+    <g fill="none" stroke="rgb(0,0,0)" stroke-width="0.00675">
+      <line x1="4.688819" y1="1.877639" x2="0.516615" y2="3.408229" />
+      <line x1="2.043224" y1="-0.413553" x2="1.467582" y2="2.310165" />
+      <line x1="2.911181" y1="-1.677639" x2="-0.816615" y2="0.741771" />
+      <line x1="3.156776" y1="1.813553" x2="0.632418" y2="0.639835" />
+    </g>
+    <g fill="none" stroke="rgb(0,0,0)" stroke-width="0.00675" id="dashed" stroke-dasharray="0.081 0.1215">
+      <circle cx="4.0" cy="0.0" r="2.0" />
+      <circle cx="0.0" cy="2.0" r="1.5" />
+    </g>
+  </g>
+</svg>
diff --git a/docs/cheat_sheet.rst b/docs/cheat_sheet.rst
@@ -21,6 +21,8 @@ Cheat Sheet
             | :class:`~objects_curve.Bezier`
             | :class:`~objects_curve.BlendCurve`
             | :class:`~objects_curve.CenterArc`
+            | :class:`~objects_curve.ConstrainedArcs`
+            | :class:`~objects_curve.ConstrainedLines`
             | :class:`~objects_curve.DoubleTangentArc`
             | :class:`~objects_curve.EllipticalCenterArc`
             | :class:`~objects_curve.ParabolicCenterArc`
diff --git a/docs/objects.rst b/docs/objects.rst
@@ -104,6 +104,22 @@ The following objects all can be used in BuildLine contexts. Note that
         +++
         Arc defined by center, radius, & angles
 
+
+    .. grid-item-card:: :class:`~objects_curve.ConstrainedArcs`
+
+        .. image:: assets/constrained_arcs_example.svg
+
+        +++
+        Arc(s) constrained by other geometric objects
+
+
+    .. grid-item-card:: :class:`~objects_curve.ConstrainedLines`
+
+        .. image:: assets/constrained_lines_example.svg
+
+        +++
+        Line(s) constrained by other geometric objects
+
     .. grid-item-card:: :class:`~objects_curve.DoubleTangentArc`
 
         .. image:: assets/double_tangent_line_example.svg
@@ -253,6 +269,8 @@ Reference
 .. autoclass:: Bezier
 .. autoclass:: BlendCurve
 .. autoclass:: CenterArc
+.. autoclass:: ConstrainedArcs
+.. autoclass:: ConstrainedLines
 .. autoclass:: DoubleTangentArc
 .. autoclass:: EllipticalCenterArc
 .. autoclass:: ParabolicCenterArc
diff --git a/docs/objects_1d_constrained.py b/docs/objects_1d_constrained.py
@@ -0,0 +1,35 @@
+# [Setup]
+from build123d import *
+
+# from ocp_vscode import *
+
+dot = Circle(0.05)
+
+with BuildLine() as arcs:
+    c1 = CenterArc((4, 0), 2, 0, 360)
+    c2 = CenterArc((0, 2), 1.5, 0, 360)
+    a1 = ConstrainedArcs(c1, c2, radius=6)
+
+s = 100 / max(*arcs.line.bounding_box().size)
+svg = ExportSVG(scale=s)
+svg.add_layer("dashed", line_type=LineType.ISO_DASH_SPACE)
+svg.add_shape(c1, "dashed")
+svg.add_shape(c2, "dashed")
+svg.add_shape(a1)
+svg.write("assets/constrained_arcs_example.svg")
+
+
+with BuildLine() as lines:
+    c1 = CenterArc((4, 0), 2, 0, 360)
+    c2 = CenterArc((0, 2), 1.5, 0, 360)
+    l1 = ConstrainedLines(c1, c2)
+
+s = 100 / max(*lines.line.bounding_box().size)
+svg = ExportSVG(scale=s)
+svg.add_layer("dashed", line_type=LineType.ISO_DASH_SPACE)
+svg.add_shape(c1, "dashed")
+svg.add_shape(c2, "dashed")
+svg.add_shape(l1)
+svg.write("assets/constrained_lines_example.svg")
+
+# show_all()
diff --git a/src/build123d/__init__.py b/src/build123d/__init__.py
@@ -85,6 +85,8 @@
     "Bezier",
     "BlendCurve",
     "CenterArc",
+    "ConstrainedArcs",
+    "ConstrainedLines",
     "DoubleTangentArc",
     "EllipticalCenterArc",
     "EllipticalStartArc",
diff --git a/src/build123d/objects_curve.py b/src/build123d/objects_curve.py
diff --git a/tests/test_direct_api/test_constrained_arcs.py b/tests/test_direct_api/test_constrained_arcs.py
diff --git a/tests/test_direct_api/test_constrained_lines.py b/tests/test_direct_api/test_constrained_lines.py
