@woosh/meep-engine 3.46.0 → 3.49.0

package/src/shade/renderer/pool/TransientResourcePool.d.ts

@@ -13,8 +13,15 @@
  * immediately (within and across frames) — there is no frames-in-flight reuse gate; only
  * *destruction* is deferred, by {@link update}.
  *
+ * A record carries what the pool is ordered and accounted by, cached when its resource enters the
+ * pool: `size` here, and whatever else {@link describeRecord} adds for {@link compare} and
+ * {@link find}. A resource can be a platform object — a `GPUBuffer`'s `size` and `usage` are native
+ * reads — and the binary search and scan visit records many times a frame, so they read the record,
+ * never the resource.
+ *
  * @typedef {object} PoolRecord
  * @property {*} resource the pooled resource (or null while the record sits on the free-list)
+ * @property {number} size {@link sizeOf} the resource, as it was when it entered the pool
  * @property {number} last_used_frame frame the resource was last released into the pool
  * @property {boolean} referenced CLOCK second-chance bit; set on release and on reuse
  */
@@ -83,6 +90,13 @@ export class TransientResourcePool {
      * @abstract
      */
     destroyResource(resource: any): void;
+    /**
+     * Cache on a record entering the pool whatever {@link compare} and {@link find} read beyond `size`,
+     * so neither has to ask the resource. Called on {@link release} once `resource` and `size` are set,
+     * and before the record is placed in order. Default: nothing.
+     * @param {PoolRecord} record
+     */
+    describeRecord(record: PoolRecord): void;
     /**
      * Hook invoked at the end of {@link get}, after the resource is acquired and tracked. Subclasses
      * override it for post-acquire work (clear-on-reuse, postcondition asserts). Default: nothing.
@@ -147,12 +161,22 @@ export class TransientResourcePool {
  * Reuse safety: within WebGPU's single in-order queue, reusing a GPU-only transient is safe
  * immediately (within and across frames) — there is no frames-in-flight reuse gate; only
  * *destruction* is deferred, by {@link update }.
+ *
+ * A record carries what the pool is ordered and accounted by, cached when its resource enters the
+ * pool: `size` here, and whatever else {@link describeRecord } adds for {@link compare } and
+ * {@link find }. A resource can be a platform object — a `GPUBuffer`'s `size` and `usage` are native
+ * reads — and the binary search and scan visit records many times a frame, so they read the record,
+ * never the resource.
  */
 export type PoolRecord = {
     /**
      * the pooled resource (or null while the record sits on the free-list)
      */
     resource: any;
+    /**
+     * {@link sizeOf } the resource, as it was when it entered the pool
+     */
+    size: number;
     /**
      * frame the resource was last released into the pool
      */

package/src/shade/renderer/pool/TransientResourcePool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransientResourcePool.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/pool/TransientResourcePool.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;IAII,+EAA+E;IAC/E,wBADqE,MAAM,CACjC;IAE1C,6EAA6E;IAC7E,mBADmE,MAAM,CAClD;IAEvB,oEAAoE;IACpE,6BAD0D,MAAM,CAChC;IAEhC,sGAAsG;IACtG,uBAD4F,MAAM,CACtE;IAE5B,6EAA6E;IAC7E,mBADmE,MAAM,CACjD;IAExB,0EAA0E;IAC1E,mBADgE,MAAM,CAC9C;IAExB;;;;OAIG;IACH,SAFU,UAAU,EAAE,CAET;IAEb;;;OAGG;IACH,OAFU,QAAM,CAEE;IAElB;;;;OAIG;IACH,kBAFU,OAAO,CAEQ;IAyBzB;;;;;OAKG;IACH,uBAHa,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,WALW,UAAU,KACV,UAAU,GACR,MAAM,CAKlB;IAED;;;;;OAKG;IACH,uBAHa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,2BAEC;IAED;;;;OAIG;IACH,qCAEC;IAED;;;;;;;OAOG;IACH,qDAHW,OAAO,uBAIjB;IAID,uBAEC;IAED,oBAEC;IAqBD;;;;;;;OAOG;IACH,yCAsCC;IAED;;;;;;OAMG;IACH,wBAFa,OAAO,CA0BnB;IAED;;;;;OAKG;IACH,eAsDC;IAED;;OAEG;IACH,+BAEC;IAED;;OAEG;IACH,gBAcC;IAED;;;OAGG;IACH,yBAsCC;;CACJ;;;;;;;;;;;;;;;;;;;;;;;;qBAnXa,MAAM;;;;gBACN,OAAO"}
+{"version":3,"file":"TransientResourcePool.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/pool/TransientResourcePool.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;IAII,+EAA+E;IAC/E,wBADqE,MAAM,CACjC;IAE1C,6EAA6E;IAC7E,mBADmE,MAAM,CAClD;IAEvB,oEAAoE;IACpE,6BAD0D,MAAM,CAChC;IAEhC,sGAAsG;IACtG,uBAD4F,MAAM,CACtE;IAE5B,6EAA6E;IAC7E,mBADmE,MAAM,CACjD;IAExB,0EAA0E;IAC1E,mBADgE,MAAM,CAC9C;IAExB;;;;OAIG;IACH,SAFU,UAAU,EAAE,CAET;IAEb;;;OAGG;IACH,OAFU,QAAM,CAEE;IAElB;;;;OAIG;IACH,kBAFU,OAAO,CAEQ;IAyBzB;;;;;OAKG;IACH,uBAHa,MAAM,CAKlB;IAED;;;;;;OAMG;IACH,WALW,UAAU,KACV,UAAU,GACR,MAAM,CAKlB;IAED;;;;;OAKG;IACH,uBAHa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,2BAEC;IAED;;;;OAIG;IACH,qCAEC;IAED;;;;;OAKG;IACH,uBAFW,UAAU,QAGpB;IAED;;;;;;;OAOG;IACH,qDAHW,OAAO,uBAIjB;IAID,uBAEC;IAED,oBAEC;IAqBD;;;;;;;OAOG;IACH,yCA0CC;IAED;;;;;;OAMG;IACH,wBAFa,OAAO,CAiCnB;IAED;;;;;OAKG;IACH,eAsDC;IAED;;OAEG;IACH,+BAEC;IAED;;OAEG;IACH,gBAcC;IAED;;;OAGG;IACH,yBAwCC;;CACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA1Ya,MAAM;;;;qBACN,MAAM;;;;gBACN,OAAO"}

package/src/shade/renderer/pool/TransientResourcePool.js

@@ -1,4 +1,6 @@
 import { assert } from "../../../core/assert.js";
+import { array_insert_at } from "../../../core/collection/array/array_insert_at.js";
+import { array_remove_at } from "../../../core/collection/array/array_remove_at.js";
 import { binarySearchHighIndex } from "../../../core/collection/array/binarySearchHighIndex.js";
 
 /**
@@ -16,8 +18,15 @@ import { binarySearchHighIndex } from "../../../core/collection/array/binarySear
  * immediately (within and across frames) — there is no frames-in-flight reuse gate; only
  * *destruction* is deferred, by {@link update}.
  *
+ * A record carries what the pool is ordered and accounted by, cached when its resource enters the
+ * pool: `size` here, and whatever else {@link describeRecord} adds for {@link compare} and
+ * {@link find}. A resource can be a platform object — a `GPUBuffer`'s `size` and `usage` are native
+ * reads — and the binary search and scan visit records many times a frame, so they read the record,
+ * never the resource.
+ *
  * @typedef {object} PoolRecord
  * @property {*} resource the pooled resource (or null while the record sits on the free-list)
+ * @property {number} size {@link sizeOf} the resource, as it was when it entered the pool
  * @property {number} last_used_frame frame the resource was last released into the pool
  * @property {boolean} referenced CLOCK second-chance bit; set on release and on reuse
  */
@@ -137,6 +146,15 @@ export class TransientResourcePool {
         throw new Error('TransientResourcePool.destroyResource is abstract');
     }
 
+    /**
+     * Cache on a record entering the pool whatever {@link compare} and {@link find} read beyond `size`,
+     * so neither has to ask the resource. Called on {@link release} once `resource` and `size` are set,
+     * and before the record is placed in order. Default: nothing.
+     * @param {PoolRecord} record
+     */
+    describeRecord(record) {
+    }
+
     /**
      * Hook invoked at the end of {@link get}, after the resource is acquired and tracked. Subclasses
      * override it for post-acquire work (clear-on-reuse, postcondition asserts). Default: nothing.
@@ -164,7 +182,7 @@ export class TransientResourcePool {
         const record = this.#free_records.pop();
 
         if (record === undefined) {
-            return { resource: null, last_used_frame: 0, referenced: false };
+            return { resource: null, size: 0, last_used_frame: 0, referenced: false };
         }
 
         return record;
@@ -191,21 +209,25 @@ export class TransientResourcePool {
         const index = this.find(descriptor);
 
         let resource;
+        let size;
         let reused;
 
         if (index !== -1) {
             const record = this.records[index];
 
             resource = record.resource;
+            size = record.size;
 
-            this.records.splice(index, 1);
-            this.#bytes_pooled -= this.sizeOf(resource);
+            array_remove_at(this.records, index);
+            this.#bytes_pooled -= size;
 
             this.#recycle_record(record);
 
             reused = true;
         } else {
             resource = this.make(descriptor);
+            size = this.sizeOf(resource);
+
             this.#surge++;
 
             reused = false;
@@ -214,7 +236,7 @@ export class TransientResourcePool {
         assert.notOk(this.bound.has(resource), 'resource is already bound');
 
         this.bound.add(resource);
-        this.#bytes_bound += this.sizeOf(resource);
+        this.#bytes_bound += size;
 
         this.afterAcquire(resource, descriptor, reused, context);
 
@@ -238,18 +260,25 @@ export class TransientResourcePool {
         }
 
         this.bound.delete(resource);
-        this.#bytes_bound -= this.sizeOf(resource);
+
+        // the one time a pooling asks the resource its size: the record keeps it from here on
+        const size = this.sizeOf(resource);
+
+        this.#bytes_bound -= size;
 
         const record = this.#take_record();
 
         record.resource = resource;
+        record.size = size;
         record.last_used_frame = this.#frame;
         record.referenced = true;
 
+        this.describeRecord(record);
+
         const index = binarySearchHighIndex(this.records, record, this.#compare);
 
-        this.records.splice(index, 0, record);
-        this.#bytes_pooled += this.sizeOf(resource);
+        array_insert_at(this.records, index, record);
+        this.#bytes_pooled += size;
 
         if (this.debug_invariants) {
             this.assertInvariants();
@@ -294,9 +323,9 @@ export class TransientResourcePool {
 
                 if (reclaim_budget > 0 && (under_pressure || idle_too_long)) {
                     const resource = record.resource;
-                    const size = this.sizeOf(resource);
+                    const size = record.size;
 
-                    records.splice(cursor, 1);
+                    array_remove_at(records, cursor);
                     this.#bytes_pooled -= size;
                     over_budget -= size;
                     record_count--;
@@ -371,7 +400,9 @@ export class TransientResourcePool {
                 assert.lessThanOrEqual(this.compare(record, records[i + 1]), 0, `records not sorted at index ${i}`);
             }
 
-            pooled_bytes += this.sizeOf(record.resource);
+            assert.equal(record.size, this.sizeOf(record.resource), `records[${i}].size is not its resource's`);
+
+            pooled_bytes += record.size;
         }
 
         assert.equal(this.#bytes_pooled, pooled_bytes, 'bytes_pooled drifted from actual pooled total');

package/src/shade/renderer/postprocess/bloom/graph_postprocess_bloom.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Offer the pipelines {@link graph_postprocess_bloom} draws with — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_postprocess_bloom_pipelines(enquiry: PipelineEnquiry): void;
 /**
  *
  * @param {Object} options
@@ -17,4 +23,5 @@ export function graph_postprocess_bloom({ graph, input, resolution, intensity, m
     composited: number;
     downsampled: any;
 };
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=graph_postprocess_bloom.d.ts.map

package/src/shade/renderer/postprocess/bloom/graph_postprocess_bloom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_postprocess_bloom.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/bloom/graph_postprocess_bloom.js"],"names":[],"mappings":"AAqGA;;;;;;;;GAQG;AACH;IAN+B,KAAK;IACT,KAAK,EAArB,MAAM;IACY,UAAU,EAA5B,MAAM,EAAE;IACS,SAAS,GAA1B,MAAM;IACW,IAAI,GAArB,MAAM;;;;EAiDhB"}
+{"version":3,"file":"graph_postprocess_bloom.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/bloom/graph_postprocess_bloom.js"],"names":[],"mappings":"AA2GA;;;;GAIG;AACH,6DAFW,eAAe,QAOzB;AAED;;;;;;;;GAQG;AACH;IAN+B,KAAK;IACT,KAAK,EAArB,MAAM;IACY,UAAU,EAA5B,MAAM,EAAE;IACS,SAAS,GAA1B,MAAM;IACW,IAAI,GAArB,MAAM;;;;EAiDhB;8BAjKY,OAAO,6CAA6C,EAAE,eAAe"}

package/src/shade/renderer/postprocess/bloom/graph_postprocess_bloom.js

@@ -5,10 +5,16 @@ import { SAMPLER_LINEAR_UPSCALE } from "../../texture/SAMPLER_LINEAR_UPSCALE.js"
 import { bloom_chain_resolution } from "./bloom_chain_resolution.js";
 import { BLOOM_PERSISTENCE } from "./BLOOM_PERSISTENCE.js";
 import { BLOOM_TEXTURE_FORMAT } from "./BLOOM_TEXTURE_FORMAT.js";
+import { downsample_karis } from "./downsample_karis.js";
+import { downsample_standard } from "./downsample_standard.js";
 import { graph_bloom_downsample } from "./graph_bloom_downsample.js";
 import { shader_bloom_mix } from "./shader_bloom_mix.js";
 import { upsample_blur } from "./upsample_blur.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
 /**
  *
  * @param {Object} options
@@ -99,6 +105,18 @@ function graph_bloom_upsample({
     return upscale_data.output;
 }
 
+/**
+ * Offer the pipelines {@link graph_postprocess_bloom} draws with — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_postprocess_bloom_pipelines(enquiry) {
+    enquiry.render.push(downsample_karis.pipeline);
+    enquiry.render.push(downsample_standard.pipeline);
+    enquiry.render.push(upsample_blur.pipeline);
+    enquiry.render.push(shader_bloom_mix.pipeline);
+}
+
 /**
  *
  * @param {Object} options

package/src/shade/renderer/postprocess/denoise/LigmaDenoiser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LigmaDenoiser.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/denoise/LigmaDenoiser.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH;IASI;;;OAGG;IACH,sCAYC;IAED;;;OAGG;IACH,qCAMC;IAED;;;;OAIG;IACH,yBAHW,MAAM,qBAOhB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH;QAf+B,KAAK;QACT,WAAW,EAA3B,MAAM;QACU,mBAAmB,EAAnC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QACU,KAAK,EAArB,MAAM;QACoB,cAAc;QACd,eAAe;QACzB,eAAe,EAA/B,MAAM;QACY,MAAM,EAAxB,MAAM,EAAE;QACU,UAAU,EAA5B,MAAM,EAAE;QACU,eAAe,GAAjC,OAAO;YA0IjB;;CACJ"}
+{"version":3,"file":"LigmaDenoiser.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/denoise/LigmaDenoiser.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH;IASI;;;OAGG;IACH,sCAYC;IAED;;;OAGG;IACH,qCAMC;IAED;;;;OAIG;IACH,yBAHW,MAAM,qBAOhB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH;QAf+B,KAAK;QACT,WAAW,EAA3B,MAAM;QACU,mBAAmB,EAAnC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,oBAAoB,EAApC,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QACU,KAAK,EAArB,MAAM;QACoB,cAAc;QACd,eAAe;QACzB,eAAe,EAA/B,MAAM;QACY,MAAM,EAAxB,MAAM,EAAE;QACU,UAAU,EAA5B,MAAM,EAAE;QACU,eAAe,GAAjC,OAAO;YA0IjB;;CACJ"}

package/src/shade/renderer/postprocess/denoise/LigmaDenoiser.js

@@ -5,6 +5,7 @@ import { TextureViewDescriptor } from "../../../descriptor/texture/TextureViewDe
 import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
 import { TextureResourceDescriptor } from "../../../device/graph/TextureResourceDescriptor.js";
 import { STRUCT_DISPATCH_COMPUTE_COMMAND } from "../../gpu_primitive/indirect/STRUCT_DISPATCH_COMPUTE_COMMAND.js";
+import { vec2f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { graph_atorus_denoise_luma } from "./graph_atorus_denoise_luma.js";
 import { shader_temporal_reprojection_luma } from "./shader_temporal_reprojection_luma.js";
 

package/src/shade/renderer/postprocess/denoise/shader_temporal_reprojection_luma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_temporal_reprojection_luma.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/denoise/shader_temporal_reprojection_luma.js"],"names":[],"mappings":"AAgSA;;;GAGG;AACH,8DAII;8BAzR0B,+BAA+B"}
+{"version":3,"file":"shader_temporal_reprojection_luma.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/denoise/shader_temporal_reprojection_luma.js"],"names":[],"mappings":"AAkSA;;;GAGG;AACH,8DAII;8BA3R0B,+BAA+B"}

package/src/shade/renderer/postprocess/denoise/shader_temporal_reprojection_luma.js

@@ -16,6 +16,8 @@ import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
+import { atomic_u32, vec2u } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
 import { chunk_clip_history_colour_YCoCg } from "../taa/chunk_clip_history_colour_YCoCg.js";
 import { chunk_taa_get_velocity } from "../velocity/chunk_taa_get_velocity.js";
 import { chunk_compute_reprojection_weight } from "./chunk_compute_reprojection_weight.js";
@@ -38,10 +40,10 @@ resources.createGroup()
     .addUniform("camera_previous",CAMERA_UNIFORM_STRUCT);
 
 resources.createGroup()
-    .addStorageBuffer("DenoiseTileCount","atomic<u32>", true)
-    .addStorageBuffer("DenoiseTileData","array<vec2<u32>>", true)
-    .addStorageBuffer("ShadowTileCount","atomic<u32>", true)
-    .addStorageBuffer("ShadowTileData","array<vec2<u32>>", true);
+    .addStorageBuffer("DenoiseTileCount", atomic_u32, true)
+    .addStorageBuffer("DenoiseTileData", WebGPUArray.from(vec2u), true)
+    .addStorageBuffer("ShadowTileCount", atomic_u32, true)
+    .addStorageBuffer("ShadowTileData", WebGPUArray.from(vec2u), true);
 
 
 const body = CodeChunk.from(

package/src/shade/renderer/postprocess/eye/GPUCameraExposureManager.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
 /**
  * Calculates exposure for eye adaptation
  */
@@ -34,6 +37,13 @@ export class GPUCameraExposureManager {
      */
     exposure_compensation: number;
     destroy(): void;
+    /**
+     * Offer the pipelines {@link update} meters and adapts with — see {@link PipelineEnquiry}.
+     * {@link unadapted} dispatches none.
+     *
+     * @param {PipelineEnquiry} enquiry
+     */
+    enquirePipelines(enquiry: PipelineEnquiry): void;
     /**
      *
      * @param {Object} options
@@ -57,4 +67,5 @@ export class GPUCameraExposureManager {
     }): any;
     #private;
 }
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=GPUCameraExposureManager.d.ts.map

package/src/shade/renderer/postprocess/eye/GPUCameraExposureManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUCameraExposureManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/eye/GPUCameraExposureManager.js"],"names":[],"mappings":"AAUA;;GAEG;AACH;IAuCI;;;OAGG;IACH,+BAcC;IAhDD;;;;OAIG;IACH,qBAFU,MAAM,CAEU;IAE1B;;;;OAIG;IACH,uBAFU,MAAM,CAEY;IAE5B;;;;;OAKG;IACH,yBAFU,MAAM,CAEc;IAE9B;;;;;OAKG;IACH,uBAFU,MAAM,CAEY;IAsB5B,gBAIC;IAED;;;;;OAKG;IACH;QAH+B,KAAK;QACxB,MAAM,CAyCjB;IAED;;;;;;OAMG;IACH;QAJ+B,KAAK;QACT,WAAW,EAA3B,MAAM;QACW,kBAAkB,GAAnC,MAAM;YAwJhB;;CAEJ"}
+{"version":3,"file":"GPUCameraExposureManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/eye/GPUCameraExposureManager.js"],"names":[],"mappings":"AAUA;;GAEG;AAEH;;GAEG;AACH;IAuCI;;;OAGG;IACH,+BAcC;IAhDD;;;;OAIG;IACH,qBAFU,MAAM,CAEU;IAE1B;;;;OAIG;IACH,uBAFU,MAAM,CAEY;IAE5B;;;;;OAKG;IACH,yBAFU,MAAM,CAEc;IAE9B;;;;;OAKG;IACH,uBAFU,MAAM,CAEY;IAsB5B,gBAIC;IAED;;;;;OAKG;IACH,0BAFW,eAAe,QAMzB;IAED;;;;;OAKG;IACH;QAH+B,KAAK;QACxB,MAAM,CAyCjB;IAED;;;;;;OAMG;IACH;QAJ+B,KAAK;QACT,WAAW,EAA3B,MAAM;QACW,kBAAkB,GAAnC,MAAM;YAwJhB;;CAEJ;8BAjSY,OAAO,6CAA6C,EAAE,eAAe"}

package/src/shade/renderer/postprocess/eye/GPUCameraExposureManager.js

@@ -8,6 +8,10 @@ import { shader_autoexposure_adapt } from "./shader_autoexposure_adapt.js";
 import { shader_autoexposure_build_histogram } from "./shader_autoexposure_build_histogram.js";
 import { shader_autoexposure_read_histogram } from "./shader_autoexposure_read_histogram.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
 /**
  * Calculates exposure for eye adaptation
  */
@@ -76,6 +80,18 @@ export class GPUCameraExposureManager {
         }
     }
 
+    /**
+     * Offer the pipelines {@link update} meters and adapts with — see {@link PipelineEnquiry}.
+     * {@link unadapted} dispatches none.
+     *
+     * @param {PipelineEnquiry} enquiry
+     */
+    enquirePipelines(enquiry) {
+        enquiry.compute.push(shader_autoexposure_build_histogram.pipeline);
+        enquiry.compute.push(shader_autoexposure_read_histogram.pipeline);
+        enquiry.compute.push(shader_autoexposure_adapt.pipeline);
+    }
+
     /**
      *
      * @param {Object} options

package/src/shade/renderer/postprocess/gtao/GTAO.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
 export class GTAO {
     /**
      *
@@ -10,6 +13,12 @@ export class GTAO {
      * @param {number} y
      */
     resize(x: number, y: number): void;
+    /**
+     * Offer the pipelines {@link graph_pass} draws with — see {@link PipelineEnquiry}.
+     *
+     * @param {PipelineEnquiry} enquiry
+     */
+    enquirePipelines(enquiry: PipelineEnquiry): void;
     /**
      *
      * @param {FrameGraph} graph
@@ -32,4 +41,5 @@ export class GTAO {
     };
     #private;
 }
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=GTAO.d.ts.map

package/src/shade/renderer/postprocess/gtao/GTAO.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GTAO.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/GTAO.js"],"names":[],"mappings":"AAQA;IAQI;;;OAGG;IACH,uCAUC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QAKhB;IAED;;;;;;;;;;;;;;OAcG;IACH,8JAFa;QAAC,SAAS,EAAC,MAAM,CAAC;QAAC,YAAY,EAAC,MAAM,CAAC;QAAC,gBAAgB,EAAC,MAAM,CAAA;KAAC,CA6F5E;;CACJ"}
+{"version":3,"file":"GTAO.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/GTAO.js"],"names":[],"mappings":"AAQA;;GAEG;AAEH;IAQI;;;OAGG;IACH,uCAUC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QAKhB;IAED;;;;OAIG;IACH,0BAFW,eAAe,QAOzB;IAED;;;;;;;;;;;;;;OAcG;IACH,8JAFa;QAAC,SAAS,EAAC,MAAM,CAAC;QAAC,YAAY,EAAC,MAAM,CAAC;QAAC,gBAAgB,EAAC,MAAM,CAAA;KAAC,CA6F5E;;CACJ;8BA5JY,OAAO,6CAA6C,EAAE,eAAe"}

package/src/shade/renderer/postprocess/gtao/GTAO.js

@@ -6,6 +6,10 @@ import { ao_reproject_shader } from "./ao_reproject_shader.js";
 import { fragment_shader_gtao } from "./fragment_shader_gtao.js";
 import { shader_ao_composit } from "./graph_composit_ao_to_gBuffer.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
 export class GTAO {
 
     /**
@@ -40,6 +44,18 @@ export class GTAO {
         this.#history.forEach(t => t.resize(x, y));
     }
 
+    /**
+     * Offer the pipelines {@link graph_pass} draws with — see {@link PipelineEnquiry}.
+     *
+     * @param {PipelineEnquiry} enquiry
+     */
+    enquirePipelines(enquiry) {
+        enquiry.render.push(fragment_shader_gtao.pipeline);
+        enquiry.render.push(shader_denoise_luminance_spatial.pipeline);
+        enquiry.render.push(ao_reproject_shader.pipeline);
+        enquiry.render.push(shader_ao_composit.pipeline);
+    }
+
     /**
      *
      * @param {FrameGraph} graph

package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fragment_shader_gtao.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/fragment_shader_gtao.js"],"names":[],"mappings":"AAiTA,+CA6BG;sCApTI,qBAAqB;0CAArB,qBAAqB;mCAArB,qBAAqB;4BAZA,6BAA6B"}
+{"version":3,"file":"fragment_shader_gtao.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/fragment_shader_gtao.js"],"names":[],"mappings":"AAuUA,+CA6BG;sCAzUI,qBAAqB;0CAArB,qBAAqB;mCAArB,qBAAqB;4BAZA,6BAA6B"}

package/src/shade/renderer/postprocess/gtao/fragment_shader_gtao.js

@@ -2,6 +2,7 @@ import { BlendState } from "../../../descriptor/blend/BlendState.js";
 import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
 import { DEPTH_STENCIL_FOREGROUND_ONLY } from "../../depth/DEPTH_STENCIL_FOREGROUND_ONLY.js";
 import { chunk_project_position_from_depth } from "../../shader/chunk/camera/chunk_project_position_from_depth.js";
+import { chunk_project_view_position_from_depth } from "../../shader/chunk/camera/chunk_project_view_position_from_depth.js";
 import { chunk_get_view_space_depth } from "../../shader/chunk/depth/chunk_get_view_space_depth.js";
 import { chunk_mat4_extract_position } from "../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import { chunk_decode_g_buffer_normal } from "../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
@@ -50,6 +51,20 @@ export { GTAO_DEPTH_MIP_LEVELS, GTAO_EFFECT_FALLOFF_RANGE, GTAO_EFFECT_RADIUS };
 
 /*
 based on https://github.com/GameTechDev/XeGTAO/tree/e7698f874e90f2516fca26c696ec3cd2c70e505a
+
+The horizon search reconstructs its samples in view space (2026-10-16). Measured on an RTX 4090 (Chrome,
+D3D12), the VSM playground's courtyard, Medium quality, TAA on. Arms swapped by pipeline every 4 frames
+inside one capture, 3 captures of 6 s each. GTAO's time, and the old world-space path against the new:
+
+                   near view (walls close)    overview (geometry far)
+    1898 x 982     185 µs, old/new 1.00       84 µs, old/new 1.055 (p10 1.049)
+    2538 x 1342    364 µs, old/new 1.00       179 µs, old/new 1.041 (p10 1.048-1.055)
+
+Up close a 1 m radius spreads the 16 samples over hundreds of pixels and the pass waits on depth fetches:
+deleting the reconstruction outright bought nothing there (1.008, 1.010). At a distance the fetches hit
+cache and the arithmetic shows: deleting it bought 9.4% and 6.6%, and the view-space path recovers half.
+The same frame replayed through both: visibility differs in 0.1-0.18% of pixels, by one f16 step
+(0.00098); bent normals in 3-7% of pixels, by at most 0.014 degrees.
  */
 const body = CodeChunk.from(
 //language=WGSL
@@ -96,9 +111,15 @@ fn main(
     viewspaceZ *= 0.99999;     // this is good for FP32 depth buffer
     
     let position_ws = project_position_from_depth(uv, device_depth, camera.view_projection_matrix_inverse );
-    let view_position_ws = mat4_extract_position(camera.view_matrix_inverse);    
+    let view_position_ws = mat4_extract_position(camera.view_matrix_inverse);
     let view_direction_ws = normalize(view_position_ws - position_ws);
-    
+
+    // The horizon search below only measures distances and angles, which the view rotation preserves, so it
+    // runs in view space: a sample there is 4 multiply-adds from the projection's inverse instead of 16
+    // from the view-projection's. Slices and the bent normal stay in world space.
+    let position_vs = project_view_position_from_depth(uv, device_depth, camera.projection_matrix_inverse);
+    let view_direction_vs = normalize(-position_vs);
+
     let view_normal_ws = decode_g_buffer_normal(textureLoad(tNormal, texel_position_u32, 0).xy); // shading normal
 
     let noiseTexel = spatio_temporal_noise_r2_64(texel_position_u32, settings.frame_index, tNoise);
@@ -202,14 +223,14 @@ fn main(
             let sampleScreenPos0 = uv + sampleOffset;
             
             let SZ0 = textureSampleLevel(tDepth, sPoint, sampleScreenPos0, mipLevel).x;
-            let samplePos0  = project_position_from_depth(sampleScreenPos0, SZ0, camera.view_projection_matrix_inverse);
-            
+            let samplePos0  = project_view_position_from_depth(sampleScreenPos0, SZ0, camera.projection_matrix_inverse);
+
             let sampleScreenPos1 = uv - sampleOffset;
             let SZ1 = textureSampleLevel(tDepth, sPoint, sampleScreenPos1, mipLevel).x;
-            let samplePos1 = project_position_from_depth(sampleScreenPos1, SZ1, camera.view_projection_matrix_inverse);
-            
-            let sampleDelta0     = (samplePos0 - position_ws); // using lpfloat for sampleDelta causes precision issues
-            let sampleDelta1     = (samplePos1 - position_ws); // using lpfloat for sampleDelta causes precision issues
+            let samplePos1 = project_view_position_from_depth(sampleScreenPos1, SZ1, camera.projection_matrix_inverse);
+
+            let sampleDelta0     = (samplePos0 - position_vs); // using lpfloat for sampleDelta causes precision issues
+            let sampleDelta1     = (samplePos1 - position_vs); // using lpfloat for sampleDelta causes precision issues
             
             let sampleDist0     = length( sampleDelta0 );
             let sampleDist1     = length( sampleDelta1 );
@@ -222,8 +243,8 @@ fn main(
             let weight1         = saturate( fma(sampleDist1, falloffMul, falloffAdd) );
             
             // sample horizon cos
-            var shc0 = dot( sampleHorizonVec0, view_direction_ws );
-            var shc1 = dot( sampleHorizonVec1, view_direction_ws );
+            var shc0 = dot( sampleHorizonVec0, view_direction_vs );
+            var shc1 = dot( sampleHorizonVec1, view_direction_vs );
             
             // discard unwanted samples
             shc0 = mix( lowHorizonCos0, shc0, weight0 ); // this would be more correct but too expensive: cos(lerp( acos(lowHorizonCos0), acos(shc0), weight0 ));
@@ -299,6 +320,7 @@ fn main(
 
         chunk_mat4_extract_position,
         chunk_project_position_from_depth,
+        chunk_project_view_position_from_depth,
         chunk_v3_matrix4_rotate,
         chunk_integrate_bent_normal_fast,
     ]);

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 "__#193@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
+    static "__#197@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
     /**
      * @param {GraphicsContext} graphics
      */

package/src/shade/renderer/postprocess/ssr/reproject/chunk_ssr_temporal_accumulate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_ssr_temporal_accumulate.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/postprocess/ssr/reproject/chunk_ssr_temporal_accumulate.js"],"names":[],"mappings":"AAUA,gGAAgG;AAChG,sDA0IuH;0BArJ7F,uCAAuC"}
+{"version":3,"file":"chunk_ssr_temporal_accumulate.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/postprocess/ssr/reproject/chunk_ssr_temporal_accumulate.js"],"names":[],"mappings":"AAUA,gGAAgG;AAChG,sDA6IuH;0BAxJ7F,uCAAuC"}

package/src/shade/renderer/postprocess/ssr/reproject/chunk_ssr_temporal_accumulate.js

@@ -92,6 +92,9 @@ fn ssr_temporal_accumulate(current: vec4f, previous: vec4f, previous_age: f32,
                 // against the current surface in world space, as the history gather does.
                 let old_depth = textureLoad(tPreviousDepth,h,0).r;
                 if (is_background(old_depth)) { continue; }
+                // These two unprojections are ~14% of SSR Reproject (2026-10-16, RTX 4090: evaluating them twice
+                // cost 1.14-1.17x). The three.js-style alternative, each camera's unprojection set up once per
+                // pixel so a tap is three multiply-adds, made the pass 1.12-1.17x slower, not faster.
                 let position = project_position_from_depth(texel_coordinate_to_uv(vec2f(p),vec2u(size)),depth,camera_current.view_projection_matrix_inverse);
                 let old_position = project_position_from_depth(texel_coordinate_to_uv(vec2f(h),vec2u(size)),old_depth,camera_previous.view_projection_matrix_inverse);
                 let plane_distance = abs(dot(normal,old_position-position));

package/src/shade/renderer/postprocess/ssr/resolve/build_ssr_resolve_shader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_ssr_resolve_shader.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/postprocess/ssr/resolve/build_ssr_resolve_shader.js"],"names":[],"mappings":"AA+BA;;;;;;;;;;;GAWG;AACH;IAN2B,KAAK,EAArB,MAAM;IACiG,SAAS,EAAhH,OAAO,yDAAyD,EAAE,2BAA2B;IAC1E,eAAe,EAAlC,SAAS;IACW,qBAAqB,GAAzC,SAAS;IACP,WAAW,CAiUvB;0BAxVyB,uCAAuC;4BACrC,gCAAgC"}
+{"version":3,"file":"build_ssr_resolve_shader.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/postprocess/ssr/resolve/build_ssr_resolve_shader.js"],"names":[],"mappings":"AA+BA;;;;;;;;;;;GAWG;AACH;IAN2B,KAAK,EAArB,MAAM;IACiG,SAAS,EAAhH,OAAO,yDAAyD,EAAE,2BAA2B;IAC1E,eAAe,EAAlC,SAAS;IACW,qBAAqB,GAAzC,SAAS;IACP,WAAW,CAoUvB;0BA3VyB,uCAAuC;4BACrC,gCAAgC"}

package/src/shade/renderer/postprocess/ssr/resolve/build_ssr_resolve_shader.js

@@ -6,7 +6,7 @@ import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
 import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js";
 import { DEPTH_STENCIL_FOREGROUND_ONLY } from "../../../depth/DEPTH_STENCIL_FOREGROUND_ONLY.js";
 import { chunk_direction_world_to_view } from "../../../shader/chunk/camera/chunk_direction_world_to_view.js";
-import { chunk_project_position_from_depth } from "../../../shader/chunk/camera/chunk_project_position_from_depth.js";
+import { chunk_project_view_position_from_depth } from "../../../shader/chunk/camera/chunk_project_view_position_from_depth.js";
 import { chunk_screen_coordinate_to_view } from "../../../shader/chunk/camera/chunk_screen_coordinate_to_view.js";
 import { chunk_rgb_to_luminance } from "../../../shader/chunk/color/chunk_rgb_to_luminance.js";
 import { chunk_rgb_to_YCoCg } from "../../../shader/chunk/color/YCoCg/chunk_rgb_to_YCoCg.js";
@@ -177,6 +177,9 @@ fn main(
     // weight the seed like every neighbour tap — both accumulators divide by weight_sum
     var result_luma_moment2 = this_hit_luma * this_hit_luma * this_weight;
 
+    // Every position in here is view space, reconstructed from four entries of the projection's inverse rather
+    // than a full multiply. Measured 2026-10-16 (RTX 4090, ssr_reprojection playground, roughness 0.2): the full
+    // multiply took 1.03-1.04x this pass's time at 960x600 and 1.03-1.05x at 1280x800, with bit-identical output.
     const NEIGHBOUR_SAMPLE_COUNT = 4;
 
     let hash_seed = murmur3_vec3u(vec3u(vec2u(coord_i), settings.frame_index));
@@ -201,7 +204,7 @@ fn main(
         let sample_hit_depth = textureLoad(tDepth, sample_hit.position, 0).r;
         if (is_background(sample_hit_depth)) { continue; }
         let sample_hit_uv = texel_coordinate_to_uv(vec2f(sample_hit.position), render_resolution);
-        let sample_hit_position_vs = project_position_from_depth(
+        let sample_hit_position_vs = project_view_position_from_depth(
             sample_hit_uv,
             sample_hit_depth,
             camera.projection_matrix_inverse,
@@ -338,7 +341,7 @@ fn main(
             chunk_murmur3_vec3u,
             chunk_reconstruct_pdf,
             chunk_get_ray_mip_level,
-            chunk_project_position_from_depth,
+            chunk_project_view_position_from_depth,
             chunk_v3_matrix4_project,
             RECIPROCAL_PI_DECLARATION,
             chunk_rgb_to_luminance,

package/src/shade/renderer/postprocess/taa/TAA.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
 export class TAA {
     /**
      * When set, will disregard history buffer
@@ -27,6 +30,14 @@ export class TAA {
      * @param {number} i
      */
     set frame_index(i: number);
+    /**
+     * Offer the pipeline {@link graph_pass} draws with into history of `history_format` — see
+     * {@link PipelineEnquiry}.
+     *
+     * @param {PipelineEnquiry} enquiry
+     * @param {GPUTextureFormat} history_format
+     */
+    enquirePipelines(enquiry: PipelineEnquiry, history_format: GPUTextureFormat): void;
     /**
      *
      * @param {Object} options
@@ -48,4 +59,5 @@ export class TAA {
     }): number;
     #private;
 }
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=TAA.d.ts.map

package/src/shade/renderer/postprocess/taa/TAA.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TAA.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/taa/TAA.js"],"names":[],"mappings":"AAOA;IAEI;;;;OAIG;IACH,eAFU,OAAO,CAEK;IAatB;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,4BAEC;IAED;;OAEG;IACH,uCAEC;IAED;;OAEG;IACH,mCAEC;IAED;;OAEG;IACH,2BAEC;IAED;;;;;;;;;;OAUG;IACH;QAR+B,KAAK;QACT,gBAAgB,EAAhC,MAAM;QACU,qBAAqB,EAArC,MAAM;QACU,qBAAqB,EAArC,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,iBAAiB,EAAjC,MAAM;eAkChB;;CACJ"}
+{"version":3,"file":"TAA.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/taa/TAA.js"],"names":[],"mappings":"AAOA;;GAEG;AAEH;IAEI;;;;OAIG;IACH,eAFU,OAAO,CAEK;IAatB;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,4BAEC;IAED;;OAEG;IACH,uCAEC;IAED;;OAEG;IACH,mCAEC;IAED;;OAEG;IACH,2BAEC;IAED;;;;;;OAMG;IACH,0BAHW,eAAe,0CAKzB;IAED;;;;;;;;;;OAUG;IACH;QAR+B,KAAK;QACT,gBAAgB,EAAhC,MAAM;QACU,qBAAqB,EAArC,MAAM;QACU,qBAAqB,EAArC,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,iBAAiB,EAAjC,MAAM;eAkChB;;CACJ;8BAlHY,OAAO,6CAA6C,EAAE,eAAe"}