Files
modeling-app/docs/kcl/angledLine.md
Adam Chalmers aea82e004a KCL: Convert x/y lines to use keyword arguments (#5615)
Previously, `xLine`, `xLineTo`, `yLine` and `yLineTo` used positional arguments. Now:

- `xLineTo` and `yLineTo` have been removed
- `xLine` and `yLine` both use keyword arguments:
  - `length`, optional (i.e. a relative distance along the X or Y axis)
  - `endAbsolute` optional (i.e. an absolute point along the X or Y axis)
  - `tag` optional
- Exactly one of `length` or `endAbsolute` must be given. Not both, not neither.

For example:

```
// Old way
|> xLine(6.04, %)
|> yLineTo(20, %, $base)

// New way
|> xLine(length = 6.04)
|> yLine(endAbsolute = 20, tag = $base)
```

This also improves some of the general-purpose keyword arguments code in modeling app's TS codebase.
2025-03-07 22:07:16 -06:00

86 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(
  data: AngledLineData,
  sketch: Sketch,
  tag?: TagDeclarator,
): Sketch

Arguments

Name Type Description Required
data AngledLineData Data to draw an angled line. Yes
sketch Sketch Yes
tag TagDeclarator No

Returns

Sketch

Examples

exampleSketch = startSketchOn(XZ)
  |> startProfileAt([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