@woosh/meep-engine 3.38.0 → 3.40.0

package/src/shade/renderer/path_tracer/shader/media/chunk_medium_volumes.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The volumes' contribution to a medium at one point: absorption and scattering coefficients, RGB,
+ * 1/m.
+ */
+export const MEDIUM_COEFFICIENTS_STRUCT: WebGPUStruct;
+/**
+ * A stretch of a ray over which the set of volumes it is inside does not change: from where the
+ * caller stands to `next`, the volumes' extinction is at most `majorant`, per channel.
+ */
+export const MEDIUM_PIECE_STRUCT: WebGPUStruct;
+/**
+ * The scene's participating-media volumes as the ray passes see them, read from the scene database
+ * the importing shader binds as `scene_database`:
+ *
+ * - `medium_volumes_coefficients_at(position)`: what every volume containing the point adds,
+ *   `density_at * particle_spec.scattering` and `density_at * (extinction - scattering)`.
+ * - `medium_volumes_piece(origin, direction, t, t_max)`: the next distance past `t` at which the ray
+ *   enters or leaves a volume (or `t_max`), and, up to there, the sum of `density * extinction` over
+ *   the volumes the ray is inside — a majorant, as the edge fade never exceeds one. Walking a ray
+ *   piece by piece keeps a long ray past a small dense volume from paying that volume's majorant
+ *   along all of its length.
+ * - `medium_volumes_rest(origin, direction, t, t_max)`: every volume the rest of the ray crosses as
+ *   one piece — their majorants summed, which bound the medium anywhere on it, up to where the last of
+ *   them ends (or `t_max` when none lies ahead). Where a ray would cross too many volumes to take
+ *   them piece by piece, this ends the walk with a valid majorant, at the price of null collisions
+ *   that grow as the square of the volumes it sums, gaps and all.
+ *
+ * Each call walks the volumes' rows, `[0, participating_media_volumes_count)`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_medium_volumes: CodeChunk;
+import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_medium_volumes.d.ts.map

package/src/shade/renderer/path_tracer/shader/media/chunk_medium_volumes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_medium_volumes.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/path_tracer/shader/media/chunk_medium_volumes.js"],"names":[],"mappings":"AAUA;;;GAGG;AACH,sDAGyB;AAEzB;;;GAGG;AACH,+CAGkB;AAElB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,mCAFU,SAAS,CAyFjB;6BAvI2B,sCAAsC;0BACzC,uCAAuC"}

package/src/shade/renderer/path_tracer/shader/media/chunk_medium_volumes.js

@@ -0,0 +1,137 @@
+import { f32, vec3f } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import {
+    chunk_participating_media_volume_sample
+} from "../../../volumetrics/chunk_participating_media_volume_sample.js";
+import {
+    chunk_participating_media_volumes_iterate
+} from "../../../volumetrics/chunk_participating_media_volumes_iterate.js";
+
+/**
+ * The volumes' contribution to a medium at one point: absorption and scattering coefficients, RGB,
+ * 1/m.
+ */
+export const MEDIUM_COEFFICIENTS_STRUCT = WebGPUStruct.from({
+    absorption: vec3f,
+    scattering: vec3f,
+}, "MediumCoefficients");
+
+/**
+ * A stretch of a ray over which the set of volumes it is inside does not change: from where the
+ * caller stands to `next`, the volumes' extinction is at most `majorant`, per channel.
+ */
+export const MEDIUM_PIECE_STRUCT = WebGPUStruct.from({
+    majorant: vec3f,
+    next: f32,
+}, "MediumPiece");
+
+/**
+ * The scene's participating-media volumes as the ray passes see them, read from the scene database
+ * the importing shader binds as `scene_database`:
+ *
+ * - `medium_volumes_coefficients_at(position)`: what every volume containing the point adds,
+ *   `density_at * particle_spec.scattering` and `density_at * (extinction - scattering)`.
+ * - `medium_volumes_piece(origin, direction, t, t_max)`: the next distance past `t` at which the ray
+ *   enters or leaves a volume (or `t_max`), and, up to there, the sum of `density * extinction` over
+ *   the volumes the ray is inside — a majorant, as the edge fade never exceeds one. Walking a ray
+ *   piece by piece keeps a long ray past a small dense volume from paying that volume's majorant
+ *   along all of its length.
+ * - `medium_volumes_rest(origin, direction, t, t_max)`: every volume the rest of the ray crosses as
+ *   one piece — their majorants summed, which bound the medium anywhere on it, up to where the last of
+ *   them ends (or `t_max` when none lies ahead). Where a ray would cross too many volumes to take
+ *   them piece by piece, this ends the walk with a valid majorant, at the price of null collisions
+ *   that grow as the square of the volumes it sums, gaps and all.
+ *
+ * Each call walks the volumes' rows, `[0, participating_media_volumes_count)`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_medium_volumes = CodeChunk.from(
+    //language=WGSL
+    `
+fn medium_volumes_coefficients_at(position: vec3<f32>) -> ${MEDIUM_COEFFICIENTS_STRUCT.wgsl_ref} {
+    var absorption = vec3<f32>(0.0);
+    var scattering = vec3<f32>(0.0);
+
+    let volume_count = participating_media_volumes_count(&scene_database);
+
+    for (var v = 0u; v < volume_count; v++) {
+        let volume = participating_media_volume_read(&scene_database, v);
+
+        let density = participating_media_volume_density_at(volume, position);
+
+        if (density <= 0.0) {
+            continue;
+        }
+
+        let spec = volume.particle_spec;
+
+        scattering += density * spec.scattering;
+        absorption += density * max(spec.extinction - spec.scattering, vec3<f32>(0.0));
+    }
+
+    return ${MEDIUM_COEFFICIENTS_STRUCT.wgsl_ref}(absorption, scattering);
+}
+
+fn medium_volumes_piece(origin: vec3<f32>, direction: vec3<f32>, t: f32, t_max: f32) -> ${MEDIUM_PIECE_STRUCT.wgsl_ref} {
+    var next = t_max;
+    var majorant = vec3<f32>(0.0);
+
+    let volume_count = participating_media_volumes_count(&scene_database);
+
+    for (var v = 0u; v < volume_count; v++) {
+        let volume = participating_media_volume_read(&scene_database, v);
+
+        let span = participating_media_volume_span(volume, origin, direction, t_max);
+
+        if (span.y <= span.x) {
+            // missed
+            continue;
+        }
+
+        if (span.x > t) {
+            // ahead: the piece ends where the ray enters it
+            next = min(next, span.x);
+        } else if (span.y > t) {
+            // inside: the piece ends where the ray leaves it at the latest
+            next = min(next, span.y);
+            majorant += volume.density * volume.particle_spec.extinction;
+        }
+    }
+
+    return ${MEDIUM_PIECE_STRUCT.wgsl_ref}(majorant, next);
+}
+
+fn medium_volumes_rest(origin: vec3<f32>, direction: vec3<f32>, t: f32, t_max: f32) -> ${MEDIUM_PIECE_STRUCT.wgsl_ref} {
+    var majorant = vec3<f32>(0.0);
+    var end = t_max;
+    var ahead = false;
+
+    let volume_count = participating_media_volumes_count(&scene_database);
+
+    for (var v = 0u; v < volume_count; v++) {
+        let volume = participating_media_volume_read(&scene_database, v);
+
+        let span = participating_media_volume_span(volume, origin, direction, t_max);
+
+        if (span.y <= max(span.x, t)) {
+            // missed, or already left behind
+            continue;
+        }
+
+        majorant += volume.density * volume.particle_spec.extinction;
+        end = select(span.y, max(end, span.y), ahead);
+        ahead = true;
+    }
+
+    return ${MEDIUM_PIECE_STRUCT.wgsl_ref}(majorant, end);
+}
+    `,
+    [
+        MEDIUM_COEFFICIENTS_STRUCT.declaration_chunk,
+        MEDIUM_PIECE_STRUCT.declaration_chunk,
+        chunk_participating_media_volumes_iterate,
+        chunk_participating_media_volume_sample,
+    ]
+);

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

@@ -1 +1 @@
-{"version":3,"file":"shader_autoexposure_build_histogram.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/eye/shader_autoexposure_build_histogram.js"],"names":[],"mappings":"AA4HA,gEAIE;8BA5H4B,+BAA+B"}
+{"version":3,"file":"shader_autoexposure_build_histogram.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/eye/shader_autoexposure_build_histogram.js"],"names":[],"mappings":"AA8FA,gEAIE;8BA7F4B,+BAA+B"}

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

@@ -1,5 +1,6 @@
 import { chunk_inverse_lerp } from "../../shader/chunk/math/chunk_inverse_lerp.js";
 import { chunk_rgb_to_luminance } from "../../shader/chunk/color/chunk_rgb_to_luminance.js";
+import { chunk_screen_importance } from "../../shader/chunk/screen_space/chunk_screen_importance.js";
 import { chunk_texel_coordinate_to_uv } from "../../shader/chunk/texture/chunk_texel_coordinate_to_uv.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
@@ -18,36 +19,6 @@ const LUMINANCE_MIN = Math.pow(2, AUTOEXPOSURE_HISTOGRAM_LOG_MIN);
 const LUMINANCE_MAX = Math.pow(2, AUTOEXPOSURE_HISTOGRAM_LOG_MAX);
 
 
-/**
- * Exposure metering mask (see https://www.unrealengine.com/en-US/tech-blog/how-epic-games-is-handling-auto-exposure-in-4-25)
- * Prioritize pixels away from the edge of the screen
- * @type {CodeChunk}
- */
-const chunk_compute_vignette = CodeChunk.from(
-    //language=WGSL
-    `
-fn compute_vignette(
-    uv: vec2<f32>,
-    vertical_aspect: f32,
-    border_fraction: f32
-) -> f32{
-    
-    let fov = border_fraction * vec2(vertical_aspect, 1.0);
-
-    let border   = smoothstep(vec2(0.0, 0.0), fov, uv) * (1.0 - smoothstep(vec2(1.0, 1.0) - fov, vec2(1.0, 1.0), uv));
-    let vignette = border.x * border.y;
-    
-    return vignette;
-}
-    `
-)
-
-/**
- * How many distinct steps to use for quantization?
- * @type {number}
- */
-const MASKING_QUANTIZATION_STEPS = 64;
-
 /**
  * NOTE: we do not explicitly initialize groupshared memory, as spec guarantees it to be initialized to default value of 0 already.
  * @type {CodeChunk}
@@ -93,10 +64,9 @@ fn main(
             let bin_index = u32( t * ${ (SCENE_LUMINANCE_HISTOGRAM_BIN_COUNT - 1) });
         
             let uv = texel_coordinate_to_uv(vec2<f32>(global_id.xy), size);
-            
-            let vignette = compute_vignette(uv, f32(size.y) / f32(size.x), 0.13);
-            
-            let quantized = max(1u, u32(vignette * ${MASKING_QUANTIZATION_STEPS}));
+
+            // the metering mask: pixels away from the edge of the screen count for more
+            let quantized = screen_importance_weight(uv, f32(size.y) / f32(size.x));
         
             atomicAdd(&group_histogram.bins[bin_index], quantized);
             
@@ -118,7 +88,7 @@ fn main(
         chunk_rgb_to_luminance,
         chunk_inverse_lerp,
         chunk_texel_coordinate_to_uv,
-        chunk_compute_vignette,
+        chunk_screen_importance,
     ]
 )
 

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

package/src/shade/renderer/postprocess/ssr/SSR.d.ts

@@ -5,9 +5,13 @@ export class SSR {
      */
     constructor(graphics: import("../../GraphicsContext.js").GraphicsContext);
     frame_index: number;
