@woosh/meep-engine 3.47.0 → 3.49.0

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"}

package/src/shade/renderer/postprocess/taa/TAA.js

@@ -5,6 +5,10 @@ import { TemporalJitterSequence } from "../TemporalJitterSequence.js";
 import { graph_image_pass } from "../../shader/graph/graph_image_pass.js";
 import { shader_taa } from "./shader_taa.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
 export class TAA {
 
     /**
@@ -62,6 +66,17 @@ export class TAA {
         this.#jitter.frame_index = i;
     }
 
+    /**
+     * 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, history_format) {
+        enquiry.render.push(shader_taa.pipeline_for([history_format]));
+    }
+
     /**
      *
      * @param {Object} options

package/src/shade/renderer/postprocess/velocity/graph_add_per_object_velocity.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Offer the pipeline {@link graph_add_per_object_velocity} draws with — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_per_object_velocity_pipelines(enquiry: PipelineEnquiry): void;
 /**
  * Per-pixel motion-vector pass with three branches:
  *
@@ -63,4 +69,5 @@ export function graph_add_per_object_velocity({ graph, texture_depth, texture_vi
     view: GPUViewContext;
     enable_mipmap?: boolean;
 }): number;
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=graph_add_per_object_velocity.d.ts.map

package/src/shade/renderer/postprocess/velocity/graph_add_per_object_velocity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_add_per_object_velocity.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/velocity/graph_add_per_object_velocity.js"],"names":[],"mappings":"AAsQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH;IAjB4B,KAAK;IACT,aAAa,EAA1B,MAAM;IACO,gBAAgB,EAA7B,MAAM;IACO,oBAAoB,EAAjC,MAAM;IACO,qBAAqB,EAAlC,MAAM;IACO,uBAAuB,EAApC,MAAM;IACO,mBAAmB,EAAhC,MAAM;IACO,4BAA4B,EAAzC,MAAM;IACO,qBAAqB,EAAlC,MAAM;IACQ,eAAe,EAA7B,OAAO;IAGQ,UAAU,EAAzB,MAAM,EAAE;IACa,IAAI;IACV,aAAa,GAA5B,OAAO;IACL,MAAM,CAgFlB"}
+{"version":3,"file":"graph_add_per_object_velocity.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/velocity/graph_add_per_object_velocity.js"],"names":[],"mappings":"AA0QA;;;;GAIG;AACH,+DAFW,eAAe,QAIzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH;IAjB4B,KAAK;IACT,aAAa,EAA1B,MAAM;IACO,gBAAgB,EAA7B,MAAM;IACO,oBAAoB,EAAjC,MAAM;IACO,qBAAqB,EAAlC,MAAM;IACO,uBAAuB,EAApC,MAAM;IACO,mBAAmB,EAAhC,MAAM;IACO,4BAA4B,EAAzC,MAAM;IACO,qBAAqB,EAAlC,MAAM;IACQ,eAAe,EAA7B,OAAO;IAGQ,UAAU,EAAzB,MAAM,EAAE;IACa,IAAI;IACV,aAAa,GAA5B,OAAO;IACL,MAAM,CAgFlB;8BA5WY,OAAO,6CAA6C,EAAE,eAAe"}

package/src/shade/renderer/postprocess/velocity/graph_add_per_object_velocity.js

@@ -36,6 +36,10 @@ import {
     construct_reprojection_matrix_rotation_only,
 } from "./construct_reprojection_matrix.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
 const resources = new ShaderResourceSetDescriptor();
 
 resources.createGroup()
@@ -260,6 +264,15 @@ const scratch_unjit_inv_view_proj_curr_f64 = new Float64Array(16);
 const scratch_unjit_view_proj_prev_f32 = new Float32Array(16);
 const scratch_unjit_inv_view_proj_curr_f32 = new Float32Array(16);
 
+/**
+ * Offer the pipeline {@link graph_add_per_object_velocity} draws with — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_per_object_velocity_pipelines(enquiry) {
+    enquiry.render.push(shader.pipeline);
+}
+
 /**
  * Per-pixel motion-vector pass with three branches:
  *

package/src/shade/renderer/rasterize/TemplatePassDescriptor.d.ts

@@ -1,5 +1,6 @@
 /**
  * @typedef {import("../../descriptor/pipeline/render/RenderPipelineDescriptor.js").RenderPipelineDescriptor} RenderPipelineDescriptor
+ * @typedef {import("../../descriptor/pipeline/PipelineLayoutDescriptor.js").PipelineLayoutDescriptor} PipelineLayoutDescriptor
  * @typedef {import("../../device/pipeline/RenderPipelineManager.js").RenderPipelineManager} RenderPipelineManager
  * @typedef {import("../material/template/ShadeMaterialTemplate.js").ShadeMaterialTemplate} ShadeMaterialTemplate
  */
@@ -14,14 +15,39 @@
  * The pass asks for a pipeline only when the template changes between consecutive materials, and
  * the answer is held per device, per template and per cull mode, so a pass never clones or hashes a
  * pipeline descriptor to find the one it already has.
+ *
+ * A pass whose shaders depend on switches has a {@link variant} per {@link ShaderSwitchSet}: the same
+ * pass, building each template's pipeline for that set's values.
  */
 export class TemplatePassDescriptor extends RenderPassDescriptor {
     /**
      * @param {string} label names the render pass, which has no one pipeline to take a name from
-     * @param {function(ShadeMaterialTemplate): RenderPipelineDescriptor} build a template's pipeline,
-     *        at the pass's default primitive state
+     * @param {function(ShadeMaterialTemplate, ShaderSwitchSet): RenderPipelineDescriptor} build a
+     *        template's pipeline, at the pass's default primitive state, for the given switch values
+     */
+    constructor(label: string, build: (arg0: ShadeMaterialTemplate, arg1: ShaderSwitchSet) => RenderPipelineDescriptor);
+    /**
+     * @returns {ShaderSwitchSet}
+     */
+    get switches(): ShaderSwitchSet;
+    /**
+     * This pass with its pipelines built for `set`: the same label, attachments and templates. The
+     * set with every switch at its default gives the pass itself. One variant per set; a frame asking
+     * again with the same set allocates nothing.
+     *
+     * @param {ShaderSwitchSet} set
+     * @returns {TemplatePassDescriptor}
+     */
+    variant(set: ShaderSwitchSet): TemplatePassDescriptor;
+    /**
+     * The layout of the pipeline the making module set on {@link pipeline} — by convention the
+     * standard template's — for passes that build their own bind groups for groups 1 and up, which
+     * every template's pipeline lays out alike. A switch never changes a layout, so a variant has its
+     * original's.
+     *
+     * @returns {PipelineLayoutDescriptor}
      */
-    constructor(label: string, build: (arg0: ShadeMaterialTemplate) => RenderPipelineDescriptor);
+    get pipeline_layout(): import("../../descriptor/pipeline/PipelineLayoutDescriptor.js").PipelineLayoutDescriptor;
     /**
      * The inherited single-pipeline helpers have no one pipeline to use here: the pass picks one per
      * template, through {@link obtain_pipeline}.
@@ -51,7 +77,9 @@ export class TemplatePassDescriptor extends RenderPassDescriptor {
     #private;
 }
 export type RenderPipelineDescriptor = import("../../descriptor/pipeline/render/RenderPipelineDescriptor.js").RenderPipelineDescriptor;
+export type PipelineLayoutDescriptor = import("../../descriptor/pipeline/PipelineLayoutDescriptor.js").PipelineLayoutDescriptor;
 export type RenderPipelineManager = import("../../device/pipeline/RenderPipelineManager.js").RenderPipelineManager;
 export type ShadeMaterialTemplate = import("../material/template/ShadeMaterialTemplate.js").ShadeMaterialTemplate;
 import { RenderPassDescriptor } from "../shader/pass/RenderPassDescriptor.js";
+import { ShaderSwitchSet } from "../shader/compiler/ShaderSwitchSet.js";
 //# sourceMappingURL=TemplatePassDescriptor.d.ts.map

package/src/shade/renderer/rasterize/TemplatePassDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TemplatePassDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/rasterize/TemplatePassDescriptor.js"],"names":[],"mappings":"AAKA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH;IAgBI;;;;OAIG;IACH,mBAJW,MAAM,gBACG,qBAAqB,KAAG,wBAAwB,EAWnE;IAED;;;OAGG;IACH,cAEC;IAED;;OAEG;IACH,qBAEC;IAED;;;OAGG;IACH,uCAHW,qBAAqB,GACnB,wBAAwB,CAYpC;IAED;;;;;OAKG;IACH,kCALW,qBAAqB,YACrB,qBAAqB,6CAsC/B;IAGL;;;OAGG;IACH,mCAFU,OAAO,CAEwC;;CANxD;uCAxHY,OAAO,8DAA8D,EAAE,wBAAwB;oCAC/F,OAAO,gDAAgD,EAAE,qBAAqB;oCAC9E,OAAO,+CAA+C,EAAE,qBAAqB;qCALrD,wCAAwC"}
+{"version":3,"file":"TemplatePassDescriptor.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/rasterize/TemplatePassDescriptor.js"],"names":[],"mappings":"AAMA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH;IA0CI;;;;OAIG;IACH,mBAJW,MAAM,gBACG,qBAAqB,QAAE,eAAe,KAAG,wBAAwB,EAWpF;IA3CD;;OAEG;IACH,gCAEC;IAwCD;;;;;;;OAOG;IACH,aAHW,eAAe,GACb,sBAAsB,CAwBlC;IAED;;;;;;;OAOG;IACH,gHAEC;IAED;;;OAGG;IACH,cAEC;IAED;;OAEG;IACH,qBAEC;IAED;;;OAGG;IACH,uCAHW,qBAAqB,GACnB,wBAAwB,CAYpC;IAED;;;;;OAKG;IACH,kCALW,qBAAqB,YACrB,qBAAqB,6CAsC/B;IAGL;;;OAGG;IACH,mCAFU,OAAO,CAEwC;;CANxD;uCAlMY,OAAO,8DAA8D,EAAE,wBAAwB;uCAC/F,OAAO,uDAAuD,EAAE,wBAAwB;oCACxF,OAAO,gDAAgD,EAAE,qBAAqB;oCAC9E,OAAO,+CAA+C,EAAE,qBAAqB;qCANrD,wCAAwC;gCAD7C,uCAAuC"}