@woosh/meep-engine 3.46.0 → 3.49.0

package/src/shade/renderer/rasterize/expand/graph_mesh_filter_one_way.js

@@ -1,171 +1,188 @@
-import { assert } from "../../../../core/assert.js";
-import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { STRUCT_DISPATCH_COMPUTE_COMMAND } from "../../gpu_primitive/indirect/STRUCT_DISPATCH_COMPUTE_COMMAND.js";
-import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
-import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
-import { COLLECTION_U32_STRUCT_WRITE } from "../../gpu_primitive/COLLECTION_U32_STRUCT_WRITE.js";
-import { chunk_scene_database_access } from "../../scene/chunk_scene_database_access.js";
-import {
-    chunk_query_depth_from_screen_space_bb
-} from "../../shader/chunk/depth/chunk_query_depth_from_screen_space_bb.js";
-import { AABB3_STRUCT } from "../../shader/chunk/geometry/aabb3/AABB3_STRUCT.js";
-import {
-    chunk_aabb3_project_perspective
-} from "../../shader/chunk/geometry/aabb3/chunk_aabb3_project_perspective.js";
-import { chunk_array_to_aabb3 } from "../../shader/chunk/geometry/aabb3/chunk_array_to_aabb3.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { build_indirect_compute_dispatch_command } from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addStorageBuffer('input', COLLECTION_U32_STRUCT_READ)
-    .addStorageBuffer('output', COLLECTION_U32_STRUCT_WRITE, true)
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
-    .addTexture("texture_hzb")
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
-fn main(
-    @builtin(global_invocation_id) global_id : vec3<u32>
-){
-
-    let index = global_id.x;
-    
-    let input_size = min(input.count, arrayLength(&input.elements));
-    
-    if(index >= input_size){
-        return;
-    }
-    
-    let mesh_index = input.elements[index];
-
-    let mesh = scene_read_mesh(&scene_database, mesh_index);
-    let mesh_bounds = array_to_aabb3(mesh.bounding_box);
-    
-    var view_bounds:${AABB3_STRUCT.wgsl_ref};
-    let valid_bounds = aabb3_project_perspective(&view_bounds, mesh_bounds, camera.view_projection_matrix);
-    
-    if(
-        valid_bounds && query_depth_from_screen_space_bb(view_bounds, texture_hzb) < 0.0
-    ){
-
-        // filter failed
-        return;
-
-    }
-    
-    let write_offset = atomicAdd(&output.count, 1u);
-    
-    if(write_offset < arrayLength(&output.elements)){
-        output.elements[write_offset] = input.elements[index];
-    }
-}
-    `, [
-        AABB3_STRUCT.declaration_chunk,
-
-        chunk_array_to_aabb3,
-        chunk_aabb3_project_perspective,
-        chunk_query_depth_from_screen_space_bb,
-        chunk_scene_database_access,
-    ]
-);
-
-const shader = ComputeShader.from({
-    label: "Cull meshes one way",
-    body,
-    resources,
-})
-
-/**
- *
- * @param {Object} options
- * @param {FrameGraph} options.graph
- * @param {GPUSceneContext} options.scene
- * @param {number} options.camera
- * @param {number} options.hzb
- * @param {number} options.input
- * @param {number} options.output_size
- * @returns {number}
- */
-export function graph_mesh_filter_one_way({
-                                              graph,
-                                              scene,
-                                              camera,
-                                              hzb,
-                                              input,
-                                              output_size,
-                                          }) {
-    assert.defined(scene, 'scene');
-    assert.equal(scene.isGPUSceneContext, true, 'scene must be a GPUSceneContext');
-
-    assert.isNonNegativeInteger(camera, 'camera');
-    assert.isNonNegativeInteger(hzb, 'hzb');
-    assert.isNonNegativeInteger(input, 'input');
-    assert.isNonNegativeInteger(output_size, 'output_size');
-
-    /**
-     *
-     * @param {{}} data
-     * @param {FramePassResources} resources
-     * @param {GraphicsExecutionContext} context
-     */
-    function execute(data, resources, context) {
-
-        const encoder = context.encoder;
-
-        const input = resources.get(data.input);
-        const output = resources.get(data.output);
-        const hzb = resources.get(data.hzb);
-        const command = resources.get(data.command);
-        const camera = resources.get(data.camera);
-
-        build_indirect_compute_dispatch_command(
-            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
-            encoder,
-            input, 0,
-            command, 0
-        );
-
-        shader.dispatchIndirect({
-            encoder,
-            command,
-            bindings: {
-                input,
-                output,
-                scene_database: scene.scene_database_buffer,
-                camera,
-                texture_hzb: hzb.obtainView(),
-                hzb,
-            }
-        });
-    }
-
-    const data = {};
-
-    const pass = graph.add("mesh filter one way", data, execute);
-
-    data.command = pass.create('command', BufferResourceDescriptor.from(
-        STRUCT_DISPATCH_COMPUTE_COMMAND.aligned_size,
-        GPUBufferUsage.INDIRECT | GPUBufferUsage.STORAGE,
-    ));
-
-    data.camera = pass.read(camera);
-
-    data.output = pass.create('filtered', BufferResourceDescriptor.from(
-        output_size,
-        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
-        0, 16
-    ));
-    data.input = pass.read(input);
-    data.hzb = pass.read(hzb);
-
-    return data.output;
+import { assert } from "../../../../core/assert.js";
+import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { STRUCT_DISPATCH_COMPUTE_COMMAND } from "../../gpu_primitive/indirect/STRUCT_DISPATCH_COMPUTE_COMMAND.js";
+import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { COLLECTION_U32_STRUCT_READ } from "../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
+import { COLLECTION_U32_STRUCT_WRITE } from "../../gpu_primitive/COLLECTION_U32_STRUCT_WRITE.js";
+import { chunk_scene_database_access } from "../../scene/chunk_scene_database_access.js";
+import {
+    chunk_query_depth_from_screen_space_bb
+} from "../../shader/chunk/depth/chunk_query_depth_from_screen_space_bb.js";
+import { AABB3_STRUCT } from "../../shader/chunk/geometry/aabb3/AABB3_STRUCT.js";
+import {
+    chunk_aabb3_project_perspective
+} from "../../shader/chunk/geometry/aabb3/chunk_aabb3_project_perspective.js";
+import { chunk_array_to_aabb3 } from "../../shader/chunk/geometry/aabb3/chunk_array_to_aabb3.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import {
+    build_indirect_compute_dispatch_command,
+    indirect_compute_dispatch_command_pipeline
+} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
+const resources = new ShaderResourceSetDescriptor();
+resources.createGroup()
+    .addStorageBuffer('input', COLLECTION_U32_STRUCT_READ)
+    .addStorageBuffer('output', COLLECTION_U32_STRUCT_WRITE, true)
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
+    .addTexture("texture_hzb")
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
+fn main(
+    @builtin(global_invocation_id) global_id : vec3<u32>
+){
+
+    let index = global_id.x;
+    
+    let input_size = min(input.count, arrayLength(&input.elements));
+    
+    if(index >= input_size){
+        return;
+    }
+    
+    let mesh_index = input.elements[index];
+
+    let mesh = scene_read_mesh(&scene_database, mesh_index);
+    let mesh_bounds = array_to_aabb3(mesh.bounding_box);
+    
+    var view_bounds:${AABB3_STRUCT.wgsl_ref};
+    let valid_bounds = aabb3_project_perspective(&view_bounds, mesh_bounds, camera.view_projection_matrix);
+    
+    if(
+        valid_bounds && query_depth_from_screen_space_bb(view_bounds, texture_hzb) < 0.0
+    ){
+
+        // filter failed
+        return;
+
+    }
+    
+    let write_offset = atomicAdd(&output.count, 1u);
+    
+    if(write_offset < arrayLength(&output.elements)){
+        output.elements[write_offset] = input.elements[index];
+    }
+}
+    `, [
+        AABB3_STRUCT.declaration_chunk,
+
+        chunk_array_to_aabb3,
+        chunk_aabb3_project_perspective,
+        chunk_query_depth_from_screen_space_bb,
+        chunk_scene_database_access,
+    ]
+);
+
+const shader = ComputeShader.from({
+    label: "Cull meshes one way",
+    body,
+    resources,
+})
+
+/**
+ * Offer the pipelines {@link graph_mesh_filter_one_way} dispatches — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_mesh_filter_one_way_pipelines(enquiry) {
+    enquiry.compute.push(indirect_compute_dispatch_command_pipeline(enquiry.device, COMPUTE_SHADER_DEFAULT_GROUP_SIZE, false));
+    enquiry.compute.push(shader.pipeline);
+}
+
+/**
+ *
+ * @param {Object} options
+ * @param {FrameGraph} options.graph
+ * @param {GPUSceneContext} options.scene
+ * @param {number} options.camera
+ * @param {number} options.hzb
+ * @param {number} options.input
+ * @param {number} options.output_size
+ * @returns {number}
+ */
+export function graph_mesh_filter_one_way({
+                                              graph,
+                                              scene,
+                                              camera,
+                                              hzb,
+                                              input,
+                                              output_size,
+                                          }) {
+    assert.defined(scene, 'scene');
+    assert.equal(scene.isGPUSceneContext, true, 'scene must be a GPUSceneContext');
+
+    assert.isNonNegativeInteger(camera, 'camera');
+    assert.isNonNegativeInteger(hzb, 'hzb');
+    assert.isNonNegativeInteger(input, 'input');
+    assert.isNonNegativeInteger(output_size, 'output_size');
+
+    /**
+     *
+     * @param {{}} data
+     * @param {FramePassResources} resources
+     * @param {GraphicsExecutionContext} context
+     */
+    function execute(data, resources, context) {
+
+        const encoder = context.encoder;
+
+        const input = resources.get(data.input);
+        const output = resources.get(data.output);
+        const hzb = resources.get(data.hzb);
+        const command = resources.get(data.command);
+        const camera = resources.get(data.camera);
+
+        build_indirect_compute_dispatch_command(
+            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
+            encoder,
+            input, 0,
+            command, 0
+        );
+
+        shader.dispatchIndirect({
+            encoder,
+            command,
+            bindings: {
+                input,
+                output,
+                scene_database: scene.scene_database_buffer,
+                camera,
+                texture_hzb: hzb.obtainView(),
+                hzb,
+            }
+        });
+    }
+
+    const data = {};
+
+    const pass = graph.add("mesh filter one way", data, execute);
+
+    data.command = pass.create('command', BufferResourceDescriptor.from(
+        STRUCT_DISPATCH_COMPUTE_COMMAND.aligned_size,
+        GPUBufferUsage.INDIRECT | GPUBufferUsage.STORAGE,
+    ));
+
+    data.camera = pass.read(camera);
+
+    data.output = pass.create('filtered', BufferResourceDescriptor.from(
+        output_size,
+        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
+        0, 16
+    ));
+    data.input = pass.read(input);
+    data.hzb = pass.read(hzb);
+
+    return data.output;
 }

