@woosh/meep-engine 3.14.1 → 3.14.3

package/src/shade/renderer/animation/GPUAnimationManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUAnimationManager.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/animation/GPUAnimationManager.js"],"names":[],"mappings":"AA4HA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAyMI;;;;OAIG;IACH,sCAHW,MAAM,kCAgBhB;IAED;;OAEG;IACH,4BAEC;IAED;;;;;;;;;;;;OAYG;IACH,gCAEC;IAED;;;;;;;;;;OAUG;IACH,qCAEC;IAED;;;;;;OAMG;IACH,gCAEC;IAED;;;;;;;;;;OAUG;IACH,mCAEC;IAED;;;;;;;;;;;;OAYG;IACH,4CAFW,MAAM,QA6BhB;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAK3D;IAED;;;;;;;;;;;;OAYG;IACH,gCAHW,MAAM,GACJ,MAAM,CAOlB;IAED;;;;;;;;;;;OAWG;IACH,kCAFa,MAAM,CA+BlB;IAED;;;;;;;;;;;;;;OAcG;IACH,oBAJW;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAEhD,MAAM,CA2BlB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH;eAPc,MAAM;qBACA,MAAM;mBACR,MAAM;kBACP,MAAM;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAEhE,MAAM,CAkElB;IAgCD;;;;;;;;;;;;;;;;;OAiBG;IACH,kBAHW,MAAM,QACN,MAAM,QAKhB;IAED;;;;;;;;OAQG;IACH,2BAHW,MAAM,QACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;OAcG;IACH,6BAHW,MAAM,UACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,mBAHW,MAAM,SACN,MAAM,QAShB;IAED;;;;;;;OAOG;IACH,qBAHW,MAAM,SACN,MAAM,QAShB;IAED;;;;;;;;;;;OAWG;IACH,eAFW,MAAM,QAShB;IAED;;;;;;;;;OASG;IACH,cAFW,MAAM,QAShB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH;gBAJe,MAAM;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC;QAEhE,MAAM,CAoElB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,2BAFa,MAAM,CA4ElB;IA8ED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,yCAFa,MAAM,CAyDlB;IAwDD;;;;;;;;;;;;;;;OAeG;IACH,yBAFW,MAAM,QAkChB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,yBAFW,MAAM,QA2ChB;IA0FD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,8CAIC;IAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,iEA2CC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,kDAFW,MAAM,QAgChB;IA8FD,gBAYC;;CACJ;4BArtD2B,gCAAgC"}
+{"version":3,"file":"GPUAnimationManager.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/animation/GPUAnimationManager.js"],"names":[],"mappings":"AA4HA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IA0NI;;;;OAIG;IACH,sCAHW,MAAM,kCAgBhB;IAED;;OAEG;IACH,4BAEC;IAED;;;;;;;;;;;;OAYG;IACH,gCAEC;IAED;;;;;;;;;;OAUG;IACH,qCAEC;IAED;;;;;;OAMG;IACH,gCAEC;IAED;;;;;;;;;;OAUG;IACH,mCAEC;IAED;;;;;;;;;;;;OAYG;IACH,4CAFW,MAAM,QA6BhB;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAK3D;IAED;;;;;;;;;;;;OAYG;IACH,gCAHW,MAAM,GACJ,MAAM,CAOlB;IAED;;;;;;;;;;;OAWG;IACH,kCAFa,MAAM,CA+BlB;IAED;;;;;;;;;;;;;;OAcG;IACH,oBAJW;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAEhD,MAAM,CA2BlB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH;eAPc,MAAM;qBACA,MAAM;mBACR,MAAM;kBACP,MAAM;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAEhE,MAAM,CAkElB;IAgCD;;;;;;;;;;;;;;;;;OAiBG;IACH,kBAHW,MAAM,QACN,MAAM,QAKhB;IAED;;;;;;;;OAQG;IACH,2BAHW,MAAM,QACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;OAcG;IACH,6BAHW,MAAM,UACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,mBAHW,MAAM,SACN,MAAM,QAShB;IAED;;;;;;;OAOG;IACH,qBAHW,MAAM,SACN,MAAM,QAShB;IAED;;;;;;;;;;;OAWG;IACH,eAFW,MAAM,QAShB;IAED;;;;;;;;;OASG;IACH,cAFW,MAAM,QAShB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH;gBAJe,MAAM;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC;QAEhE,MAAM,CAoElB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,2BAFa,MAAM,CA4ElB;IA8ED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,yCAFa,MAAM,CAyDlB;IAwDD;;;;;;;;;;;;;;;OAeG;IACH,yBAFW,MAAM,QAkChB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,yBAFW,MAAM,QA2ChB;IAqHD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,8CAIC;IAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,iEA2CC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,kDAFW,MAAM,QAgChB;IA8FD,gBAYC;;CACJ;4BAjwD2B,gCAAgC"}

