@woosh/meep-engine 3.11.2 → 3.12.0

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

@@ -1,63 +1,62 @@
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { COLLECTION_U32_STRUCT_READ } from "../../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
-import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.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 { GEOMETRY_METADATA_STRUCT } from "../../../geometry/GEOMETRY_METADATA_STRUCT.js";
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.createGroup()
-    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
-    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
-;
-
-resources.createGroup()
-    .addStorageBuffer("input", COLLECTION_U32_STRUCT_READ)
-    .addStorageBuffer("output", COLLECTION_U32_STRUCT_READ, true)
-;
-
-const body = CodeChunk.from(
-// language=WGSL
-    `
-@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
-fn unpack(@builtin(global_invocation_id) global_id : vec3<u32>){
-
-    let input_index = global_id.x;
-
-    if(input_index >= input.count){
-        return;
-    }
-    
-    if(input_index == 0){
-        // copy element count
-        output.count = input.count;
-    }
-
-    let mesh_index = input.elements[input_index];
-
-    let mesh = scene_read_mesh(&scene_database, mesh_index);
-
-    let geometry_index = mesh.geometry;
-
-    let geometry = geometries[geometry_index];
-
-    let meshlet_count = geometry.meshlets_count;
-     
-    output.elements[input_index] = meshlet_count;
-
-
-}`, [
-    chunk_scene_database_access,
-]);
-
-
-export const shader_meshes_to_meshlet_counts = ComputeShader.from({
-    label: "Mesh instances to meshlet counts",
-    body,
-    resources,
-    group_size: [COMPUTE_SHADER_DEFAULT_GROUP_SIZE],
+import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
+import { COLLECTION_U32_STRUCT_READ } from "../../../gpu_primitive/COLLECTION_U32_STRUCT_READ.js";
+import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.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 { GEOMETRY_METADATA_STRUCT } from "../../../geometry/GEOMETRY_METADATA_STRUCT.js";
+
+const resources = new ShaderResourceSetDescriptor();
+
+resources.createGroup()
+    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
+    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+;
+
+resources.createGroup()
+    .addStorageBuffer("input", COLLECTION_U32_STRUCT_READ)
+    .addStorageBuffer("output", COLLECTION_U32_STRUCT_READ, true)
+;
+
+const body = CodeChunk.from(
+// language=WGSL
+    `
+@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
+fn unpack(@builtin(global_invocation_id) global_id : vec3<u32>){
+
+    let input_index = global_id.x;
+
+    if(input_index >= input.count){
+        return;
+    }
+    
+    if(input_index == 0){
+        // copy element count
+        output.count = input.count;
+    }
+
+    let mesh_index = input.elements[input_index];
+
+    let mesh = scene_read_mesh(&scene_database, mesh_index);
+
+    let geometry_index = mesh.geometry;
+
+    let geometry = geometries[geometry_index];
+
+    let meshlet_count = geometry.meshlets_count;
+     
+    output.elements[input_index] = meshlet_count;
+
+
+}`, [
+    chunk_scene_database_access,
+]);
+
+
+export const shader_meshes_to_meshlet_counts = ComputeShader.from({
+    label: "Mesh instances to meshlet counts",
+    body,
+    resources,
 })

package/src/shade/renderer/rasterize/expand/pass1/filter_meshlets.2-way.compute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter_meshlets.2-way.compute.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/pass1/filter_meshlets.2-way.compute.js"],"names":[],"mappings":"AAqJA,uDAKG;8BAhI2B,kCAAkC"}
+{"version":3,"file":"filter_meshlets.2-way.compute.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/pass1/filter_meshlets.2-way.compute.js"],"names":[],"mappings":"AAqJA,uDAIG;8BA/H2B,kCAAkC"}

package/src/shade/renderer/rasterize/expand/pass1/filter_meshlets.2-way.compute.js

@@ -1,155 +1,154 @@
-import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js";
-import { MESHLET_COLLECTION_STRUCT } from "../../MESHLET_COLLECTION_STRUCT.js";
-import { MESHLET_COLLECTION_WRITE_STRUCT } from "../../MESHLET_COLLECTION_WRITE_STRUCT.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_intersects_frustum
-} from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_intersects_frustum.js";
-import {
-    chunk_aabb3_intersects_frustum_degree
-} from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_intersects_frustum_degree.js";
-import { chunk_aabb3_project } from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_project.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 {
-    chunk_aabb2_clip_overlaps_texel_centers
-} from "../../../shader/chunk/texture/chunk_aabb2_clip_overlaps_texel_centers.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 { VIEW_UNIFORM_STRUCT } from "../../../view/VIEW_UNIFORM_STRUCT.js";
-import { MESHLET_METADATA_STRUCT } from "../../../geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addUniform("camera_current", CAMERA_UNIFORM_STRUCT)
-    .addUniform("camera_previous", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT)
-    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
-    .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT))
-    .addTexture("texture_hzb") // HZB of previous frame
-;
-
-resources.createGroup()
-    .addStorageBuffer("input", MESHLET_COLLECTION_STRUCT)
-    .addStorageBuffer("output_positive", MESHLET_COLLECTION_WRITE_STRUCT, true)
-    .addStorageBuffer("output_maybe", MESHLET_COLLECTION_WRITE_STRUCT, true)
-;
-
-
-const body = CodeChunk.from(
-// language=WGSL
-    `
-@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
-fn unpack(@builtin(global_invocation_id) global_id : vec3<u32>){
-    
-    let input_index = global_id.x;
-    
-    if(input_index >= input.count){
-        return;
-    }
-    
-    let meshlet = input.elements[input_index];
-
-    let mesh = scene_read_mesh(&scene_database, meshlet.mesh);
-    let node = scene_read_node(&scene_database, mesh.node);
-
-    let bounds_array = meshlet_metadata[ meshlet.index ].bounds_box;
-
-
-    // check if cluster is too small to be visible
-
-    let meshlet_bounds = array_to_aabb3(bounds_array);
-
-    let world_bounds = aabb3_project(meshlet_bounds, node.global);
-    
-    /*
-        TODO do frustum cull using a sphere representation, which is faster
-    */
-    
-    if( !aabb3_intersects_frustum(world_bounds, camera_current.frustum) ){
-        // outside of view frustum
-        return ;
-    }
-    
-    {
-        // small primitive culling
-        var current_view_bounds:${AABB3_STRUCT.wgsl_ref};
-    
-        // TODO we can perform frustum culling using view bounds instead of actual frustum planes
-        
-        let valid = aabb3_project_perspective(&current_view_bounds, world_bounds, camera_current.view_projection_matrix);
-        
-        let resolution = vec2(view.width, view.height);
-        
-        let would_draw = aabb2_clip_overlaps_texel_centers(
-            current_view_bounds.min.xy,
-            current_view_bounds.max.xy,
-            resolution
-        );
-        
-        if(valid && !would_draw){
-            // cull, doesn't result in any draw
-            return;
-        }
-    }
-    
-    var previous_view_bounds:${AABB3_STRUCT.wgsl_ref};
-    
-    let valid_bounds = aabb3_project_perspective(&previous_view_bounds, world_bounds, camera_previous.view_projection_matrix);
-    
-    if(
-        !valid_bounds || query_depth_from_screen_space_bb(previous_view_bounds, texture_hzb) >= 0.0
-    ){
-    
-        let write_offset = atomicAdd(&output_positive.count, 1u);
-        
-        if(write_offset < arrayLength(&output_positive.elements)){
-            output_positive.elements[ write_offset ] = meshlet;
-        }
-    
-    }else{
-    
-        let write_offset = atomicAdd(&output_maybe.count, 1u);
-        
-        if(write_offset < arrayLength(&output_maybe.elements)){
-            output_maybe.elements[ write_offset ] = meshlet;
-        }
-    
-    }
-
-}`, [
-
-        AABB3_STRUCT.declaration_chunk,
-
-        chunk_array_to_aabb3,
-
-        chunk_aabb3_intersects_frustum_degree,
-
-        chunk_aabb3_intersects_frustum,
-
-        chunk_aabb3_project,
-
-        chunk_aabb3_project_perspective,
-        chunk_query_depth_from_screen_space_bb,
-
-        chunk_aabb2_clip_overlaps_texel_centers,
-
-        chunk_scene_database_access,
-    ]);
-
-export const shader_meshlet_filter_2way = ComputeShader.from({
-    label: "Filter Meshlets 2way",
-    resources,
-    body,
-    group_size: [COMPUTE_SHADER_DEFAULT_GROUP_SIZE]
+import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
+import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js";
+import { MESHLET_COLLECTION_STRUCT } from "../../MESHLET_COLLECTION_STRUCT.js";
+import { MESHLET_COLLECTION_WRITE_STRUCT } from "../../MESHLET_COLLECTION_WRITE_STRUCT.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_intersects_frustum
+} from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_intersects_frustum.js";
+import {
+    chunk_aabb3_intersects_frustum_degree
+} from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_intersects_frustum_degree.js";
+import { chunk_aabb3_project } from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_project.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 {
+    chunk_aabb2_clip_overlaps_texel_centers
+} from "../../../shader/chunk/texture/chunk_aabb2_clip_overlaps_texel_centers.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 { VIEW_UNIFORM_STRUCT } from "../../../view/VIEW_UNIFORM_STRUCT.js";
+import { MESHLET_METADATA_STRUCT } from "../../../geometry/meshlet/encoding/MESHLET_METADATA_STRUCT.js";
+
+const resources = new ShaderResourceSetDescriptor();
+resources.createGroup()
+    .addUniform("camera_current", CAMERA_UNIFORM_STRUCT)
+    .addUniform("camera_previous", CAMERA_UNIFORM_STRUCT)
+    .addUniform("view", VIEW_UNIFORM_STRUCT)
+    .addStorageBuffer("scene_database", WebGPUArray.from(u32))
+    .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT))
+    .addTexture("texture_hzb") // HZB of previous frame
+;
+
+resources.createGroup()
+    .addStorageBuffer("input", MESHLET_COLLECTION_STRUCT)
+    .addStorageBuffer("output_positive", MESHLET_COLLECTION_WRITE_STRUCT, true)
+    .addStorageBuffer("output_maybe", MESHLET_COLLECTION_WRITE_STRUCT, true)
+;
+
+
+const body = CodeChunk.from(
+// language=WGSL
+    `
+@compute @workgroup_size(${COMPUTE_SHADER_DEFAULT_GROUP_SIZE})
+fn unpack(@builtin(global_invocation_id) global_id : vec3<u32>){
+    
+    let input_index = global_id.x;
+    
+    if(input_index >= input.count){
+        return;
+    }
+    
+    let meshlet = input.elements[input_index];
+
+    let mesh = scene_read_mesh(&scene_database, meshlet.mesh);
+    let node = scene_read_node(&scene_database, mesh.node);
+
+    let bounds_array = meshlet_metadata[ meshlet.index ].bounds_box;
+
+
+    // check if cluster is too small to be visible
+
+    let meshlet_bounds = array_to_aabb3(bounds_array);
+
+    let world_bounds = aabb3_project(meshlet_bounds, node.global);
+    
+    /*
+        TODO do frustum cull using a sphere representation, which is faster
+    */
+    
+    if( !aabb3_intersects_frustum(world_bounds, camera_current.frustum) ){
+        // outside of view frustum
+        return ;
+    }
+    
+    {
+        // small primitive culling
+        var current_view_bounds:${AABB3_STRUCT.wgsl_ref};
+    
+        // TODO we can perform frustum culling using view bounds instead of actual frustum planes
+        
+        let valid = aabb3_project_perspective(&current_view_bounds, world_bounds, camera_current.view_projection_matrix);
+        
+        let resolution = vec2(view.width, view.height);
+        
+        let would_draw = aabb2_clip_overlaps_texel_centers(
+            current_view_bounds.min.xy,
+            current_view_bounds.max.xy,
+            resolution
+        );
+        
+        if(valid && !would_draw){
+            // cull, doesn't result in any draw
+            return;
+        }
+    }
+    
+    var previous_view_bounds:${AABB3_STRUCT.wgsl_ref};
+    
+    let valid_bounds = aabb3_project_perspective(&previous_view_bounds, world_bounds, camera_previous.view_projection_matrix);
+    
+    if(
+        !valid_bounds || query_depth_from_screen_space_bb(previous_view_bounds, texture_hzb) >= 0.0
+    ){
+    
+        let write_offset = atomicAdd(&output_positive.count, 1u);
+        
+        if(write_offset < arrayLength(&output_positive.elements)){
+            output_positive.elements[ write_offset ] = meshlet;
+        }
+    
+    }else{
+    
+        let write_offset = atomicAdd(&output_maybe.count, 1u);
+        
+        if(write_offset < arrayLength(&output_maybe.elements)){
+            output_maybe.elements[ write_offset ] = meshlet;
+        }
+    
+    }
+
+}`, [
+
+        AABB3_STRUCT.declaration_chunk,
+
+        chunk_array_to_aabb3,
+
+        chunk_aabb3_intersects_frustum_degree,
+
+        chunk_aabb3_intersects_frustum,
+
+        chunk_aabb3_project,
+
+        chunk_aabb3_project_perspective,
+        chunk_query_depth_from_screen_space_bb,
+
+        chunk_aabb2_clip_overlaps_texel_centers,
+
+        chunk_scene_database_access,
+    ]);
+
+export const shader_meshlet_filter_2way = ComputeShader.from({
+    label: "Filter Meshlets 2way",
+    resources,
+    body,
 });

