@woosh/meep-engine 3.54.0 → 3.56.0

package/src/shade/renderer/postprocess/nss/NSS.d.ts

@@ -53,7 +53,7 @@ export class NSS {
      * @returns {number}
      */
     static recommended_jitter_sequence_size(upscale_ratio: number): number;
-    static "__#203@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
+    static "__#200@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
     /**
      * @param {GraphicsContext} graphics
      */

package/src/shade/renderer/postprocess/ssr/prefilter/NOTES.md

@@ -37,10 +37,3 @@ It has drifted against the live pipeline in one way that a reader will not notic
 directory: the à-trous path grew `chunk_ssr_metadata`, and the variance/metadata contract the
 prefilter expects predates it. Reconcile those before wiring the pass in, rather than after.
 
-## Sibling trap, same territory
-
-`graph_build_depth_max_pyramid.js` (also one directory up, also unreferenced) builds a
-**single-channel `r32float`** max-depth chain, while the live `HierarchicalZBuffer` the SSR trace
-actually reads is **two-channel** — `chunk_ffx_sssr_load_depth` reads its `.y`. The two are not
-interchangeable, and swapping one in for the other gives a silently zero `.y` rather than an error.
-That file's own header says the same thing.

package/src/shade/renderer/view/GPUViewContext.d.ts

@@ -1,11 +1,3 @@
-export namespace ViewStats {
-    let VisibleMeshes0: number;
-    let VisibleMeshlets0: number;
-    let VisibleTriangles0: number;
-    let VisibleMeshes1: number;
-    let VisibleMeshlets1: number;
-    let VisibleTriangles1: number;
-}
 /**
  * Represents state of scene rendering from a given point of view
  */
@@ -75,11 +67,6 @@ export class GPUViewContext {
      * @returns {GPUTypedBuffer}
      */
     get uniform_buffer(): GPUTypedBuffer;
-    /**
-     *
-     * @returns {GPUViewVolumetrics}
-     */
-    get volumetrics(): GPUViewVolumetrics;
     /**
      * Unsafe, be sure you understand what you are doing when using this
      * @param {GPUCameraContext} v
@@ -138,7 +125,6 @@ export type GraphicsContext = import("../GraphicsContext.js").GraphicsContext;
 export type GPUSceneContext = import("../scene/GPUSceneContext.js").GPUSceneContext;
 import { HierarchicalZBuffer } from "../hiz/HierarchicalZBuffer.js";
 import { GPUTypedBuffer } from "../buffer/GPUTypedBuffer.js";
-import { GPUViewVolumetrics } from "../volumetrics/GPUViewVolumetrics.js";
 import { GPUCameraContext } from "../camera/GPUCameraContext.js";
 import { VGeoViewCut } from "../geometry/virtual/runtime/VGeoViewCut.js";
 //# sourceMappingURL=GPUViewContext.d.ts.map

package/src/shade/renderer/view/GPUViewContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUViewContext.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/view/GPUViewContext.js"],"names":[],"mappings":";;;;;;;;AAgCA;;GAEG;AACH;IAiPI;;;;;OAKG;IACH,sBAJW,eAAe,SACf,eAAe,UACf,gBAAgB,EAyB1B;IA5QD;;;OAGG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,OAFU,MAAM,CAEL;IAuBX;;;;OAIG;IACH,mBAHW,MAAM,KACN,MAAM,QAiBhB;IAED;;;;OAIG;IACH,aAHW,MAAM,KACN,MAAM,QAQhB;IAED;;;;OAIG;IACH,kBAHW,MAAM,KACN,MAAM,QAOhB;IAED,wEAAwE;IACxE,2BAAqC;IAErC,6BAA6B;IAC7B,8BAEC;IAQD;;;OAGG;IACH,0BAEC;IAED;;;;OAIG;IACH,mBAHW,MAAM,KACN,MAAM,QAUhB;IAgBD;;;OAGG;IACH,kDAEC;IAdD;;;OAGG;IACH,iDAEC;IAgBD;;;OAGG;IACH,qCAEC;IAQD;;;OAGG;IACH,sCAEC;IA4BD;;;OAGG;IACH,mDAEC;IAdD;;;OAGG;IACH,kDAEC;IAyBD;;OAEG;IACH,wCAEC;IAED;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,mEAEC;IAiCD;;;;OAIG;IACH,cAHW,cAAc,GACZ,OAAO,CAWnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED,wBA6BC;IAGD;;;OAGG;IACH,YAFW,eAAe,QAWzB;IAED;;OAEG;IACH,0BAFW,sBAAsB,QAShC;IAED,gBAkBC;IAGL;;;OAGG;IACH,2BAFU,OAAO,CAEwB;;CANxC;qCA1YY,OAAO,wCAAwC,EAAE,sBAAsB;8BACvE,OAAO,uBAAuB,EAAE,eAAe;8BAC/C,OAAO,6BAA6B,EAAE,eAAe;oCAP9B,+BAA+B;+BAHpC,6BAA6B;mCAIzB,sCAAsC;iCAHxC,+BAA+B;4BACpC,4CAA4C"}
+{"version":3,"file":"GPUViewContext.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/view/GPUViewContext.js"],"names":[],"mappings":"AAqBA;;GAEG;AACH;IAmOI;;;;;OAKG;IACH,sBAJW,eAAe,SACf,eAAe,UACf,gBAAgB,EAuB1B;IA5PD;;;OAGG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,OAFU,MAAM,CAEL;IAuBX;;;;OAIG;IACH,mBAHW,MAAM,KACN,MAAM,QAiBhB;IAED;;;;OAIG;IACH,aAHW,MAAM,KACN,MAAM,QAQhB;IAED;;;;OAIG;IACH,kBAHW,MAAM,KACN,MAAM,QAOhB;IAED,wEAAwE;IACxE,2BAAqC;IAErC,6BAA6B;IAC7B,8BAEC;IAQD;;;OAGG;IACH,0BAEC;IAED;;;;OAIG;IACH,mBAHW,MAAM,KACN,MAAM,QAUhB;IAgBD;;;OAGG;IACH,kDAEC;IAdD;;;OAGG;IACH,iDAEC;IAgBD;;;OAGG;IACH,qCAEC;IA4BD;;;OAGG;IACH,mDAEC;IAdD;;;OAGG;IACH,kDAEC;IAyBD;;OAEG;IACH,wCAEC;IAED;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,mEAEC;IA+BD;;;;OAIG;IACH,cAHW,cAAc,GACZ,OAAO,CAWnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED,wBA6BC;IAGD;;;OAGG;IACH,YAFW,eAAe,QAWzB;IAED;;OAEG;IACH,0BAFW,sBAAsB,QAShC;IAED,gBAgBC;IAGL;;;OAGG;IACH,2BAFU,OAAO,CAEwB;;CANxC;qCA9WY,OAAO,wCAAwC,EAAE,sBAAsB;8BACvE,OAAO,uBAAuB,EAAE,eAAe;8BAC/C,OAAO,6BAA6B,EAAE,eAAe;oCAN9B,+BAA+B;+BAHpC,6BAA6B;iCAC3B,+BAA+B;4BACpC,4CAA4C"}

package/src/shade/renderer/view/GPUViewContext.js

@@ -9,7 +9,6 @@ import { GPUTypedBuffer } from "../buffer/GPUTypedBuffer.js";
 import { GPUCameraContext } from "../camera/GPUCameraContext.js";
 import { VGeoViewCut } from "../geometry/virtual/runtime/VGeoViewCut.js";
 import { HierarchicalZBuffer } from "../hiz/HierarchicalZBuffer.js";
-import { GPUViewVolumetrics } from "../volumetrics/GPUViewVolumetrics.js";
 import { VIEW_UNIFORM_STRUCT } from "./VIEW_UNIFORM_STRUCT.js";
 
 /**
@@ -20,16 +19,6 @@ import { VIEW_UNIFORM_STRUCT } from "./VIEW_UNIFORM_STRUCT.js";
 
 let id_counter = 0;
 
-export const ViewStats = {
-    VisibleMeshes0: 0,
-    VisibleMeshlets0: 1,
-    VisibleTriangles0: 2,
-    // second draw pass (after partial hzb)
-    VisibleMeshes1: 3,
-    VisibleMeshlets1: 4,
-    VisibleTriangles1: 5,
-}
-
 /**
  * Represents state of scene rendering from a given point of view
  */
@@ -188,20 +177,6 @@ export class GPUViewContext {
         return this.#uniform_buffer;
     }
 
-    /**
-     * Per-view volumetric fog (froxel LUTs + integration).
-     * @type {GPUViewVolumetrics}
-     */
-    #volumetrics;
-
-    /**
-     *
-     * @returns {GPUViewVolumetrics}
-     */
-    get volumetrics() {
-        return this.#volumetrics;
-    }
-
 
     /**
      * What is that we're drawing?
@@ -299,8 +274,6 @@ export class GPUViewContext {
 
         this.#previous_camera_state = camera.clone();
 
-        this.#volumetrics = new GPUViewVolumetrics(this, device);
-
         this.#virtual_geometry_cut = new VGeoViewCut({ device, label: this.label });
 
     }
@@ -403,8 +376,6 @@ export class GPUViewContext {
 
         this.#hierarchical_z_buffer.destroy();
 
-        this.#volumetrics.destroy();
-
         this.#virtual_geometry_cut.destroy();
     }
 }

package/src/shade/renderer/view/ViewManager.d.ts

@@ -37,7 +37,7 @@ export class ViewManager {
     obtain(view: View): GPUViewContext;
     /**
      * Release the GPU context cached for a view, destroying its GPU resources (view uniform
-     * buffer, hierarchical-Z buffer, volumetrics, and the previous-frame camera clone), and drop
+     * buffer, hierarchical-Z buffer, and the previous-frame camera clone), and drop
      * the cache entry. The cache keys on the View object with no GC path, so a context whose view
      * is gone (e.g. an evicted shadowmap face) must be released explicitly or its buffers leak.
      * No-op if the view was never obtained.

package/src/shade/renderer/view/ViewManager.js

@@ -110,7 +110,7 @@ export class ViewManager {
 
     /**
      * Release the GPU context cached for a view, destroying its GPU resources (view uniform
-     * buffer, hierarchical-Z buffer, volumetrics, and the previous-frame camera clone), and drop
+     * buffer, hierarchical-Z buffer, and the previous-frame camera clone), and drop
      * the cache entry. The cache keys on the View object with no GC path, so a context whose view
      * is gone (e.g. an evicted shadowmap face) must be released explicitly or its buffers leak.
      * No-op if the view was never obtained.

package/src/shade/renderer/volumetrics/GPUViewVolumetrics.d.ts

@@ -1,10 +1,13 @@
+/**
+ * @typedef {import("../../../engine/graphics/render/frame_graph/FrameGraph.js").FrameGraph} FrameGraph
+ * @typedef {import("../view/GPUViewContext.js").GPUViewContext} GPUViewContext
+ */
 export class GPUViewVolumetrics {
     /**
      *
-     * @param {GPUViewContext} view
      * @param {GPUDevice} device
      */
-    constructor(view: GPUViewContext, device: GPUDevice);
+    constructor(device: GPUDevice);
     /**
      * @param {boolean} v
      */
@@ -13,6 +16,31 @@ export class GPUViewVolumetrics {
      * @returns {boolean}
      */
     get taa_enabled(): boolean;
+    /**
+     * @param {number} v positive integer
+     */
+    set tile_size(v: number);
+    /**
+     * Size of one froxel in XY, in screen pixels. Smaller is finer fog detail at a cost that grows
+     * with the inverse square. The grid is resized on the next update and the TAA history dropped,
+     * so the frame after a change starts its accumulation over.
+     *
+     * The grid's XY extent, `ceil(view resolution / tile_size)`, must stay within the device's
+     * `maxTextureDimension3D`.
+     * @returns {number}
+     */
+    get tile_size(): number;
+    /**
+     * @param {number} v integer, at least 2 (the depth curve needs a first and a last slice) and at
+     * most the device's `maxTextureDimension3D`
+     */
+    set resolution_z(v: number);
+    /**
+     * Number of froxel slices between the camera near and {@link froxel_far}. Cost grows linearly.
+     * The grid is resized on the next update and the TAA history dropped, as for {@link tile_size}.
+     * @returns {number}
+     */
+    get resolution_z(): number;
     /**
      * @param {number} v
      */
@@ -25,11 +53,19 @@ export class GPUViewVolumetrics {
      * @returns {GPUIrradianceClipmap}
      */
     get irradiance_clipmap(): GPUIrradianceClipmap;
+    /**
+     * Drop the TAA history, so the next frame integrates without blending against what came before
+     * it. For a cut the grid, the depth curve and the view cannot see: the camera jumped, or the
+     * scene changed significantly.
+     */
+    reset_history(): void;
     destroy(): void;
     /**
      *
      * @param {Object} options
      * @param {FrameGraph} options.graph
+     * @param {GPUViewContext} options.view what the fog is seen from: its resolution sizes the
+     *   froxel grid, its camera places it, its scene fills it
      * @param {number} options.light_cluster_data
      * @param {number} options.light_cluster_lookup
      * @param {number} options.light_cluster_parameters
@@ -39,8 +75,9 @@ export class GPUViewVolumetrics {
      * @param {import("../global_illumination/lpv/GPULightProbeVolume.js").GPULightProbeVolume} [options.lpv]
      * @returns {{resolved: number, metadata: number, irradiance: {Y: number, CoCg: number, uniform: number}}}
      */
-    graph_update({ graph, light_cluster_data, light_cluster_lookup, light_cluster_parameters, shadowmap_atlas, shader_switches, brick4, lpv, }: {
+    graph_update({ graph, view, light_cluster_data, light_cluster_lookup, light_cluster_parameters, shadowmap_atlas, shader_switches, brick4, lpv, }: {
         graph: FrameGraph;
+        view: GPUViewContext;
         light_cluster_data: number;
         light_cluster_lookup: number;
         light_cluster_parameters: number;

package/src/shade/renderer/volumetrics/GPUViewVolumetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUViewVolumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/GPUViewVolumetrics.js"],"names":[],"mappings":"AAiCA;IAiJI;;;;OAIG;IACH,kBAHW,cAAc,qBA2CxB;IA1JD;;OAEG;IACH,4BAOC;IAjBD;;OAEG;IACH,2BAEC;IAsCD;;OAEG;IACH,0BAEC;IAZD;;OAEG;IACH,yBAEC;IA0HD;;OAEG;IACH,+CAEC;IAED,gBAcC;IA6ND;;;;;;;;;;;;OAYG;IACH;QAV+B,KAAK,EAAzB,UAAU;QACM,kBAAkB,EAAlC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,wBAAwB,EAAxC,MAAM;QACU,eAAe,EAA/B,MAAM;QACoB,eAAe,GAAzC,eAAe;QACoE,MAAM,GAAzF,OAAO,iDAAiD,EAAE,cAAc;QACkB,GAAG,GAA7F,OAAO,mDAAmD,EAAE,mBAAmB;QAC7E;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAsGxG;;CAEJ;yBA9iBY,OAAO,2DAA2D,EAAE,UAAU;6BAC9E,OAAO,2BAA2B,EAAE,cAAc;qCAZ1B,8CAA8C;gCAXnD,uCAAuC"}
+{"version":3,"file":"GPUViewVolumetrics.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/GPUViewVolumetrics.js"],"names":[],"mappings":"AAuBA;;;GAGG;AAEH;IA0MI;;;OAGG;IACH,+BAuCC;IA/MD;;OAEG;IACH,4BAOC;IAjBD;;OAEG;IACH,2BAEC;IAuCD;;OAEG;IACH,yBAIC;IApBD;;;;;;;;OAQG;IACH,wBAEC;IAoBD;;;OAGG;IACH,4BAMC;IAnBD;;;;OAIG;IACH,2BAEC;IAsCD;;OAEG;IACH,0BAEC;IAZD;;OAEG;IACH,yBAEC;IAwHD;;OAEG;IACH,+CAEC;IAED;;;;OAIG;IACH,sBAEC;IAED,gBAcC;IAsOD;;;;;;;;;;;;;;OAcG;IACH;QAZ+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QAEE,kBAAkB,EAAlC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,wBAAwB,EAAxC,MAAM;QACU,eAAe,EAA/B,MAAM;QACoB,eAAe,GAAzC,eAAe;QACoE,MAAM,GAAzF,OAAO,iDAAiD,EAAE,cAAc;QACkB,GAAG,GAA7F,OAAO,mDAAmD,EAAE,mBAAmB;QAC7E;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CA6GxG;;CAEJ;yBA3nBY,OAAO,2DAA2D,EAAE,UAAU;6BAC9E,OAAO,2BAA2B,EAAE,cAAc;qCAX1B,8CAA8C;gCAXnD,uCAAuC"}