modeling-app/docs/kcl-std/tangentialArc.md

title, excerpt, layout

title	excerpt	layout
std::sketch::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?: Point2d,
  end?: Point2d,
  radius?: number,
  angle?: number,
  tag?: TagDeclarator,
): Sketch

Arguments

Name	Type	Description	Required
sketch	Sketch	Which sketch should this path be added to?	Yes
endAbsolute	Point2d	Which absolute point should this arc go to? Incompatible with end, radius, and offset.	No
end	Point2d	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 - A sketch is a collection of paths.

Examples

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

example = extrude(exampleSketch, length = 10)

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

example = extrude(exampleSketch, length = 10)

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

example = extrude(exampleSketch, length = 10)