xeokit Vector Math Utilities

---

Mathematical functions and types for working with vectors

---

A small, allocation-conscious set of vector primitives and operations used by the math modules (eg. matrix and quat) and by geometry/transforms across the SDK.

Vectors are represented as either typed arrays (eg. Float32Array, Float64Array, Int32Array, …) or fixed-length numeric tuples. All functions accept either form and generally support an optional dest parameter to write results in-place, which helps avoid temporary allocations in tight loops.

Vector type system

This module defines vector aliases grouped by:

• Length: Vec2, Vec3, Vec4, Vec9
• Domain: integer vs floating-point
• Precision (floats): explicit Float32 / Float64 or “either precision”

Notable aliases:

• Vec2Int, Vec3Int, Vec4Int
• Vec2Float32, Vec2Float64, Vec3Float32, Vec3Float64, …
• Vec2Float, Vec3Float, Vec4Float, Vec9Float

Factory helpers like createVec3Float64 and createVec4Float32 produce typed arrays of the requested size/precision, optionally seeded from an existing vector.

Core operations

• Arithmetic: addVec3, subVec3, mulVec3Scalar, divVec3Scalar, plus scalar variants for common dimensions.
• Products: dotVec2, dotVec3, dotVec4, cross3Vec3
• Length & distance: lenVec2, lenVec3, lenVec4, distVec2, distVec3
• Normalization: normalizeVec2, normalizeVec3, normalizeVec4
• Geometry helpers: triangleNormal, angleVec3, testOrthogonalAxis

Mutability and destinations

Many functions default to mutating their first input (eg. addVec3(u, v) writes into u) unless a dest is provided. If you need to keep inputs unchanged, always pass an explicit destination vector.