@meimu/mutracer 0.0.0-stage → 0.1.1

package/lib/util/commonGeometry.js

@@ -0,0 +1,240 @@
+import { vec3 } from '../math.js';
+import Geometry, { Attribute } from '../scene/Geometry.js';
+import { generateVertexNormals, updateBoundingBox } from './geometry.js';
+/** Unit sphere (radius 1) centered at the origin, with normals and UVs. */
+export function createSphereGeometry(phiSegments = 40, thetaSegments = 20, phiStart = 0, phiLength = Math.PI * 2, thetaStart = 0, thetaLength = Math.PI) {
+    const positions = [];
+    const uvs = [];
+    const normals = [];
+    const faces = [];
+    const radius = 1;
+    const divider = 1 / radius;
+    for (let j = 0; j <= thetaSegments; j++) {
+        for (let i = 0; i <= phiSegments; i++) {
+            const u = i / phiSegments;
+            const v = j / thetaSegments;
+            // X axis is inverted so texture can be mapped from left to right
+            const x = -radius *
+                Math.cos(phiStart + u * phiLength) *
+                Math.sin(thetaStart + v * thetaLength);
+            const y = radius * Math.cos(thetaStart + v * thetaLength);
+            const z = radius *
+                Math.sin(phiStart + u * phiLength) *
+                Math.sin(thetaStart + v * thetaLength);
+            positions.push(x, y, z);
+            uvs.push(u, v);
+            normals.push(x * divider, y * divider, z * divider);
+        }
+    }
+    let i1, i2, i3, i4;
+    const len = phiSegments + 1;
+    let n = 0;
+    for (let j = 0; j < thetaSegments; j++) {
+        for (let i = 0; i < phiSegments; i++) {
+            i2 = j * len + i;
+            i1 = j * len + i + 1;
+            i4 = (j + 1) * len + i + 1;
+            i3 = (j + 1) * len + i;
+            faces[n++] = i1;
+            faces[n++] = i2;
+            faces[n++] = i4;
+            faces[n++] = i2;
+            faces[n++] = i3;
+            faces[n++] = i4;
+        }
+    }
+    const geo = new Geometry({
+        uv: new Attribute(new Float32Array(uvs), 2),
+        position: new Attribute(new Float32Array(positions), 3),
+        normal: new Attribute(new Float32Array(normals), 3),
+        indices: new Attribute(new Uint32Array(faces), 1)
+    });
+    vec3.set(geo.boundingBox.min, -1, -1, -1);
+    vec3.set(geo.boundingBox.max, 1, 1, 1);
+    return geo;
+}
+/**
+ * 2x2 plane centered at the origin. `horizontal` lies in XZ facing +Y,
+ * `vertical` lies in XY facing +Z.
+ */
+export function createPlaneGeometry(widthSegments = 1, heightSegments = 1, orient = 'horizontal') {
+    const positions = [];
+    const uvs = [];
+    const normals = [];
+    const faces = [];
+    const isVertical = orient === 'vertical';
+    for (let y = 0; y <= heightSegments; y++) {
+        const t = y / heightSegments;
+        for (let x = 0; x <= widthSegments; x++) {
+            const s = x / widthSegments;
+            if (isVertical) {
+                positions.push(2 * s - 1, 2 * t - 1, 0);
+                if (normals) {
+                    normals.push(0, 0, 1);
+                }
+            }
+            else {
+                positions.push(2 * t - 1, 0, 2 * s - 1);
+                if (normals) {
+                    normals.push(0, 1, 0);
+                }
+            }
+            if (uvs) {
+                uvs.push(s, t);
+            }
+            if (x < widthSegments && y < heightSegments) {
+                const i = x + y * (widthSegments + 1);
+                faces.push(i, i + 1, i + widthSegments + 1);
+                faces.push(i + widthSegments + 1, i + 1, i + widthSegments + 2);
+            }
+        }
+    }
+    const geo = new Geometry({
+        uv: new Attribute(new Float32Array(uvs), 2),
+        position: new Attribute(new Float32Array(positions), 3),
+        normal: new Attribute(new Float32Array(normals), 3),
+        indices: new Attribute(new Uint32Array(faces), 1)
+    });
+    if (isVertical) {
+        vec3.set(geo.boundingBox.min, -1, -1, 0);
+        vec3.set(geo.boundingBox.max, 1, 1, 0);
+    }
+    else {
+        vec3.set(geo.boundingBox.min, -1, 0, -1);
+        vec3.set(geo.boundingBox.max, 1, 0, 1);
+    }
+    return geo;
+}
+/** 2x2x2 cube centered at the origin. */
+export function createCubeGeometry(widthSegments = 1, heightSegments = 1, depthSegments = 1) {
+    const faces = [];
+    const positions = [];
+    const normals = [];
+    const uvs = [];
+    // helper variables
+    let offset = 0;
+    const w = 1;
+    const h = 1;
+    const d = 1;
+    // build each side of the box geometry
+    buildPlane(2, 1, 0, -1, -1, d, h, w, depthSegments, heightSegments); // px
+    buildPlane(2, 1, 0, 1, -1, d, h, -w, depthSegments, heightSegments); // nx
+    buildPlane(0, 2, 1, 1, 1, w, d, h, widthSegments, depthSegments); // py
+    buildPlane(0, 2, 1, 1, -1, w, d, -h, widthSegments, depthSegments); // ny
+    buildPlane(0, 1, 2, 1, -1, w, h, d, widthSegments, heightSegments); // pz
+    buildPlane(0, 1, 2, -1, -1, w, h, -d, widthSegments, heightSegments); // nz
+    // build geometry
+    function buildPlane(u, v, w, udir, vdir, width, height, depth, gridX, gridY) {
+        const segmentWidth = width / gridX;
+        const segmentHeight = height / gridY;
+        const widthHalf = width / 2;
+        const heightHalf = height / 2;
+        const depthHalf = depth / 2;
+        const gridX1 = gridX + 1;
+        const gridY1 = gridY + 1;
+        let vertexCounter = 0;
+        const vector = vec3.create();
+        // generate positions, normals and uvs
+        for (let iy = 0; iy < gridY1; iy++) {
+            const y = iy * segmentHeight - heightHalf;
+            for (let ix = 0; ix < gridX1; ix++) {
+                const x = ix * segmentWidth - widthHalf;
+                vector[u] = x * udir;
+                vector[v] = y * vdir;
+                vector[w] = depthHalf;
+                positions.push(vector[0], vector[1], vector[2]);
+                vector[u] = 0;
+                vector[v] = 0;
+                vector[w] = depth > 0 ? 1 : -1;
+                normals.push(vector[0], vector[1], vector[2]);
+                uvs.push(ix / gridX);
+                uvs.push(1 - iy / gridY);
+                vertexCounter += 1;
+            }
+        }
+        // indices
+        // 1. you need three indices to draw a single face
+        // 2. a single segment consists of two faces
+        // 3. so we need to generate six (2*3) indices per segment
+        for (let iy = 0; iy < gridY; iy++) {
+            for (let ix = 0; ix < gridX; ix++) {
+                const a = offset + ix + gridX1 * iy;
+                const b = offset + ix + gridX1 * (iy + 1);
+                const c = offset + (ix + 1) + gridX1 * (iy + 1);
+                const d = offset + (ix + 1) + gridX1 * iy;
+                // faces
+                faces.push(a, b, d);
+                faces.push(b, c, d);
+            }
+        }
+        offset += vertexCounter;
+    }
+    const geo = new Geometry({
+        uv: new Attribute(new Float32Array(uvs), 2),
+        position: new Attribute(new Float32Array(positions), 3),
+        normal: new Attribute(new Float32Array(normals), 3),
+        indices: new Attribute(new Uint32Array(faces), 1)
+    });
+    vec3.set(geo.boundingBox.min, -1, -1, -1);
+    vec3.set(geo.boundingBox.max, 1, 1, 1);
+    return geo;
+}
+/**
+ * Studio backdrop ("infinity cove"): a floor that curves up into a back wall.
+ * `curveSize` is the fraction of the profile taken by the bend.
+ */
+export function createCurvePlaneGeometry(curveSize = 0.2) {
+    const faces = [];
+    const positions = [];
+    // Set width segments to 1 may have weired bands in ray tracing.
+    const widthSegments = 5;
+    const heightSegments = 200;
+    const texcoords = [];
+    const curveRadius = (curveSize / Math.PI) * 2;
+    const planeSize = (1 - curveSize) / 2;
+    let mm = 0;
+    for (let m = 0; m <= heightSegments; m++) {
+        // TODO t is stretched
+        let y, z;
+        let t = m / heightSegments;
+        // Skip the plane part to reduce the number of vertices.
+        if ((t > 0 && t <= planeSize - 1 / heightSegments) ||
+            (t >= planeSize + curveSize + 1 / heightSegments && t < 1)) {
+            continue;
+        }
+        if (t <= planeSize) {
+            y = 0;
+            z = curveRadius + planeSize - t;
+        }
+        else if (t >= planeSize + curveSize) {
+            y = t - planeSize - curveSize + curveRadius;
+            z = 0;
+        }
+        else {
+            const rad = (((t - planeSize) / curveSize) * Math.PI) / 2;
+            y = (1 - Math.cos(rad)) * curveRadius;
+            z = (1 - Math.sin(rad)) * curveRadius;
+        }
+        for (let n = 0; n <= widthSegments; n++) {
+            const s = n / widthSegments;
+            const x = 2 * s - 1;
+            positions.push([x, y * 2, z * 2]);
+            texcoords.push([s, t]);
+            if (n < widthSegments && m < heightSegments) {
+                const i = n + mm * (widthSegments + 1);
+                faces.push([i, i + 1, i + widthSegments + 1]);
+                faces.push([i + widthSegments + 1, i + 1, i + widthSegments + 2]);
+            }
+        }
+        mm++;
+    }
+    const geo = new Geometry({
+        uv: new Attribute(new Float32Array(texcoords.flat()), 2),
+        position: new Attribute(new Float32Array(positions.flat()), 3),
+        indices: new Attribute(new Uint32Array(faces.flat()), 1)
+    });
+    updateBoundingBox(geo);
+    generateVertexNormals(geo);
+    return geo;
+}
+//# sourceMappingURL=commonGeometry.js.map

