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

title, subtitle, excerpt, layout

title	subtitle	excerpt	layout
angledLine	Function in std::sketch	Draw a line segment relative to the current origin using the polar measure of some angle and distance.	manual

Draw a line segment relative to the current origin using the polar measure of some angle and distance.

angledLine(
  @sketch: Sketch,
  angle: number(Angle),
  length?: number(Length),
  lengthX?: number(Length),
  lengthY?: number(Length),
  endAbsoluteX?: number(Length),
  endAbsoluteY?: number(Length),
  tag?: tag,
): Sketch

Arguments

Name	Type	Description	Required
sketch	Sketch	Which sketch should this path be added to?	Yes
angle	number(Angle)	Which angle should the line be drawn at?	Yes
length	number(Length)	Draw the line this distance along the given angle. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given.	No
lengthX	number(Length)	Draw the line this distance along the X axis. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given.	No
lengthY	number(Length)	Draw the line this distance along the Y axis. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given.	No
endAbsoluteX	number(Length)	Draw the line along the given angle until it reaches this point along the X axis. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given.	No
endAbsoluteY	number(Length)	Draw the line along the given angle until it reaches this point along the Y axis. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given.	No
tag	tag	Create a new tag which refers to this line.	No

Returns

Sketch - A sketch is a collection of paths.

Examples

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

example = extrude(exampleSketch, length = 10)