@woosh/meep-engine 3.47.0 → 3.50.0

package/src/shade/renderer/path_tracer/graph_path_trace_scene.js

@@ -16,6 +16,8 @@ import { sr_create_group_RTX } from "../geometry/sr_create_group_RTX.js";
 import { INDIRECT_MATERIAL_ARRAY_TYPE } from "../material/resident/INDIRECT_MATERIAL_ARRAY_TYPE.js";
 import { MEDIA_TABLE_STRUCT } from "../medium/MEDIA_TABLE_STRUCT.js";
 import { chunk_render_trace_path } from "./shader/chunk_render_trace_path.js";
+import { PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR } from "../volumetrics/noise/PARTICIPATING_MEDIA_NOISE.js";
+import { wind_field_add_resources } from "../wind/wind_field_add_resources.js";
 
 const RAY_TRACING_UNIFORMS_STRUCT = WebGPUStruct.from({
     random_seed: u32
@@ -30,9 +32,13 @@ resources.createGroup()
     .addUniform("media", MEDIA_TABLE_STRUCT)
     .addTexture("textures", "unfilterable-float", "2d-array")
 
-resources.createGroup()
+// the scene's wind, which carries the fog volumes' noise: one uniform, one texture, one sampler
+wind_field_add_resources(resources.createGroup()
     .addStorageBuffer("light_data", WebGPUArray.u32)
     .addTexture("tEnvironment", "unfilterable-float", "2d")
+    // the fog volumes' noise, read through participating_media_volume_density_at
+    .addTexture("tParticipatingMediaNoise", "float", "3d")
+    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR));
 
 resources.createGroup()
     .addUniform("common_uniforms", RAY_TRACING_UNIFORMS_STRUCT)
@@ -166,6 +172,10 @@ export function graph_path_trace_scene({
                 //
                 light_data: scene_ctx.lights.buffer_data,
                 tEnvironment: view.scene.lights.environment.obtainView(),
+                tParticipatingMediaNoise: scene_ctx.volumetrics.noise_atlas.texture.obtainView(),
+                sParticipatingMediaNoise: graphics.samplers.obtain(PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR),
+                wind_field: scene_ctx.wind.uniform,
+                wind_field_atlas: scene_ctx.wind.atlas.texture,
 
                 common_uniforms: rt_uniforms,
                 camera: view.camera.gpu_buffer,

package/src/shade/renderer/path_tracer/shader/chunk_render_trace_path.js

@@ -5,7 +5,7 @@ import { chunk_scene_database_access } from "../../scene/chunk_scene_database_ac
 import { chunk_BRDF_GGX } from "../../shader/chunk/brdf/chunk_BRDF_GGX.js";
 import { chunk_compute_ggx_vndf_pdf } from "../../shader/chunk/brdf/chunk_compute_ggx_pdf.js";
 import { chunk_oren_nayar_compensated_diffuse } from "../../shader/chunk/brdf/diffuse/EON.js";
-import { chunk_F_Hauber } from "../../shader/chunk/brdf/fresnel/chunk_F_Hauber.js";
+import { chunk_F_Schlick } from "../../shader/chunk/brdf/fresnel/chunk_F_Schlick.js";
 import { chunk_rgb_to_luminance } from "../../shader/chunk/color/chunk_rgb_to_luminance.js";
 import { chunk_sample_reflection_vector } from "../../shader/chunk/screen_space/chunk_sample_reflection_vector.js";
 import {
@@ -511,7 +511,7 @@ fn render_trace_path(
             }
         }
                 
-        let fresnel = F_Hauber(shading_material.specularF0, shading_material.specularF90, NoV);
+        let fresnel = F_Schlick(shading_material.specularF0, shading_material.specularF90, NoV);
         let specular_weight = rgb_to_luminance(fresnel);
         let diffuse_weight = rgb_to_luminance(shading_material.diffuse);
 
@@ -541,7 +541,7 @@ fn render_trace_path(
             let VoH = saturate(dot(V, H));
 
             // Fresnel evaluated for this specific bounce
-            let F = F_Hauber(shading_material.specularF0, shading_material.specularF90, VoH);
+            let F = F_Schlick(shading_material.specularF0, shading_material.specularF90, VoH);
 
             // This is the "Magic" cancellation for VNDF + Smith Correlated
             let a2 = alpha * alpha;
@@ -655,7 +655,7 @@ fn render_trace_path(
         chunk_get_cosine_weighted_sample,
         chunk_compute_ggx_vndf_pdf,
         chunk_russian_roulette,
-        chunk_F_Hauber,
+        chunk_F_Schlick,
         chunk_shadow_terminator_term_Dreamworks2020,
         chunk_scene_database_access,
         chunk_participating_media_volumes_iterate,

package/src/shade/renderer/path_tracer/shader/chunk_sample_material_data.js

@@ -2,7 +2,7 @@ import { chunk_compute_normal_matrix_from_m4 } from "../../shader/chunk/geometry
 import {
     chunk_mat4_linear_determinant
 } from "../../shader/chunk/geometry/mat4/chunk_mat4_linear_determinant.js";
-import { chunk_F_Hauber } from "../../shader/chunk/brdf/fresnel/chunk_F_Hauber.js";
+import { chunk_F_Schlick } from "../../shader/chunk/brdf/fresnel/chunk_F_Schlick.js";
 import { chunk_albedo_unpremultiply } from "../../shader/chunk/material/chunk_albedo_unpremultiply.js";
 import {
     chunk_build_orthonormal_matrix_nt
@@ -90,7 +90,7 @@ fn sample_material_alpha(
         let f_metalness = material.metallic_factor; // ORM texture not sampled in alpha path; metallic_factor is enough for typical glass (metalness = 0)
         let specular_f0 = dielectric_specular_color(material.ior_factor, f_metalness, albedo);
         let nov = saturate(abs(dot(world_face_normal, ray_direction)));
-        let f_view = F_Hauber(specular_f0, 1.0, nov);
+        let f_view = F_Schlick(specular_f0, 1.0, nov);
         let f_scalar = max(f_view.r, max(f_view.g, f_view.b));
         // Glass coverage tracks the view-Fresnel reflection coefficient.
         // No per-channel transmission tint in the material today — when one
@@ -127,7 +127,7 @@ fn sample_material_alpha(
         chunk_interpolate_attribute_2f32,
         chunk_dielectric_specular_color,
         chunk_albedo_unpremultiply,
-        chunk_F_Hauber,
+        chunk_F_Schlick,
     ]
 )
 

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

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

@@ -44,19 +44,22 @@ export class SSR {
      * @param {number} options.input_normal
      * @param {number} options.input_velocity
      * @param {number} options.input_occlusion
-     * @param {number} [options.input_environment]
+     * @param {number} options.input_environment the environment map
      * @param {ArrayLike<number>} options.resolution
      * @param {number} options.camera_current
      * @param {number} options.camera_previous
-     * @param {ShadeIndirectLightingMode} [options.indirect_lighting_mode] Explicit GI fallback selection
-     * @param {import("../../global_illumination/brick4/Brick4LightMap.js").Brick4LightMap} [options.brick4]
-     * @param {import("../../global_illumination/lpv/GPULightProbeVolume.js").GPULightProbeVolume} [options.lpv]
+     * @param {ShaderSwitchSet} [options.shader_switches] the renderer's; the resolve is built for them, and
+     *   falls back to the indirect lighting they say where the trace finds nothing
+     * @param {import("../../global_illumination/brick4/Brick4LightMap.js").Brick4LightMap} [options.brick4] the scene's,
+     *   while Brick4 runs
+     * @param {import("../../global_illumination/lpv/GPULightProbeVolume.js").GPULightProbeVolume} [options.lpv] the
+     *   scene's, while LPV runs. A source not given is the resolve's default, for a variant that does not read it
      * @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, 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_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, shader_switches, lpv, brick4, mip, }: {
         graph: import("../../../../engine/graphics/render/frame_graph/FrameGraph.js").FrameGraph;
         input_depth: number;
         input_depth_previous?: number;
@@ -67,11 +70,11 @@ export class SSR {
         input_normal: number;
         input_velocity: number;
         input_occlusion: number;
-        input_environment?: number;
+        input_environment: number;
         resolution: ArrayLike<number>;
         camera_current: number;
         camera_previous: number;
-        indirect_lighting_mode?: ShadeIndirectLightingMode;
+        shader_switches?: ShaderSwitchSet;
         brick4?: import("../../global_illumination/brick4/Brick4LightMap.js").Brick4LightMap;
         lpv?: import("../../global_illumination/lpv/GPULightProbeVolume.js").GPULightProbeVolume;
         view_ctx?: import("../../view/GPUViewContext.js").GPUViewContext;
@@ -87,5 +90,5 @@ export class SSR {
     };
     #private;
 }
-import { ShadeIndirectLightingMode } from "../../ShadeIndirectLightingMode.js";
+import { ShaderSwitchSet } from "../../shader/compiler/ShaderSwitchSet.js";
 //# sourceMappingURL=SSR.d.ts.map

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":"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"}
+{"version":3,"file":"SSR.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/ssr/SSR.js"],"names":[],"mappings":"AAiBA;IA6EI;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH;QAzBsG,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;QACU,iBAAiB,EAAjC,MAAM;QACqB,UAAU,EAArC,UAAU,MAAM,CAAC;QACD,cAAc,EAA9B,MAAM;QACU,eAAe,EAA/B,MAAM;QACoB,eAAe,GAAzC,eAAe;QAEuE,MAAM,GAA5F,OAAO,oDAAoD,EAAE,cAAc;QAEkB,GAAG,GAAhG,OAAO,sDAAsD,EAAE,mBAAmB;QAElB,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,CAsQtH;;CACJ;gCApa+B,0CAA0C"}