-    set spatial_denoising_enabled(value: boolean);
-    /** Toggle the three spatial passes independently of temporal reprojection. @returns {boolean} */
-    get spatial_denoising_enabled(): boolean;
+    set tile_denoising_enabled(value: boolean);
+    /**
+     * Opt-in constant-neighborhood coverage tiles. Classification adds overhead;
+     * measure the scene/device before enabling it, particularly at low resolutions.
+     * @returns {boolean}
+     */
+    get tile_denoising_enabled(): boolean;
     set reset_history(value: boolean);
     /**
      * When set, will disregard history buffer
@@ -15,6 +19,9 @@ export class SSR {
      * @type {boolean}
      */
     get reset_history(): boolean;
+    set spatial_denoising_enabled(value: boolean);
+    /** Toggle the three spatial passes independently of temporal reprojection. @returns {boolean} */
+    get spatial_denoising_enabled(): boolean;
     set reprojection_mode(value: number);
     /** @returns {SSRReprojectionMode} */
     get reprojection_mode(): number;
@@ -47,7 +54,7 @@ export class SSR {
      * @param {import("../../view/GPUViewContext.js").GPUViewContext} [options.view_ctx]
      * @param {ArrayLike<number>} [options.jitter] Raster jitter in internal pixels
      * @param {number} [options.mip] Higher mip = lower resolution trace
-     * @returns {{final:number, trace:number, reflections:number, denoised:number, denoised_1:number}}
+     * @returns {{final:number, trace:number, reflections:number, denoised:number, denoised_1:number, denoise_tiles:number}}
      */
     graph_pass({ graph, input_depth, input_depth_previous, view_ctx, jitter, input_hzb, input_scene_color, input_pbr, input_normal, input_velocity, input_occlusion, input_albedo, resolution, camera_current, camera_previous, input_environment, indirect_lighting_mode, lpv, brick4, mip, }: {
         graph: import("../../../../engine/graphics/render/frame_graph/FrameGraph.js").FrameGraph;
@@ -76,6 +83,7 @@ export class SSR {
         reflections: number;
         denoised: number;
         denoised_1: number;
+        denoise_tiles: number;
     };
     #private;
 }

package/src/shade/renderer/postprocess/ssr/SSR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SSR.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/ssr/SSR.js"],"names":[],"mappings":"AAiBA;IAyDI;;;OAGG;IACH,sBAFW,OAAO,0BAA0B,EAAE,eAAe,EAkB5D;IA3DD,oBAAgB;IAMhB,8CAOC;IATD,iGAAiG;IACjG,yCAA2E;IA0B3E,kCAMC;IAZD;;;;OAIG;IACH,6BAAmD;IAbnD,qCAMC;IARD,qCAAqC;IACrC,gCAA2D;IA6C3D;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QAUhB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH;QAtBsG,KAAK,EAAhG,OAAO,8DAA8D,EAAE,UAAU;QACjE,WAAW,EAA3B,MAAM;QACW,oBAAoB,GAArC,MAAM;QACU,SAAS,EAAzB,MAAM;QACU,iBAAiB,EAAjC,MAAM;QACU,YAAY,EAA5B,MAAM;QACU,SAAS,EAAzB,MAAM;QACU,YAAY,EAA5B,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QACW,iBAAiB,GAAlC,MAAM;QACqB,UAAU,EAArC,UAAU,MAAM,CAAC;QACD,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QAC8B,sBAAsB,GAA1D,yBAAyB;QAC6D,MAAM,GAA5F,OAAO,oDAAoD,EAAE,cAAc;QACkB,GAAG,GAAhG,OAAO,sDAAsD,EAAE,mBAAmB;QAClB,QAAQ,GAAxE,OAAO,8BAA8B,EAAE,cAAc;QACzB,MAAM,GAAlC,UAAU,MAAM,CAAC;QACA,GAAG,GAApB,MAAM;QACJ;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,WAAW,EAAC,MAAM,CAAC;QAAC,QAAQ,EAAC,MAAM,CAAC;QAAC,UAAU,EAAC,MAAM,CAAA;KAAC,CAoQhG;;CACJ;0CA3YyC,oCAAoC"}
+{"version":3,"file":"SSR.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/ssr/SSR.js"],"names":[],"mappings":"AAmBA;IAwEI;;;OAGG;IACH,sBAFW,OAAO,0BAA0B,EAAE,eAAe,EAkB5D;IA1ED,oBAAgB;IAWhB,2CAMC;IAZD;;;;OAIG;IACH,sCAAqE;IAoCrE,kCAMC;IAZD;;;;OAIG;IACH,6BAAmD;IAxBnD,8CAOC;IATD,iGAAiG;IACjG,yCAA2E;IAY3E,qCAMC;IARD,qCAAqC;IACrC,gCAA2D;IA6C3D;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QAUhB;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH;QAtBsG,KAAK,EAAhG,OAAO,8DAA8D,EAAE,UAAU;QACjE,WAAW,EAA3B,MAAM;QACW,oBAAoB,GAArC,MAAM;QACU,SAAS,EAAzB,MAAM;QACU,iBAAiB,EAAjC,MAAM;QACU,YAAY,EAA5B,MAAM;QACU,SAAS,EAAzB,MAAM;QACU,YAAY,EAA5B,MAAM;QACU,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QACW,iBAAiB,GAAlC,MAAM;QACqB,UAAU,EAArC,UAAU,MAAM,CAAC;QACD,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QAC8B,sBAAsB,GAA1D,yBAAyB;QAC6D,MAAM,GAA5F,OAAO,oDAAoD,EAAE,cAAc;QACkB,GAAG,GAAhG,OAAO,sDAAsD,EAAE,mBAAmB;QAClB,QAAQ,GAAxE,OAAO,8BAA8B,EAAE,cAAc;QACzB,MAAM,GAAlC,UAAU,MAAM,CAAC;QACA,GAAG,GAApB,MAAM;QACJ;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAC,WAAW,EAAC,MAAM,CAAC;QAAC,QAAQ,EAAC,MAAM,CAAC;QAAC,UAAU,EAAC,MAAM,CAAC;QAAC,aAAa,EAAC,MAAM,CAAA;KAAC,CA+QtH;;CACJ;0CAvayC,oCAAoC"}

package/src/shade/renderer/postprocess/ssr/SSR.js

@@ -11,9 +11,11 @@ import { ssr_resolve_shader_LPV } from "./resolve/ssr_resolve_shader_LPV.js";
 import { ssr_combine_shader } from "./ssr_combine_shader.js";
 import { ssr_graph_prefilter_color } from "./ssr_graph_prefilter_color.js";
 import { SSR_PREFILTER_MIP_COUNT } from "./SSR_PREFILTER_MIP_COUNT.js";
-import { ssr_reproject_shader } from "./ssr_reproject_shader.js";
-import { ssr_spatial_denoise_shader, ssr_spatial_denoise_metadata_shader } from "./ssr_spatial_denoise_shader.js";
+import { ssr_reproject_shader, ssr_reproject_tile_shader } from "./ssr_reproject_shader.js";
+import { ssr_spatial_denoise_shader, ssr_spatial_denoise_metadata_shader,
+    ssr_spatial_denoise_tile_shader, ssr_spatial_denoise_metadata_tile_shader } from "./ssr_spatial_denoise_shader.js";
 import { ssr_trace_shader } from "./ssr_trace_shader.js";
+import { ssr_graph_denoise_tiles } from "./ssr_graph_denoise_tiles.js";
 
 export class SSR {
 
@@ -36,6 +38,21 @@ export class SSR {
     frame_index = 0;
     #reprojection_mode = SSRReprojectionMode.Parallax;
     #spatial_denoising_enabled = true;
+    #tile_denoising_enabled = false;
+
+    /**
+     * Opt-in constant-neighborhood coverage tiles. Classification adds overhead;
+     * measure the scene/device before enabling it, particularly at low resolutions.
+     * @returns {boolean}
+     */
+    get tile_denoising_enabled() { return this.#tile_denoising_enabled; }
+    set tile_denoising_enabled(value) {
+        assert.isBoolean(value, 'tile_denoising_enabled');
+        if (value !== this.#tile_denoising_enabled) {
+            this.#tile_denoising_enabled = value;
+            this.reset_history = true;
+        }
+    }
 
     /** Toggle the three spatial passes independently of temporal reprojection. @returns {boolean} */
     get spatial_denoising_enabled() { return this.#spatial_denoising_enabled; }
@@ -132,7 +149,7 @@ export class SSR {
      * @param {import("../../view/GPUViewContext.js").GPUViewContext} [options.view_ctx]
      * @param {ArrayLike<number>} [options.jitter] Raster jitter in internal pixels
      * @param {number} [options.mip] Higher mip = lower resolution trace
-     * @returns {{final:number, trace:number, reflections:number, denoised:number, denoised_1:number}}
+     * @returns {{final:number, trace:number, reflections:number, denoised:number, denoised_1:number, denoise_tiles:number}}
      */
     graph_pass({
                    graph,
@@ -282,7 +299,13 @@ export class SSR {
             },
         });
 
-        // History validity is captured above and consumed by temporal reprojection.
+        const tile_denoising = this.#tile_denoising_enabled
+            && (this.#spatial_denoising_enabled || this.#reprojection_mode !== SSRReprojectionMode.CurrentFrame);
+        const denoise_tiles = tile_denoising ? ssr_graph_denoise_tiles({
+            graph, resolution, input: reflections, metadata: reflection_metadata,
+            history, history_metadata, velocity: input_velocity, history_valid: valid, jitter_delta,
+        }) : -1;
+        const tile_inputs = denoise_tiles >= 0 ? { tDenoiseTiles: denoise_tiles } : {};
 
         // denoise
 
@@ -295,9 +318,10 @@ export class SSR {
         if (this.#spatial_denoising_enabled) {
             [denoised, denoised_metadata] = graph_image_pass({
                 graph,
-                shader: ssr_spatial_denoise_metadata_shader,
+                shader: tile_denoising ? ssr_spatial_denoise_metadata_tile_shader : ssr_spatial_denoise_metadata_shader,
                 output_resolution: resolution,
                 inputs: {
+                    ...tile_inputs,
                     tInput: denoised,
                     tMetadata: denoised_metadata,
                     tDepth: input_depth,
@@ -313,9 +337,10 @@ export class SSR {
 
         [denoised, denoised_metadata] = graph_image_pass({
             graph,
-            shader: ssr_reproject_shader,
+            shader: tile_denoising ? ssr_reproject_tile_shader : ssr_reproject_shader,
             output: [output, output_metadata, output_geometry],
             inputs: {
+                ...tile_inputs,
                 tInput: denoised,
                 tMetadata: denoised_metadata,
                 tHistory: history,
@@ -337,9 +362,10 @@ export class SSR {
             // 2 more spatial denoise steps
             [denoised] = graph_image_pass({
                 graph,
-                shader: ssr_spatial_denoise_shader,
+                shader: tile_denoising ? ssr_spatial_denoise_tile_shader : ssr_spatial_denoise_shader,
                 output_resolution: resolution,
                 inputs: {
+                    ...tile_inputs,
                     tInput: denoised,
                     tDepth: input_depth,
                     tNormal: input_normal,
@@ -352,9 +378,10 @@ export class SSR {
 
             [denoised] = graph_image_pass({
                 graph,
-                shader: ssr_spatial_denoise_shader,
+                shader: tile_denoising ? ssr_spatial_denoise_tile_shader : ssr_spatial_denoise_shader,
                 output_resolution: resolution,
                 inputs: {
+                    ...tile_inputs,
                     tInput: denoised,
                     tDepth: input_depth,
                     tNormal: input_normal,
@@ -391,6 +418,7 @@ export class SSR {
             denoised,
             denoised_1,
             reflections,
+            denoise_tiles,
         };
     }
 }

package/src/shade/renderer/postprocess/ssr/SSR_DENOISE_TILE_SIZE.d.ts

@@ -0,0 +1,3 @@
+/** Tile width in internal pixels; shared by classification and denoise shader variants. */
+export const SSR_DENOISE_TILE_SIZE: 8;
+//# sourceMappingURL=SSR_DENOISE_TILE_SIZE.d.ts.map

package/src/shade/renderer/postprocess/ssr/SSR_DENOISE_TILE_SIZE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SSR_DENOISE_TILE_SIZE.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/ssr/SSR_DENOISE_TILE_SIZE.js"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,sCAAuC"}

package/src/shade/renderer/postprocess/ssr/SSR_DENOISE_TILE_SIZE.js

@@ -0,0 +1,2 @@
+/** Tile width in internal pixels; shared by classification and denoise shader variants. */
+export const SSR_DENOISE_TILE_SIZE = 8;

package/src/shade/renderer/postprocess/ssr/chunk_ssr_denoise_tile_active.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A miss can still contain varying GI radiance or useful history. Only a constant,
+ * stationary, zero-uncertainty neighborhood may take the denoiser's copy path.
+ * Texture names are supplied by shader_ssr_denoise_tile_classify.
+ */
+export const chunk_ssr_denoise_tile_active: CodeChunk;
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_ssr_denoise_tile_active.d.ts.map

package/src/shade/renderer/postprocess/ssr/chunk_ssr_denoise_tile_active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_ssr_denoise_tile_active.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/ssr/chunk_ssr_denoise_tile_active.js"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,sDA8B8C;0BAvCpB,oCAAoC"}

package/src/shade/renderer/postprocess/ssr/chunk_ssr_denoise_tile_active.js

@@ -0,0 +1,40 @@
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { chunk_is_finite } from "../../shader/chunk/math/chunk_is_finite.js";
+import { chunk_rgb_to_luminance } from "../../shader/chunk/color/chunk_rgb_to_luminance.js";
+
+/**
+ * A miss can still contain varying GI radiance or useful history. Only a constant,
+ * stationary, zero-uncertainty neighborhood may take the denoiser's copy path.
+ * Texture names are supplied by shader_ssr_denoise_tile_classify.
+ */
+export const chunk_ssr_denoise_tile_active = CodeChunk.from(/* language=WGSL */ `
+fn ssr_denoise_tile_active(p: vec2i, history_valid: bool, jitter_delta: vec2f) -> u32 {
+    // The halo covers ordinary raster jitter, not an arbitrary jump in raster grids.
+    if (!is_finite(jitter_delta.x) || !is_finite(jitter_delta.y)
+        || any(abs(jitter_delta) > vec2f(1.0))) { return 1u; }
+    let current = textureLoad(tInput, p, 0);
+    let metadata = textureLoad(tMetadata, p, 0).rg;
+    let velocity = textureLoad(tVelocity, p, 0).rg;
+    if (!is_finite(current.x) || !is_finite(current.y) || !is_finite(current.z) || !is_finite(current.w)
+        || !is_finite(metadata.x) || !is_finite(metadata.y)
+        || !is_finite(velocity.x) || !is_finite(velocity.y)) { return 1u; }
+    // Velocity is already in INTERNAL PIXELS. Depth clipping can select a neighboring
+    // velocity; the dilated mask protects that neighbor's moving coverage too.
+    if (any(velocity != vec2f(0.0)) || current.w != 0.0 || any(metadata != vec2f(0.0))) { return 1u; }
+    if (any(current.rgb < vec3f(0.0))) { return 1u; }
+    let size = vec2i(textureDimensions(tInput));
+    // Every horizontal/vertical color boundary has an owner. The tile halo then
+    // covers both sides, including boundaries between tiles and isoluminant colors.
+    if (p.x + 1 < size.x && any(textureLoad(tInput, p + vec2i(1,0), 0).rgb != current.rgb)) { return 1u; }
+    if (p.y + 1 < size.y && any(textureLoad(tInput, p + vec2i(0,1), 0).rgb != current.rgb)) { return 1u; }
+    if (history_valid) {
+        let old = textureLoad(tHistory, p, 0);
+        let old_metadata = textureLoad(tHistoryMetadata, p, 0);
+        // Comparisons also keep invalid history active. A hard reset never loads it.
+        if (!all(old == current) || !all(old_metadata.rg == metadata)
+            || !is_finite(old_metadata.x) || !is_finite(old_metadata.z)
+            || !(old_metadata.w == rgb_to_luminance(current.rgb))) { return 1u; }
+    }
+    return 0u;
+}
+`, [chunk_is_finite, chunk_rgb_to_luminance]);

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

@@ -1 +1 @@
-{"version":3,"file":"chunk_ssr_sample_history.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/postprocess/ssr/reproject/chunk_ssr_sample_history.js"],"names":[],"mappings":"AAUA,8FAA8F;AAC9F,iDAwEkD;0BAnFxB,uCAAuC"}
+{"version":3,"file":"chunk_ssr_sample_history.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/postprocess/ssr/reproject/chunk_ssr_sample_history.js"],"names":[],"mappings":"AAWA,8FAA8F;AAC9F,iDAwEgF;0BApFtD,uCAAuC"}