Files
modeling-app/docs/kcl/angledLine.md
Nick Cameron c050739f41 Some improvements to the boxed signatures in the docs (#6593)
* Show a more reasonable name in function docs

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Fix buggy docs for union types

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Make types in the docs signatures into links

Signed-off-by: Nick Cameron <nrc@ncameron.org>

---------

Signed-off-by: Nick Cameron <nrc@ncameron.org>
2025-04-30 16:03:22 +00:00

88 KiB

title, excerpt, layout
title excerpt layout
angledLine 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](/docs/kcl/types/Sketch),
  angle: [number](/docs/kcl/types/number),
  length?: [number](/docs/kcl/types/number),
  lengthX?: [number](/docs/kcl/types/number),
  lengthY?: [number](/docs/kcl/types/number),
  endAbsoluteX?: [number](/docs/kcl/types/number),
  endAbsoluteY?: [number](/docs/kcl/types/number),
  tag?: [TagDeclarator](/docs/kcl/types#tag-declaration),
): [Sketch](/docs/kcl/types/Sketch)

Arguments

Name Type Description Required
sketch Sketch Which sketch should this path be added to? Yes
angle number Which angle should the line be drawn at? Yes
length number Draw the line this distance along the given angle. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given. No
lengthX number Draw the line this distance along the X axis. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given. No
lengthY number Draw the line this distance along the Y axis. Only one of length, lengthX, lengthY, endAbsoluteX, endAbsoluteY can be given. No
endAbsoluteX number 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 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 TagDeclarator Create a new tag which refers to this line No

Returns

Sketch

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)

Rendered example of angledLine 0