@woosh/meep-engine 3.47.0 → 3.50.0

package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js

@@ -3,7 +3,7 @@ import { RenderPipelineDescriptor } from "../../../../descriptor/pipeline/render
 import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js";
 import { DEPTH_BACKGROUND_VALUE } from "../../../depth/DEPTH_BACKGROUND_VALUE.js";
 import { STANDARD_MATERIAL_TEMPLATE } from "../../../material/standard/STANDARD_MATERIAL_TEMPLATE.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_mat4_extract_position } from "../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import { chunk_dielectric_specular_color } from "../../../shader/chunk/material/chunk_dielectric_specular_color.js";
 import { chunk_unjitter_uv } from "../../../shader/chunk/texture/chunk_unjitter_uv.js";
@@ -99,7 +99,7 @@ fn main(
         let view_position = mat4_extract_position(camera.transform);
         let view_direction = normalize(view_position - vert.position_ws);
         let nov = saturate(abs(dot(normalize(vert.normal), view_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));
         // No per-channel transmission tint in the material today — scalar
         // MBOIT can't filter the background per-channel. For tinted/dark
@@ -138,7 +138,7 @@ fn main(
         chunk_unjitter_uv,
         chunk_mat4_extract_position,
         chunk_dielectric_specular_color,
-        chunk_F_Hauber,
+        chunk_F_Schlick,
     ]
 );
 

package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.d.ts

@@ -1,9 +1,18 @@
 /**
- * MBOIT resolve, one pipeline per template that can be drawn forward. See
- * `oit_resolve_fragment_body.js`, which holds the body both resolve passes run.
+ * The resolve's own group, group 2: the view, the moments, and what every indirect lighting mode
+ * reads (`brick4`; `tEnvironment` is the lights'). The orchestrator binds it by name.
+ *
+ * @type {ShaderResourceGroupDescriptor}
+ */
+export const OIT_RESOLVE_VIEW_GROUP: ShaderResourceGroupDescriptor;
+/**
+ * MBOIT resolve, one pipeline per template that can be drawn forward and per switch set: the set picks
+ * the indirect lighting the fragment links (`chunk_forward_sample_indirect`), and the bindings are the
+ * same for every set. See `oit_resolve_fragment_body.js` for the body.
  *
  * @type {TemplatePassDescriptor}
  */
 export const shader_oit_resolve_moments: TemplatePassDescriptor;
+import { ShaderResourceGroupDescriptor } from "../../../shader/resource/ShaderResourceGroupDescriptor.js";
 import { TemplatePassDescriptor } from "../../TemplatePassDescriptor.js";
 //# sourceMappingURL=shader_oit_resolve_moments.d.ts.map

package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_oit_resolve_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js"],"names":[],"mappings":"AA6DA;;;;;GAKG;AACH,yCAFU,sBAAsB,CAkC7B;uCAhFoC,iCAAiC"}
+{"version":3,"file":"shader_oit_resolve_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,qCAFU,6BAA6B,CAEmC;AA+B1E;;;;;;GAMG;AACH,yCAFU,sBAAsB,CAmC7B;8CA5F2C,2DAA2D;uCAIlE,iCAAiC"}

package/src/shade/renderer/rasterize/native/oit/shader_oit_resolve_moments.js

@@ -19,7 +19,7 @@ import { SAMPLER_LINEAR_UPSCALE } from "../../../texture/SAMPLER_LINEAR_UPSCALE.
 import { VIEW_UNIFORM_STRUCT } from "../../../view/VIEW_UNIFORM_STRUCT.js";
 import { TemplatePassDescriptor } from "../../TemplatePassDescriptor.js";
 import { rasterization_primitive_state } from "../rasterization_primitive_state.js";
-import { chunk_forward_shade_standard_fragment_brick4 } from "../../forward/chunk_forward_shade_standard_fragment_brick4.js";
+import { chunk_forward_shade_standard_fragment } from "../../forward/chunk_forward_shade_standard_fragment.js";
 import {
     FORWARD_LIGHT_LAYOUT,
     forward_fragment_resources,
@@ -28,14 +28,20 @@ import {
 } from "../../forward/forward_template_pipeline.js";
 import { vertex_shader_chunk } from "../../forward/vertex_shader_chunk.js";
 
+/**
+ * The resolve's own group, group 2: the view, the moments, and what every indirect lighting mode
+ * reads (`brick4`; `tEnvironment` is the lights'). The orchestrator binds it by name.
+ *
+ * @type {ShaderResourceGroupDescriptor}
+ */
+export const OIT_RESOLVE_VIEW_GROUP = new ShaderResourceGroupDescriptor();
 
-const view_group = new ShaderResourceGroupDescriptor();
-
-view_group
+OIT_RESOLVE_VIEW_GROUP
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
     .addUniform("view", VIEW_UNIFORM_STRUCT)
     .addTexture('moments', 'unfilterable-float')
     .addTexture('optical_depth', 'unfilterable-float')
+    // the light map, read under Brick4 indirect lighting
     .addStorageBuffer("brick4",BRICK4_DATA_STRUCT, false)
     .addTexture("tSplitSum", "float")
     .addSampler("sLinear","filtering", SAMPLER_LINEAR_UPSCALE)
@@ -44,39 +50,41 @@ view_group
     .addTexture("tVolumetrics", "float", "3d")
     .addTexture("tSTBN_vec3", "float", "3d")
 
-const pass_groups = [view_group, SHADING_LIGHT_RESOURCE_GROUP];
+const pass_groups = [OIT_RESOLVE_VIEW_GROUP, SHADING_LIGHT_RESOURCE_GROUP];
 
 // the view group keeps the visibility the orchestrator builds its bind group for, as the vertex stage
 // reads the camera from it; the lights are the fragment stage's alone
 const pass_layouts = [
-    view_group.generateBindGroupLayoutDescriptor(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT),
+    OIT_RESOLVE_VIEW_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT),
     FORWARD_LIGHT_LAYOUT,
 ];
 
 const shader_vertex = ShaderDescriptor.from({
     label: 'OIT / vertex shader',
     body: vertex_shader_chunk,
-    resources: forward_vertex_resources([view_group]),
+    resources: forward_vertex_resources([OIT_RESOLVE_VIEW_GROUP]),
 });
 
 /**
- * MBOIT resolve, one pipeline per template that can be drawn forward. See
- * `oit_resolve_fragment_body.js`, which holds the body both resolve passes run.
+ * MBOIT resolve, one pipeline per template that can be drawn forward and per switch set: the set picks
+ * the indirect lighting the fragment links (`chunk_forward_sample_indirect`), and the bindings are the
+ * same for every set. See `oit_resolve_fragment_body.js` for the body.
  *
  * @type {TemplatePassDescriptor}
  */
-export const shader_oit_resolve_moments = new TemplatePassDescriptor("OIT / resolve moments", template => {
+export const shader_oit_resolve_moments = new TemplatePassDescriptor("OIT / resolve moments", (template, switches) => {
     const shader_fragment = ShaderDescriptor.from({
         label: "OIT / resolve moments",
         resources: forward_fragment_resources(template, pass_groups),
         body: CodeChunk.from(OIT_RESOLVE_FRAGMENT_BODY, [
             ...OIT_RESOLVE_FRAGMENT_DEPENDENCIES,
-            chunk_forward_shade_standard_fragment_brick4,
+            chunk_forward_shade_standard_fragment,
         ])
-    });
+    }).variant(switches);
 
     return RenderPipelineDescriptor.from({
-        label: "OIT / resolve moments",
+        // the variant's, which names the switch values it was built for
+        label: shader_fragment.label,
         layout: forward_pipeline_layout(template, pass_layouts),
         vertex: {
             module: {

package/src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.d.ts

@@ -1,3 +1,16 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ */
+/**
+ * Offer the pipelines {@link graph_rasterize_partial_opaque} draws with — see {@link PipelineEnquiry}.
+ * A virtual-geometry scene expands its meshes with more, which are left to its first frame.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} render_pass_descriptor
+ * @param {Readonly<Record<number, GPUCullMode>>} cull_policy
+ */
+export function enquire_rasterize_partial_opaque_pipelines(enquiry: PipelineEnquiry, render_pass_descriptor: RenderPassDescriptor, cull_policy: Readonly<Record<number, GPUCullMode>>): void;
 /**
  *
  * @param {FrameGraph} graph
@@ -20,4 +33,6 @@ export function graph_rasterize_partial_opaque({ graph, buckets, view, render_pa
     depth: number;
     color_targets: number[];
 };
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
+export type RenderPassDescriptor = import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor;
 //# sourceMappingURL=graph_rasterize_partial_opaque.d.ts.map

package/src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_partial_opaque.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;GAeG;AACH,gMAFa;IAAC,eAAe,EAAC,MAAM,CAAC;IAAC,cAAc,EAAC,MAAM,CAAC;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,EAAE,CAAA;CAAC,CA0NjG"}
+{"version":3,"file":"graph_rasterize_partial_opaque.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.js"],"names":[],"mappings":"AA8BA;;;GAGG;AAEH;;;;;;;GAOG;AACH,oEAJW,eAAe,0BACf,oBAAoB,eACpB,SAAS,OAAO,MAAM,cAAc,CAAC,QAY/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,gMAFa;IAAC,eAAe,EAAC,MAAM,CAAC;IAAC,cAAc,EAAC,MAAM,CAAC;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,EAAE,CAAA;CAAC,CA0NjG;8BAhQY,OAAO,6CAA6C,EAAE,eAAe;mCACrE,OAAO,2CAA2C,EAAE,oBAAoB"}

package/src/shade/renderer/rasterize/standard/graph_rasterize_partial_opaque.js

@@ -9,17 +9,50 @@ import { graph_record_stat } from "../../util/graph_record_stat.js";
 import {
     build_indirect_compute_dispatch_command,
     graph_build_indirect_dispatch_command,
+    indirect_compute_dispatch_command_pipeline,
     INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
 } from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
-import { graph_expand_meshes_to_meshlets } from "../expand/mesh/graph_expand_meshes_to_meshlets.js";
+import { shader_meshlet_filter_2way } from "../expand/pass1/filter_meshlets.2-way.compute.js";
+import {
+    enquire_expand_meshes_to_meshlets_pipelines,
+    graph_expand_meshes_to_meshlets
+} from "../expand/mesh/graph_expand_meshes_to_meshlets.js";
 import { graph_vgeo_expand_if_enabled } from "../../geometry/virtual/runtime/graph_vgeo_expand_if_enabled.js";
 import { MeshletFilter2WayPassData, pass_filter_meshlets_2way } from "../expand/pass1/pass_filter_meshlets_2way.js";
 import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
 import { CullPolicy } from "../bucket/construct_primitive_state.js";
-import { graph_meshlets_rasterize_by_bucket } from "../bucket/graph_meshlets_rasterize_by_bucket.js";
+import {
+    enquire_meshlets_rasterize_by_bucket_pipelines,
+    graph_meshlets_rasterize_by_bucket
+} from "../bucket/graph_meshlets_rasterize_by_bucket.js";
 import { rasterization_opaque_buckets } from "../bucket/rasterization_opaque_buckets.js";
 import { graph_clear_raster_targets } from "../graph_clear_raster_targets.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ */
+
+/**
+ * Offer the pipelines {@link graph_rasterize_partial_opaque} draws with — see {@link PipelineEnquiry}.
+ * A virtual-geometry scene expands its meshes with more, which are left to its first frame.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} render_pass_descriptor
+ * @param {Readonly<Record<number, GPUCullMode>>} cull_policy
+ */
+export function enquire_rasterize_partial_opaque_pipelines(enquiry, render_pass_descriptor, cull_policy) {
+    enquiry.compute.push(indirect_compute_dispatch_command_pipeline(enquiry.device, COMPUTE_SHADER_DEFAULT_GROUP_SIZE, false));
+    enquiry.compute.push(shader_hzb_mesh_filter_2way.pipeline);
+
+    enquire_expand_meshes_to_meshlets_pipelines(enquiry);
+
+    enquiry.compute.push(indirect_compute_dispatch_command_pipeline(enquiry.device, COMPUTE_SHADER_DEFAULT_GROUP_SIZE, true));
+    enquiry.compute.push(shader_meshlet_filter_2way.pipeline);
+
+    enquire_meshlets_rasterize_by_bucket_pipelines(enquiry, render_pass_descriptor, cull_policy);
+}
+
 /**
  *
  * @param {FrameGraph} graph

package/src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.d.ts

@@ -1,3 +1,15 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ */
+/**
+ * Offer the pipelines {@link graph_rasterize_remaining_opaque} draws with — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} render_pass_descriptor
+ * @param {Readonly<Record<number, GPUCullMode>>} cull_policy
+ */
+export function enquire_rasterize_remaining_opaque_pipelines(enquiry: PipelineEnquiry, render_pass_descriptor: RenderPassDescriptor, cull_policy: Readonly<Record<number, GPUCullMode>>): void;
 /**
  *
  * @param {FrameGraph} graph
@@ -20,4 +32,6 @@ export function graph_rasterize_remaining_opaque({ graph, limits, instances_mayb
     depth: number;
     color_targets: number[];
 };
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
+export type RenderPassDescriptor = import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor;
 //# sourceMappingURL=graph_rasterize_remaining_opaque.d.ts.map

package/src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_remaining_opaque.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;GAiBG;AACH,kOAFa;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,EAAE,CAAA;CAAC,CAqFlD"}
+{"version":3,"file":"graph_rasterize_remaining_opaque.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.js"],"names":[],"mappings":"AAmBA;;;GAGG;AAEH;;;;;;GAMG;AACH,sEAJW,eAAe,0BACf,oBAAoB,eACpB,SAAS,OAAO,MAAM,cAAc,CAAC,QAO/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,kOAFa;IAAC,KAAK,EAAC,MAAM,CAAC;IAAC,aAAa,EAAC,MAAM,EAAE,CAAA;CAAC,CAqFlD;8BAvHY,OAAO,6CAA6C,EAAE,eAAe;mCACrE,OAAO,2CAA2C,EAAE,oBAAoB"}

package/src/shade/renderer/rasterize/standard/graph_rasterize_remaining_opaque.js

@@ -1,13 +1,41 @@
 import { graph_record_stat } from "../../util/graph_record_stat.js";
-import { graph_mesh_filter_one_way } from "../expand/graph_mesh_filter_one_way.js";
-import { graph_meshlets_filter_one_way } from "../expand/graph_meshlets_filter_one_way.js";
-import { graph_expand_meshes_to_meshlets } from "../expand/mesh/graph_expand_meshes_to_meshlets.js";
+import { enquire_mesh_filter_one_way_pipelines, graph_mesh_filter_one_way } from "../expand/graph_mesh_filter_one_way.js";
+import {
+    enquire_meshlets_filter_one_way_pipelines,
+    graph_meshlets_filter_one_way
+} from "../expand/graph_meshlets_filter_one_way.js";
+import {
+    enquire_expand_meshes_to_meshlets_pipelines,
+    graph_expand_meshes_to_meshlets
+} from "../expand/mesh/graph_expand_meshes_to_meshlets.js";
 import { graph_vgeo_expand_if_enabled } from "../../geometry/virtual/runtime/graph_vgeo_expand_if_enabled.js";
 import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
 import { CullPolicy } from "../bucket/construct_primitive_state.js";
-import { graph_meshlets_rasterize_by_bucket } from "../bucket/graph_meshlets_rasterize_by_bucket.js";
+import {
+    enquire_meshlets_rasterize_by_bucket_pipelines,
+    graph_meshlets_rasterize_by_bucket
+} from "../bucket/graph_meshlets_rasterize_by_bucket.js";
 import { rasterization_opaque_buckets } from "../bucket/rasterization_opaque_buckets.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ */
+
+/**
+ * Offer the pipelines {@link graph_rasterize_remaining_opaque} draws with — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} render_pass_descriptor
+ * @param {Readonly<Record<number, GPUCullMode>>} cull_policy
+ */
+export function enquire_rasterize_remaining_opaque_pipelines(enquiry, render_pass_descriptor, cull_policy) {
+    enquire_mesh_filter_one_way_pipelines(enquiry);
+    enquire_expand_meshes_to_meshlets_pipelines(enquiry);
+    enquire_meshlets_filter_one_way_pipelines(enquiry);
+    enquire_meshlets_rasterize_by_bucket_pipelines(enquiry, render_pass_descriptor, cull_policy);
+}
+
 /**
  *
  * @param {FrameGraph} graph

package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.d.ts

@@ -1,3 +1,18 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ */
+/**
+ * Offer the pipelines {@link graph_rasterize_scene} draws a view with — see {@link PipelineEnquiry}.
+ *
+ * The alpha-tested passes offer nothing: their pipelines are per material template, made by the
+ * first frame that meets an alpha-tested material.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} opaque_pass what the job draws opaque meshlets with
+ * @param {Readonly<Record<number, GPUCullMode>>} cull_policy
+ */
+export function enquire_rasterize_scene_pipelines(enquiry: PipelineEnquiry, opaque_pass: RenderPassDescriptor, cull_policy: Readonly<Record<number, GPUCullMode>>): void;
 /**
  * TODO:
  *      - add meshlet -> triangle expansion phase to utilize post-transform vertex cache
@@ -19,4 +34,6 @@ export function graph_rasterize_scene({ graph, job, limits, }: {
     depth: number;
     color_targets: number[];
 };
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
+export type RenderPassDescriptor = import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor;
 //# sourceMappingURL=graph_rasterize_scene.d.ts.map

package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_scene.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_scene.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;GAWG;AACH;IAN+B,KAAK;IACC,GAAG;IACA,MAAM;IACjC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAC,CAmNrE"}
+{"version":3,"file":"graph_rasterize_scene.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/standard/graph_rasterize_scene.js"],"names":[],"mappings":"AAqBA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,2DAJW,eAAe,eACf,oBAAoB,eACpB,SAAS,OAAO,MAAM,cAAc,CAAC,QAQ/C;AAED;;;;;;;;;;;GAWG;AACH;IAN+B,KAAK;IACC,GAAG;IACA,MAAM;IACjC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAC,CAmNrE;8BAlPY,OAAO,6CAA6C,EAAE,eAAe;mCACrE,OAAO,2CAA2C,EAAE,oBAAoB"}

package/src/shade/renderer/rasterize/standard/graph_rasterize_scene.js

@@ -1,16 +1,46 @@
 import { assert } from "../../../../core/assert.js";
 import { graph_build_hzb } from "../../hiz/graph_build_hzb.js";
+import { HierarchicalZBuffer } from "../../hiz/HierarchicalZBuffer.js";
 import { ShadeDrawSide } from "../../material/ShadeDrawSide.js";
 import { graph_import_buffer } from "../../shader/graph/graph_import_buffer.js";
 import { graph_import_texture } from "../../shader/graph/graph_import_texture.js";
 import { graph_record_stat } from "../../util/graph_record_stat.js";
-import { graph_mesh_frustum_cull } from "../compute/graph_mesh_frustum_cull.js";
+import { enquire_mesh_frustum_cull_pipelines, graph_mesh_frustum_cull } from "../compute/graph_mesh_frustum_cull.js";
 import { rasterization_material_bucket } from "../expand/bucket/chunk_rasterization_material_bucket.js";
-import { graph_meshes_classify_buckets } from "../expand/bucket/mesh/graph_meshes_classify_buckets.js";
+import {
+    enquire_meshes_classify_buckets_pipelines,
+    graph_meshes_classify_buckets
+} from "../expand/bucket/mesh/graph_meshes_classify_buckets.js";
 import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
 import { graph_rasterize_meshes_alpha_tested } from "../native/graph_rasterize_meshes_alpha_tested.js";
-import { graph_rasterize_partial_opaque } from "./graph_rasterize_partial_opaque.js";
-import { graph_rasterize_remaining_opaque } from "./graph_rasterize_remaining_opaque.js";
+import { enquire_rasterize_partial_opaque_pipelines, graph_rasterize_partial_opaque } from "./graph_rasterize_partial_opaque.js";
+import {
+    enquire_rasterize_remaining_opaque_pipelines,
+    graph_rasterize_remaining_opaque
+} from "./graph_rasterize_remaining_opaque.js";
+
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ */
+
+/**
+ * Offer the pipelines {@link graph_rasterize_scene} draws a view with — see {@link PipelineEnquiry}.
+ *
+ * The alpha-tested passes offer nothing: their pipelines are per material template, made by the
+ * first frame that meets an alpha-tested material.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} opaque_pass what the job draws opaque meshlets with
+ * @param {Readonly<Record<number, GPUCullMode>>} cull_policy
+ */
+export function enquire_rasterize_scene_pipelines(enquiry, opaque_pass, cull_policy) {
+    enquire_mesh_frustum_cull_pipelines(enquiry);
+    enquire_meshes_classify_buckets_pipelines(enquiry);
+    enquire_rasterize_partial_opaque_pipelines(enquiry, opaque_pass, cull_policy);
+    HierarchicalZBuffer.enquirePipelines(enquiry);
+    enquire_rasterize_remaining_opaque_pipelines(enquiry, opaque_pass, cull_policy);
+}
 
 /**
  * TODO:

package/src/shade/renderer/restir/di/RESTIR_RADIANCE_RESOURCE.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ReSTIR DI's resolved radiance, read when the deferred pass shades local lights by ReSTIR.
+ * @type {ShaderResourceDescriptor}
+ */
+export const RESTIR_RADIANCE_RESOURCE: ShaderResourceDescriptor;
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+//# sourceMappingURL=RESTIR_RADIANCE_RESOURCE.d.ts.map

package/src/shade/renderer/restir/di/RESTIR_RADIANCE_RESOURCE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RESTIR_RADIANCE_RESOURCE.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/RESTIR_RADIANCE_RESOURCE.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,uCAFU,wBAAwB,CAE0D;yCANnD,mDAAmD"}

package/src/shade/renderer/restir/di/RESTIR_RADIANCE_RESOURCE.js

@@ -0,0 +1,7 @@
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+
+/**
+ * ReSTIR DI's resolved radiance, read when the deferred pass shades local lights by ReSTIR.
+ * @type {ShaderResourceDescriptor}
+ */
+export const RESTIR_RADIANCE_RESOURCE = ShaderResourceDescriptor.texture("tRestirRadiance");

package/src/shade/renderer/restir/di/chunk_restir_resolve.d.ts

@@ -4,9 +4,11 @@
  *   radiance = BRDF·Le·G (full RGB, unshadowed) · W · V
  *
  * where W == reservoir.weightSum after FinalizeResampling (it already folds in
- * 1/p_hat and 1/M) and V is the traced visibility. Because p_hat was the
- * luminance of this same unshadowed BRDF·Le·G, the scalar normalization cancels
- * and the RGB is carried exactly (the RTXDI `f_rgb · weightSum` identity).
+ * 1/p_hat and 1/M) and V is the traced visibility (the RTXDI `f_rgb · weightSum`
+ * identity). p_hat is the luminance of the single-scattering BRDF·Le·G; this
+ * BRDF also carries `re_direct_multiscatter`'s per-pixel scale of the specular,
+ * so f / p_hat is no longer 1 but stays within [1, that scale]. The estimate is
+ * unbiased either way: f and p_hat are positive on the same lights.
  *
  * Visibility is a single opaque shadow ray toward the survivor's sampled emitter
  * point — matching the brute-force NEE reference (`ray_sample_light`), which also

package/src/shade/renderer/restir/di/chunk_restir_resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_restir_resolve.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/chunk_restir_resolve.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;GAiBG;AACH,mCAFU,SAAS,CA6DjB;0BAnFwB,oCAAoC"}
+{"version":3,"file":"chunk_restir_resolve.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/chunk_restir_resolve.js"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,mCAFU,SAAS,CA+DjB;0BAvFwB,oCAAoC"}

package/src/shade/renderer/restir/di/chunk_restir_resolve.js

@@ -1,4 +1,5 @@
 import { REFLECTED_LIGHT_STRUCT } from "../../shader/chunk/light/REFLECTED_LIGHT_STRUCT.js";
+import { chunk_re_direct_multiscatter } from "../../shader/chunk/material/chunk_re_direct_multiscatter.js";
 import { chunk_re_direct_physical } from "../../shader/chunk/material/chunk_re_direct_physical.js";
 import { GEOMETRIC_SHADING_INFO_STRUCT } from "../../shader/chunk/material/GEOMETRIC_SHADING_INFO_STRUCT.js";
 import { MATERIAL_SHADING_INFO_STRUCT } from "../../shader/chunk/material/MATERIAL_SHADING_INFO_STRUCT.js";
@@ -15,9 +16,11 @@ import { chunk_restir_trace_visibility } from "./chunk_restir_trace_visibility.j
  *   radiance = BRDF·Le·G (full RGB, unshadowed) · W · V
  *
  * where W == reservoir.weightSum after FinalizeResampling (it already folds in
- * 1/p_hat and 1/M) and V is the traced visibility. Because p_hat was the
- * luminance of this same unshadowed BRDF·Le·G, the scalar normalization cancels
- * and the RGB is carried exactly (the RTXDI `f_rgb · weightSum` identity).
+ * 1/p_hat and 1/M) and V is the traced visibility (the RTXDI `f_rgb · weightSum`
+ * identity). p_hat is the luminance of the single-scattering BRDF·Le·G; this
+ * BRDF also carries `re_direct_multiscatter`'s per-pixel scale of the specular,
+ * so f / p_hat is no longer 1 but stays within [1, that scale]. The estimate is
+ * unbiased either way: f and p_hat are positive on the same lights.
  *
  * Visibility is a single opaque shadow ray toward the survivor's sampled emitter
  * point — matching the brute-force NEE reference (`ray_sample_light`), which also
@@ -48,6 +51,7 @@ fn restir_resolve(
     let incident = restir_get_light_info(light_type, light_index, geometry.position);
     var reflected: ${REFLECTED_LIGHT_STRUCT.wgsl_ref};
     re_direct_physical(incident, geometry, material, &reflected);
+    re_direct_multiscatter(geometry, material, &reflected);
     let radiance = reflected.diffuse + reflected.specular;
 
     if (all(radiance <= vec3<f32>(0.0))) {
@@ -81,6 +85,7 @@ fn restir_resolve(
         GEOMETRIC_SHADING_INFO_STRUCT.declaration_chunk,
         MATERIAL_SHADING_INFO_STRUCT.declaration_chunk,
         chunk_re_direct_physical,
+        chunk_re_direct_multiscatter,
         chunk_restir_get_light_info,
         chunk_restir_light_ref,
         chunk_restir_sample_light_record,

package/src/shade/renderer/restir/di/graph_restir_di.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_restir_di.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/graph_restir_di.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,+RAFa,MAAM,CAsLlB"}
+{"version":3,"file":"graph_restir_di.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/graph_restir_di.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,+RAFa,MAAM,CAuLlB"}

package/src/shade/renderer/restir/di/graph_restir_di.js

@@ -163,6 +163,7 @@ export function graph_restir_di({
                 gBufferEmissive: resources.get(data.emissive).obtainView(),
                 tDepth: resources.get(data.depth).obtainView(),
                 tHZB: resources.get(data.hzb).obtainView(),
+                tSplitSum: STATIC_GRAPHICS_ENGINE_ASSETS.split_sum,
                 output: out.obtainView(),
                 camera: view.camera.buffer,
                 view: view.uniform_buffer.buffer,

package/src/shade/renderer/restir/di/shader_restir_di_resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_restir_di_resolve.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_resolve.js"],"names":[],"mappings":"AAgGA,qDAIG;8BA9F2B,+BAA+B"}
+{"version":3,"file":"shader_restir_di_resolve.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/di/shader_restir_di_resolve.js"],"names":[],"mappings":"AAoGA,qDAIG;8BAlG2B,+BAA+B"}

package/src/shade/renderer/restir/di/shader_restir_di_resolve.js

@@ -8,6 +8,7 @@ import { ComputeShader } from "../../shader/ComputeShader.js";
 import { ShaderResourceGroupDescriptor } from "../../shader/resource/ShaderResourceGroupDescriptor.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { sr_create_group_RTX } from "../../geometry/sr_create_group_RTX.js";
+import { SAMPLER_LINEAR_UPSCALE } from "../../texture/SAMPLER_LINEAR_UPSCALE.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
 import { chunk_restir_reconstruct_surface } from "./chunk_restir_reconstruct_surface.js";
 import { chunk_restir_reservoir_address } from "./chunk_restir_reservoir_address.js";
@@ -43,7 +44,10 @@ resources.createGroup()
     .addTexture("tHZB")
     .addStorageTexture("output", "rgba16float", "2d", "write-only")
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT);
+    .addUniform("view", VIEW_UNIFORM_STRUCT)
+    // the split-sum LUT, for the direct specular's multiple-scattering compensation
+    .addTexture("tSplitSum", "float")
+    .addSampler("sLinear", "filtering", SAMPLER_LINEAR_UPSCALE);
 
 // Local light tables (resolve re-evaluates the selected light; no clusters needed).
 const RESTIR_DI_RESOLVE_LIGHT_GROUP = new ShaderResourceGroupDescriptor();

package/src/shade/renderer/restir/reservoir/shader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/reservoir/shader.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,6CAFU,SAAS,CAwBjB;AAEF;;;;GAIG;AACH,8CAFU,SAAS,CA2CjB;0BAlFwB,oCAAoC"}
+{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/restir/reservoir/shader.js"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,6CAFU,SAAS,CAwBjB;AAEF;;;;GAIG;AACH,8CAFU,SAAS,CA6CjB;0BApFwB,oCAAoC"}

package/src/shade/renderer/restir/reservoir/shader.js

@@ -1,3 +1,4 @@
+import { F32_MAX_DEFINITION } from "../../shader/chunk/math/F32_MAX_DEFINITION.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { chunk_rtxdi_internal_simple_resample } from "./chunk_rtxdi_internal_simple_resample.js";
 import { RTXDI_Reservoir } from "./RTXDI_Reservoir.js";
@@ -47,9 +48,6 @@ fn RTXDI_FinalizeResampling(
     normalizationNumerator: f32,
     normalizationDenominator: f32
 ){
-    // largest finite f32; both an infinity and a NaN fail the comparison against it
-    const WEIGHT_LIMIT = 3.4028235e38;
-
     let denominator = reservoir.targetPdf * normalizationDenominator;
 
     let weight = (reservoir.weightSum * normalizationNumerator) / denominator;
@@ -74,10 +72,15 @@ fn RTXDI_FinalizeResampling(
 
      Zero is the right answer for all of them: it is what an empty reservoir carries, and it is the
      one value restir_resolve already rejects.
+
+     F32_MAX is the largest finite f32, so both an infinity and a NaN fail the comparison against it.
+     It is spelled below that f32 on purpose: 3.4028235e38, the decimal that names it, is above it,
+     and a device refuses to convert it to f32 at all, so the passes linking this did not compile.
     */
-    reservoir.weightSum = select(0.0, weight, weight > 0.0 && weight < WEIGHT_LIMIT);
+    reservoir.weightSum = select(0.0, weight, weight > 0.0 && weight < F32_MAX);
 }
     `, [
         RTXDI_Reservoir.declaration_chunk,
+        F32_MAX_DEFINITION,
     ]
 );

package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.d.ts

@@ -2,6 +2,12 @@
  * Top-Level Acceleration Structure (TLAS)
  */
 export class GPUInstancesAccelerationStructure {
+    /**
+     * Offer the pipelines the tree is built with — see {@link PipelineEnquiry}.
+     *
+     * @param {PipelineEnquiry} enquiry
+     */
+    static enquirePipelines(enquiry: PipelineEnquiry): void;
     /**
      *
      * @param {GraphicsContext} graphics
@@ -76,6 +82,7 @@ export class GPUInstancesAccelerationStructure {
     destroy(): void;
     #private;
 }
+export type PipelineEnquiry = import("../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 export type GraphicsContext = import("../GraphicsContext.js").GraphicsContext;
 import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
 //# sourceMappingURL=GPUInstancesAccelerationStructure.d.ts.map

package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUInstancesAccelerationStructure.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/scene/GPUInstancesAccelerationStructure.js"],"names":[],"mappings":"AAmCA;;GAEG;AACH;IA8DI;;;OAGG;IACH,sBAFW,eAAe,EAqBzB;IAzED,cAIC;IAOD;;;OAGG;IACH,wBAEC;IAmED;;;;OAIG;IACH,oBAFW,MAAM,QAUhB;IAED;;;;;OAKG;IACH,uBAFW,MAAM,QAUhB;IAED;;;;OAIG;IACH,uBAFW,MAAM,QAOhB;IA8CD;;;;OAIG;IACH;;;OAGG;IACH,mBAEC;IAiGD;;;;;;;;;;;;OAYG;IACH,0BAHW,YAAY,GAAC,YAAY,GAAC,MAAM,EAAE,GAChC,QAAQ,OAAO,CAAC,CA0C5B;IAED;;;OAGG;IACH,wDAFW,sBAAsB,QAMhC;IAED;;;;;;OAMG;IACH,mDAHW,sBAAsB,QAShC;IAED;;;OAGG;IACH,gBAKC;;CACJ;8BAxZY,OAAO,uBAAuB,EAAE,eAAe;uCARrB,wCAAwC"}
+{"version":3,"file":"GPUInstancesAccelerationStructure.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/scene/GPUInstancesAccelerationStructure.js"],"names":[],"mappings":"AAoCA;;GAEG;AACH;IAEI;;;;OAIG;IACH,iCAFW,eAAe,QAKzB;IA+DD;;;OAGG;IACH,sBAFW,eAAe,EAqBzB;IAzED,cAIC;IAOD;;;OAGG;IACH,wBAEC;IAmED;;;;OAIG;IACH,oBAFW,MAAM,QAUhB;IAED;;;;;OAKG;IACH,uBAFW,MAAM,QAUhB;IAED;;;;OAIG;IACH,uBAFW,MAAM,QAOhB;IA8CD;;;;OAIG;IACH;;;OAGG;IACH,mBAEC;IAiGD;;;;;;;;;;;;OAYG;IACH,0BAHW,YAAY,GAAC,YAAY,GAAC,MAAM,EAAE,GAChC,QAAQ,OAAO,CAAC,CA0C5B;IAED;;;OAGG;IACH,wDAFW,sBAAsB,QAMhC;IAED;;;;;;OAMG;IACH,mDAHW,sBAAsB,QAShC;IAED;;;OAGG;IACH,gBAKC;;CACJ;8BApaY,OAAO,0CAA0C,EAAE,eAAe;8BAClE,OAAO,uBAAuB,EAAE,eAAe;uCATrB,wCAAwC"}

package/src/shade/renderer/scene/GPUInstancesAccelerationStructure.js

@@ -5,10 +5,11 @@ import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
 import { ensure_buffer_capacity } from "../geometry/make_temp_gpu_buffer.js";
 import { BVH_HEADER_WORDS, BVH_NODE_STRIDE_WORDS, bvh_buffer_size } from "../gpu_primitive/bvh/BVH_BUFFER_LAYOUT.js";
 import { BVH_NULL_NODE, bvh_tree_views, read_bvh_node } from "../gpu_primitive/bvh/check_bvh_structure.js";
-import { graph_bvh_build_lbvh } from "../gpu_primitive/bvh/graph_bvh_build_lbvh.js";
+import { enquire_bvh_build_lbvh_pipelines, graph_bvh_build_lbvh } from "../gpu_primitive/bvh/graph_bvh_build_lbvh.js";
 import { shader_bvh_extract_instance_leaves } from "./shader_bvh_extract_instance_leaves.js";
 
 /**
+ * @typedef {import("../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
  * @typedef {import("../GraphicsContext.js").GraphicsContext} GraphicsContext
  */
 
@@ -38,6 +39,17 @@ const SCENE_BOUNDS_SEED = Uint32Array.from([
  */
 export class GPUInstancesAccelerationStructure {
 
+    /**
+     * Offer the pipelines the tree is built with — see {@link PipelineEnquiry}.
+     *
+     * @param {PipelineEnquiry} enquiry
+     */
+    static enquirePipelines(enquiry) {
+        enquiry.compute.push(shader_bvh_extract_instance_leaves.pipeline);
+        enquire_bvh_build_lbvh_pipelines(enquiry);
+    }
+
+
     /**
      * @type {GraphicsContext}
      */