@carbonenginejs/runtime-utils 0.1.1 → 0.1.3

package/src/geometry/cylinder.js

@@ -17,18 +17,18 @@ export function createCylinder(options = {})
         openEnded = false,
         thetaStart = 0,
         thetaLength = Math.PI * 2
-    } = options;
-
-    if (![ radiusTop, radiusBottom, height, thetaStart, thetaLength ].every(Number.isFinite) ||
-        height === 0 ||
-        thetaLength === 0 ||
-        (radiusTop === 0 && radiusBottom === 0))
-    {
-        throw new Error("Invalid cylinder dimensions");
-    }
-
-    radialSegments = Math.max(3, Math.floor(Number.isFinite(radialSegments) ? radialSegments : 32));
-    heightSegments = Math.max(1, Math.floor(Number.isFinite(heightSegments) ? heightSegments : 1));
+    } = options;
+
+    if (![ radiusTop, radiusBottom, height, thetaStart, thetaLength ].every(Number.isFinite) ||
+        height === 0 ||
+        thetaLength === 0 ||
+        (radiusTop === 0 && radiusBottom === 0))
+    {
+        throw new Error("Invalid cylinder dimensions");
+    }
+
+    radialSegments = Math.max(3, Math.floor(Number.isFinite(radialSegments) ? radialSegments : 32));
+    heightSegments = Math.max(1, Math.floor(Number.isFinite(heightSegments) ? heightSegments : 1));
 
     // buffers
     const
@@ -102,20 +102,20 @@ export function createCylinder(options = {})
         // generate indices
         for (let x = 0; x < radialSegments; x++)
         {
-            for (let y = 0; y < heightSegments; y++)
-            {
+            for (let y = 0; y < heightSegments; y++)
+            {
                 // we use the index array to access the correct indices
                 const
                     a = indexArray[y][x],
                     b = indexArray[y + 1][x],
-                    c = indexArray[y + 1][x + 1],
-                    d = indexArray[y][x + 1],
-                    upperRadius = (y / heightSegments) * (radiusBottom - radiusTop) + radiusTop,
-                    lowerRadius = ((y + 1) / heightSegments) * (radiusBottom - radiusTop) + radiusTop;
-
-                // faces
-                if (upperRadius !== 0) indices.push(a, b, d);
-                if (lowerRadius !== 0) indices.push(b, c, d);
+                    c = indexArray[y + 1][x + 1],
+                    d = indexArray[y][x + 1],
+                    upperRadius = (y / heightSegments) * (radiusBottom - radiusTop) + radiusTop,
+                    lowerRadius = ((y + 1) / heightSegments) * (radiusBottom - radiusTop) + radiusTop;
+
+                // faces
+                if (upperRadius !== 0) indices.push(a, b, d);
+                if (lowerRadius !== 0) indices.push(b, c, d);
             }
         }
     }

package/src/geometry/helpers/earcut.js

@@ -312,7 +312,7 @@ function eliminateHoles(data, holeIndices, outerNode, dim)
 
     queue.sort(compareX);
 
-    // handle holes from left to right
+    // handle holes from left to right
     for (i = 0; i < queue.length; i++)
     {
         outerNode = eliminateHole(queue[i], outerNode);

package/src/geometry/helpers/misc.js

@@ -1,5 +1,5 @@
-import { num } from "../../num.js";
-import { triangulate } from "./earcut.js";
+import { num } from "../../num.js";
+import { triangulate } from "./earcut.js";
 
 
 // Ported from ThreeJS
@@ -15,7 +15,7 @@ export function getShapeArea(points)
     let a = 0.0;
     for (let p = n - 1, q = 0; q < n; p = q++)
     {
-        a += points[p][0] * points[q][1] - points[q][0] * points[p][1];
+        a += points[p][0] * points[q][1] - points[q][0] * points[p][1];
     }
     return a * 0.5;
 }

package/src/geometry/index.js

@@ -1,8 +1,8 @@
-export * from "./box.js";
-export * from "./cylinder.js";
-export * from "./plane.js";
-export * from "./shape.js";
-export * from "./sphere.js";
-export * from "./torus.js";
-export * from "./json.js";
-export * from "./lathe.js";
+export * from "./box.js";
+export * from "./cylinder.js";
+export * from "./plane.js";
+export * from "./shape.js";
+export * from "./sphere.js";
+export * from "./torus.js";
+export * from "./json.js";
+export * from "./lathe.js";

