@woosh/meep-engine 3.58.0 → 3.60.0

package/src/shade/renderer/global_illumination/probe_clipmap/probe/GPUProbeClipmap.d.ts

@@ -1,15 +1,16 @@
 /**
  * What shading samples (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §8): {@link cascade_count} cascades of
  * {@link resolution}³ lattice points around the view, {@link spacing} metres apart in the finest
- * cascade and twice as far apart in each one around it. A point holds a probe only while something on
- * screen wants it, so probes are a sparse cache over the lattice.
+ * cascade and twice as far apart in each one around it. A point gets a probe when a pixel wants it, or
+ * a hit of a probe a pixel wants, and keeps it until its window leaves it or the slots are wanted for
+ * others, so probes are a sparse cache over the lattice.
  *
  * **Storage** (§8.2):
  * - {@link indirection}, `r32uint`, a texel a lattice point in storage that wraps, the cascades
  *   stacked along z: the slot of the point's probe, or none. Allocated whole, since the lattice follows
  *   from the structure alone.
  * - a slot each: a state of two words, the kind and updates and then where relocation moved it
- *   (`PROBE_CLIPMAP.js`), a 64-byte record (`PROBE_RECORD_STRUCT`), an octahedral radiance tile of
+ *   (`PROBE_CLIPMAP.js`), a 48-byte record (`PROBE_RECORD_STRUCT`), an octahedral radiance tile of
  *   {@link radiance_resolution}² texels and a depth-moment tile of {@link depth_resolution}², each with
  *   a one-texel skirt, in two 2-D tile atlases. The slots are handed out by a free list on the device.
  * - the active lists, double-buffered: each frame's retire reads the last frame's and writes the
@@ -18,12 +19,22 @@
  *
  * **A frame's lifetime** ({@link graph_update}, §8.3, §8.5): the windows are placed around the anchor,
  * coarsest first, each a parent cell inside its parent. Retire frees the probes whose points left
- * their windows or that nobody wanted for `retention_time`, want marks the cages one pixel of each
- * screen tile reads, admit gives each wanted point without a probe a NEW one, schedule sets the period
- * T from the wanted count, and the due passes list the frame's updates, NEW probes first.
+ * their windows and those the last frame's schedule evicted, want marks the cages one pixel of each
+ * screen tile reads, the hits' wants the cages the last frame's hits read their bounce from, admit
+ * gives each wanted point without a probe a NEW one, schedule sets the period T from the probes waiting
+ * for an update and the next frame's eviction from the pressure on the slots (`PROBE_FREE_SLACK`), and
+ * the due passes list the frame's updates, NEW probes first.
  *
- * **The frame's update** (§8.4, §8.6), once the brick clipmap is built: relocate, then trace, a ray a
- * thread, R a probe, each with its hit and the suns' soft shadows there.
+ * **The frame's rays** (§8.6): the lifetime's last passes lay them out. Each listed probe's rays this update
+ * are a count the budget does not scale (a uniform update's R, a DEAD probe's fewest) and a request it
+ * does (a guided update's, `probe_requests`, which projection sets after each update). Both are scanned
+ * (`graph_prefix_scan_csdldf`'s shaders), the requests are scaled into what the budget leaves, and the
+ * sums of the two are `probe_ray_sums`: a probe's rays follow one another in the trace list's order, and
+ * the last sum is the frame's count, which the rays' command dispatches.
+ *
+ * **The frame's update** (§8.4, §8.6), once the brick clipmap is built: relocate; then the guide, the
+ * CDF over each listed probe's history that its guided updates' rays follow (`PROBE_UNIFORM_PERIOD`);
+ * then trace, a ray a thread, each with its hit and the suns' shadow rays from there.
  *
  * Retire, admit, due and the update run through commands written on the device, want over the screen's
  * tiles: nothing is sized by the capacity.
@@ -79,6 +90,16 @@ export class GPUProbeClipmap {
      * @readonly
      */
     readonly depth_resolution: number;
+    /**
+     * Put what the probes' readers bind into `bindings`, under the names `chunk_probe_clipmap_pick` reads
+     * them by: the levels and the sampling uniforms, the indirection, the states and records, the depth
+     * atlas. As the last {@link graph_update} left them; take them each frame, since a growth replaces
+     * the per-slot buffers.
+     *
+     * @param {Object} bindings
+     * @returns {Object} bindings
+     */
+    write_sampling_bindings(bindings: any): any;
     /**
      * @returns {GPUTexture}
      */