package/lib/util/commonGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonGeometry.js","sourceRoot":"","sources":["../../src/util/commonGeometry.ts"],"names":[],"mappings":"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","sourcesContent":["import { vec3 } from '../math.js';\nimport Geometry, { Attribute } from '../scene/Geometry.js';\nimport { generateVertexNormals, updateBoundingBox } from './geometry.js';\n\n/** Unit sphere (radius 1) centered at the origin, with normals and UVs. */\nexport function createSphereGeometry(\n  phiSegments: number = 40,\n  thetaSegments: number = 20,\n\n  phiStart = 0,\n  phiLength = Math.PI * 2,\n  thetaStart = 0,\n  thetaLength = Math.PI\n) {\n  const positions: number[] = [];\n  const uvs: number[] = [];\n  const normals: number[] = [];\n  const faces: number[] = [];\n\n  const radius = 1;\n  const divider = 1 / radius;\n  for (let j = 0; j <= thetaSegments; j++) {\n    for (let i = 0; i <= phiSegments; i++) {\n      const u = i / phiSegments;\n      const v = j / thetaSegments;\n\n      // X axis is inverted so texture can be mapped from left to right\n      const x =\n        -radius *\n        Math.cos(phiStart + u * phiLength) *\n        Math.sin(thetaStart + v * thetaLength);\n      const y = radius * Math.cos(thetaStart + v * thetaLength);\n      const z =\n        radius *\n        Math.sin(phiStart + u * phiLength) *\n        Math.sin(thetaStart + v * thetaLength);\n\n      positions.push(x, y, z);\n      uvs.push(u, v);\n      normals.push(x * divider, y * divider, z * divider);\n    }\n  }\n\n  let i1, i2, i3, i4;\n\n  const len = phiSegments + 1;\n\n  let n = 0;\n  for (let j = 0; j < thetaSegments; j++) {\n    for (let i = 0; i < phiSegments; i++) {\n      i2 = j * len + i;\n      i1 = j * len + i + 1;\n      i4 = (j + 1) * len + i + 1;\n      i3 = (j + 1) * len + i;\n\n      faces[n++] = i1;\n      faces[n++] = i2;\n      faces[n++] = i4;\n\n      faces[n++] = i2;\n      faces[n++] = i3;\n      faces[n++] = i4;\n    }\n  }\n  const geo = new Geometry({\n    uv: new Attribute(new Float32Array(uvs), 2),\n    position: new Attribute(new Float32Array(positions), 3),\n    normal: new Attribute(new Float32Array(normals), 3),\n    indices: new Attribute(new Uint32Array(faces), 1)\n  });\n  vec3.set(geo.boundingBox.min, -1, -1, -1);\n  vec3.set(geo.boundingBox.max, 1, 1, 1);\n  return geo;\n}\n\n/**\n * 2x2 plane centered at the origin. `horizontal` lies in XZ facing +Y,\n * `vertical` lies in XY facing +Z.\n */\nexport function createPlaneGeometry(\n  widthSegments = 1,\n  heightSegments = 1,\n  orient: 'horizontal' | 'vertical' = 'horizontal'\n) {\n  const positions: number[] = [];\n  const uvs: number[] = [];\n  const normals: number[] = [];\n  const faces: number[] = [];\n  const isVertical = orient === 'vertical';\n\n  for (let y = 0; y <= heightSegments; y++) {\n    const t = y / heightSegments;\n    for (let x = 0; x <= widthSegments; x++) {\n      const s = x / widthSegments;\n\n      if (isVertical) {\n        positions.push(2 * s - 1, 2 * t - 1, 0);\n        if (normals) {\n          normals.push(0, 0, 1);\n        }\n      } else {\n        positions.push(2 * t - 1, 0, 2 * s - 1);\n        if (normals) {\n          normals.push(0, 1, 0);\n        }\n      }\n      if (uvs) {\n        uvs.push(s, t);\n      }\n      if (x < widthSegments && y < heightSegments) {\n        const i = x + y * (widthSegments + 1);\n        faces.push(i, i + 1, i + widthSegments + 1);\n        faces.push(i + widthSegments + 1, i + 1, i + widthSegments + 2);\n      }\n    }\n  }\n\n  const geo = new Geometry({\n    uv: new Attribute(new Float32Array(uvs), 2),\n    position: new Attribute(new Float32Array(positions), 3),\n    normal: new Attribute(new Float32Array(normals), 3),\n    indices: new Attribute(new Uint32Array(faces), 1)\n  });\n\n  if (isVertical) {\n    vec3.set(geo.boundingBox.min, -1, -1, 0);\n    vec3.set(geo.boundingBox.max, 1, 1, 0);\n  } else {\n    vec3.set(geo.boundingBox.min, -1, 0, -1);\n    vec3.set(geo.boundingBox.max, 1, 0, 1);\n  }\n  return geo;\n}\n\n/** 2x2x2 cube centered at the origin. */\nexport function createCubeGeometry(\n  widthSegments: number = 1,\n  heightSegments: number = 1,\n  depthSegments: number = 1\n) {\n  const faces: number[] = [];\n  const positions: number[] = [];\n  const normals: number[] = [];\n  const uvs: number[] = [];\n\n  // helper variables\n\n  let offset = 0;\n\n  const w = 1;\n  const h = 1;\n  const d = 1;\n\n  // build each side of the box geometry\n\n  buildPlane(2, 1, 0, -1, -1, d, h, w, depthSegments, heightSegments); // px\n  buildPlane(2, 1, 0, 1, -1, d, h, -w, depthSegments, heightSegments); // nx\n  buildPlane(0, 2, 1, 1, 1, w, d, h, widthSegments, depthSegments); // py\n  buildPlane(0, 2, 1, 1, -1, w, d, -h, widthSegments, depthSegments); // ny\n  buildPlane(0, 1, 2, 1, -1, w, h, d, widthSegments, heightSegments); // pz\n  buildPlane(0, 1, 2, -1, -1, w, h, -d, widthSegments, heightSegments); // nz\n\n  // build geometry\n\n  function buildPlane(\n    u: 0 | 1 | 2,\n    v: 0 | 1 | 2,\n    w: 0 | 1 | 2,\n    udir: number,\n    vdir: number,\n    width: number,\n    height: number,\n    depth: number,\n    gridX: number,\n    gridY: number\n  ) {\n    const segmentWidth = width / gridX;\n    const segmentHeight = height / gridY;\n\n    const widthHalf = width / 2;\n    const heightHalf = height / 2;\n    const depthHalf = depth / 2;\n\n    const gridX1 = gridX + 1;\n    const gridY1 = gridY + 1;\n\n    let vertexCounter = 0;\n\n    const vector = vec3.create();\n\n    // generate positions, normals and uvs\n\n    for (let iy = 0; iy < gridY1; iy++) {\n      const y = iy * segmentHeight - heightHalf;\n\n      for (let ix = 0; ix < gridX1; ix++) {\n        const x = ix * segmentWidth - widthHalf;\n\n        vector[u] = x * udir;\n        vector[v] = y * vdir;\n        vector[w] = depthHalf;\n\n        positions.push(vector[0], vector[1], vector[2]);\n\n        vector[u] = 0;\n        vector[v] = 0;\n        vector[w] = depth > 0 ? 1 : -1;\n\n        normals.push(vector[0], vector[1], vector[2]);\n\n        uvs.push(ix / gridX);\n        uvs.push(1 - iy / gridY);\n\n        vertexCounter += 1;\n      }\n    }\n\n    // indices\n\n    // 1. you need three indices to draw a single face\n    // 2. a single segment consists of two faces\n    // 3. so we need to generate six (2*3) indices per segment\n\n    for (let iy = 0; iy < gridY; iy++) {\n      for (let ix = 0; ix < gridX; ix++) {\n        const a = offset + ix + gridX1 * iy;\n        const b = offset + ix + gridX1 * (iy + 1);\n        const c = offset + (ix + 1) + gridX1 * (iy + 1);\n        const d = offset + (ix + 1) + gridX1 * iy;\n\n        // faces\n        faces.push(a, b, d);\n        faces.push(b, c, d);\n      }\n    }\n\n    offset += vertexCounter;\n  }\n\n  const geo = new Geometry({\n    uv: new Attribute(new Float32Array(uvs), 2),\n    position: new Attribute(new Float32Array(positions), 3),\n    normal: new Attribute(new Float32Array(normals), 3),\n    indices: new Attribute(new Uint32Array(faces), 1)\n  });\n  vec3.set(geo.boundingBox.min, -1, -1, -1);\n  vec3.set(geo.boundingBox.max, 1, 1, 1);\n  return geo;\n}\n\n/**\n * Studio backdrop (\"infinity cove\"): a floor that curves up into a back wall.\n * `curveSize` is the fraction of the profile taken by the bend.\n */\nexport function createCurvePlaneGeometry(curveSize = 0.2) {\n  const faces = [];\n  const positions = [];\n  // Set width segments to 1 may have weired bands in ray tracing.\n  const widthSegments = 5;\n  const heightSegments = 200;\n  const texcoords = [];\n  const curveRadius = (curveSize / Math.PI) * 2;\n  const planeSize = (1 - curveSize) / 2;\n\n  let mm = 0;\n  for (let m = 0; m <= heightSegments; m++) {\n    // TODO t is stretched\n    let y, z;\n    let t = m / heightSegments;\n\n    // Skip the plane part to reduce the number of vertices.\n    if (\n      (t > 0 && t <= planeSize - 1 / heightSegments) ||\n      (t >= planeSize + curveSize + 1 / heightSegments && t < 1)\n    ) {\n      continue;\n    }\n\n    if (t <= planeSize) {\n      y = 0;\n      z = curveRadius + planeSize - t;\n    } else if (t >= planeSize + curveSize) {\n      y = t - planeSize - curveSize + curveRadius;\n      z = 0;\n    } else {\n      const rad = (((t - planeSize) / curveSize) * Math.PI) / 2;\n      y = (1 - Math.cos(rad)) * curveRadius;\n      z = (1 - Math.sin(rad)) * curveRadius;\n    }\n\n    for (let n = 0; n <= widthSegments; n++) {\n      const s = n / widthSegments;\n      const x = 2 * s - 1;\n      positions.push([x, y * 2, z * 2]);\n      texcoords.push([s, t]);\n      if (n < widthSegments && m < heightSegments) {\n        const i = n + mm * (widthSegments + 1);\n        faces.push([i, i + 1, i + widthSegments + 1]);\n        faces.push([i + widthSegments + 1, i + 1, i + widthSegments + 2]);\n      }\n    }\n    mm++;\n  }\n  const geo = new Geometry({\n    uv: new Attribute(new Float32Array(texcoords.flat()), 2),\n    position: new Attribute(new Float32Array(positions.flat()), 3),\n    indices: new Attribute(new Uint32Array(faces.flat()), 1)\n  });\n  updateBoundingBox(geo);\n  generateVertexNormals(geo);\n  return geo;\n}\n"]}

package/lib/util/events.d.ts

@@ -0,0 +1,7 @@
+/** Internal typed event subscriptions. A failing listener does not block others. */
+export declare class Events<T extends object> {
+    private listeners;
+    on<K extends keyof T>(name: K, listener: (event: T[K]) => void): () => void;
+    emit<K extends keyof T>(name: K, event: T[K]): void;
+    clear(): void;
+}

package/lib/util/events.js

@@ -0,0 +1,23 @@
+/** Internal typed event subscriptions. A failing listener does not block others. */
+export class Events {
+    listeners = new Map();
+    on(name, listener) {
+        let listeners = this.listeners.get(name);
+        if (!listeners)
+            this.listeners.set(name, listeners = new Set());
+        listeners.add(listener);
+        return () => { listeners.delete(listener); };
+    }
+    emit(name, event) {
+        for (const listener of [...this.listeners.get(name) ?? []]) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Event listener failed.', error);
+            }
+        }
+    }
+    clear() { this.listeners.clear(); }
+}
+//# sourceMappingURL=events.js.map

package/lib/util/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/util/events.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,OAAO,MAAM;IACT,SAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;IAClE,EAAE,CAAoB,IAAO,EAAE,QAA+B;QAC5D,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QAChE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAoB,IAAO,EAAE,KAAW;QAC1C,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,KAAK,KAAW,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CAC1C","sourcesContent":["/** Internal typed event subscriptions. A failing listener does not block others. */\nexport class Events<T extends object> {\n  private listeners = new Map<keyof T, Set<(event: any) => void>>();\n  on<K extends keyof T>(name: K, listener: (event: T[K]) => void): () => void {\n    let listeners = this.listeners.get(name);\n    if (!listeners) this.listeners.set(name, listeners = new Set());\n    listeners.add(listener);\n    return () => { listeners.delete(listener); };\n  }\n  emit<K extends keyof T>(name: K, event: T[K]): void {\n    for (const listener of [...this.listeners.get(name) ?? []]) {\n      try { listener(event); } catch (error) { console.error('Event listener failed.', error); }\n    }\n  }\n  clear(): void { this.listeners.clear(); }\n}\n"]}

package/lib/util/frame.d.ts

@@ -0,0 +1,2 @@
+/** Internal frame scheduling; dedicated workers without rAF use a 16 ms timer. */
+export declare function scheduleFrame(callback: (time: number) => void): () => void;

package/lib/util/frame.js

@@ -0,0 +1,10 @@
+/** Internal frame scheduling; dedicated workers without rAF use a 16 ms timer. */
+export function scheduleFrame(callback) {
+    if (typeof requestAnimationFrame === 'function') {
+        const id = requestAnimationFrame(callback);
+        return () => cancelAnimationFrame(id);
+    }
+    const id = setTimeout(() => callback(performance.now()), 16);
+    return () => clearTimeout(id);
+}
+//# sourceMappingURL=frame.js.map

package/lib/util/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/util/frame.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,QAAgC;IAC5D,IAAI,OAAO,qBAAqB,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC","sourcesContent":["/** Internal frame scheduling; dedicated workers without rAF use a 16 ms timer. */\nexport function scheduleFrame(callback: (time: number) => void): () => void {\n  if (typeof requestAnimationFrame === 'function') {\n    const id = requestAnimationFrame(callback); return () => cancelAnimationFrame(id);\n  }\n  const id = setTimeout(() => callback(performance.now()), 16);\n  return () => clearTimeout(id);\n}\n"]}

package/lib/util/fromTHREE.d.ts

@@ -0,0 +1,105 @@
+import InstancedMesh from '../scene/InstancedMesh.js';
+import Sync from '../Sync.js';
+import type Engine from '../Engine.js';
+import type * as THREE from 'three';
+import Mesh from '../scene/Mesh.js';
+import OpenPBRMaterial from '../scene/OpenPBRMaterial.js';
+import Camera from '../scene/Camera.js';
+import { Scene, SceneLight } from '../scene/Scene.js';
+/** Options for one-shot conversion and persistent Three.js synchronization. */
+export interface FromTHREESceneOptions {
+    /** Custom material conversion. Default undefined uses built-in conversion; returning null skips every mesh using this material. THREESync invokes once per source material identity/version, so the result cannot depend on a particular mesh. Returned materials are caller-owned; engine.update detects parameter edits. */
+    convertMaterial?(material: THREE.Material): OpenPBRMaterial | null | undefined;
+    /** Custom light conversion. Default undefined uses built-in conversion; returning null skips this light. THREESync invokes once per source light identity and numeric userData.mutracerVersion (default undefined, never rerun). Returned lights are retained by identity and remain caller-owned. */
+    convertLight?(light: THREE.Light): SceneLight | null | undefined;
+    /** Receives each converted visible mesh/group on every update. Default: no callback. */
+    onMeshConverted?(mesh: Mesh | InstancedMesh, source: THREE.Mesh, group: {
+        start: number;
+        count: number;
+        materialIndex?: number;
+    }, groupIndex: number): void;
+}
+/**
+ * Converts a Three.js scene into a MuTracer {@link Scene}: meshes with
+ * `MeshStandardMaterial` / `MeshPhysicalMaterial` (mapped to OpenPBR),
+ * directional, ambient, rect-area, point and spot lights, and the scene
+ * background / environment. Calls `scene.updateMatrixWorld()` and creates fresh objects on every call.
+ * CPU-evaluates skinning/morph targets and batches InstancedMesh instances
+ * with shared geometry, native colors and cached projection material variants. Unsupported batched
+ * or instanced deformation falls back to an ordinary mesh with a warning.
+ * For animation and editing, use {@link THREESync}.
+ *
+ * Renderer-specific material settings can be supplied through
+ * `material.userData`, e.g. `userData.mutracerShadowCatcher = true` or
+ * `userData.mutracerOpenPBR = { ... }` for OpenPBR inputs without a Three.js
+ * equivalent.
+ */
+export declare function fromTHREEScene(scene: THREE.Scene, options?: FromTHREESceneOptions): Scene;
+/** Structural control interface; no Three.js imports are needed in core APIs. */
+export interface THREEControls {
+    update(deltaTime?: number): boolean | void;
+    addEventListener(type: 'start' | 'end', listener: () => void): void;
+    removeEventListener(type: 'start' | 'end', listener: () => void): void;
+    target?: THREE.Vector3;
+    enableDamping?: boolean;
+    /** Damping per 60 Hz frame; synchronization adjusts it for elapsed time. Default undefined uses the control's own timing. */
+    dampingFactor?: number;
+    autoRotate?: boolean;
+    enabled?: boolean;
+    /** Optional OrbitControls polar-angle accessor. Default undefined. */ getPolarAngle?(): number;
+    /** Optional OrbitControls azimuthal-angle accessor. Default undefined. */ getAzimuthalAngle?(): number;
+}
+/** Three.js sources synchronized on each tick. */
+export interface THREESyncOptions extends FromTHREESceneOptions {
+    /** Scene source. Default undefined (engine.scene is untouched). */ scene?: THREE.Scene;
+    /** Camera source. Default undefined (engine.camera is untouched). */ camera?: THREE.PerspectiveCamera | THREE.OrthographicCamera;
+    /** Camera controls. Default undefined. */ controls?: THREEControls;
+    /** Call controls.update during synchronization. Default true. */ updateControls?: boolean;
+}
+/**
+ * Keeps one MuTracer scene in sync with a Three.js scene, reusing unchanged objects.
+ * Skinning/morph targets run on the CPU with per-source-mesh dynamic geometry.
+ * InstancedMesh retains its prefix on count changes and shares geometry/BLAS;
+ * Instance colors use native batch storage; automatic UV-less projections
+ * share cached material variants per source material. Source edits refresh variants; unused variants
+ * are removed after each update.
+ */
+export declare class THREESync extends Sync {
+    private _options;
+    /** Retained converted scene; absent when no scene source was supplied. */
+    readonly scene: Scene | undefined;
+    /** Retained converted camera; absent until the first camera update. */
+    private _camera?;
+    private _store;
+    private _disposed;
+    private _started;
+    private _cameraState;
+    private _lastUpdate?;
+    private _idleControlsState?;
+    private _start;
+    private _end;
+    /** Subscribes to controls without converting sources or modifying the engine. */
+    constructor(engine: Engine, _options?: THREESyncOptions);
+    /** Updates controls, world matrices, retained instances and camera before engine.update. */
+    update(): void;
+    /** Removes control subscriptions and caches. The last converted objects remain usable. */
+    dispose(): void;
+}
+/** Lens settings for {@link fromTHREECamera}. */
+export interface FromTHREECameraOptions {
+    /** Lens f-number; `0` disables depth of field. Default `0`. */
+    fStop?: number;
+    /**
+     * Distance to the plane in focus in scene units. Default: the perspective
+     * camera's `focus` (Three.js default `10`), otherwise `10`.
+     */
+    focusDistance?: number;
+    /** Length of one scene unit in metres. Default `1`. */
+    metersPerUnit?: number;
+}
+/**
+ * Converts a Three.js perspective or orthographic camera. A perspective
+ * camera's `focus` and film height (`filmGauge` and `aspect`) become
+ * `focusDistance` and `sensorHeight`.
+ */
+export declare function fromTHREECamera(threeCamera: THREE.PerspectiveCamera | THREE.OrthographicCamera, options?: FromTHREECameraOptions): Camera;