@woosh/meep-engine 3.18.0 → 3.19.0

package/src/shade/playground/ssr_variance/statistics.js

@@ -0,0 +1,51 @@
+/** Per-pixel temporal moments of linear Rec.709 luminance. No spatial pooling before variance. */
+export function measure_variance(samples, mask, width, height) {
+    if (samples.length < 2) { throw new Error('At least two samples are required'); }
+    const pixels = width * height;
+    if (mask.length !== pixels * 4 || samples.some(s => s.length !== pixels * 4)) {
+        throw new Error('Capture dimensions do not match');
+    }
+    const mean = new Float64Array(pixels), m2 = new Float64Array(pixels);
+    const minimum = new Float64Array(pixels).fill(Infinity), maximum = new Float64Array(pixels).fill(-Infinity);
+    for (let n = 0; n < samples.length; n++) {
+        const sample = samples[n];
+        for (let p = 0; p < pixels; p++) {
+            const i = p * 4;
+            if (![sample[i], sample[i + 1], sample[i + 2], sample[i + 3]].every(Number.isFinite)) {
+                throw new Error(`Non-finite capture at sample ${n}, pixel ${p}`);
+            }
+            const y = sample[i] * 0.2126 + sample[i + 1] * 0.7152 + sample[i + 2] * 0.0722;
+            const delta = y - mean[p];
+            mean[p] += delta / (n + 1);
+            m2[p] += delta * (y - mean[p]);
+            minimum[p] = Math.min(minimum[p], y); maximum[p] = Math.max(maximum[p], y);
+        }
+    }
+    const variance = Float32Array.from(m2, v => v / samples.length);
+    const summarize = predicate => {
+        const sigmas = [];
+        let variance_sum = 0, mean_sum = 0, range_sum = 0, max_range = 0;
+        for (let p = 0; p < pixels; p++) {
+            if (!predicate(p)) { continue; }
+            sigmas.push(Math.sqrt(variance[p])); variance_sum += variance[p]; mean_sum += mean[p];
+            const range = maximum[p] - minimum[p]; range_sum += range; max_range = Math.max(max_range, range);
+        }
+        sigmas.sort((a, b) => a - b);
+        const count = sigmas.length;
+        if (!count) { throw new Error('Empty measurement region'); }
+        return { pixels: count, mean_luminance: mean_sum / count,
+            mean_population_variance: variance_sum / count,
+            mean_sample_variance: variance_sum / count * samples.length / (samples.length - 1),
+            rms_temporal_sigma: Math.sqrt(variance_sum / count),
+            p95_temporal_sigma: sigmas[Math.ceil(count * 0.95) - 1],
+            mean_peak_to_peak: range_sum / count, max_peak_to_peak: max_range };
+    };
+    // Fixed screen rectangle shared by every stage/control, intersected with ground normals.
+    const roi = { x: Math.floor(width * 0.25), y: Math.floor(height * 0.50),
+        width: Math.floor(width * 0.5), height: Math.floor(height * 0.42) };
+    const ground = p => mask[p * 4] > 0.5;
+    return { mean: Float32Array.from(mean), variance, roi,
+        summary: { all: summarize(() => true), ground: summarize(ground),
+            reflection: summarize(p => ground(p) && p % width >= roi.x && p % width < roi.x + roi.width
+                && Math.floor(p / width) >= roi.y && Math.floor(p / width) < roi.y + roi.height) } };
+}

package/src/shade/renderer/loader/gltf/tiny-gltf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tiny-gltf.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/loader/gltf/tiny-gltf.js"],"names":[],"mappings":"AA4UA;IAoEI;;;;;;;;;;;;;OAaG;IACH,+CAFU,aAAa,CAEgC;IA3BvD;;;;OAIG;IACH,qFAFW,qBAAqB,EAQ/B;IAjED,oBAA2B;IAE3B;;;;;;;;OAQG;IACH,iDAAmD;IAEnD;;;;;;;;;OASG;IACH,SAFU,IAAI,MAAM,EAAE,IAAI,GAAC,IAAI,GAAC,WAAW,CAAC,GAAC,SAAS,CAElC;IAqKpB;;;OAGG;IACH,iBAHW,MAAM,GACJ,QAAQ,QAAQ,CAAC,CAgB7B;IAED;;;;;;OAMG;IACH,4BAJW,WAAW,WACX,MAAM,GACL,QAAQ;QAAC,KAAK,CAAA;KAAC,MAAE,CAAC,CAM7B;IAED;;;;;;OAMG;IACH;;;mBALwC,EAAE;eAAO,EAAE;mBAAW,EAAE;iBAAS,EAAE;mBAAW,EAAE;kBAAW,EAAE;gBAAS,EAAE;gBAAQ,EAAE;gBAC/G,MAAM,gBACN,UAAU,GACT,QAAQ;QAAC,KAAK,CAAA;KAAC,MAAE,CAAC,CAiR7B;;CAGJ;8BAtyB6B,qDAAqD"}
+{"version":3,"file":"tiny-gltf.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/loader/gltf/tiny-gltf.js"],"names":[],"mappings":"AA4UA;IAoEI;;;;;;;;;;;;;OAaG;IACH,+CAFU,aAAa,CAEgC;IA3BvD;;;;OAIG;IACH,qFAFW,qBAAqB,EAQ/B;IAjED,oBAA2B;IAE3B;;;;;;;;OAQG;IACH,iDAAmD;IAEnD;;;;;;;;;OASG;IACH,SAFU,IAAI,MAAM,EAAE,IAAI,GAAC,IAAI,GAAC,WAAW,CAAC,GAAC,SAAS,CAElC;IAqKpB;;;OAGG;IACH,iBAHW,MAAM,GACJ,QAAQ,QAAQ,CAAC,CAgB7B;IAED;;;;;;OAMG;IACH,4BAJW,WAAW,WACX,MAAM,GACL,QAAQ;QAAC,KAAK,CAAA;KAAC,MAAE,CAAC,CAM7B;IAED;;;;;;OAMG;IACH;;;mBALwC,EAAE;eAAO,EAAE;mBAAW,EAAE;iBAAS,EAAE;mBAAW,EAAE;kBAAW,EAAE;gBAAS,EAAE;gBAAQ,EAAE;gBAC/G,MAAM,gBACN,UAAU,GACT,QAAQ;QAAC,KAAK,CAAA;KAAC,MAAE,CAAC,CAuR7B;;CAGJ;8BA5yB6B,qDAAqD"}