package/src/shade/renderer/rasterize/expand/graph_meshlets_filter_one_way.d.ts

@@ -1,3 +1,12 @@
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+/**
+ * Offer the pipelines {@link graph_meshlets_filter_one_way} dispatches — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_meshlets_filter_one_way_pipelines(enquiry: PipelineEnquiry): void;
 /**
  *
  * @param {Object} options
@@ -19,4 +28,5 @@ export function graph_meshlets_filter_one_way({ graph, view, camera, input_meshl
     hzb: number;
     stat_id?: number;
 }): number;
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=graph_meshlets_filter_one_way.d.ts.map

package/src/shade/renderer/rasterize/expand/graph_meshlets_filter_one_way.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_meshlets_filter_one_way.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/expand/graph_meshlets_filter_one_way.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH;IAT+B,KAAK;IACD,IAAI;IACZ,MAAM,EAAtB,MAAM;IACU,cAAc,EAA9B,MAAM;IACU,WAAW,EAA3B,MAAM;IACU,GAAG,EAAnB,MAAM;IACW,OAAO,GAAxB,MAAM;IACL,MAAM,CAgCjB"}
+{"version":3,"file":"graph_meshlets_filter_one_way.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/expand/graph_meshlets_filter_one_way.js"],"names":[],"mappings":"AASA;;GAEG;AAEH;;;;GAIG;AACH,mEAFW,eAAe,QAKzB;AAED;;;;;;;;;;;GAWG;AACH;IAT+B,KAAK;IACD,IAAI;IACZ,MAAM,EAAtB,MAAM;IACU,cAAc,EAA9B,MAAM;IACU,WAAW,EAA3B,MAAM;IACU,GAAG,EAAnB,MAAM;IACW,OAAO,GAAxB,MAAM;IACL,MAAM,CAgCjB;8BAvDY,OAAO,6CAA6C,EAAE,eAAe"}

package/src/shade/renderer/rasterize/expand/graph_meshlets_filter_one_way.js

@@ -1,7 +1,25 @@
 import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
 import { hzb_filter_meshlets_pass, HzbFilterMeshletsPassData } from "../cull/hzb/HZBFilterMeshlets.js";
 import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import { graph_build_indirect_dispatch_command } from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+import {
+    graph_build_indirect_dispatch_command,
+    indirect_compute_dispatch_command_pipeline
+} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+import { shader_hzb_meshlet_filter_1way } from "../cull/hzb/shader_hzb_meshlet_filter_1way.js";
+
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
+/**
+ * Offer the pipelines {@link graph_meshlets_filter_one_way} dispatches — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_meshlets_filter_one_way_pipelines(enquiry) {
+    enquiry.compute.push(indirect_compute_dispatch_command_pipeline(enquiry.device, COMPUTE_SHADER_DEFAULT_GROUP_SIZE, true));
+    enquiry.compute.push(shader_hzb_meshlet_filter_1way.pipeline);
+}
 
 /**
  *

package/src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Offer the pipelines {@link graph_meshlets_rasterize} draws `pass_descriptor` with at `primitive_state`
+ * — see {@link PipelineEnquiry}. A viewport short of the whole target also clears it with
+ * {@link texture_fill_rectangle}, whose pipeline is left to the frame that does that.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} pass_descriptor
+ * @param {PrimitiveState} primitive_state
+ */
+export function enquire_meshlets_rasterize_pipelines(enquiry: PipelineEnquiry, pass_descriptor: RenderPassDescriptor, primitive_state: PrimitiveState): void;
 /**
  *
  * @param {Object} options
@@ -23,4 +33,7 @@ export function graph_meshlets_rasterize({ graph, view, input_meshlets, depth, p
     primitive_state?: PrimitiveState;
     clear_targets?: boolean;
 }): [depth: number, color: number[]];
+export type PipelineEnquiry = import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
+export type RenderPassDescriptor = import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor;
+export type PrimitiveState = import("../../../descriptor/pipeline/render/PrimitiveState.js").PrimitiveState;
 //# sourceMappingURL=graph_meshlets_rasterize.d.ts.map

package/src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_meshlets_rasterize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH;IAX+B,KAAK;IACD,IAAI;IACZ,cAAc,EAA9B,MAAM;IACU,KAAK,EAArB,MAAM;IACwB,eAAe;IAC1B,aAAa,GAAhC,MAAM,EAAE;IACW,QAAQ,GAA3B,MAAM,EAAE;IACiB,eAAe;IACtB,aAAa,GAA/B,OAAO;IACN,CAAC,KAAK,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAE,CAAC,CA2IzC"}
+{"version":3,"file":"graph_meshlets_rasterize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.js"],"names":[],"mappings":"AAmBA;;;;;;;;GAQG;AACH,8DAJW,eAAe,mBACf,oBAAoB,mBACpB,cAAc,QAKxB;AAED;;;;;;;;;;;;;GAaG;AACH;IAX+B,KAAK;IACD,IAAI;IACZ,cAAc,EAA9B,MAAM;IACU,KAAK,EAArB,MAAM;IACwB,eAAe,EAA7C,oBAAoB;IACD,aAAa,GAAhC,MAAM,EAAE;IACW,QAAQ,GAA3B,MAAM,EAAE;IACiB,eAAe,GAAxC,cAAc;IACI,aAAa,GAA/B,OAAO;IACN,CAAC,KAAK,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAE,CAAC,CA2IzC;8BA5KY,OAAO,6CAA6C,EAAE,eAAe;mCACrE,OAAO,2CAA2C,EAAE,oBAAoB;6BACxE,OAAO,uDAAuD,EAAE,cAAc"}

package/src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.js

@@ -2,11 +2,35 @@ import { assert } from "../../../../core/assert.js";
 import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
 import { STRUCT_UNINDEXED_DRAW_COMMAND } from "../../gpu_primitive/indirect/STRUCT_UNINDEXED_DRAW_COMMAND.js";
 import { texture_fill_rectangle } from "../../texture/util/texture_fill_rectangle.js";
-import { build_indirect_draw_command } from "../../gpu_primitive/indirect/build_indirect_draw_command.js";
+import {
+    build_indirect_draw_command,
+    indirect_draw_command_pipeline
+} from "../../gpu_primitive/indirect/build_indirect_draw_command.js";
+import { rp_rewrite_for_primitive_state } from "../../../device/pipeline/rp_rewrite_for_primitive_state.js";
 import { GEOMETRY_MESHLET_TRIANGLE_LIMIT } from "../../geometry/meshlet/GEOMETRY_MESHLET_TRIANGLE_LIMIT.js";
 
+/**
+ * @typedef {import("../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ * @typedef {import("../../shader/pass/RenderPassDescriptor.js").RenderPassDescriptor} RenderPassDescriptor
+ * @typedef {import("../../../descriptor/pipeline/render/PrimitiveState.js").PrimitiveState} PrimitiveState
+ */
+
 const DRAW_COMMAND_PATTERN = `${GEOMETRY_MESHLET_TRIANGLE_LIMIT * 3}, input, 0, 0`;
 
