Class Curve`Abstract`

Base class for parametric 3D curves.

Curves are sampled over t in the range [0..1] and provide helpers for point, tangent, arc-length, and uniform-distance sampling.

Hierarchy (View Summary)

Curve

Index

Constructors

Properties

__arcLengthDivisions? _t cacheArcLengths? needsUpdate?

Accessors

length t tangent

Methods

_getLengths _updateArcLengths getPoint getPointAt getPoints getTangent getUToTMapping

Constructors

constructor

new Curve(cfg?: { t?: number }): Curve
Creates a curve.
Parameters
- cfg: { t?: number } = {}
  Configuration options
  - Optionalt?: number
    Initial curve parameter in the range [0..1]
Returns Curve
- Defined in packages/sdk/src/base/math/curves/Curve.ts:21

Properties

`Protected` `Optional`__arcLengthDivisions

__arcLengthDivisions?: number

`Protected`_t

_t: number = 0

`Protected` `Optional`cacheArcLengths

cacheArcLengths?: number[]

`Protected` `Optional`needsUpdate

needsUpdate?: boolean

Accessors

length

get length(): number
Approximate arc length of the curve.

Computed from cached sampled lengths.

Returns number
- Defined in packages/sdk/src/base/math/curves/Curve.ts:51

t

get t(): number
Returns number
- Defined in packages/sdk/src/base/math/curves/Curve.ts:35
set t(value: number): void
Current curve parameter.

Clamped to the range [0..1].
Parameters
- value: number
Returns void
- Defined in packages/sdk/src/base/math/curves/Curve.ts:30

tangent

get tangent(): Vec3
Normalized tangent at the current t.

Returns Vec3
- Defined in packages/sdk/src/base/math/curves/Curve.ts:42

Methods

`Protected`_getLengths

_getLengths(divisions?: number): number[]
Returns cumulative sampled arc lengths for the curve.

The returned array starts at 0 and ends at the total sampled length. Results are cached until invalidated.
Parameters
- Optionaldivisions: number
  Number of sampling divisions used to approximate arc length
Returns number[]
Cumulative arc lengths
- Defined in packages/sdk/src/base/math/curves/Curve.ts:127

`Protected`_updateArcLengths

_updateArcLengths(): void
Invalidates cached arc-length data and rebuilds it.

Returns void
- Defined in packages/sdk/src/base/math/curves/Curve.ts:163

`Abstract`getPoint

getPoint(t: number): Vec3
Samples the curve at parameter t.
Parameters
- t: number
  Curve parameter in the range [0..1]
Returns Vec3
Point on the curve
- Defined in packages/sdk/src/base/math/curves/Curve.ts:231

getPointAt

getPointAt(u: number): Vec3
Returns a point using normalized arc-length parameterization.

Unlike getPoint, u maps to distance along the curve rather than directly to the curve parameter.
Parameters
- u: number
  Normalized distance along the curve in the range [0..1]
Returns Vec3
Point on the curve
- Defined in packages/sdk/src/base/math/curves/Curve.ts:97

getPoints

getPoints(divisions?: number): Vec3[]
Samples points at evenly spaced parameter intervals.
Parameters
- divisions: number = 5
  Number of intervals to divide [0..1] into
Returns Vec3[]
Sampled points, including both endpoints
- Defined in packages/sdk/src/base/math/curves/Curve.ts:108

getTangent

getTangent(t?: number): Vec3
Returns the normalized tangent at parameter t.

Uses a small finite difference around t.
Parameters
- Optionalt: number
  Curve parameter in the range [0..1]. Defaults to the current t.
Returns Vec3
Normalized tangent vector
- Defined in packages/sdk/src/base/math/curves/Curve.ts:64

getUToTMapping

getUToTMapping(u: number, distance?: number): number
Maps normalized arc-length parameter u to curve parameter t.

This is useful when you want points spaced by distance along the curve instead of by raw parameter value.
Parameters
- u: number
  Normalized distance along the curve in the range [0..1]
- Optionaldistance: number
  Absolute distance along the curve. When provided, overrides u.
Returns number
Curve parameter in the range [0..1]
- Defined in packages/sdk/src/base/math/curves/Curve.ts:178