@carbonenginejs/runtime-utils 0.1.2 → 0.1.4

package/src/ray3.js

@@ -10,31 +10,31 @@ import { mat3 } from "./mat3.js";
  * @typedef {Float32Array} ray3
  */
 
-export const ray3 = {};
-
-function getAtParameter(out, a, t)
-{
-    out[0] = a[0] + a[3] * t;
-    out[1] = a[1] + a[4] * t;
-    out[2] = a[2] + a[5] * t;
-    return out;
-}
-
-/**
- * Allocates a pooled ray3
- * @returns {Float32Array|ray3}
- */
-ray3.alloc = box3.alloc;
-
-/**
- * Unallocates a pooled ray3
- * @param {ray3|Float32Array} a
- */
-ray3.unalloc = box3.unalloc;
-
-/**
- * Gets a subarray of a ray3's origin vector
- * @property {box3} a
+export const ray3 = {};
+
+function getAtParameter(out, a, t)
+{
+    out[0] = a[0] + a[3] * t;
+    out[1] = a[1] + a[4] * t;
+    out[2] = a[2] + a[5] * t;
+    return out;
+}
+
+/**
+ * Allocates a pooled ray3
+ * @returns {Float32Array|ray3}
+ */
+ray3.alloc = box3.alloc;
+
+/**
+ * Unallocates a pooled ray3
+ * @param {ray3|Float32Array} a
+ */
+ray3.unalloc = box3.unalloc;
+
+/**
+ * Gets a subarray of a ray3's origin vector
+ * @property {box3} a
  * @returns {TypedArray}
  */
 ray3.$origin = box3.$min;
@@ -86,10 +86,10 @@ ray3.copyDirection = box3.copyMax;
  *
  * @returns {ray3}
  */
-ray3.create = function ()
-{
-    return new Float32Array(6);
-};
+ray3.create = function ()
+{
+    return new Float32Array(6);
+};
 
 /**
  * Gets the distance from a ray3 to a point
@@ -112,18 +112,18 @@ ray3.distance = function (a, p)
  * @param {number} c      - plane constant
  * @returns {null|number} - distance
  */
-ray3.distanceNormalConstant = function (a, n, c)
-{
+ray3.distanceNormalConstant = function (a, n, c)
+{
     let den = n[0] * a[3] + n[1] * a[4] + n[2] * a[5];
     let dist = (a[0] * n[0] + a[1] * n[1] + a[2] * n[2]) + c;
     if (den === 0)
     {
         if (dist === 0) return 0;
-        return null;
-    }
-
-    let t = -dist / den;
-    return t >= 0 ? t * Math.hypot(a[3], a[4], a[5]) : null;
+        return null;
+    }
+
+    let t = -dist / den;
+    return t >= 0 ? t * Math.hypot(a[3], a[4], a[5]) : null;
 };
 
 /**
@@ -134,9 +134,9 @@ ray3.distanceNormalConstant = function (a, n, c)
  * @param {pln} p         - plane to measure distance to
  * @returns {null|Number} - distance
  */
