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.
97 lines
2.2 KiB
Plaintext
97 lines
2.2 KiB
Plaintext
@no_std
|
||
|
||
/// The value of `pi`, Archimedes’ constant (π).
|
||
///
|
||
/// ```
|
||
/// circumference = 70
|
||
///
|
||
/// exampleSketch = startSketchOn("XZ")
|
||
/// |> circle(center = [0, 0], radius = circumference/ (2 * PI))
|
||
///
|
||
/// example = extrude(exampleSketch, length = 5)
|
||
/// ```
|
||
export PI = 3.14159265358979323846264338327950288_
|
||
|
||
/// The value of Euler’s number `e`.
|
||
///
|
||
/// ```
|
||
/// exampleSketch = startSketchOn("XZ")
|
||
/// |> startProfileAt([0, 0], %)
|
||
/// |> angledLine({
|
||
/// angle = 30,
|
||
/// length = 2 * E ^ 2,
|
||
/// }, %)
|
||
/// |> yLine(endAbsolute = 0)
|
||
/// |> close()
|
||
///
|
||
/// example = extrude(exampleSketch, length = 10)
|
||
/// ```
|
||
export E = 2.71828182845904523536028747135266250_
|
||
|
||
/// The value of `tau`, the full circle constant (τ). Equal to 2π.
|
||
///
|
||
/// ```
|
||
/// exampleSketch = startSketchOn("XZ")
|
||
/// |> startProfileAt([0, 0], %)
|
||
/// |> angledLine({
|
||
/// angle = 50,
|
||
/// length = 10 * TAU,
|
||
/// }, %)
|
||
/// |> yLine(endAbsolute = 0)
|
||
/// |> close()
|
||
///
|
||
/// example = extrude(exampleSketch, length = 5)
|
||
/// ```
|
||
export TAU = 6.28318530717958647692528676655900577_
|
||
|
||
/// Compute the cosine of a number (in radians).
|
||
///
|
||
/// ```
|
||
/// exampleSketch = startSketchOn("XZ")
|
||
/// |> startProfileAt([0, 0], %)
|
||
/// |> angledLine({
|
||
/// angle = 30,
|
||
/// length = 3 / cos(toRadians(30)),
|
||
/// }, %)
|
||
/// |> yLine(endAbsolute = 0)
|
||
/// |> close()
|
||
///
|
||
/// example = extrude(exampleSketch, length = 5)
|
||
/// ```
|
||
@(impl = std_rust)
|
||
export fn cos(num: number(rad)): number(_) {}
|
||
|
||
/// Compute the sine of a number (in radians).
|
||
///
|
||
/// ```
|
||
/// exampleSketch = startSketchOn("XZ")
|
||
/// |> startProfileAt([0, 0], %)
|
||
/// |> angledLine({
|
||
/// angle = 50,
|
||
/// length = 15 / sin(toDegrees(135)),
|
||
/// }, %)
|
||
/// |> yLine(endAbsolute = 0)
|
||
/// |> close()
|
||
///
|
||
/// example = extrude(exampleSketch, length = 5)
|
||
/// ```
|
||
@(impl = std_rust)
|
||
export fn sin(num: number(rad)): number(_) {}
|
||
|
||
/// Compute the tangent of a number (in radians).
|
||
///
|
||
/// ```
|
||
/// exampleSketch = startSketchOn("XZ")
|
||
/// |> startProfileAt([0, 0], %)
|
||
/// |> angledLine({
|
||
/// angle = 50,
|
||
/// length = 50 * tan(1/2),
|
||
/// }, %)
|
||
/// |> yLine(endAbsolute = 0)
|
||
/// |> close()
|
||
///
|
||
/// example = extrude(exampleSketch, length = 5)
|
||
/// ```
|
||
@(impl = std_rust)
|
||
export fn tan(num: number(rad)): number(_) {}
|