package/src/geometry/json.js

@@ -21,63 +21,63 @@ function isAreaLike(value)
  * @throw If required data is not provided
  * @returns {Object}
  */
-export function toJSON(indices, positions, uvs, normals, areas, tangents)
-{
+export function toJSON(indices, positions, uvs, normals, areas, tangents)
+{
     if (!indices || !positions || !uvs || !indices.length || !positions.length || !uvs.length)
     {
         throw new Error("Invalid inputs");
     }
 
-    if (isAreaLike(normals))
+    if (isAreaLike(normals))
     {
         const temp = areas;
         areas = normals;
-        normals = temp;
-    }
-
-    const vertexCount = positions.length / 3;
-    if (!Number.isInteger(vertexCount) ||
-        indices.length % 3 !== 0 ||
-        uvs.length !== vertexCount * 2)
-    {
-        throw new Error("Invalid geometry channel lengths");
-    }
-
-    for (let i = 0; i < indices.length; i++)
-    {
-        if (!Number.isInteger(indices[i]) || indices[i] < 0 || indices[i] >= vertexCount)
-        {
-            throw new Error(`Invalid vertex index at ${i}`);
-        }
-    }
-
-    if (normals && normals.length && normals.length !== positions.length)
-    {
-        throw new Error("Invalid normal channel length");
-    }
-
-    if (tangents && tangents.length &&
-        tangents.length !== vertexCount * 3 &&
-        tangents.length !== vertexCount * 4)
-    {
-        throw new Error("Invalid tangent channel length");
-    }
-
-    areas = toArray(areas && areas.length !== 0 ? areas : { start: 0, count: indices.length });
-    for (const area of areas)
-    {
-        if (!area ||
-            !Number.isInteger(area.start) ||
-            !Number.isInteger(area.count) ||
-            area.start < 0 ||
-            area.count < 0 ||
-            area.start % 3 !== 0 ||
-            area.count % 3 !== 0 ||
-            area.start + area.count > indices.length)
-        {
-            throw new Error("Invalid geometry area");
-        }
-    }
+        normals = temp;
+    }
+
+    const vertexCount = positions.length / 3;
+    if (!Number.isInteger(vertexCount) ||
+        indices.length % 3 !== 0 ||
+        uvs.length !== vertexCount * 2)
+    {
+        throw new Error("Invalid geometry channel lengths");
+    }
+
+    for (let i = 0; i < indices.length; i++)
+    {
+        if (!Number.isInteger(indices[i]) || indices[i] < 0 || indices[i] >= vertexCount)
+        {
+            throw new Error(`Invalid vertex index at ${i}`);
+        }
+    }
+
+    if (normals && normals.length && normals.length !== positions.length)
+    {
+        throw new Error("Invalid normal channel length");
+    }
+
+    if (tangents && tangents.length &&
+        tangents.length !== vertexCount * 3 &&
+        tangents.length !== vertexCount * 4)
+    {
+        throw new Error("Invalid tangent channel length");
+    }
+
+    areas = toArray(areas && areas.length !== 0 ? areas : { start: 0, count: indices.length });
+    for (const area of areas)
+    {
+        if (!area ||
+            !Number.isInteger(area.start) ||
+            !Number.isInteger(area.count) ||
+            area.start < 0 ||
+            area.count < 0 ||
+            area.start % 3 !== 0 ||
+            area.count % 3 !== 0 ||
+            area.start + area.count > indices.length)
+        {
+            throw new Error("Invalid geometry area");
+        }
+    }
 
     if (!normals || !normals.length)
     {
@@ -101,24 +101,24 @@ export function toJSON(indices, positions, uvs, normals, areas, tangents)
                 binormal: null,
                 blendIndice: null,
                 blendWeight: null
-            },
-            indices: areas.map(area =>
-            {
-                const faces = indices.slice(area.start, area.start + area.count);
-                const requires32Bit = faces.some(index => index > 0xffff);
-                const bytesPerIndex = area.bytesPerIndex ?? (requires32Bit ? 4 : 2);
-                if ((bytesPerIndex !== 2 && bytesPerIndex !== 4) ||
-                    (bytesPerIndex === 2 && requires32Bit))
-                {
-                    throw new Error("Invalid bytes per index");
-                }
-                return {
-                    bytesPerIndex,
-                    start: area.start,
-                    count: area.count,
-                    faces
-                };
-            })
+            },
+            indices: areas.map(area =>
+            {
+                const faces = indices.slice(area.start, area.start + area.count);
+                const requires32Bit = faces.some(index => index > 0xffff);
+                const bytesPerIndex = area.bytesPerIndex ?? (requires32Bit ? 4 : 2);
+                if ((bytesPerIndex !== 2 && bytesPerIndex !== 4) ||
+                    (bytesPerIndex === 2 && requires32Bit))
+                {
+                    throw new Error("Invalid bytes per index");
+                }
+                return {
+                    bytesPerIndex,
+                    start: area.start,
+                    count: area.count,
+                    faces
+                };
+            })
         } ]
     };
 }