package/src/shade/renderer/animation/GPUAnimationManager.js

@@ -293,6 +293,23 @@ export class GPUAnimationManager {
      */
     #curve_id_cache = new WeakMap();
 
+    /**
+     * The curves uploaded so far, by what they are rather than which instance they were: the
+     * `hash()` of a curve's keys, to every uploaded curve with that hash and its GPU id.
+     *
+     * An instance cache alone shares nothing between two parses of one file, and a character
+     * instanced a few hundred times is a few hundred parses — each with its own instances of the
+     * same keys, filling the keyframe-block table with copies of one dance until its page limit
+     * refuses the next dancer. Curves are read-only once uploaded and nothing here releases them,
+     * so equal content can safely mean one upload.
+     *
+     * A hash bucket is a list because a hash is not an identity: a curve is only shared with one
+     * whose every key `equals` its own, tangents included.
+     *
+     * @type {Map<number, {curve: AnimationCurve, id: number}[]>}
+     */
+    #curve_id_by_content = new Map();
+
     /**
      * Cache of track-id-on-GPU keyed by `(curve_id_x, curve_id_y,
      * curve_id_z, curve_id_w, mask)`. With curve dedup already
@@ -1379,22 +1396,49 @@ export class GPUAnimationManager {
     }
 
     /**
-     * Identity-cached wrapper around {@link add_curve}. First time
-     * the manager sees a given {@link AnimationCurve} instance, it
-     * uploads via the low-level path and caches the resulting GPU id.
-     * Subsequent calls with the same instance reuse that id —
-     * keyframe blocks are shared, not duplicated.
+     * Cached wrapper around {@link add_curve}: one upload per distinct curve, where distinct means
+     * distinct *content*.
+     *
+     * The instance cache answers first — the common case inside one clip, and free. Otherwise the
+     * curve's keys are hashed and held against every uploaded curve with that hash; a match on
+     * every key, tangents included, reuses that upload, and only a curve nobody has uploaded before
+     * goes through the low-level path. Either way the instance is remembered, so the next look-up
+     * of it is the free one.
      *
      * @param {AnimationCurve} curve
      * @returns {number} curve id (index into the `animation_curves` table)
      */
     #intern_curve(curve) {
         const cached = this.#curve_id_cache.get(curve);
+
         if (cached !== undefined) {
             return cached;
         }
+
+        const hash = curve.hash();
+
+        let bucket = this.#curve_id_by_content.get(hash);
+
+        if (bucket === undefined) {
+            bucket = [];
+
+            this.#curve_id_by_content.set(hash, bucket);
+        } else {
+            for (const entry of bucket) {
+                if (entry.curve.equals(curve)) {
+                    this.#curve_id_cache.set(curve, entry.id);
+
+                    return entry.id;
+                }
+            }
+        }
+
         const id = this.add_curve(curve);
+
         this.#curve_id_cache.set(curve, id);
+
+        bucket.push({ curve, id });
+
         return id;
     }
 