@@ -126,9 +147,7 @@ export class GPUProbeClipmap {
      * @param {GPUBuffer} options.camera the view's camera uniform
      * @param {*} options.stbn the 2-channel spatio-temporal blue noise, `STATIC_GRAPHICS_ENGINE_ASSETS.stbn_vec2`
      * @param {ArrayLike<number>} options.resolution the frame's pixels, x and y
-     * @param {number} options.time the caller's clock, seconds
-     * @param {number} options.retention_time seconds an unwanted probe keeps its slot
-     * @param {number} options.response_time seconds of the blend's response, τ (§8.8)
+     * @param {number} options.response_frames frames of the blend's response, τ (§8.8)
      * @param {number} options.ray_budget rays a frame
      * @param {number} options.rays_per_probe rays an update, R: the frame updates ⌊ray_budget / R⌋ probes at most
      * @param {import("../brick/GPUBrickClipmap.js").GPUBrickClipmap} options.brick_clipmap the world the
@@ -141,7 +160,7 @@ export class GPUProbeClipmap {
      *   the resident materials, updated this frame: what a hit no card sees takes
      * @param {GPUBuffer} options.card_rows the row → card set table, a word a `meshes` row
      */
-    graph_update({ graph, x, y, z, depth, normal, camera, stbn, resolution, time, retention_time, response_time, ray_budget, rays_per_probe, brick_clipmap, bricks, scene, materials, card_rows }: {
+    graph_update({ graph, x, y, z, depth, normal, camera, stbn, resolution, response_frames, ray_budget, rays_per_probe, brick_clipmap, bricks, scene, materials, card_rows }: {
         graph: FrameGraph;
         x: number;
         y: number;
@@ -151,9 +170,7 @@ export class GPUProbeClipmap {
         camera: GPUBuffer;
         stbn: any;
         resolution: ArrayLike<number>;
-        time: number;
-        retention_time: number;
-        response_time: number;
+        response_frames: number;
         ray_budget: number;
         rays_per_probe: number;
         brick_clipmap: import("../brick/GPUBrickClipmap.js").GPUBrickClipmap;

package/src/shade/renderer/global_illumination/probe_clipmap/probe/GPUProbeClipmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUProbeClipmap.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/GPUProbeClipmap.js"],"names":[],"mappings":"AAgFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH;IA4KI;;;;;;;;OAQG;IACH;QAN2B,aAAa,EAA7B,MAAM;QACU,UAAU,EAA1B,MAAM;QACU,OAAO,EAAvB,MAAM;QACU,mBAAmB,EAAnC,MAAM;QACU,gBAAgB,EAAhC,MAAM;OAyFhB;IA3QD;;;OAGG;IACH,wBAHU,MAAM,CAGF;IAEd;;;;OAIG;IACH,qBAHU,MAAM,CAGL;IAEX;;;;OAIG;IACH,kBAHU,MAAM,CAGR;IAER;;;;OAIG;IACH,8BAHU,MAAM,CAGI;IAEpB;;;;OAIG;IACH,2BAHU,MAAM,CAGC;IA6OjB;;OAEG;IACH,8BAEC;IAED;;;;;OAKG;IACH,wBAEC;IAED;;;OAGG;IACH,uBAEC;IAED;;;;OAIG;IACH,gBAJW,MAAM,QACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAHW,oBAAoB,GAClB,OAAO,CAQnB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH;QAxB+B,KAAK,EAAzB,UAAU;QACM,CAAC,EAAjB,MAAM;QACU,CAAC,EAAjB,MAAM;QACU,CAAC,EAAjB,MAAM;QACU,KAAK,EAArB,MAAM;QACU,MAAM,EAAtB,MAAM;QACa,MAAM;QACd,IAAI;QACY,UAAU,EAArC,UAAU,MAAM,CAAC;QACD,IAAI,EAApB,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,aAAa,EAA7B,MAAM;QACU,UAAU,EAA1B,MAAM;QACU,cAAc,EAA9B,MAAM;QACyD,aAAa,EAA5E,OAAO,6BAA6B,EAAE,eAAe;QAErC,MAAM,EAAtB,MAAM;QAE+D,KAAK,EAA1E,OAAO,mCAAmC,EAAE,eAAe;QAE4C,SAAS,EAAhH,OAAO,0DAA0D,EAAE,0BAA0B;QAE1E,SAAS;aA8JtC;IAqVD,gBAcC;;CACJ;mCAl6BY,OAAO,4BAA4B,EAAE,oBAAoB;yBACzD,OAAO,iEAAiE,EAAE,UAAU"}
+{"version":3,"file":"GPUProbeClipmap.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/GPUProbeClipmap.js"],"names":[],"mappings":"AAiHA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH;IA4NI;;;;;;;;OAQG;IACH;QAN2B,aAAa,EAA7B,MAAM;QACU,UAAU,EAA1B,MAAM;QACU,OAAO,EAAvB,MAAM;QACU,mBAAmB,EAAnC,MAAM;QACU,gBAAgB,EAAhC,MAAM;OAmGhB;IArUD;;;OAGG;IACH,wBAHU,MAAM,CAGF;IAEd;;;;OAIG;IACH,qBAHU,MAAM,CAGL;IAEX;;;;OAIG;IACH,kBAHU,MAAM,CAGR;IAER;;;;OAIG;IACH,8BAHU,MAAM,CAGI;IAEpB;;;;OAIG;IACH,2BAHU,MAAM,CAGC;IAuSjB;;;;;;;;OAQG;IACH,4CAUC;IAED;;OAEG;IACH,8BAEC;IAED;;;;;OAKG;IACH,wBAEC;IAED;;;OAGG;IACH,uBAEC;IAED;;;;OAIG;IACH,gBAJW,MAAM,QACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAHW,oBAAoB,GAClB,OAAO,CAQnB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH;QAtB+B,KAAK,EAAzB,UAAU;QACM,CAAC,EAAjB,MAAM;QACU,CAAC,EAAjB,MAAM;QACU,CAAC,EAAjB,MAAM;QACU,KAAK,EAArB,MAAM;QACU,MAAM,EAAtB,MAAM;QACa,MAAM;QACd,IAAI;QACY,UAAU,EAArC,UAAU,MAAM,CAAC;QACD,eAAe,EAA/B,MAAM;QACU,UAAU,EAA1B,MAAM;QACU,cAAc,EAA9B,MAAM;QACyD,aAAa,EAA5E,OAAO,6BAA6B,EAAE,eAAe;QAErC,MAAM,EAAtB,MAAM;QAE+D,KAAK,EAA1E,OAAO,mCAAmC,EAAE,eAAe;QAE4C,SAAS,EAAhH,OAAO,0DAA0D,EAAE,0BAA0B;QAE1E,SAAS;aAoOtC;IAydD,gBAcC;;CACJ;mCA1sCY,OAAO,4BAA4B,EAAE,oBAAoB;yBACzD,OAAO,iEAAiE,EAAE,UAAU"}