package/src/geometry/lathe.js

@@ -1,13 +1,13 @@
-import { num } from "../num.js";
-import { vec2 } from "../vec2.js";
-import { vec3 } from "../vec3.js";
+import { num } from "../num.js";
+import { vec2 } from "../vec2.js";
+import { vec3 } from "../vec3.js";
 import { toJSON } from "./json.js";
 
 /**
  * Creates a lathe
  * @author Three.js converted
  **/
-export function createLathe(options = {})
+export function createLathe(options = {})
 {
     let {
         points = [
@@ -20,31 +20,31 @@ export function createLathe(options = {})
         phiLength = Math.PI * 2
     } = options;
 
-    segments = Math.max(3, Math.floor(Number.isFinite(segments) ? segments : 12));
-    if (!Array.isArray(points) || points.length < 2)
-    {
-        throw new Error("Lathe requires at least two profile points");
-    }
-    if (!Number.isFinite(phiStart) || !Number.isFinite(phiLength) || phiLength <= 0)
-    {
-        throw new Error("Invalid lathe sweep");
-    }
-    let hasRadius = false;
-    for (let i = 0; i < points.length; i++)
-    {
-        const point = points[i];
-        if (!point || point.length < 2 || !Number.isFinite(point[0]) || !Number.isFinite(point[1]))
-        {
-            throw new Error("Invalid lathe profile point");
-        }
-        hasRadius ||= point[0] !== 0;
-        if (i > 0 && point[0] === points[i - 1][0] && point[1] === points[i - 1][1])
-        {
-            throw new Error("Lathe profile contains a zero-length segment");
-        }
-    }
-    if (!hasRadius) throw new Error("Lathe profile must leave the rotation axis");
-
+    segments = Math.max(3, Math.floor(Number.isFinite(segments) ? segments : 12));
+    if (!Array.isArray(points) || points.length < 2)
+    {
+        throw new Error("Lathe requires at least two profile points");
+    }
+    if (!Number.isFinite(phiStart) || !Number.isFinite(phiLength) || phiLength <= 0)
+    {
+        throw new Error("Invalid lathe sweep");
+    }
+    let hasRadius = false;
+    for (let i = 0; i < points.length; i++)
+    {
+        const point = points[i];
+        if (!point || point.length < 2 || !Number.isFinite(point[0]) || !Number.isFinite(point[1]))
+        {
+            throw new Error("Invalid lathe profile point");
+        }
+        hasRadius ||= point[0] !== 0;
+        if (i > 0 && point[0] === points[i - 1][0] && point[1] === points[i - 1][1])
+        {
+            throw new Error("Lathe profile contains a zero-length segment");
+        }
+    }
+    if (!hasRadius) throw new Error("Lathe profile must leave the rotation axis");
+
     // clamp phiLength so it's in range of [ 0, 2PI ]
     phiLength = num.clamp(phiLength, 0, Math.PI * 2);
 
@@ -56,12 +56,12 @@ export function createLathe(options = {})
         initNormals = [],
         normals = [];
 
-    // helper variables
-    const
-        inverseSegments = 1.0 / segments,
-        normal = vec3.alloc(),
-        curNormal = vec3.alloc(),
-        prevNormal = vec3.alloc();
+    // helper variables
+    const
+        inverseSegments = 1.0 / segments,
+        normal = vec3.alloc(),
+        curNormal = vec3.alloc(),
+        prevNormal = vec3.alloc();
 
     let dx = 0,
         dy = 0;
@@ -84,10 +84,10 @@ export function createLathe(options = {})
                 initNormals.push(normal[0], normal[1], normal[2]);
                 break;
 
-            case (points.length - 1):	// special handling for last Vertex on path
-                vec3.normalize(prevNormal, prevNormal);
-                initNormals.push(prevNormal[0], prevNormal[1], prevNormal[2]);
-                break;
+            case (points.length - 1):	// special handling for last Vertex on path
+                vec3.normalize(prevNormal, prevNormal);
+                initNormals.push(prevNormal[0], prevNormal[1], prevNormal[2]);
+                break;
 
             default:			// default handling for all positions in between
                 dx = points[j + 1][0] - points[j][0];
@@ -138,9 +138,9 @@ export function createLathe(options = {})
         }
     }
 