package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUMeshSkinningContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js"],"names":[],"mappings":"AAyEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IA2MI;;;;;;;OAOG;IACH,sEAPW;QACV,UAAgB,qBAAqB;QACrC,iBAAuB,sBAAsB;QAC7C,aAAmB,kBAAkB;QACrC,MAAY,YAAY;KACrB,EAYH;IAED;;;;;;OAMG;IACH,iCAEC;IAED;;;;;;OAMG;IACH,2BAEC;IAED;;;;;;;OAOG;IACH,wCAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,mCAFa,MAAM,CAelB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,iCAFW,MAAM,QAmBhB;IAED;;;;;;;OAOG;IACH,gCAFa,MAAM,GAAC,SAAS,CAI5B;IAED;;;;;;;;;;OAUG;IACH,gCAYC;IAED;;;;;;;;OAQG;IACH,4BAFW,MAAM,QAYhB;IAyCD;;;;;;;;;;;;;;;OAeG;IACH,8CAkNC;IAsSD,gBAiBC;;CACJ"}
+{"version":3,"file":"GPUMeshSkinningContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js"],"names":[],"mappings":"AAyEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAoNI;;;;;;;OAOG;IACH,sEAPW;QACV,UAAgB,qBAAqB;QACrC,iBAAuB,sBAAsB;QAC7C,aAAmB,kBAAkB;QACrC,MAAY,YAAY;KACrB,EAcH;IAED;;;;;;OAMG;IACH,iCAEC;IAED;;;;;;OAMG;IACH,2BAEC;IAED;;;;;;;OAOG;IACH,wCAEC;IAED;;;;;;;;;;;;;;OAcG;IACH,mCAFa,MAAM,CAelB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,iCAFW,MAAM,QAmBhB;IAED;;;;;;;OAOG;IACH,gCAFa,MAAM,GAAC,SAAS,CAI5B;IAED;;;;;;;;;;OAUG;IACH,gCAYC;IAED;;;;;;;;OAQG;IACH,4BAFW,MAAM,QAYhB;IAyCD;;;;;;;;;;;;;;;OAeG;IACH,8CAyNC;IAqSD,gBAkBC;;CACJ"}

package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js

