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

title, subtitle, excerpt, layout

title	subtitle	excerpt	layout
tangentialArc	Function in std::sketch	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.

tangentialArc(
  @sketch: Sketch,
  endAbsolute?: Point2d,
  end?: Point2d,
  radius?: number(Length),
  diameter?: number(Length),
  angle?: number(Angle),
  tag?: tag,
): Sketch

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.

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(Length)	Radius of the imaginary circle. angle must be given. Incompatible with end and endAbsolute and diameter.	No
diameter	number(Length)	Diameter of the imaginary circle. angle must be given. Incompatible with end and endAbsolute and radius.	No
angle	number(Angle)	Offset of the arc. radius must be given. Incompatible with end and endAbsolute.	No
tag	tag	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)