Spline Curve Math Functions

This module provides various mathematical functions for spline curves, including Bézier and Catmull-Rom interpolation methods. These functions are useful for generating and manipulating smooth curves in 3D and 2D space.

Installation

To install the module, run the following command:

npm install @xeokit/sdk
Copy

Usage

We'll demonstrate a selection of curve functions provided by this module.

Import the functions:

import {
  tangentQuadraticBezier,
  tangentQuadraticBezier3,
  tangentSpline,
  catmullRomInterpolate,
  b2,
  b3
} from "@xeokit/sdk/curves";
Copy

Quadratic Bézier curve tangent at a given parameter

const t = 0.5; // Parameter t (0 ≤ t ≤ 1)
const p0 = 0, p1 = 10, p2 = 20; // Control points
const tangentQuad = tangentQuadraticBezier(t, p0, p1, p2);
console.log("Quadratic Bézier curve tangent:", tangentQuad);
Copy

Cubic Bézier curve tangent at a given parameter

const p3 = 30; // Fourth control point
const tangentCubic = tangentQuadraticBezier3(t, p0, p1, p2, p3);
console.log("Cubic Bézier curve tangent:", tangentCubic);
Copy

Spline curve tangent at a given parameter

const tangentSplineValue = tangentSpline(t);
console.log("Spline curve tangent:", tangentSplineValue);
Copy

Catmull-Rom interpolation at a given parameter

const p4 = 40; // Additional control point for Catmull-Rom
const interpolatedValue = catmullRomInterpolate(p0, p1, p2, p3, t);
console.log("Catmull-Rom interpolation result:", interpolatedValue);
Copy

Quadratic Bézier curve result at a given parameter

const quadBezierResult = b2(t, p0, p1, p2);
console.log("Quadratic Bézier curve result:", quadBezierResult);
Copy

Cubic Bézier curve result at a given parameter

const cubicBezierResult = b3(t, p0, p1, p2, p3);
console.log("Cubic Bézier curve result:", cubicBezierResult);
Copy