package/src/shade/renderer/loader/gltf/tiny-gltf.js

@@ -498,7 +498,7 @@ export class TinyGltf {
      * Read a KTX2 image into texels, transcoding it where its payload is Basis.
      *
      * @param {ArrayBuffer|Uint8Array} bytes the whole file
-     * @returns {ShadeTexelData}
+     * @returns {Promise<ShadeTexelData>}
      * @param {TextureRole} [role] what the image is for, which orders the candidate targets
      * @throws {Error} naming the feature, for a container this reader does not read
      */
@@ -811,7 +811,13 @@ export class TinyGltf {
         place_nodes(json);
 
         // Replace the resolved resources in the JSON structure.
-        const buffers = await Promise.all(pendingBuffers);
+        // Observe image failures while buffers are still loading. Native decompression can reject
+        // during another resource's I/O; deferring its handler until all buffers finish would leave
+        // that rejection unhandled (and could leave the load waiting indefinitely).
+        const [buffers, images] = await Promise.all([
+            Promise.all(pendingBuffers),
+            Promise.all(pendingImages),
+        ]);
 
         /*
          Views that some extension produces the bytes for become ordinary ones here, over decoded
@@ -827,7 +833,7 @@ export class TinyGltf {
         );
 
         json.buffers = buffers;
-        json.images = await Promise.all(pendingImages);
+        json.images = images;
 
         return json;
     }

package/src/shade/renderer/loader/usd/usd_decode_image.d.ts

@@ -13,17 +13,17 @@ export function decode_data_url(url: string): {
  *
  * Accepts anything `PNGReader` accepts; see the module comment for what that covers and how
  * other layouts are brought to RGBA8. Errors from the reader (bad signature, truncated stream,
- * corrupt deflate payload) propagate as thrown.
+ * corrupt deflate payload) reject the returned promise.
  *
  * @param {Uint8Array|ArrayBuffer} png_bytes
- * @returns {{ width: number, height: number, channels: number, pixels: Uint8Array }}
+ * @returns {Promise<{ width: number, height: number, channels: number, pixels: Uint8Array }>}
  */
-export function decode_png(png_bytes: Uint8Array | ArrayBuffer): {
+export function decode_png(png_bytes: Uint8Array | ArrayBuffer): Promise<{
     width: number;
     height: number;
     channels: number;
     pixels: Uint8Array;
-};
+}>;
 /**
  * Create a ShadeTexture from decoded image data.
  *

package/src/shade/renderer/loader/usd/usd_decode_image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usd_decode_image.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/loader/usd/usd_decode_image.js"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,qCAHW,MAAM;cACQ,MAAM;UAAQ,UAAU;EAgChD;AAGD;;;;;;;;;GASG;AACH,sCAHW,UAAU,GAAC,WAAW;WACX,MAAM;YAAU,MAAM;cAAY,MAAM;YAAU,UAAU;EA0DjF;AAGD;;;;;GAKG;AACH,2DAHW;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACrE,YAAY,CAexB;6BAnI4B,+BAA+B"}
+{"version":3,"file":"usd_decode_image.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/loader/usd/usd_decode_image.js"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,qCAHW,MAAM;cACQ,MAAM;UAAQ,UAAU;EAgChD;AAGD;;;;;;;;;GASG;AACH,sCAHW,UAAU,GAAC,WAAW;WACH,MAAM;YAAU,MAAM;cAAY,MAAM;YAAU,UAAU;GA0DzF;AAGD;;;;;GAKG;AACH,2DAHW;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACrE,YAAY,CAexB;6BAnI4B,+BAA+B"}

package/src/shade/renderer/loader/usd/usd_decode_image.js

@@ -70,14 +70,14 @@ export function decode_data_url(url) {
  *
  * Accepts anything `PNGReader` accepts; see the module comment for what that covers and how
  * other layouts are brought to RGBA8. Errors from the reader (bad signature, truncated stream,
- * corrupt deflate payload) propagate as thrown.
+ * corrupt deflate payload) reject the returned promise.
  *
  * @param {Uint8Array|ArrayBuffer} png_bytes
- * @returns {{ width: number, height: number, channels: number, pixels: Uint8Array }}
+ * @returns {Promise<{ width: number, height: number, channels: number, pixels: Uint8Array }>}
  */
-export function decode_png(png_bytes) {
+export async function decode_png(png_bytes) {
 
-    const png = new PNGReader(to_array_buffer(png_bytes)).parse();
+    const png = await new PNGReader(to_array_buffer(png_bytes)).parse();
 
     const width = png.getWidth();
     const height = png.getHeight();