+/**
+ * Offer the pipelines {@link graph_meshlets_rasterize} draws `pass_descriptor` with at `primitive_state`
+ * — see {@link PipelineEnquiry}. A viewport short of the whole target also clears it with
+ * {@link texture_fill_rectangle}, whose pipeline is left to the frame that does that.
+ *
+ * @param {PipelineEnquiry} enquiry
+ * @param {RenderPassDescriptor} pass_descriptor
+ * @param {PrimitiveState} primitive_state
+ */
+export function enquire_meshlets_rasterize_pipelines(enquiry, pass_descriptor, primitive_state) {
+    enquiry.compute.push(indirect_draw_command_pipeline(enquiry.device, DRAW_COMMAND_PATTERN));
+    enquiry.render.push(rp_rewrite_for_primitive_state(pass_descriptor.pipeline, primitive_state));
+}
+
 /**
  *
  * @param {Object} options

package/src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.d.ts

@@ -1,3 +1,12 @@
+/**
+ * @typedef {import("../../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+/**
+ * Offer the pipelines {@link graph_expand_meshes_to_meshlets} dispatches — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_expand_meshes_to_meshlets_pipelines(enquiry: PipelineEnquiry): void;
 /**
  *
  * @param {Object} options
@@ -16,4 +25,5 @@ export function graph_expand_meshes_to_meshlets({ graph, input_meshes, output_me
     expected_output_size?: number;
     limits: GPUCollectionLimits;
 }): any;
+export type PipelineEnquiry = import("../../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry;
 //# sourceMappingURL=graph_expand_meshes_to_meshlets.d.ts.map

package/src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_expand_meshes_to_meshlets.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.js"],"names":[],"mappings":"AAqBA;;;;;;;;;GASG;AACH;IAP+B,KAAK;IACT,YAAY,EAA5B,MAAM;IACU,eAAe,EAA/B,MAAM;IACmB,KAAK;IACb,oBAAoB,GAArC,MAAM;IACuB,MAAM;QAyJ7C"}
+{"version":3,"file":"graph_expand_meshes_to_meshlets.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.js"],"names":[],"mappings":"AAsBA;;GAEG;AAGH;;;;GAIG;AACH,qEAFW,eAAe,QASzB;AAED;;;;;;;;;GASG;AACH;IAP+B,KAAK;IACT,YAAY,EAA5B,MAAM;IACU,eAAe,EAA/B,MAAM;IACmB,KAAK;IACb,oBAAoB,GAArC,MAAM;IACuB,MAAM;QAyJ7C;8BAnLY,OAAO,gDAAgD,EAAE,eAAe"}

package/src/shade/renderer/rasterize/expand/mesh/graph_expand_meshes_to_meshlets.js

@@ -2,9 +2,11 @@ import { assert } from "../../../../../core/assert.js";
 import { BufferResourceDescriptor } from "../../../../device/graph/BufferResourceDescriptor.js";
 import {
     graph_build_indirect_dispatch_command,
+    indirect_compute_dispatch_command_pipeline,
     INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
 } from "../../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
 import {
+    enquire_prefix_scan_csdldf_pipelines,
     graph_prefix_scan_csdldf,
     prefix_scan_csdldf_output_descriptor
 } from "../../../gpu_primitive/prefix_sum/v1/graph_prefix_scan_csdldf.js";
@@ -18,6 +20,24 @@ import { shader_mesh_expand_to_meshlets_prefix } from "./shader_mesh_expand_to_m
 import { shader_meshes_to_meshlet_counts } from "./shader_meshes_to_meshlet_counts.js";
 import { shader_prefix_sum_to_command } from "./shader_prefix_sum_to_command.js";
 
+/**
+ * @typedef {import("../../../../device/pipeline/PipelineEnquiry.js").PipelineEnquiry} PipelineEnquiry
+ */
+
+
+/**
+ * Offer the pipelines {@link graph_expand_meshes_to_meshlets} dispatches — see {@link PipelineEnquiry}.
+ *
+ * @param {PipelineEnquiry} enquiry
+ */
+export function enquire_expand_meshes_to_meshlets_pipelines(enquiry) {
+    enquiry.compute.push(indirect_compute_dispatch_command_pipeline(enquiry.device, COMPUTE_SHADER_DEFAULT_GROUP_SIZE, false));
+    enquiry.compute.push(shader_meshes_to_meshlet_counts.pipeline);
+    enquire_prefix_scan_csdldf_pipelines(enquiry);
+    enquiry.compute.push(shader_prefix_sum_to_command.pipeline);
+    enquiry.compute.push(shader_mesh_expand_to_meshlets_prefix.pipeline);
+    enquiry.compute.push(shader_increment_count_by_prefix_sum.pipeline);
+}
 
 /**
  *

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_forward_shade_standard_fragment_brick4.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js"],"names":[],"mappings":"AA6BA,qEA4JC;0BA/JyB,oCAAoC"}
+{"version":3,"file":"chunk_forward_shade_standard_fragment_brick4.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js"],"names":[],"mappings":"AA6BA,qEAkKC;0BArKyB,oCAAoC"}

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js

@@ -90,6 +90,8 @@ fn forward_shade_standard_fragment(
     // (the prior call passed already-substrate-scaled albedo here, which
     // collapsed metal F0 to zero — silently broken for any transparent metal).
     let specularF0 = dielectric_specular_color(f_ior, f_metalness, diffuse);
+    // the two F0s it blends, apart for multiple-scattering compensation
+    let specularF0_dielectric = dielectric_specular_color(f_ior, 0.0, diffuse);
 
     // Glass coverage: blend toward view-angle Fresnel as transmission_factor
     // approaches 1. There is no per-channel transmission tint in the material
@@ -106,6 +108,8 @@ fn forward_shade_standard_fragment(
         diffuse: 'albedo',
         roughness: 'material_roughness',
         specularF0: 'specularF0',
+        specularF0_dielectric: 'specularF0_dielectric',
+        specularF0_metal: 'diffuse',
         specularF90: '1.0',
         emissive: 'emissive',
         occlusion:'f_occlusion',
@@ -145,6 +149,8 @@ fn forward_shade_standard_fragment(
             geometry.view_direction,
             material.diffuse,
             material.specularF0,
+            material.specularF0_dielectric,
+            material.specularF0_metal,
             material.specularF90,
             material.roughness,
         );

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_forward_shade_standard_fragment_ibl.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,kEAiJC;0BAxJyB,oCAAoC"}
+{"version":3,"file":"chunk_forward_shade_standard_fragment_ibl.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,kEAuJC;0BA9JyB,oCAAoC"}

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js

@@ -88,6 +88,8 @@ fn forward_shade_standard_fragment(
 
     // IOR-aware F0 (default ior=1.5 collapses to the legacy F0=0.04).
     let specularF0 = dielectric_specular_color(f_ior, f_metalness, diffuse);
+    // the two F0s it blends, apart for multiple-scattering compensation
+    let specularF0_dielectric = dielectric_specular_color(f_ior, 0.0, diffuse);
 
     // Glass coverage: blend toward view-angle Fresnel as transmission_factor
     // approaches 1. No per-channel transmission tint in the material today;
@@ -102,6 +104,8 @@ fn forward_shade_standard_fragment(
         diffuse: 'albedo',
         roughness: 'material_roughness',
         specularF0: 'specularF0',
+        specularF0_dielectric: 'specularF0_dielectric',
+        specularF0_metal: 'diffuse',
         specularF90: '1.0',
         emissive: 'emissive',
         occlusion:'f_occlusion',
@@ -136,6 +140,8 @@ fn forward_shade_standard_fragment(
             geometry.view_direction,
             material.diffuse,
             material.specularF0,
+            material.specularF0_dielectric,
+            material.specularF0_metal,
             material.specularF90,
             material.roughness,
         );

package/src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.d.ts

@@ -36,8 +36,8 @@
 export type AVBOITSideChannel = {
     /**
      * Optional optics preparation before occupancy; at most one producer per view. Inputs are
-     * immutable opaque resources; the light clusters, the shadow atlas and the GI mode are the ones
-     * the transparent meshes are lit by. The returned background is read by the one shared resolve.
+     * immutable opaque resources; the light clusters, the shadow atlas, the GI mode and the shader
+     * switches are the ones the transparent meshes are lit by. The returned background is read by the one shared resolve.
      * Keep prepared state per graph/camera, not on an entity or in a global current-view slot.
      */
     avboit_prepare?: (args: {
@@ -54,6 +54,7 @@ export type AVBOITSideChannel = {
         light_cluster_data: number;
         shadowmap_atlas: number;
         indirect_lighting_mode: import("../../../ShadeIndirectLightingMode.js").ShadeIndirectLightingMode;
+        shader_switches: import("../../../shader/compiler/ShaderSwitchSet.js").ShaderSwitchSet;
     }) => {
         background_color?: number;
     };

package/src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AVBOITSideChannel.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAoCc,CAAC,IAAI,EAAE;QAAC,KAAK,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QACjH,QAAc,EAAE,OAAO,iCAAiC,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QACzF,aAAmB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAC3E,WAAiB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QACvD,wBAA8B,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QACjG,eAAqB,EAAE,MAAM,CAAC;QAC9B,sBAA4B,EAAE,OAAO,uCAAuC,EAAE,yBAAyB,CAAC;KACrG,KAAK;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC;;;;;sBAKtB,CAAC,IAAI,EAAE;QACpB,KAAW,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QAClG,MAAY,EAAE,MAAM,CAAC;QACrB,kBAAwB,EAAE,UAAU,MAAM,CAAC,CAAC;QAC5C,SAAe,EAAE,MAAM,CAAC;KACrB,KAAK,MAAM;;;;;;;;kBAED,CAAC,IAAI,EAAE;QACpB,KAAW,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QAClG,MAAY,EAAE,MAAM,CAAC;QACrB,IAAU,EAAE,MAAM,CAAC;QACnB,aAAmB,EAAE,MAAM,CAAC;QAC5B,gBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,MAAY,EAAE;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAC,CAAC;KACjE,KAAK;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC;;;;;;;;;;;;;;iBAKhD,CAAC,IAAI,EAAE;QACpB,KAAW,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QAClG,QAAc,EAAE,OAAO,iCAAiC,EAAE,cAAc,CAAC;QACzE,MAAY,EAAE,MAAM,CAAC;QACrB,aAAmB,EAAE,MAAM,CAAC;QAC5B,IAAU,EAAE,MAAM,CAAC;QACnB,QAAc,EAAE,MAAM,CAAC;QACvB,eAAqB,EAAE,MAAM,CAAC;QAC9B,oBAA0B,EAAE,MAAM,CAAC;QACnC,sBAA4B,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC;QACxD,YAAkB,EAAE;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAC,CAAC;KACrF,KAAK;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC;;;;;;sBAW9D,CAAC,IAAI,EAAE,OAAO,iCAAiC,EAAE,cAAc,KAAK,OAAO"}
+{"version":3,"file":"AVBOITSideChannel.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/native/avboit/AVBOITSideChannel.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAoCc,CAAC,IAAI,EAAE;QAAC,KAAK,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QACjH,QAAc,EAAE,OAAO,iCAAiC,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QACzF,aAAmB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAC3E,WAAiB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QACvD,wBAA8B,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QACjG,eAAqB,EAAE,MAAM,CAAC;QAC9B,sBAA4B,EAAE,OAAO,uCAAuC,EAAE,yBAAyB,CAAC;QACxG,eAAqB,EAAE,OAAO,6CAA6C,EAAE,eAAe,CAAC;KAC1F,KAAK;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAC;;;;;sBAKtB,CAAC,IAAI,EAAE;QACpB,KAAW,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QAClG,MAAY,EAAE,MAAM,CAAC;QACrB,kBAAwB,EAAE,UAAU,MAAM,CAAC,CAAC;QAC5C,SAAe,EAAE,MAAM,CAAC;KACrB,KAAK,MAAM;;;;;;;;kBAED,CAAC,IAAI,EAAE;QACpB,KAAW,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QAClG,MAAY,EAAE,MAAM,CAAC;QACrB,IAAU,EAAE,MAAM,CAAC;QACnB,aAAmB,EAAE,MAAM,CAAC;QAC5B,gBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,MAAY,EAAE;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAC,CAAC;KACjE,KAAK;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC;;;;;;;;;;;;;;iBAKhD,CAAC,IAAI,EAAE;QACpB,KAAW,EAAE,OAAO,iEAAiE,EAAE,UAAU,CAAC;QAClG,QAAc,EAAE,OAAO,iCAAiC,EAAE,cAAc,CAAC;QACzE,MAAY,EAAE,MAAM,CAAC;QACrB,aAAmB,EAAE,MAAM,CAAC;QAC5B,IAAU,EAAE,MAAM,CAAC;QACnB,QAAc,EAAE,MAAM,CAAC;QACvB,eAAqB,EAAE,MAAM,CAAC;QAC9B,oBAA0B,EAAE,MAAM,CAAC;QACnC,sBAA4B,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC;QACxD,YAAkB,EAAE;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAC,CAAC;KACrF,KAAK;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC;;;;;;sBAW9D,CAAC,IAAI,EAAE,OAAO,iCAAiC,EAAE,cAAc,KAAK,OAAO"}