-    vec3.unalloc(normal);
-    vec3.unalloc(curNormal);
-    vec3.unalloc(prevNormal);
+    vec3.unalloc(normal);
+    vec3.unalloc(curNormal);
+    vec3.unalloc(prevNormal);
 
     // indices
     for (let i = 0; i < segments; i++)
@@ -155,8 +155,8 @@ export function createLathe(options = {})
                 d = base + 1;
 
             // faces
-            if (points[j][0] !== 0) indices.push(a, b, d);
-            if (points[j + 1][0] !== 0) indices.push(c, d, b);
+            if (points[j][0] !== 0) indices.push(a, b, d);
+            if (points[j + 1][0] !== 0) indices.push(c, d, b);
         }
     }
 

package/src/geometry/plane.js

@@ -17,13 +17,13 @@ export function createPlane(options = {})
         height = 1,
         widthSegments = 1,
         heightSegments = 1
-    } = options;
-
-    if (!Number.isFinite(width) || !Number.isFinite(height) || width === 0 || height === 0)
-    {
-        throw new Error("Plane dimensions must be finite and non-zero");
-    }
-
+    } = options;
+
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width === 0 || height === 0)
+    {
+        throw new Error("Plane dimensions must be finite and non-zero");
+    }
+
     const
         indices = [],
         positions = [],
@@ -33,8 +33,8 @@ export function createPlane(options = {})
     const
         widthHalf = width / 2,
         heightHalf = height / 2,
-        gridX = Math.max(1, Math.floor(Number.isFinite(widthSegments) ? widthSegments : 1)),
-        gridY = Math.max(1, Math.floor(Number.isFinite(heightSegments) ? heightSegments : 1)),
+        gridX = Math.max(1, Math.floor(Number.isFinite(widthSegments) ? widthSegments : 1)),
+        gridY = Math.max(1, Math.floor(Number.isFinite(heightSegments) ? heightSegments : 1)),
         gridX1 = gridX + 1,
         gridY1 = gridY + 1,
         segmentWidth = width / gridX,
@@ -71,11 +71,11 @@ export function createPlane(options = {})
     // Normalize
     const result = toJSON(indices, positions, uvs, normals);
     result.factory = createPlane;
-    result.options = {
-        width,
-        height,
-        widthSegments: gridX,
-        heightSegments: gridY
+    result.options = {
+        width,
+        height,
+        widthSegments: gridX,
+        heightSegments: gridY
     };
     return result;
 }

package/src/geometry/shape.js

@@ -33,10 +33,10 @@ export function createShape(shapes)
         areas.push({ start, count, index });
     }
 
-    function addShape(shape)
-    {
-        let shapeVertices = shape.positions.map(point => Array.from(point)),
-            shapeHoles = (shape.holes || []).map(hole => hole.map(point => Array.from(point)));
+    function addShape(shape)
+    {
+        let shapeVertices = shape.positions.map(point => Array.from(point)),
+            shapeHoles = (shape.holes || []).map(hole => hole.map(point => Array.from(point)));
 
         const indexOffset = positions.length / 3;
 

package/src/geometry/sphere.js

@@ -18,16 +18,16 @@ export function createSphere(options = {})
         phiLength = Math.PI * 2,
         thetaStart = 0,
         thetaLength = Math.PI
-    } = options;
-
-    if (![ radius, widthSegments, heightSegments, phiStart, phiLength, thetaStart, thetaLength ].every(Number.isFinite) ||
-        radius <= 0 ||
-        phiLength <= 0 ||
-        thetaLength <= 0)
-    {
-        throw new Error("Invalid sphere dimensions");
-    }
-
+    } = options;
+
+    if (![ radius, widthSegments, heightSegments, phiStart, phiLength, thetaStart, thetaLength ].every(Number.isFinite) ||
+        radius <= 0 ||
+        phiLength <= 0 ||
+        thetaLength <= 0)
+    {
+        throw new Error("Invalid sphere dimensions");
+    }
+
     widthSegments = Math.max(3, Math.floor(widthSegments));
     heightSegments = Math.max(2, Math.floor(heightSegments));
 