-ray3.distancePln = function (a, p)
-{
-    return ray3.distanceNormalConstant(a, p, p[3]);
+ray3.distancePln = function (a, p)
+{
+    return ray3.distanceNormalConstant(a, p, p[3]);
 };
 
 /**
@@ -178,23 +178,23 @@ ray3.exactEquals = box3.exactEquals;
 ray3.exactEqualsOriginDestination = box3.exactEqualsBounds;
 
 /**
- * Sets a ray3 from origin and direction
+ * Sets a ray3 from origin and direction
  *
  * @param {ray3} out
  * @param {vec3} o
  * @param {vec3} d
  * @returns {ray3} out
  */
-ray3.from = function (out, origin, direction)
-{
-    out[0] = origin[0];
-    out[1] = origin[1];
-    out[2] = origin[2];
-    out[3] = direction[0];
-    out[4] = direction[1];
-    out[5] = direction[2];
-    return direction[0] || direction[1] || direction[2] ? ray3.normalize(out, out) : out;
-};
+ray3.from = function (out, origin, direction)
+{
+    out[0] = origin[0];
+    out[1] = origin[1];
+    out[2] = origin[2];
+    out[3] = direction[0];
+    out[4] = direction[1];
+    out[5] = direction[2];
+    return direction[0] || direction[1] || direction[2] ? ray3.normalize(out, out) : out;
+};
 
 /**
  * Sets a ray3 from an array at an optional offset
@@ -204,11 +204,11 @@ ray3.from = function (out, origin, direction)
  * @param {number} [index=0]
  * @returns {ray3}
  */
-ray3.fromArray = function (out, array, offset = 0)
-{
-    box3.fromArray(out, array, offset);
-    return out[3] || out[4] || out[5] ? ray3.normalize(out, out) : out;
-};
+ray3.fromArray = function (out, array, offset = 0)
+{
+    box3.fromArray(out, array, offset);
+    return out[3] || out[4] || out[5] ? ray3.normalize(out, out) : out;
+};
 
 /**
  * Sets a ray 3 from start and end vectors
@@ -319,11 +319,11 @@ ray3.unproject = function (out, coords, invProjView, viewport)
  * @param {number} t   - distance along the ray3
  * @returns {vec3} out - receiving vec3
  */
-ray3.get = function (out, a, t)
-{
-    const length = Math.hypot(a[3], a[4], a[5]);
-    return length === 0 ? vec3.set(out, a[0], a[1], a[2]) :
-        getAtParameter(out, a, t / length);
+ray3.get = function (out, a, t)
+{
+    const length = Math.hypot(a[3], a[4], a[5]);
+    return length === 0 ? vec3.set(out, a[0], a[1], a[2]) :
+        getAtParameter(out, a, t / length);
 };
 
 /**
@@ -344,15 +344,15 @@ ray3.getDirection = box3.getMax;
  * @param {vec3} p     - point to compare
  * @returns {vec3} out - receiving vec3
  */
-ray3.getClosestPointToPoint = function (out, a, p)
-{
+ray3.getClosestPointToPoint = function (out, a, p)
+{
     let x = p[0] - a[0],
         y = p[1] - a[1],
         z = p[2] - a[2];
 
-    const directionLengthSquared = a[3] * a[3] + a[4] * a[4] + a[5] * a[5];
-    let dirDist = directionLengthSquared === 0 ? 0 :
-        (x * a[3] + y * a[4] + z * a[5]) / directionLengthSquared;
+    const directionLengthSquared = a[3] * a[3] + a[4] * a[4] + a[5] * a[5];
+    let dirDist = directionLengthSquared === 0 ? 0 :
+        (x * a[3] + y * a[4] + z * a[5]) / directionLengthSquared;
 
     if (dirDist < 0)
     {
@@ -362,7 +362,7 @@ ray3.getClosestPointToPoint = function (out, a, p)
     }
     else
     {
-        getAtParameter(out, a, dirDist);
+        getAtParameter(out, a, dirDist);
     }
 
     return out;
@@ -431,7 +431,7 @@ ray3.getIntersectBounds = function (out, a, min, max)
     if (tzMax < tMax || tMax !== tMax) tMax = tzMax;
     if (tMax < 0) return null;
 
-    return getAtParameter(out, a, tMin >= 0 ? tMin : tMax);
+    return getAtParameter(out, a, tMin >= 0 ? tMin : tMax);
 };
 
 /**
@@ -559,7 +559,7 @@ ray3.getIntersectVertices = (function ()
         let QdN = -sign * vec3.dot(diff, n);
         if (QdN < 0) return null;
 
-        return getAtParameter(out, a, QdN / DdN);
+        return getAtParameter(out, a, QdN / DdN);
     };
 })();
 
@@ -627,33 +627,33 @@ ray3.getIntersectPositionRadius = (function ()
  * @param {sph3} s              - sphere
  * @returns {(null|vec3)} [out] - null or receiving vec3
  */
-ray3.getIntersectSph3 = function (out, a, s)
-{
-    if (s[3] < 0) return null;
-
-    const
-        x = a[0] - s[0],
-        y = a[1] - s[1],
-        z = a[2] - s[2],
-        directionLengthSquared = a[3] * a[3] + a[4] * a[4] + a[5] * a[5];
-
-    if (directionLengthSquared === 0) return null;
-
-    const
-        directionDotOffset = a[3] * x + a[4] * y + a[5] * z,
-        constant = x * x + y * y + z * z - s[3] * s[3],
-        discriminant = directionDotOffset * directionDotOffset - directionLengthSquared * constant;
-
-    if (discriminant < 0) return null;
-
-    const
-        root = Math.sqrt(discriminant),
-        t0 = (-directionDotOffset - root) / directionLengthSquared,
-        t1 = (-directionDotOffset + root) / directionLengthSquared;
+ray3.getIntersectSph3 = function (out, a, s)
+{
+    if (s[3] < 0) return null;
+
+    const
+        x = a[0] - s[0],
+        y = a[1] - s[1],
+        z = a[2] - s[2],
+        directionLengthSquared = a[3] * a[3] + a[4] * a[4] + a[5] * a[5];
+
+    if (directionLengthSquared === 0) return null;
+
+    const
+        directionDotOffset = a[3] * x + a[4] * y + a[5] * z,
+        constant = x * x + y * y + z * z - s[3] * s[3],
+        discriminant = directionDotOffset * directionDotOffset - directionLengthSquared * constant;
+
+    if (discriminant < 0) return null;
+
+    const
+        root = Math.sqrt(discriminant),
+        t0 = (-directionDotOffset - root) / directionLengthSquared,
+        t1 = (-directionDotOffset + root) / directionLengthSquared;
 
     if (t0 < 0 && t1 < 0) return null;
-    if (t0 < 0) return getAtParameter(out, a, t1);
-    return getAtParameter(out, a, t0);
+    if (t0 < 0) return getAtParameter(out, a, t1);
+    return getAtParameter(out, a, t0);
 };
 
 
@@ -679,7 +679,7 @@ ray3.intersectsBox3 = (function ()
     return function (a, b)
     {
         if (!vec3_0) vec3_0 = vec3.create();
-        return ray3.getIntersectBox3(vec3_0, a, b) !== null;
+        return ray3.getIntersectBox3(vec3_0, a, b) !== null;
     };
 })();
 
@@ -801,12 +801,12 @@ ray3.normalize = function (out, a)
         out[4] = y * len;
         out[5] = z * len;
     }
-    else
-    {
-        out[3] = 0;
-        out[4] = 0;
-        out[5] = 0;
-        throw new Error("Normalization error");
+    else
+    {
+        out[3] = 0;
+        out[4] = 0;
+        out[5] = 0;
+        throw new Error("Normalization error");
     }
 
     return out;
@@ -820,13 +820,13 @@ ray3.normalize = function (out, a)
  * @param {number} t - distance along the ray3
  * @returns {ray3}    - receiving ray3
  */
-ray3.recast = function (out, a, t)
-{
-    const length = Math.hypot(a[3], a[4], a[5]);
-    const scale = length === 0 ? 0 : t / length;
-    out[0] = a[0] + (a[3] * scale);
-    out[1] = a[1] + (a[4] * scale);
-    out[2] = a[2] + (a[5] * scale);
+ray3.recast = function (out, a, t)
+{
+    const length = Math.hypot(a[3], a[4], a[5]);
+    const scale = length === 0 ? 0 : t / length;
+    out[0] = a[0] + (a[3] * scale);
+    out[1] = a[1] + (a[4] * scale);
+    out[2] = a[2] + (a[5] * scale);
     out[3] = a[3];
     out[4] = a[4];
     out[5] = a[5];
@@ -841,11 +841,11 @@ ray3.recast = function (out, a, t)
  * @param {vec3} endProp
  * @returns {ray3} out
  */
-ray3.set = function (out, originX, originY, originZ, directionX, directionY, directionZ)
-{
-    box3.set(out, originX, originY, originZ, directionX, directionY, directionZ);
-    return directionX || directionY || directionZ ? ray3.normalize(out, out) : out;
-};
+ray3.set = function (out, originX, originY, originZ, directionX, directionY, directionZ)
+{
+    box3.set(out, originX, originY, originZ, directionX, directionY, directionZ);
+    return directionX || directionY || directionZ ? ray3.normalize(out, out) : out;
+};
 
 /**
  * Ray3 generic sorting
@@ -884,16 +884,16 @@ ray3.squaredDistance = (function ()
         vec3_0[1] = p[1] - a[1];
         vec3_0[2] = p[2] - a[2];
 
-        const directionLengthSquared = a[3] * a[3] + a[4] * a[4] + a[5] * a[5];
-        let dirDist = directionLengthSquared === 0 ? 0 :
-            (vec3_0[0] * a[3] + vec3_0[1] * a[4] + vec3_0[2] * a[5]) / directionLengthSquared;
+        const directionLengthSquared = a[3] * a[3] + a[4] * a[4] + a[5] * a[5];
+        let dirDist = directionLengthSquared === 0 ? 0 :
+            (vec3_0[0] * a[3] + vec3_0[1] * a[4] + vec3_0[2] * a[5]) / directionLengthSquared;
         if (dirDist < 0)
         {
             ray3.getOrigin(vec3_1, a);
             return vec3.squaredDistance(vec3_1, p); // could just pass in the ray3
         }
 
-        getAtParameter(vec3_0, a, dirDist);
+        getAtParameter(vec3_0, a, dirDist);
         return vec3.squaredDistance(vec3_0, p);
     };
 })();
@@ -966,16 +966,16 @@ ray3.transformMat4 = function (out, a, m)
  * @param {vec3} v
  * @returns {ray3} out
  */
-ray3.translate = function (out, a, v)
-{
-    out[0] = a[0] + v[0];
-    out[1] = a[1] + v[1];
-    out[2] = a[2] + v[2];
-    out[3] = a[3];
-    out[4] = a[4];
-    out[5] = a[5];
-    return out;
-};
+ray3.translate = function (out, a, v)
+{
+    out[0] = a[0] + v[0];
+    out[1] = a[1] + v[1];
+    out[2] = a[2] + v[2];
+    out[3] = a[3];
+    out[4] = a[4];
+    out[5] = a[5];
+    return out;
+};
 
 let viewPort;
 
@@ -989,8 +989,8 @@ let viewPort;
  * @param {vec2} [css]
  * @returns {ray3}
  */
-ray3.fromEvent = function (ray, viewProjectionInverse, event, mouse, pixel, css)
-{
+ray3.fromEvent = function (ray, viewProjectionInverse, event, mouse, pixel, css)
+{
     if (!viewPort) viewPort = pln.create();
 
     const
@@ -999,9 +999,9 @@ ray3.fromEvent = function (ray, viewProjectionInverse, event, mouse, pixel, css)
         mX = event.clientX,
         mY = event.clientY,
         cX = mX - rect.left,
-        cY = mY - rect.top,
-        pX = cX * el.width / el.clientWidth,
-        pY = el.height - cY * el.height / el.clientHeight - 1;
+        cY = mY - rect.top,
+        pX = cX * el.width / el.clientWidth,
+        pY = el.height - cY * el.height / el.clientHeight - 1;
 
     // Should this be a param?
     viewPort[0] = 0;
@@ -1026,60 +1026,60 @@ ray3.fromEvent = function (ray, viewProjectionInverse, event, mouse, pixel, css)
         css[0] = cX;
         css[1] = cY;
     }
-
-    return ray3.unproject(ray, [ pX, pY ], viewProjectionInverse, viewPort);
-};
-
-export const {
-    alloc,
-    unalloc,
-    $origin,
-    $direction,
-    clone,
-    copy,
-    copyOrigin,
-    copyDirection,
-    create,
-    distance,
-    distanceNormalConstant,
-    distancePln,
-    equals,
-    equalsOriginDestination,
-    exactEquals,
-    exactEqualsOriginDestination,
-    from,
-    fromArray,
-    fromStartEnd,
-    fromMat4,
-    fromPerspective,
-    unproject,
-    get,
-    getDirection,
-    getClosestPointToPoint,
-    getIntersectBounds,
-    getIntersectBox3,
-    getIntersectTri3,
-    getIntersectVertices,
-    getIntersectNormalConstant,
-    getIntersectPln,
-    getIntersectPositionRadius,
-    getIntersectSph3,
-    getOrigin,
-    intersectsBox3,
-    intersectsBounds,
-    intersectsNormalConstant,
-    intersectsPln,
-    intersectsPositionRadius,
-    intersectsSph3,
-    lookAt,
-    normalize,
-    recast,
-    set,
-    SORT,
-    squaredDistance,
-    toArray,
-    toOriginDirection,
-    transformMat4,
-    translate,
-    fromEvent
-} = ray3;
+
+    return ray3.unproject(ray, [ pX, pY ], viewProjectionInverse, viewPort);
+};
+
+export const {
+    alloc,
+    unalloc,
+    $origin,
+    $direction,
+    clone,
+    copy,
+    copyOrigin,
+    copyDirection,
+    create,
+    distance,
+    distanceNormalConstant,
+    distancePln,
+    equals,
+    equalsOriginDestination,
+    exactEquals,
+    exactEqualsOriginDestination,
+    from,
+    fromArray,
+    fromStartEnd,
+    fromMat4,
+    fromPerspective,
+    unproject,
+    get,
+    getDirection,
+    getClosestPointToPoint,
+    getIntersectBounds,
+    getIntersectBox3,
+    getIntersectTri3,
+    getIntersectVertices,
+    getIntersectNormalConstant,
+    getIntersectPln,
+    getIntersectPositionRadius,
+    getIntersectSph3,
+    getOrigin,
+    intersectsBox3,
+    intersectsBounds,
+    intersectsNormalConstant,
+    intersectsPln,
+    intersectsPositionRadius,
+    intersectsSph3,
+    lookAt,
+    normalize,
+    recast,
+    set,
+    SORT,
+    squaredDistance,
+    toArray,
+    toOriginDirection,
+    transformMat4,
+    translate,
+    fromEvent
+} = ray3;