@@ -25,7 +25,7 @@ import {
 import {
     MESHLET_METADATA_STRUCT
 } from "../../geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
-import { record_blas_refit } from "../../geometry/bvh/record_blas_refit.js";
+import { GPUBLASRefitBatch } from "../../geometry/bvh/GPUBLASRefitBatch.js";
 
 /**
  * Initial bindings-buffer capacity (in binding records). 16 × 16 bytes
@@ -296,6 +296,15 @@ export class GPUMeshSkinningContext {
      */
     #scene_context;
 
+    /**
+     * The per-frame refit of every bound mesh's clone BLAS, as one batch. Its entries are the
+     * binding list, re-listed whenever that changes; when the trees themselves become resident,
+     * and where, is the BLAS manager's business, and the batch asks it.
+     *
+     * @type {GPUBLASRefitBatch}
+     */
+    #refit_batch;
+
     /**
      * @param {{
      *     geometries: GPUGeometryManager,
@@ -314,6 +323,8 @@ export class GPUMeshSkinningContext {
         this.#animation_manager = animation_manager;
         this.#scene_context = scene_context;
         this.#device = device;
+
+        this.#refit_batch = new GPUBLASRefitBatch(device);
     }
 
     /**
@@ -571,10 +582,15 @@ export class GPUMeshSkinningContext {
         }
 
         if (this.#bindings_dirty) {
-            // Neither of these reads anything outside the binding list, so a scene edit that left
+            // None of these reads anything outside the binding list, so a scene edit that left
             // the list alone cannot have moved them.
             this.#upload_dispatch_lookup();
             this.#upload_prev_position_offsets();
+            this.#refit_batch.set_entries(this.#bindings.map(binding => ({
+                // the identity the clone's BLAS is registered under, and the row skinning deforms
+                owner: binding.clone_metadata,
+                geometry_index: binding.clone_geometry_index,
+            })));
             this.#bindings_dirty = false;
         }
 
@@ -729,7 +745,7 @@ export class GPUMeshSkinningContext {
             }
         }
 
-        // ── 5. BLAS refit: the clone's tree catches up with its vertices ──
+        // ── 5. BLAS refit: every clone's tree catches up with its vertices ──
         //
         // The chain above fixes what the *rasterizer* culls by — meshlet boxes, a mesh sphere. A
         // ray does not consult any of those; it walks the clone's BLAS, whose boxes still describe
@@ -737,15 +753,23 @@ export class GPUMeshSkinningContext {
         // longer in: rays miss where the mesh now is and hit where it no longer is.
         //
         // Topology is untouched. Refitting a tree whose triangles moved but whose shape did not is
-        // two dispatches, against the full build's sort-and-emit — which is why a clone gets a copy
-        // of the source's nodes rather than a build of its own.
+        // a fraction of the full build's sort-and-emit — which is why a clone gets a copy of the
+        // source's nodes rather than a build of its own. And it is one batch for every clone at
+        // once, not a dispatch per clone: the command count is the same for one skinned mesh as
+        // for three hundred, and each tree's climb overlaps the next's instead of waiting on it.
         this.#record_blas_refits(cmd_ctx);
     }
 
     /**
      * Refit every skinned clone's BLAS against the vertices this frame's skinning just deformed.
      *
-     * Per binding rather than per dispatch-pair: a refit is scoped to a tree, and a clone has one.
+     * The batch's entries are the binding list, set whenever that changes; which of those trees
+     * are resident, and where, the batch asks the BLAS manager — and only when the manager says the
+     * answer may have moved.
+     *
+     * Recorded here and nowhere else, on purpose: the batch binds the manager's arena buffers as
+     * they are at this moment, and those are replaced when an arena grows in the geometry update,
+     * which runs before this frame's command context exists. See {@link GPUBLASRefitBatch}.
      *
      * @param {ShadeGPUCommandContext} cmd_ctx
      */
@@ -758,14 +782,7 @@ export class GPUMeshSkinningContext {
             return;
         }
 
-        for (const binding of this.#bindings) {
-            record_blas_refit(cmd_ctx, {
-                blas,
-                geometries,
-                owner: binding.clone_metadata,
-                geometry_index: binding.clone_geometry_index,
-            });
-        }
+        this.#refit_batch.record(cmd_ctx, { blas, geometries });
     }
 
     /**
@@ -1051,5 +1068,6 @@ export class GPUMeshSkinningContext {
             this.#prev_position_offsets_buffer.destroy();
             this.#prev_position_offsets_buffer = null;
         }
+        this.#refit_batch.destroy();
     }
 }

package/src/shade/renderer/geometry/GPUGeometryManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUGeometryManager.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/GPUGeometryManager.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH;IA8HI;;;OAGG;IACH,+BAUC;IAtID;;;OAGG;IACH,iBAFU,YAAU,IAAI,CAED;IA4BvB;;;OAGG;IACH,mEAEC;IAED;;;;OAIG;IACH,8BAA0B;IAE1B;;;;OAIG;IACH,uBAAsB;IAOtB;;;OAGG;IACH,kCAEC;IAeD;;;OAGG;IACH,kCAEC;IAGD;;;OAGG;IACH,iCAEC;IAED;;;OAGG;IACH,+BAiBC;IAkBD;;;;OAIG;IACH,qBAHW,mBAAmB,GAClB,MAAM,CAMjB;IAED;;;;OAIG;IACH,gCAFY,OAAO,CAIlB;IAGD;;;;OAIG;IACH,gCAFa,OAAO,CAqCnB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,6CANa,mBAAmB,CA8B/B;IAED;;;;;;;OAOG;IACH,yCAFa,mBAAmB,GAAC,SAAS,CAIzC;IAED;;;;OAIG;IACH,mCAFa,OAAO,CA6BnB;IAED,gBAWC;IAED;;;;;;OAMG;IACH,mDA0BC;IAsDD,cAmCC;IAED,0CASC;;CA+BJ;oCA1emC,0BAA0B;kCAC5B,gCAAgC;sCAH5B,gCAAgC"}
+{"version":3,"file":"GPUGeometryManager.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/GPUGeometryManager.js"],"names":[],"mappings":"AAaA;;;;GAIG;AACH;IAqJI;;;OAGG;IACH,+BAUC;IA7JD;;;OAGG;IACH,iBAFU,YAAU,IAAI,CAED;IA0CvB;;;OAGG;IACH,mEAEC;IAED;;;;OAIG;IACH,8BAA0B;IAE1B;;;;OAIG;IACH,uBAAsB;IAOtB;;;OAGG;IACH,kCAEC;IAwBD;;;OAGG;IACH,kCAEC;IAGD;;;OAGG;IACH,iCAEC;IAED;;;OAGG;IACH,+BAiBC;IAkBD;;;;OAIG;IACH,qBAHW,mBAAmB,GAClB,MAAM,CAMjB;IAED;;;;OAIG;IACH,gCAFY,OAAO,CAIlB;IAGD;;;;OAIG;IACH,gCAFa,OAAO,CAiEnB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,6CANa,mBAAmB,CAiC/B;IAED;;;;;;;OAOG;IACH,yCAFa,mBAAmB,GAAC,SAAS,CAIzC;IAED;;;;OAIG;IACH,mCAFa,OAAO,CAsCnB;IAyBD,gBAWC;IAED;;;;;;OAMG;IACH,mDAiCC;IAmDD,cAmCC;IAED,0CAWC;;CA+BJ;oCAtkBmC,0BAA0B;kCAC5B,gCAAgC;sCAH5B,gCAAgC"}