Files
modeling-app/docs/kcl/tangentialArc.md
Jonathan Tran 319c60d4fa BREAKING: Change tangential arc to keyword args (#6266)
* Change tangentialArc, tangentialArcTo, and tangentialArcToRelative to keyword args

* Change tangentialArc offset to angle and convert to kw arg calls

* Fix lints

* Fix sketch errors and all unit tests passing

* Fix tangentialArcTo calls in KCL samples

* Update tangentialArc in samples

* Update sim test output

* Fix formatting

* Fix mistake in merge

* Fix gear rack sample

* Update output after more samples fixes

* Update gear rack output

* Add end label to docs snippet

* Fix to not add endAbsolute for an arc with radius or angle arguments

* Update docs outputs

* Fix formatting

* Fix executor tests

* Fix formatting

* Fix bench input files

* Fix spelling

* Improve error messages

---------

Co-authored-by: Adam Chalmers <adam.chalmers@zoo.dev>
2025-04-11 14:17:20 -04:00

253 KiB

title, excerpt, layout
title excerpt layout
tangentialArc Starting at the current sketch's origin, draw a curved line segment along some part of an imaginary circle until it reaches the desired (x, y) coordinates. manual

Starting at the current sketch's origin, draw a curved line segment along some part of an imaginary circle until it reaches the desired (x, y) coordinates.

When using radius and angle, draw a curved line segment along part of an imaginary circle. The arc is constructed such that the last line segment is placed tangent to the imaginary circle of the specified radius. The resulting arc is the segment of the imaginary circle from that tangent point for 'angle' degrees along the imaginary circle.

tangentialArc(
  sketch: Sketch,
  endAbsolute?: [number],
  end?: [number],
  radius?: number,
  angle?: number,
  tag?: TagDeclarator,
): Sketch

Arguments

Name Type Description Required
sketch Sketch Which sketch should this path be added to? Yes
endAbsolute [number] Which absolute point should this arc go to? Incompatible with end, radius, and offset. No
end [number] How far away (along the X and Y axes) should this arc go? Incompatible with endAbsolute, radius, and offset. No
radius number Radius of the imaginary circle. angle must be given. Incompatible with end and endAbsolute. No
angle number Offset of the arc in degrees. radius must be given. Incompatible with end and endAbsolute. No
tag TagDeclarator Create a new tag which refers to this arc No

Returns

Sketch

Examples

exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine(angle = 45, length = 10)
  |> tangentialArc(end = [0, -10])
  |> line(end = [-10, 0])
  |> close()

example = extrude(exampleSketch, length = 10)

Rendered example of tangentialArc 0

exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine(angle = 60, length = 10)
  |> tangentialArc(endAbsolute = [15, 15])
  |> line(end = [10, -15])
  |> close()

example = extrude(exampleSketch, length = 10)

Rendered example of tangentialArc 1

exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine(angle = 60, length = 10)
  |> tangentialArc(radius = 10, angle = -120)
  |> angledLine(angle = -60, length = 10)
  |> close()

example = extrude(exampleSketch, length = 10)

Rendered example of tangentialArc 2