package/src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_extract_meshes_from_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,sGAFa,MAAM,CA+DlB"}
+{"version":3,"file":"graph_extract_meshes_from_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,sGAFa,MAAM,CA2DlB"}

package/src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js

@@ -1,82 +1,78 @@
-import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import {
-    build_indirect_compute_dispatch_command,
-    INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
-} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
-import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
-import { PUSH_CONSTANTS, shader_read_out_bucket } from "../bucket/shader_read_out_bucket.js";
-
-/**
- * Extract a single bucket's mesh indices out of a bucket-sorted mesh buffer.
- * Produces a flat {@link COLLECTION_U32_STRUCT_READ} buffer.
- *
- * @param {FrameGraph} graph
- * @param {number} buckets bucket-sorted meshes resource ID
- * @param {number} bucket_id
- * @param {GPUCollectionLimits} limits
- * @returns {number} resource ID of extracted mesh list
- */
-export function graph_extract_meshes_from_bucket({
-                                                     graph,
-                                                     buckets,
-                                                     bucket_id,
-                                                     limits,
-                                                 }) {
-
-    /**
-     *
-     * @param data
-     * @param {FramePassResources} resources
-     * @param {GraphicsExecutionContext} context
-     */
-    function execute(data, resources, context) {
-        const encoder = context.encoder;
-
-        const buckets = resources.get(data.buckets);
-        const output = resources.get(data.output);
-        const command = resources.get(data.command);
-
-        const bucket_id = data.bucket_id;
-
-        build_indirect_compute_dispatch_command(
-            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
-            encoder,
-            buckets,
-            // the bucketed buffer header consists of pairs of u32 values (count,offset)
-            bucket_id * (u32.size * 2),
-            command,
-            0
-        );
-
-        const settings = encoder.allocateTransientValueBuffer(PUSH_CONSTANTS, {
-            bucket_id,
-        });
-
-        shader_read_out_bucket.dispatchIndirect({
-            encoder,
-            command,
-            bindings: {
-                settings,
-                input: buckets,
-                output,
-            }
-        });
-    }
-
-    const data = {};
-
-    const pass = graph.add("extract meshes from bucket", data, execute);
-
-    data.buckets = pass.read(buckets);
-    data.bucket_id = bucket_id;
-    data.command = pass.create("command", INDIRECT_COMPUTE_COMMAND_DESCRIPTOR);
-    data.output = pass.create("output", BufferResourceDescriptor.from(
-        limits.compute_buffer_size(RasterizationCollectionType.Meshes),
-        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
-        0, 16 // clear count
-    ));
-
-    return data.output;
+import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import {
+    build_indirect_compute_dispatch_command,
+    INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
+} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
+import { shader_read_out_bucket } from "../bucket/shader_read_out_bucket.js";
+
+/**
+ * Extract a single bucket's mesh indices out of a bucket-sorted mesh buffer.
+ * Produces a flat {@link COLLECTION_U32_STRUCT_READ} buffer.
+ *
+ * @param {FrameGraph} graph
+ * @param {number} buckets bucket-sorted meshes resource ID
+ * @param {number} bucket_id
+ * @param {GPUCollectionLimits} limits
+ * @returns {number} resource ID of extracted mesh list
+ */
+export function graph_extract_meshes_from_bucket({
+                                                     graph,
+                                                     buckets,
+                                                     bucket_id,
+                                                     limits,
+                                                 }) {
+
+    /**
+     *
+     * @param data
+     * @param {FramePassResources} resources
+     * @param {GraphicsExecutionContext} context
+     */
+    function execute(data, resources, context) {
+        const encoder = context.encoder;
+
+        const buckets = resources.get(data.buckets);
+        const output = resources.get(data.output);
+        const command = resources.get(data.command);
+
+        const bucket_id = data.bucket_id;
+
+        build_indirect_compute_dispatch_command(
+            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
+            encoder,
+            buckets,
+            // the bucketed buffer header consists of pairs of u32 values (count,offset)
+            bucket_id * (u32.size * 2),
+            command,
+            0
+        );
+
+        shader_read_out_bucket.dispatchIndirect({
+            encoder,
+            command,
+            bindings: {
+                settings: { bucket_id },
+                input: buckets,
+                output,
+            }
+        });
+    }
+
+    const data = {};
+
+    const pass = graph.add("extract meshes from bucket", data, execute);
+
+    data.buckets = pass.read(buckets);
+    data.bucket_id = bucket_id;
+    data.command = pass.create("command", INDIRECT_COMPUTE_COMMAND_DESCRIPTOR);
+    data.output = pass.create("output", BufferResourceDescriptor.from(
+        limits.compute_buffer_size(RasterizationCollectionType.Meshes),
+        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
+        0, 16 // clear count
+    ));
+
+    return data.output;
 }