@@ -107,17 +107,17 @@ export function createSphere(options = {})
     vec3.unalloc(normal);
 
     const result = toJSON(indices, vertices, uvs, normals);
-    result.factory = createSphere;
-    result.options = {
-        radius,
-        widthSegments,
-        heightSegments,
-        phiStart,
-        phiLength,
-        thetaStart,
-        thetaLength
-    };
-    result.shape = { factory: result.factory, options: result.options };
-
-    return result;
-}
+    result.factory = createSphere;
+    result.options = {
+        radius,
+        widthSegments,
+        heightSegments,
+        phiStart,
+        phiLength,
+        thetaStart,
+        thetaLength
+    };
+    result.shape = { factory: result.factory, options: result.options };
+
+    return result;
+}

package/src/geometry/torus.js

@@ -1,5 +1,5 @@
-import { toJSON } from "./json.js";
-import { vec3 } from "../vec3.js";
+import { toJSON } from "./json.js";
+import { vec3 } from "../vec3.js";
 
 
 export function createTorus(options = {})
@@ -10,18 +10,18 @@ export function createTorus(options = {})
         radialSegments = 12,
         tubularSegments = 49,
         arc = Math.PI * 2
-    } = options;
-
-    if (![ radius, tube, radialSegments, tubularSegments, arc ].every(Number.isFinite) ||
-        radius <= 0 ||
-        tube <= 0 ||
-        arc === 0)
-    {
-        throw new Error("Invalid torus dimensions");
-    }
-
-    radialSegments = Math.max(3, Math.floor(Number.isFinite(radialSegments) ? radialSegments : 12));
-    tubularSegments = Math.max(3, Math.floor(Number.isFinite(tubularSegments) ? tubularSegments : 49));
+    } = options;
+
+    if (![ radius, tube, radialSegments, tubularSegments, arc ].every(Number.isFinite) ||
+        radius <= 0 ||
+        tube <= 0 ||
+        arc === 0)
+    {
+        throw new Error("Invalid torus dimensions");
+    }
+
+    radialSegments = Math.max(3, Math.floor(Number.isFinite(radialSegments) ? radialSegments : 12));
+    tubularSegments = Math.max(3, Math.floor(Number.isFinite(tubularSegments) ? tubularSegments : 49));
 
     const
         indices = [],

package/src/graphics/colorSpaces.js

@@ -1,22 +1,22 @@
-/**
- * Canonical color space tokens for decoded image/texture payloads.
- */
-export const ColorSpace = Object.freeze({
-    UNKNOWN: "unknown",
-    LINEAR: "linear",
-    SRGB: "srgb",
-    DISPLAY_P3: "display-p3",
-    REC709: "rec709",
-    REC2020: "rec2020"
-});
-
-/**
- * Normalize a color space token.
- *
- * @param {string} colorSpace Color space token.
- * @returns {string} Canonical lowercase token or unknown.
- */
-export function normalizeColorSpace(colorSpace)
-{
-    return colorSpace ? String(colorSpace).trim().toLowerCase() : ColorSpace.UNKNOWN;
-}
+/**
+ * Canonical color space tokens for decoded image/texture payloads.
+ */
+export const ColorSpace = Object.freeze({
+    UNKNOWN: "unknown",
+    LINEAR: "linear",
+    SRGB: "srgb",
+    DISPLAY_P3: "display-p3",
+    REC709: "rec709",
+    REC2020: "rec2020"
+});
+
+/**
+ * Normalize a color space token.
+ *
+ * @param {string} colorSpace Color space token.
+ * @returns {string} Canonical lowercase token or unknown.
+ */
+export function normalizeColorSpace(colorSpace)
+{
+    return colorSpace ? String(colorSpace).trim().toLowerCase() : ColorSpace.UNKNOWN;
+}

package/src/graphics/index.js

@@ -1,4 +1,4 @@
-export * from "./pixelFormats.js";
-export * from "./colorSpaces.js";
-export * from "./textureDimensions.js";
-export * from "./trinityEnums.js";
+export * from "./pixelFormats.js";
+export * from "./colorSpaces.js";
+export * from "./textureDimensions.js";
+export * from "./trinityEnums.js";