Class GeometryHelper

constructor

• new GeometryHelper(): GeometryHelper

  Returns GeometryHelper

getArrayDepth

transformControlPoints

• transformControlPoints(
      transformation: number[][] | number[][][],
      transformedControlPoints: Point3[],
  ): Point3[]

  Applies one or more 4×4 transformation matrices to a list of points sequentially. Each transformation is applied in order (composition of transformations). Example: points=[[0,0,0], [1,0,0]] with translation [5,0,0] → [[5,0,0], [6,0,0]]

  Parameters

  • transformation: number[][] | number[][][]
  • transformedControlPoints: Point3[]

  Returns Point3[]

getFlatTransformations

• getFlatTransformations(transformation: number[][] | number[][][]): number[][]

  Flattens nested transformation arrays into a single-level array of transformation matrices. Handles both 2D arrays (single transform list) and 3D arrays (nested transform lists). Example: [[[matrix1, matrix2]], [[matrix3]]] → [matrix1, matrix2, matrix3]

  Parameters

  • transformation: number[][] | number[][][]

  Returns number[][]

transformPointsByMatrixArray

• transformPointsByMatrixArray(points: Point3[], transform: number[]): Point3[]

  Applies a single 4×4 transformation matrix (as flat 16-element array) to multiple points. Example: points=[[0,0,0], [1,0,0]] with translation matrix → transformed points

  Parameters

  • points: Point3[]
  • transform: number[]

  Returns Point3[]

transformPointsCoordinates

• transformPointsCoordinates(points: Point3[], transform: number[]): Point3[]

  Transforms multiple points using a transformation matrix (maps each point through the matrix). Example: points=[[1,0,0], [0,1,0]] with 90° rotation → [[0,1,0], [-1,0,0]]

  Parameters

  • points: Point3[]
  • transform: number[]

  Returns Point3[]

removeAllDuplicateVectors

• removeAllDuplicateVectors(vectors: number[][], tolerance?: number): number[][]

  Removes all duplicate vectors from a list (works with arbitrary-length numeric vectors). Compares vectors using tolerance for floating-point equality. Example: [[1,2], [3,4], [1,2], [5,6]] with tolerance=1e-7 → [[1,2], [3,4], [5,6]]

  Parameters

  • vectors: number[][]
  • Optionaltolerance: number

  Returns number[][]

removeConsecutiveVectorDuplicates

• removeConsecutiveVectorDuplicates(
      vectors: number[][],
      checkFirstAndLast?: boolean,
      tolerance?: number,
  ): number[][]

  Removes consecutive duplicate vectors from a list (keeps only first occurrence in each sequence). Optionally checks and removes duplicate if first and last vectors match. Example: [[1,2], [1,2], [3,4], [3,4], [5,6]] → [[1,2], [3,4], [5,6]]

  Parameters

  • vectors: number[][]
  • OptionalcheckFirstAndLast: boolean
  • Optionaltolerance: number

  Returns number[][]

vectorsTheSame

• vectorsTheSame(vec1: number[], vec2: number[], tolerance: number): boolean

  Compares two vectors for approximate equality using tolerance (element-wise comparison). Returns false if vectors have different lengths. Example: [1.0000001, 2.0], [1.0, 2.0] with tolerance=1e-6 → true

  Parameters

  • vec1: number[]
  • vec2: number[]
  • tolerance: number

  Returns boolean

approxEq

• approxEq(num1: number, num2: number, tolerance: number): boolean

  Checks if two numbers are approximately equal within a tolerance. Example: 1.0000001, 1.0 with tolerance=1e-6 → true, 1.001, 1.0 with tolerance=1e-6 → false

  Parameters

  • num1: number
  • num2: number
  • tolerance: number

  Returns boolean

removeConsecutivePointDuplicates

• removeConsecutivePointDuplicates(
      points: Point3[],
      checkFirstAndLast?: boolean,
      tolerance?: number,
  ): Point3[]

  Removes consecutive duplicate points from a list (specialized for 3D/2D points). Optionally checks and removes duplicate if first and last points match (for closed loops). Example: [[0,0,0], [0,0,0], [1,0,0], [1,0,0]] → [[0,0,0], [1,0,0]]

  Parameters

  • points: Point3[]
  • OptionalcheckFirstAndLast: boolean
  • Optionaltolerance: number

  Returns Point3[]

arePointsTheSame

• arePointsTheSame(
      pointA: Point3 | Point2,
      pointB: Point3 | Point2,
      tolerance: number,
  ): boolean

  Checks if two points are approximately equal using tolerance (supports 2D and 3D points). Example: [1.0000001, 2.0, 3.0], [1.0, 2.0, 3.0] with tolerance=1e-6 → true

  Parameters

  • pointA: Point3 | Point2
  • pointB: Point3 | Point2
  • tolerance: number

  Returns boolean