@woosh/meep-engine 3.29.0 → 3.31.0

package/src/shade/renderer/rasterize/native/graph_rasterize_meshes_alpha_tested.js

@@ -1,5 +1,4 @@
 import { assert } from "../../../../core/assert.js";
-import { rp_rewrite_for_primitive_state } from "../../../device/pipeline/rp_rewrite_for_primitive_state.js";
 import { STRUCT_UNINDEXED_DRAW_COMMAND } from "../../gpu_primitive/indirect/STRUCT_UNINDEXED_DRAW_COMMAND.js";
 import { BindGroupDescriptor } from "../../binding/BindGroupDescriptor.js";
 import { ShadeDrawMode } from "../../material/ShadeDrawMode.js";
@@ -9,12 +8,14 @@ import { graph_import_buffer } from "../../shader/graph/graph_import_buffer.js";
 import { HILBERT_R2_INDEX_TEXTURE } from "../../texture/noise/HILBERT_R2_INDEX_TEXTURE.js";
 import { texture_fill_rectangle } from "../../texture/util/texture_fill_rectangle.js";
 import { rasterization_material_bucket } from "../expand/bucket/chunk_rasterization_material_bucket.js";
-import { construct_primitive_state, CullPolicy } from "../bucket/construct_primitive_state.js";
+import { CullPolicy } from "../bucket/construct_primitive_state.js";
 import { filter_materials_by_bucket } from "../bucket/filter_materials_by_bucket.js";
 import {
     graph_prepare_meshlet_draw_commands_by_material
 } from "../bucket/prepare_meshlet_draw_commands_by_material.js";
 import {
+    ALPHA_TESTED_SCENE_LAYOUT,
+    ALPHA_TESTED_VIEW_LAYOUT,
     RASTERIZATION_SHADER_BIND_GROUP_MATERIAL,
     RASTERIZATION_SHADER_BIND_GROUP_SCENE,
     RASTERIZATION_SHADER_BIND_GROUP_VIEW
@@ -36,7 +37,7 @@ const DRAW_COMMAND_BYTE_SIZE = STRUCT_UNINDEXED_DRAW_COMMAND.aligned_size;
  * @param {number[]} options.raster_color_targets Resource IDs, color targets
  * @param {GPUCollectionLimits} options.limits
  * @param {number[]} [options.viewport] [x,y, width, height] -1 width/height indicates that we need to disable viewport setup
- * @param {RenderPassDescriptor} options.render_pass_descriptor will rely on material uniforms from material manager
+ * @param {TemplatePassDescriptor} options.render_pass_descriptor the pass, with a pipeline per material template
  * @returns {{executed:boolean, depth:number, color_targets:number[]}} whether a pass was recorded, along with the depth and colour handles to carry forward. When no pass is recorded the input handles are returned unchanged.
  */
 export function graph_rasterize_meshes_alpha_tested({
@@ -61,6 +62,8 @@ export function graph_rasterize_meshes_alpha_tested({
     assert.equal(view_ctx.isGPUViewContext, true, 'view_ctx.isGPUViewContext !== true');
     assert.isBoolean(clear_target, 'clear_target');
 
+    assert.equal(render_pass_descriptor.isTemplatePassDescriptor, true, 'render_pass_descriptor.isTemplatePassDescriptor !== true');
+
     const scene_ctx = view_ctx.scene;
 
     /**
@@ -68,7 +71,10 @@ export function graph_rasterize_meshes_alpha_tested({
      * @type {ShadeMaterial[]}
      */
     const relevant_materials = [];
-    const scene_materials = scene_ctx.drawn_materials;
+
+    // grouped by template — once per drawn set, not per pass — so the commands built below come out
+    // grouped, and the loop switches pipeline once per template
+    const scene_materials = scene_ctx.materials.sorted_by_template(scene_ctx.drawn_materials);
 
     const material_count = filter_materials_by_bucket(
         relevant_materials, 0,
@@ -152,13 +158,6 @@ export function graph_rasterize_meshes_alpha_tested({
 
         const bind_manager = graphics.bind_groups;
 
-        const primitiveState = construct_primitive_state(ShadeDrawMode.Triangles, side, cull_policy);
-
-        const _pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitiveState);
-
-        const pipeline = graphics.render_pipelines.obtain(_pipeline_descriptor)
-        pass_encoder.setPipeline(pipeline);
-
         if (!is_viewport_unrestricted) {
             const width = viewport[2] >= 0 ? viewport[2] : depth_texture.width - viewport[0];
             const height = viewport[3] >= 0 ? viewport[3] : depth_texture.height - viewport[1];
@@ -174,21 +173,23 @@ export function graph_rasterize_meshes_alpha_tested({
         }
 
 
+        // groups 1 and 2 are the same layout under every template's pipeline, so they are bound once
         const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
-            render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_SCENE],
+            ALPHA_TESTED_SCENE_LAYOUT,
             [
                 { buffer: meshlet_buffer },
                 { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
                 { buffer: scene_ctx.geometries.meshlets.buffer_data },
                 { buffer: scene_ctx.scene_database_buffer },
                 { buffer: scene_ctx.geometries.buffer_metadata },
+                { buffer: scene_ctx.materials.metadata_table.buffer },
             ]
         ));
 
         const t_noise = graphics.textures.obtain(HILBERT_R2_INDEX_TEXTURE);
 
         const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
-            render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_VIEW],
+            ALPHA_TESTED_VIEW_LAYOUT,
             [
                 { buffer: view_ctx.camera.buffer.buffer },
                 { buffer: view_ctx.uniform_buffer.buffer },
@@ -202,30 +203,34 @@ export function graph_rasterize_meshes_alpha_tested({
 
         // rasterize
 
+        const render_pipelines = graphics.render_pipelines;
+
+        // one cull mode for the whole pass — `Front` and `Back` share it, the vertex stage reverses
+        const cull_mode = cull_policy[side];
+
         const materials = scene_ctx.materials;
+
+        let bound_template = null;
+
         for (let i = 0; i < material_count; i++) {
 
-            const material = relevant_materials[i];
-            const gpu_material = materials.obtain(material);
+            const gpu_material = materials.obtain(relevant_materials[i]);
 
             if (!gpu_material.is_built) {
                 // skip, not ready for rendering
                 continue;
             }
 
-            // set material-specific bind group at 0
-            const material_bind_group = bind_manager.obtain(BindGroupDescriptor.from(
-                render_pass_descriptor.pipeline.layout.bindGroupLayouts[RASTERIZATION_SHADER_BIND_GROUP_MATERIAL],
-                [
-                    // color/alpha texture
-                    gpu_material.binding_data.texture_diffuse,
-                    // sampler
-                    gpu_material.binding_data.texture_diffuse_sampler,
-                    { buffer: gpu_material.uniform_buffer },
-                ]
-            ));
+            const template = gpu_material.template;
+
+            if (template !== bound_template) {
+                pass_encoder.setPipeline(render_pass_descriptor.obtain_pipeline(render_pipelines, template, cull_mode));
+
+                bound_template = template;
+            }
 
-            pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_MATERIAL, material_bind_group);
+            // the same group 0 the G-buffer pass binds — the layouts are one object
+            pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_MATERIAL, gpu_material.material_binding);
 
             pass_encoder.drawIndirect(
                 command_buffer_draw,
@@ -252,7 +257,10 @@ export function graph_rasterize_meshes_alpha_tested({
         scene: scene_ctx,
         camera: gr_camera,
         hzb,
-        resolution: [viewport[2], viewport[3]],
+        // The texel grid the filter tests against is the render target's, not the scissor's —
+        // viewport defaults to the [0, 0, -1, -1] sentinel and the main view never sets one, so
+        // forwarding it bound -1 as a vec2u and the small-object arm has never rejected anything.
+        resolution: Array.from(view_ctx.resolution),
         label: `${view_ctx.label}/AlphaTested`,
     });
 

package/src/shade/renderer/rasterize/native/material_draw_indirect.d.ts

@@ -1,22 +1,24 @@
 /**
  * One indirect draw per material out of a command buffer built by
- * `graph_prepare_meshlet_draw_commands_by_material`, with the material's bind group at slot 0.
- * Materials whose GPU side is not built yet are skipped. Shared by the MBOIT and AVBOIT
- * orchestrators, which call it once per render pass they record.
+ * `graph_prepare_meshlet_draw_commands_by_material`, under the pipeline of the material's template,
+ * with the material's own group 0 — the bind group the G-buffer pass binds, which the pass's
+ * pipelines lay out the same way, so nothing is built here per material. Materials whose GPU side
+ * is not built yet are skipped. Shared by the MBOIT and AVBOIT orchestrators, which call it once per
+ * render pass they record, after binding every group but 0.
+ *
+ * The list is grouped by template (see {@link GPUMaterialManager#forward_drawable}), so the pipeline
+ * changes once per template, not once per material.
  *
  * @param {GPUMaterialManager} material_manager
  * @param {number} material_count
  * @param {ShadeMaterial[]} materials
- * @param {RenderPassDescriptor} render_pass_descriptor its group 0 is the material group
- * @param {BindGroupManager} bind_manager
+ * @param {TemplatePassDescriptor} render_pass_descriptor
+ * @param {RenderPipelineManager} render_pipelines
+ * @param {GPUCullMode} cull_mode the pass's, for every draw in it
  * @param {ShadeGPURenderPassEncoder} pass_encoder
  * @param {GPUBuffer} command_buffer_draw one `STRUCT_UNINDEXED_DRAW_COMMAND` per material, in order
  */
-export function material_draw_indirect(material_manager: GPUMaterialManager, material_count: number, materials: ShadeMaterial[], render_pass_descriptor: RenderPassDescriptor, bind_manager: BindGroupManager, pass_encoder: ShadeGPURenderPassEncoder, command_buffer_draw: GPUBuffer): void;
-/**
- * The material bind group layout every transparent draw binds at slot 0; hoisted so it is computed
- * once and so the two transparency pipelines cannot disagree on it.
- * @type {BindGroupLayoutDescriptor}
- */
-export const BIND_GROUP_LAYOUT_MATERIAL: BindGroupLayoutDescriptor;
+export function material_draw_indirect(material_manager: GPUMaterialManager, material_count: number, materials: ShadeMaterial[], render_pass_descriptor: TemplatePassDescriptor, render_pipelines: RenderPipelineManager, cull_mode: GPUCullMode, pass_encoder: ShadeGPURenderPassEncoder, command_buffer_draw: GPUBuffer): void;
+export type RenderPipelineManager = import("../../../device/pipeline/RenderPipelineManager.js").RenderPipelineManager;
+export type TemplatePassDescriptor = import("../TemplatePassDescriptor.js").TemplatePassDescriptor;
 //# sourceMappingURL=material_draw_indirect.d.ts.map

package/src/shade/renderer/rasterize/native/material_draw_indirect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material_draw_indirect.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/native/material_draw_indirect.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;GAaG;AACH,6FAPW,MAAM,aACN,eAAe,+JA8CzB;AA7DD;;;;GAIG;AACH,mEAA6J"}
+{"version":3,"file":"material_draw_indirect.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/native/material_draw_indirect.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,6FARW,MAAM,aACN,eAAe,0BACf,sBAAsB,oBACtB,qBAAqB,yGAiD/B;oCAtEY,OAAO,mDAAmD,EAAE,qBAAqB;qCACjF,OAAO,8BAA8B,EAAE,sBAAsB"}

package/src/shade/renderer/rasterize/native/material_draw_indirect.js

@@ -1,28 +1,30 @@
 import { assert } from "../../../../core/assert.js";
 import { STRUCT_UNINDEXED_DRAW_COMMAND } from "../../gpu_primitive/indirect/STRUCT_UNINDEXED_DRAW_COMMAND.js";
-import { BindGroupDescriptor } from "../../binding/BindGroupDescriptor.js";
-import { SHADING_MATERIAL_RESOURCE_GROUP } from "../../material/standard/SHADING_MATERIAL_RESOURCE_GROUP.js";
-
-const DRAW_COMMAND_BYTE_SIZE = STRUCT_UNINDEXED_DRAW_COMMAND.aligned_size;
 
 /**
- * The material bind group layout every transparent draw binds at slot 0; hoisted so it is computed
- * once and so the two transparency pipelines cannot disagree on it.
- * @type {BindGroupLayoutDescriptor}
+ * @typedef {import("../../../device/pipeline/RenderPipelineManager.js").RenderPipelineManager} RenderPipelineManager
+ * @typedef {import("../TemplatePassDescriptor.js").TemplatePassDescriptor} TemplatePassDescriptor
  */
-export const BIND_GROUP_LAYOUT_MATERIAL = SHADING_MATERIAL_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
+
+const DRAW_COMMAND_BYTE_SIZE = STRUCT_UNINDEXED_DRAW_COMMAND.aligned_size;
 
 /**
  * One indirect draw per material out of a command buffer built by
- * `graph_prepare_meshlet_draw_commands_by_material`, with the material's bind group at slot 0.
- * Materials whose GPU side is not built yet are skipped. Shared by the MBOIT and AVBOIT
- * orchestrators, which call it once per render pass they record.
+ * `graph_prepare_meshlet_draw_commands_by_material`, under the pipeline of the material's template,
+ * with the material's own group 0 — the bind group the G-buffer pass binds, which the pass's
+ * pipelines lay out the same way, so nothing is built here per material. Materials whose GPU side
+ * is not built yet are skipped. Shared by the MBOIT and AVBOIT orchestrators, which call it once per
+ * render pass they record, after binding every group but 0.
+ *
+ * The list is grouped by template (see {@link GPUMaterialManager#forward_drawable}), so the pipeline
+ * changes once per template, not once per material.
  *
  * @param {GPUMaterialManager} material_manager
  * @param {number} material_count
  * @param {ShadeMaterial[]} materials
- * @param {RenderPassDescriptor} render_pass_descriptor its group 0 is the material group
- * @param {BindGroupManager} bind_manager
+ * @param {TemplatePassDescriptor} render_pass_descriptor
+ * @param {RenderPipelineManager} render_pipelines
+ * @param {GPUCullMode} cull_mode the pass's, for every draw in it
  * @param {ShadeGPURenderPassEncoder} pass_encoder
  * @param {GPUBuffer} command_buffer_draw one `STRUCT_UNINDEXED_DRAW_COMMAND` per material, in order
  */
@@ -31,7 +33,8 @@ export function material_draw_indirect(
     material_count,
     materials,
     render_pass_descriptor,
-    bind_manager,
+    render_pipelines,
+    cull_mode,
     pass_encoder,
     command_buffer_draw
 ) {
@@ -39,26 +42,29 @@ export function material_draw_indirect(
     assert.defined(material_manager, 'material_manager');
     assert.isNonNegativeInteger(material_count, 'material_count');
     assert.isArray(materials, 'materials');
+    assert.equal(render_pass_descriptor.isTemplatePassDescriptor, true, 'render_pass_descriptor.isTemplatePassDescriptor !== true');
+
+    let bound_template = null;
 
     for (let i = 0; i < material_count; i++) {
 
-        const material = materials[i];
-        const gpu_material = material_manager.obtain(material);
+        const gpu_material = material_manager.obtain(materials[i]);
 
         if (!gpu_material.is_built) {
             // skip, not ready for rendering
             continue;
         }
 
-        const material_resource_group = render_pass_descriptor.resources.groups[0];
-        const binding_entries = material_resource_group.generateBindings(gpu_material.binding_data);
-        const material_bindings = bind_manager.obtain(BindGroupDescriptor.from(
-            BIND_GROUP_LAYOUT_MATERIAL,
-            binding_entries
-        ));
+        const template = gpu_material.template;
+
+        if (template !== bound_template) {
+            pass_encoder.setPipeline(render_pass_descriptor.obtain_pipeline(render_pipelines, template, cull_mode));
+
+            bound_template = template;
+        }
 
         // set material-specific bind group at 0
-        pass_encoder.setBindGroup(0, material_bindings)
+        pass_encoder.setBindGroup(0, gpu_material.material_binding);
 
         pass_encoder.drawIndirect(
             command_buffer_draw,

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

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_meshes_transparent_oit.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js"],"names":[],"mappings":"AAqaA;;;;;;;;;;;;;;;;GAgBG;AACH,uSAFa,MAAM,CAuOlB"}
+{"version":3,"file":"graph_rasterize_meshes_transparent_oit.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/graph_rasterize_meshes_transparent_oit.js"],"names":[],"mappings":"AA6ZA;;;;;;;;;;;;;;;;GAgBG;AACH,uSAFa,MAAM,CAyOlB"}

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

@@ -1,9 +1,7 @@
 import { assert } from "../../../../../core/assert.js";
 import { SamplerDescriptor } from "../../../../descriptor/texture/SamplerDescriptor.js";
 import { TextureResourceDescriptor } from "../../../../device/graph/TextureResourceDescriptor.js";
-import { rp_rewrite_for_primitive_state } from "../../../../device/pipeline/rp_rewrite_for_primitive_state.js";
 import { BindGroupDescriptor } from "../../../binding/BindGroupDescriptor.js";
-import { SHADING_LIGHT_RESOURCE_GROUP } from "../../../deferred/SHADING_LIGHT_RESOURCE_GROUP.js";
 import { ShadeDrawMode } from "../../../material/ShadeDrawMode.js";
 import { ShadeDrawSide } from "../../../material/ShadeDrawSide.js";
 import { TransparencyMode } from "../../../material/TransparencyMode.js";
@@ -30,10 +28,8 @@ import { shader_oit_blend } from "./shader_oit_blend.js";
 import { shader_oit_generate_moments } from "./shader_oit_generate_moments.js";
 import { shader_oit_resolve_moments } from "./shader_oit_resolve_moments.js";
 import { shader_oit_resolve_moments_ibl } from "./shader_oit_resolve_moments_ibl.js";
-import { SHADING_SCENE_RESOURCE_GROUP } from "../../forward/SHADING_SCENE_RESOURCE_GROUP.js";
-
-const BIND_GROUP_LAYOUT_SCENE = SHADING_SCENE_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
-const BIND_GROUP_LAYOUT_LIGHT = SHADING_LIGHT_RESOURCE_GROUP.generateBindGroupLayoutDescriptor(GPUShaderStage.FRAGMENT | GPUShaderStage.VERTEX);
+import { FORWARD_LIGHT_LAYOUT } from "../../forward/forward_template_pipeline.js";
+import { SHADING_SCENE_LAYOUT } from "../../forward/SHADING_SCENE_RESOURCE_GROUP.js";
 
 /**
  *
@@ -121,20 +117,22 @@ function graph_oit_resolve_moments({
         const bind_manager = graphics.bind_groups;
 
         const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
-            BIND_GROUP_LAYOUT_SCENE,
+            SHADING_SCENE_LAYOUT,
             [
                 { buffer: meshlet_buffer },
                 { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
                 { buffer: scene_ctx.geometries.meshlets.buffer_data },
                 { buffer: scene_ctx.scene_database_buffer },
                 { buffer: scene_ctx.geometries.buffer_metadata },
+                // the side each material draws, which the forward vertex stage reads per instance
+                { buffer: scene_ctx.materials.metadata_table.buffer },
             ]
         ));
 
         const sampler_shadowmap = context.graphics.samplers.obtain(SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR);
 
         const light_bindings = bind_manager.obtain(BindGroupDescriptor.from(
-            BIND_GROUP_LAYOUT_LIGHT,
+            FORWARD_LIGHT_LAYOUT,
             [
                 { buffer: view_ctx.scene.lights.buffer_data },
                 view_ctx.scene.lights.environment.obtainView(),
@@ -162,11 +160,6 @@ function graph_oit_resolve_moments({
             storeOp: "store",
         }));
 
-        const pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitive);
-
-        const pipeline = graphics.render_pipelines.obtain(pipeline_descriptor)
-        pass_encoder.setPipeline(pipeline);
-
         pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_SCENE, scene_bindings);
         pass_encoder.setBindGroup(3, light_bindings);
 
@@ -220,7 +213,8 @@ function graph_oit_resolve_moments({
             material_count,
             materials,
             render_pass_descriptor,
-            bind_manager,
+            graphics.render_pipelines,
+            primitive.cullMode,
             pass_encoder,
             command_buffer_draw
         );
@@ -328,13 +322,15 @@ function graph_oit_generate_moments({
         const bind_manager = graphics.bind_groups;
 
         const scene_bindings = bind_manager.obtain(BindGroupDescriptor.from(
-            BIND_GROUP_LAYOUT_SCENE,
+            SHADING_SCENE_LAYOUT,
             [
                 { buffer: meshlet_buffer },
                 { buffer: scene_ctx.geometries.meshlets.buffer_metadata },
                 { buffer: scene_ctx.geometries.meshlets.buffer_data },
                 { buffer: scene_ctx.scene_database_buffer },
                 { buffer: scene_ctx.geometries.buffer_metadata },
+                // the side each material draws, which the forward vertex stage reads per instance
+                { buffer: scene_ctx.materials.metadata_table.buffer },
             ]
         ));
 
@@ -351,11 +347,6 @@ function graph_oit_generate_moments({
             storeOp: "store",
         }));
 
-        const pipeline_descriptor = rp_rewrite_for_primitive_state(render_pass_descriptor.pipeline, primitive);
-
-        const pipeline = graphics.render_pipelines.obtain(pipeline_descriptor)
-        pass_encoder.setPipeline(pipeline);
-
         pass_encoder.setBindGroup(RASTERIZATION_SHADER_BIND_GROUP_SCENE, scene_bindings);
 
         const view_bindings = bind_manager.obtain(BindGroupDescriptor.from(
@@ -373,7 +364,8 @@ function graph_oit_generate_moments({
             material_count,
             materials,
             render_pass_descriptor,
-            bind_manager,
+            graphics.render_pipelines,
+            primitive.cullMode,
             pass_encoder,
             command_buffer_draw
         );
@@ -481,7 +473,9 @@ export function graph_rasterize_meshes_transparent_oit({
      */
     const materials_double = [];
 
-    const scene_materials = scene_ctx.drawn_materials;
+    // what the transparent passes can draw: templates that can be drawn forward, which for now is
+    // the standard one — derived once per drawn set, and the drawn list itself when that is all of it
+    const scene_materials = scene_ctx.materials.forward_drawable(scene_ctx.drawn_materials);
 
     // we need to draw with different pipeline states, so the code is a little convoluted
     // Essentially, we draw double-sided and single-sided materials. `ShadeDrawSide.Back` is

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

@@ -0,0 +1,33 @@
+/**
+ * The fragment stage of the MBOIT resolve pass, shared verbatim by the IBL and Brick4 pipelines
+ * (`shader_oit_resolve_moments_ibl`, `shader_oit_resolve_moments`), which differ only in which
+ * `forward_shade_standard_fragment` they link and in one storage buffer in the view group.
+ *
+ * `diff` over the two files used to report differences on exactly those two imports, that one bind
+ * entry and five label strings — the ~110 lines of WGSL were character-identical. Only one of the two
+ * runs at a time, whichever `indirect_lighting_mode` selects, so a fix landing in one and not the other
+ * had nothing to make it visible. The `c[2] -> 0` guard, the NaN backstop and the coverage clamp all
+ * live in here now.
+ *
+ * Same arrangement as `avboit_draw_fragment_body.js`, which reached it first: the body is a literal
+ * WGSL string and the dependencies a list, so neither is generated or templated — the caller adds its
+ * shading chunk to the list and links it.
+ *
+ * @type {string}
+ */
+export const OIT_RESOLVE_FRAGMENT_BODY: string;
+/**
+ * Everything {@link OIT_RESOLVE_FRAGMENT_BODY} needs except the shading chunk, which is the one thing
+ * the two pipelines choose differently.
+ *
+ * @type {CodeChunk[]}
+ */
+export const OIT_RESOLVE_FRAGMENT_DEPENDENCIES: CodeChunk[];
+/**
+ * The single HDR colour target both resolve pipelines write, additively — the resolve sums one
+ * premultiplied contribution per transparent fragment, which is what makes it order-independent.
+ *
+ * @type {GPUColorTargetState[]}
+ */
+export const OIT_RESOLVE_TARGETS: GPUColorTargetState[];
+//# sourceMappingURL=oit_resolve_fragment_body.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oit_resolve_fragment_body.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/oit_resolve_fragment_body.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;GAgBG;AACH,wCAFU,MAAM,CA4DN;AAEV;;;;;GAKG;AACH,gDAFU,WAAW,CAQnB;AAEF;;;;;GAKG;AACH,kCAFU,qBAAqB,CAkB7B"}

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

@@ -0,0 +1,123 @@
+import { chunk_sample_volumetrics } from "../../../deferred/chunk_sample_volumetrics.js";
+import {
+    chunk_resolve_power_moments_4
+} from "../../../shader/chunk/mboit/moments/power/chunk_resolve_power_moments_4.js";
+import { chunk_unjitter_uv } from "../../../shader/chunk/texture/chunk_unjitter_uv.js";
+import { FORWARD_VERTEX_SHADER_STRUCT } from "../../forward/FORWARD_VERTEX_SHADER_STRUCT.js";
+import { chunk_oit_linearize_depth } from "./chunk_oit_linearize_depth.js";
+import { OIT_COVERAGE_MAX } from "./OIT_CONSTANTS.js";
+
+/**
+ * The fragment stage of the MBOIT resolve pass, shared verbatim by the IBL and Brick4 pipelines
+ * (`shader_oit_resolve_moments_ibl`, `shader_oit_resolve_moments`), which differ only in which
+ * `forward_shade_standard_fragment` they link and in one storage buffer in the view group.
+ *
+ * `diff` over the two files used to report differences on exactly those two imports, that one bind
+ * entry and five label strings — the ~110 lines of WGSL were character-identical. Only one of the two
+ * runs at a time, whichever `indirect_lighting_mode` selects, so a fix landing in one and not the other
+ * had nothing to make it visible. The `c[2] -> 0` guard, the NaN backstop and the coverage clamp all
+ * live in here now.
+ *
+ * Same arrangement as `avboit_draw_fragment_body.js`, which reached it first: the body is a literal
+ * WGSL string and the dependencies a list, so neither is generated or templated — the caller adds its
+ * shading chunk to the list and links it.
+ *
+ * @type {string}
+ */
+export const OIT_RESOLVE_FRAGMENT_BODY =
+    //language=WGSL
+    `
+@fragment
+fn main(
+    @builtin(front_facing) front_facing : bool,
+    vert: ${FORWARD_VERTEX_SHADER_STRUCT.wgsl_ref},
+) -> @location(0) vec4<f32>{
+
+    let coord_u = vec2u(vert.position.xy);
+
+    // this is total absorbance
+    let b_0 = textureLoad(optical_depth, coord_u, 0).r;
+
+    if(b_0 < 0.00100050033f){
+        // indicates that pixel has no opacity
+        // would result in division by 0
+        discard;
+    }
+
+    // need to unjitter UV to account for TAA
+    var vert_adjusted = vert;
+    vert_adjusted.uv = unjitter_uv(vert.uv, view.jitter);
+
+    let shaded = forward_shade_standard_fragment(vert_adjusted, front_facing);
+
+    // composite volumetric fog between the camera and this transparent fragment. Use the linear
+    // view-space depth from the fragment's device depth (vert.position is @builtin(position), so
+    // .z is the device depth — the same metric the opaque path feeds the froxel lookup). NOT
+    // oit_linearize_depth, which returns a normalized [0,1] log-depth for the moment warp and would
+    // collapse every fragment onto a near slice (no fog).
+    let frag_view_depth = get_view_space_depth(vert_adjusted.position.z, camera);
+    let frag_screen_uv = vert_adjusted.position.xy / vec2<f32>(f32(view.width), f32(view.height));
+    let volumetrics = sample_volumetrics(frag_view_depth, frag_screen_uv, vert_adjusted.position.xy);
+
+    let color = shaded.rgb * volumetrics.w + volumetrics.xyz;
+    let opacity = shaded.a;
+
+    // if opacity is 1 - we end up with 0 transmittance, which breaks the algorithm
+    let coverage = min(opacity, ${OIT_COVERAGE_MAX});
+
+    let total_moments1234 = textureLoad(moments, coord_u, 0);
+
+    // linear distance to fragment (vert_adjusted.position is @builtin(position); .z is device depth)
+    let depth = oit_linearize_depth(vert_adjusted.position.z, camera);
+
+    let transmittance = resolve_power_moments_4(
+        depth,
+        b_0,
+        total_moments1234,
+    );
+
+    return vec4(
+        color * coverage, // premultiply
+        coverage
+    ) * transmittance;
+
+}
+        `;
+
+/**
+ * Everything {@link OIT_RESOLVE_FRAGMENT_BODY} needs except the shading chunk, which is the one thing
+ * the two pipelines choose differently.
+ *
+ * @type {CodeChunk[]}
+ */
+export const OIT_RESOLVE_FRAGMENT_DEPENDENCIES = [
+    FORWARD_VERTEX_SHADER_STRUCT.declaration_chunk,
+    chunk_resolve_power_moments_4,
+    chunk_oit_linearize_depth,
+    chunk_unjitter_uv,
+    chunk_sample_volumetrics,
+];
+
+/**
+ * The single HDR colour target both resolve pipelines write, additively — the resolve sums one
+ * premultiplied contribution per transparent fragment, which is what makes it order-independent.
+ *
+ * @type {GPUColorTargetState[]}
+ */
+export const OIT_RESOLVE_TARGETS = [
+    {
+        format: "rgba16float",
+        blend: {
+            color: {
+                operation: "add",
+                srcFactor: "one",
+                dstFactor: "one",
+            },
+            alpha: {
+                operation: "add",
+                srcFactor: "one",
+                dstFactor: "one",
+            }
+        }
+    }
+];

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

@@ -1,3 +1,8 @@
-export const shader_oit_generate_moments: RenderPassDescriptor;
-import { RenderPassDescriptor } from "../../../shader/pass/RenderPassDescriptor.js";
+/**
+ * MBOIT moments, one pipeline per template that can be drawn forward.
+ *
+ * @type {TemplatePassDescriptor}
+ */
+export const shader_oit_generate_moments: TemplatePassDescriptor;
+import { TemplatePassDescriptor } from "../../TemplatePassDescriptor.js";
 //# sourceMappingURL=shader_oit_generate_moments.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shader_oit_generate_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js"],"names":[],"mappings":"AA2MA,+DAAsE;qCAjMjC,8CAA8C"}
+{"version":3,"file":"shader_oit_generate_moments.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js"],"names":[],"mappings":"AAgJA;;;;GAIG;AACH,0CAFU,sBAAsB,CAgE7B;uCArMoC,iCAAiC"}