@woosh/meep-engine 3.60.5 → 3.60.7

package/src/shade/renderer/global_illumination/probe_clipmap/brick/GPUBrickClipmap.js

@@ -6,19 +6,26 @@ import { BufferDescriptor } from "../../../../descriptor/buffer/BufferDescriptor
 import { graph_read_buffer } from "../../../buffer/graph_read_buffer.js";
 import { MESH_SDF_BRICK_TEXELS, MESH_SDF_BRICK_VOXELS } from "../../../geometry/sdf/MESH_SDF.js";
 import { MESH_SDF_SAMPLER } from "../../../geometry/sdf/MESH_SDF_RESOURCES.js";
-import { WEBGPU_GUARANTEED_MAX_COMPUTE_WORKGROUPS_PER_DIMENSION } from "../../../gpu_primitive/indirect/WEBGPU_GUARANTEED_MAX_COMPUTE_WORKGROUPS_PER_DIMENSION.js";
-import { shader_slot_stack_fill, SLOT_STACK_FILL_WORKGROUP_SIZE } from "../../../gpu_primitive/slot_stack/shader_slot_stack_fill.js";
+import {
+    WEBGPU_GUARANTEED_MAX_COMPUTE_WORKGROUPS_PER_DIMENSION
+} from "../../../gpu_primitive/indirect/WEBGPU_GUARANTEED_MAX_COMPUTE_WORKGROUPS_PER_DIMENSION.js";
+import {
+    shader_slot_stack_fill,
+    SLOT_STACK_FILL_WORKGROUP_SIZE
+} from "../../../gpu_primitive/slot_stack/shader_slot_stack_fill.js";
 import {
     shader_slot_stack_push_range,
     SLOT_STACK_PUSH_RANGE_WORKGROUP_SIZE
 } from "../../../gpu_primitive/slot_stack/shader_slot_stack_push_range.js";
-import { CLIPMAP_LEVEL_ARRAY, CLIPMAP_LEVEL_STRUCT } from "../../../shader/chunk/clipmap/CLIPMAP_LEVEL_STRUCT.js";
-import { graph_import_buffer } from "../../../shader/graph/graph_import_buffer.js";
 import { SCENE_MOVER_CAPACITY } from "../../../scene/movers/SCENE_MOVER_LAYOUT.js";
+import {
+    CLIPMAP_LEVEL_ARRAY,
+    CLIPMAP_LEVEL_LIMIT,
+    CLIPMAP_LEVEL_STRUCT
+} from "../../../shader/chunk/clipmap/CLIPMAP_LEVEL_STRUCT.js";
+import { graph_import_buffer } from "../../../shader/graph/graph_import_buffer.js";
 import { GPUTileAtlas3D } from "../../../texture/atlas/GPUTileAtlas3D.js";
-import { PROBE_CLIPMAP_CASCADE_COUNT_MAX, PROBE_CLIPMAP_CASCADE_RESOLUTIONS } from "../ProbeClipmapSettings.js";
 import {
-    BRICK_CLIPMAP_UNKNOWN,
     BRICK_OBJECT_CELLS,
     BRICK_OCCUPANCY_BLOCK,
     BRICK_STAGING_WORDS,
@@ -292,14 +299,18 @@ export class GPUBrickClipmap {
     /**
      * @param {GPUDevice} device
      * @param {object} options
-     * @param {number} options.cascade_count
-     * @param {number} options.resolution one of {@link PROBE_CLIPMAP_CASCADE_RESOLUTIONS}
+     * @param {number} options.cascade_count at most the levels table holds, {@link CLIPMAP_LEVEL_LIMIT}
+     * @param {number} options.resolution a power of two, at least an occupancy block,
+     *        {@link BRICK_OCCUPANCY_BLOCK}; the brick map's height, resolution · cascade_count, at most the
+     *        device's `maxTextureDimension3D`
      * @param {number} options.voxel_size metres
      */
     constructor(device, { cascade_count, resolution, voxel_size }) {
         assert.isPositiveInteger(cascade_count, 'cascade_count');
-        assert.lessThanOrEqual(cascade_count, PROBE_CLIPMAP_CASCADE_COUNT_MAX, 'cascade_count');
-        assert.isOneOf(resolution, PROBE_CLIPMAP_CASCADE_RESOLUTIONS, 'resolution');
+        assert.lessThanOrEqual(cascade_count, CLIPMAP_LEVEL_LIMIT, "cascade_count, the levels table's length");
+        assert.isPositiveInteger(resolution, 'resolution');
+        assert.greaterThanOrEqual(resolution, BRICK_OCCUPANCY_BLOCK, 'resolution, an occupancy block');
+        assert.lessThanOrEqual(resolution * cascade_count, device.limits.maxTextureDimension3D, "resolution · cascade_count, the brick map's height, past maxTextureDimension3D");
         assert.isFinite(voxel_size, 'voxel_size');
         assert.greaterThan(voxel_size, 0, 'voxel_size');
 
@@ -386,7 +397,8 @@ export class GPUBrickClipmap {
         this.#levels = device.createBuffer(BufferDescriptor.fromJSON({
             label: 'Probe clipmap / brick levels',
             size: CLIPMAP_LEVEL_ARRAY.size,
-            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            // the world light clusters read the windows from its front as storage
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
         }));
     }
 
@@ -545,7 +557,7 @@ export class GPUBrickClipmap {
             device.queue.writeBuffer(this.#runs, 0, this.#runs_data, 0, 8 * this.#run_count);
         }
 
-        device.queue.writeBuffer(this.#levels, 0, this.#levels_data);
+        device.queue.writeBuffer(this.#levels, 0, this.#levels_data, 0, this.cascade_count * CLIPMAP_LEVEL_STRUCT.aligned_size);
 
         // the rows the movers read this frame; what comes after is the next frame's
         const rows = this.#invalidated_count;
@@ -943,6 +955,9 @@ export class GPUBrickClipmap {
      * @returns {GPUBuffer}
      */
     #create_buffer(name, size, usage) {
+        // bound whole, as storage
+        assert.lessThanOrEqual(size, this.#device.limits.maxStorageBufferBindingSize, `${name} past maxStorageBufferBindingSize`);
+
         return this.#device.createBuffer(BufferDescriptor.fromJSON({
             label: `Probe clipmap / ${name}`,
             size,

package/src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick_clipmap.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap.js"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,mCAFU,wBAAwB,CAE4F;AAE9H;;;;;GAKG;AACH,kCAFU,wBAAwB,CAEuE;AAEzG;;;;GAIG;AACH,kCAFU,wBAAwB,CAE6E;AAE/G;;;;GAIG;AACH,qCAFU,wBAAwB,CAEgG;AAElI;;;;GAIG;AACH,kCAFU,wBAAwB,CAE6E;AAE/G;;;;GAIG;AACH,qCAFU,wBAAwB,CAEmF;AAErH;;;;;;;;;;;;;;;;GAgBG;AACH,kCAFU,SAAS,CAoDhB;AAEH;;;;;;;;;;GAUG;AACH,0CAFU,SAAS,CAmBhB;AAMH;;;;;;;;;;GAUG;AACH,kDAFU,SAAS,CAYhB;yCAhMsC,sDAAsD;0BADrE,uCAAuC"}
+{"version":3,"file":"chunk_brick_clipmap.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap.js"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,mCAFU,wBAAwB,CAE4F;AAE9H;;;;;GAKG;AACH,kCAFU,wBAAwB,CAEuE;AAEzG;;;;GAIG;AACH,kCAFU,wBAAwB,CAE6E;AAE/G;;;;GAIG;AACH,qCAFU,wBAAwB,CAEgG;AAElI;;;;GAIG;AACH,kCAFU,wBAAwB,CAE6E;AAE/G;;;;GAIG;AACH,qCAFU,wBAAwB,CAEmF;AAErH;;;;;;;;;;;;;;;;GAgBG;AACH,kCAFU,SAAS,CAwDhB;AAEH;;;;;;;;;;GAUG;AACH,0CAFU,SAAS,CAmBhB;AAMH;;;;;;;;;;GAUG;AACH,kDAFU,SAAS,CAYhB;yCAnMsC,sDAAsD;0BADrE,uCAAuC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap.js

@@ -1,8 +1,9 @@
+import { MESH_SDF_BAND_VOXELS } from "../../../geometry/sdf/MESH_SDF.js";
+import { chunk_clipmap_key } from "../../../shader/chunk/clipmap/chunk_clipmap_key.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { ShaderResourceDescriptor } from "../../../shader/resource/ShaderResourceDescriptor.js";
 import { atomic_u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
-import { MESH_SDF_BAND_VOXELS } from "../../../geometry/sdf/MESH_SDF.js";
 import {
     BRICK_CELL_WORKGROUP_SIZE,
     BRICK_CLIPMAP_EMPTY,
@@ -112,19 +113,19 @@ const BRICK_TAKE_FIRST = ${BRICK_TAKE_FIRST}u;
 const BRICK_TAKE_COUNT = ${BRICK_TAKE_COUNT}u;
 
 fn brick_clipmap_key(cascade: u32, storage: vec3<u32>, resolution: u32) -> u32 {
-    return (cascade * resolution + storage.z) * resolution * resolution + storage.y * resolution + storage.x;
+    return clipmap_key(cascade, storage, resolution);
 }
 
 fn brick_clipmap_key_cascade(key: u32, resolution: u32) -> u32 {
-    return key / (resolution * resolution * resolution);
+    return clipmap_key_cascade(key, resolution);
 }
 
 fn brick_clipmap_key_storage(key: u32, resolution: u32) -> vec3<u32> {
-    return vec3<u32>(key % resolution, (key / resolution) % resolution, (key / (resolution * resolution)) % resolution);
+    return clipmap_key_storage(key, resolution);
 }
 
 fn brick_clipmap_map_texel(cascade: u32, storage: vec3<u32>, resolution: u32) -> vec3<u32> {
-    return vec3<u32>(storage.x, storage.y, storage.z + cascade * resolution);
+    return clipmap_stacked_texel(cascade, storage, resolution);
 }
 
 fn brick_clipmap_entry_holds_slot(entry: u32) -> bool {
@@ -132,9 +133,13 @@ fn brick_clipmap_entry_holds_slot(entry: u32) -> bool {
 }
 
 fn brick_clipmap_byte_voxels(byte: u32) -> f32 {
-    return 2.0 * BRICK_CLIPMAP_BAND_VOXELS * (f32(byte) / 255.0 - 0.5);
+    const scale = 2.0 * BRICK_CLIPMAP_BAND_VOXELS / 255.0;
+
+    return fma(f32(byte), scale, -BRICK_CLIPMAP_BAND_VOXELS);
 }
-`);
+`, [
+    chunk_clipmap_key,
+]);
 
 /**
  * Queue a key unless it is already pending: set its bit, and append it to the ring when the bit was

package/src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap_trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick_clipmap_trace.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap_trace.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,gCAFU,MAAM,CAEoB;AAEpC;;;;GAIG;AACH,gCAFU,MAAM,CAEwB;AAExC;;;GAGG;AACH,yCAFU,wBAAwB,CAEoE;AAEtG;;;GAGG;AACH,+CAFU,wBAAwB,CAEgF;AAElH;;;GAGG;AACH,2CAFU,wBAAwB,CAEyE;AAE3G;;;GAGG;AACH,qCAFU,wBAAwB,CAEqF;AAEvH;;;GAGG;AACH,oCAFU,wBAAwB,CAEyE;AAE3G;;;GAGG;AACH,qCAFU,wBAAwB,CAE6E;AAE/G;;;;;;;;;;;;;GAaG;AACH,yCAFU,SAAS,CAoCZ;AAKP;;;;;;;;;;;;GAYG;AACH,yCAFU,SAAS,CAyBZ;AAIP;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wCAFU,SAAS,CAgFZ;AAKP;;;;;;;;;;;;;;;;;;GAkBG;AACH,wCAFU,SAAS,CAoGZ;AAEP;;;;;;;;;;;;GAYG;AACH,2CAFU,SAAS,CAsCZ;AAIP;;;;;;;;;;;;;;GAcG;AACH,2CAFU,SAAS,CA0BZ;AAEP;;;;;;;;;;;;;;GAcG;AACH,yCAFU,SAAS,CAqBZ;yCA5fkC,sDAAsD;0BADrE,uCAAuC"}
+{"version":3,"file":"chunk_brick_clipmap_trace.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap_trace.js"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,gCAFU,MAAM,CAEoB;AAEpC;;;;GAIG;AACH,gCAFU,MAAM,CAEwB;AAExC;;;GAGG;AACH,yCAFU,wBAAwB,CAEoE;AAEtG;;;GAGG;AACH,+CAFU,wBAAwB,CAEgF;AAElH;;;GAGG;AACH,2CAFU,wBAAwB,CAEyE;AAE3G;;;GAGG;AACH,qCAFU,wBAAwB,CAEqF;AAEvH;;;GAGG;AACH,oCAFU,wBAAwB,CAEyE;AAE3G;;;GAGG;AACH,qCAFU,wBAAwB,CAE6E;AAE/G;;;;;;;;;;;;;GAaG;AACH,yCAFU,SAAS,CAsCZ;AAKP;;;;;;;;;;;;GAYG;AACH,yCAFU,SAAS,CAyBZ;AAIP;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wCAFU,SAAS,CAgFZ;AAKP;;;;;;;;;;;;;;;;;;GAkBG;AACH,wCAFU,SAAS,CAoGZ;AAEP;;;;;;;;;;;;GAYG;AACH,2CAFU,SAAS,CAsCZ;AAIP;;;;;;;;;;;;;;GAcG;AACH,2CAFU,SAAS,CA0BZ;AAEP;;;;;;;;;;;;;;GAcG;AACH,yCAFU,SAAS,CAqBZ;yCA9fkC,sDAAsD;0BADrE,uCAAuC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/chunk_brick_clipmap_trace.js

@@ -1,6 +1,10 @@
 import { MESH_SDF_BRICK_TEXELS, MESH_SDF_BRICK_VOXELS } from "../../../geometry/sdf/MESH_SDF.js";
 import { MESH_SDF_SAMPLER } from "../../../geometry/sdf/MESH_SDF_RESOURCES.js";
-import { CLIPMAP_LEVEL_ARRAY, CLIPMAP_LEVEL_LIMIT, CLIPMAP_LEVEL_STRUCT } from "../../../shader/chunk/clipmap/CLIPMAP_LEVEL_STRUCT.js";
+import {
+    CLIPMAP_LEVEL_ARRAY,
+    CLIPMAP_LEVEL_LIMIT,
+    CLIPMAP_LEVEL_STRUCT
+} from "../../../shader/chunk/clipmap/CLIPMAP_LEVEL_STRUCT.js";
 import { chunk_aabb3_distance_to_ray_v2 } from "../../../shader/chunk/geometry/aabb3/chunk_aabb3_distance_to_ray_v2.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { ShaderResourceDescriptor } from "../../../shader/resource/ShaderResourceDescriptor.js";
@@ -92,7 +96,9 @@ fn brick_clipmap_tap(slot: u32, local: vec3<f32>) -> f32 {
 }
 
 fn brick_clipmap_sample(slot: u32, local: vec3<f32>, voxel: f32) -> f32 {
-    return 2.0 * BRICK_CLIPMAP_BAND_VOXELS * voxel * (brick_clipmap_tap(slot, local) - 0.5);
+    let band = BRICK_CLIPMAP_BAND_VOXELS * voxel;
+
+    return fma(brick_clipmap_tap(slot, local), 2.0 * band, -band);
 }
 
 fn brick_clipmap_normal(slot: u32, local: vec3<f32>) -> vec3<f32> {

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/chunk_mesh_brick_instance.d.ts

@@ -10,8 +10,8 @@
  * `mesh_brick_accept` is the gather's leaf filter, with `bounds` the row's world box and `voxel` the
  * cascade's: the row is in the SDF world, its geometry's field is resident (a skinned clone's through
  * its source's, the hook), and its box resolves in the cascade (`brick_provider_resolves`). A virtual
- * geometry's field is the one baked for its proxy and adopted into it (§7.8), so its rows are taken as
- * a mesh's are, once it is resident.
+ * geometry's header is an alias of its proxy's (§7.8), so its rows are taken as a mesh's are, once the
+ * proxy's field is resident.
  *
  * `mesh_brick_instance` makes the instance the texels sample: the inverse of its transform, its box,
  * its smallest axis scale, and the coarsest level of its field no coarser than the cascade,

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/chunk_mesh_brick_instance.js

@@ -19,8 +19,8 @@ import { MESH_BRICK_INSTANCE_STRUCT } from "./MESH_BRICK_INSTANCE_STRUCT.js";
  * `mesh_brick_accept` is the gather's leaf filter, with `bounds` the row's world box and `voxel` the
  * cascade's: the row is in the SDF world, its geometry's field is resident (a skinned clone's through
  * its source's, the hook), and its box resolves in the cascade (`brick_provider_resolves`). A virtual
- * geometry's field is the one baked for its proxy and adopted into it (§7.8), so its rows are taken as
- * a mesh's are, once it is resident.
+ * geometry's header is an alias of its proxy's (§7.8), so its rows are taken as a mesh's are, once the
+ * proxy's field is resident.
  *
  * `mesh_brick_instance` makes the instance the texels sample: the inverse of its transform, its box,
  * its smallest axis scale, and the coarsest level of its field no coarser than the cascade,

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/chunk_mesh_brick_walk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_mesh_brick_walk.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/chunk_mesh_brick_walk.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,oCAFU,SAAS,CAkChB;0BAjEuB,0CAA0C"}
+{"version":3,"file":"chunk_mesh_brick_walk.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/chunk_mesh_brick_walk.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,oCAFU,SAAS,CAoChB;0BAnEuB,0CAA0C"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/chunk_mesh_brick_walk.js

@@ -1,3 +1,4 @@
+import { chunk_divide_round_up_u32 } from "../../../../shader/chunk/math/chunk_divide_round_up_u32.js";
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import {
     MESH_BRICK_ACCUMULATOR_FLAGS,
@@ -53,7 +54,7 @@ fn mesh_brick_walk_spill_index(slot: u32, start: u32) -> u32 {
 }
 
 fn mesh_brick_records(entries: u32) -> u32 {
-    return (entries + MESH_BRICK_BATCH - 1u) / MESH_BRICK_BATCH;
+    return divide_round_up_u32(entries, MESH_BRICK_BATCH);
 }
 
 fn mesh_brick_record(index: u32) -> u32 {
@@ -63,4 +64,6 @@ fn mesh_brick_record(index: u32) -> u32 {
 fn mesh_brick_accumulator(build: u32) -> u32 {
     return build * MESH_BRICK_ACCUMULATOR_WORDS;
 }
-`);
+`, [
+    chunk_divide_round_up_u32,
+]);

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/shader_mesh_brick_batch.js

@@ -14,9 +14,9 @@ import { atomic_u32, u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_T
 import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
 import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
 import { BRICK_CELL_WORKGROUP_SIZE, BRICK_OBJECT_CELLS_PER_AXIS } from "../BRICK_CLIPMAP.js";
+import { BRICK_RING_RESOURCE, BRICK_TAKE_RESOURCE, chunk_brick_clipmap } from "../chunk_brick_clipmap.js";
 import { chunk_brick_object } from "../chunk_brick_object.js";
 import { chunk_brick_provider } from "../chunk_brick_provider.js";
-import { BRICK_RING_RESOURCE, BRICK_TAKE_RESOURCE, chunk_brick_clipmap } from "../chunk_brick_clipmap.js";
 import { chunk_mesh_brick_instance } from "./chunk_mesh_brick_instance.js";
 import { chunk_mesh_brick_texel } from "./chunk_mesh_brick_texel.js";
 import { chunk_mesh_brick_walk } from "./chunk_mesh_brick_walk.js";

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/shader_mesh_brick_gather.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_mesh_brick_gather.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/shader_mesh_brick_gather.js"],"names":[],"mappings":"AAuCA;;GAEG;AACH,yCAFU,YAAY,CAeQ;AA0V9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,uCAFU,aAAa,CAMpB;6BApa0B,yCAAyC;8BAJxC,qCAAqC"}
+{"version":3,"file":"shader_mesh_brick_gather.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/shader_mesh_brick_gather.js"],"names":[],"mappings":"AAyCA;;GAEG;AACH,yCAFU,YAAY,CAeQ;AA0V9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,uCAFU,aAAa,CAMpB;6BApa0B,yCAAyC;8BAJxC,qCAAqC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/shader_mesh_brick_gather.js

@@ -10,7 +10,9 @@ import {
 } from "../../../../shader/chunk/bvh/chunk_bvh_query_aabb_frontier.js";
 import { CLIPMAP_LEVEL_ARRAY } from "../../../../shader/chunk/clipmap/CLIPMAP_LEVEL_STRUCT.js";
 import { chunk_folded_workgroup_index } from "../../../../shader/chunk/grid/chunk_folded_workgroup_index.js";
-import { chunk_subgroup_reserve_workgroup } from "../../../../shader/chunk/subgroup/chunk_subgroup_reserve_workgroup.js";
+import {
+    chunk_subgroup_reserve_workgroup
+} from "../../../../shader/chunk/subgroup/chunk_subgroup_reserve_workgroup.js";
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
@@ -18,8 +20,8 @@ import { atomic_u32, u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_T
 import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
 import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
 import { BRICK_CELL_WORKGROUP_SIZE } from "../BRICK_CLIPMAP.js";
-import { chunk_brick_provider } from "../chunk_brick_provider.js";
 import { BRICK_RING_RESOURCE, BRICK_TAKE_RESOURCE, chunk_brick_clipmap } from "../chunk_brick_clipmap.js";
+import { chunk_brick_provider } from "../chunk_brick_provider.js";
 import { chunk_mesh_brick_instance } from "./chunk_mesh_brick_instance.js";
 import { chunk_mesh_brick_walk } from "./chunk_mesh_brick_walk.js";
 import {
@@ -275,7 +277,7 @@ fn main(
     for (var level = 0u; level < ${BVH_QUERY_AABB_LEVEL_BUDGET}u && expand_count != 0u; level++) {
         let list = level & 1u;
         let next = list ^ 1u;
-        let iterations = (expand_count + MESH_BRICK_BATCH - 1u) / MESH_BRICK_BATCH;
+        let iterations = mesh_brick_records(expand_count);
 
         // where this iteration's children start on the next list
         var start = 0u;

package/src/shade/renderer/global_illumination/probe_clipmap/brick/mesh/shader_mesh_brick_resolve.js

@@ -5,8 +5,8 @@ import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderR
 import { atomic_u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
 import { BRICK_CELL_WORKGROUP_SIZE, BRICK_OBJECT_CELLS_PER_AXIS } from "../BRICK_CLIPMAP.js";
-import { chunk_brick_object } from "../chunk_brick_object.js";
 import { BRICK_STAGING_RESOURCE, chunk_brick_clipmap } from "../chunk_brick_clipmap.js";
+import { chunk_brick_object } from "../chunk_brick_object.js";
 import { chunk_mesh_brick_walk } from "./chunk_mesh_brick_walk.js";
 import { MESH_BRICK_COUNTER_RESOLVE_GROUPS, MESH_BRICK_STATISTIC_CELLS_RETRIED } from "./MESH_BRICK.js";
 

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_free.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick_clipmap_free.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_free.js"],"names":[],"mappings":"AAoBA;;GAEG;AACH,kCAFU,YAAY,CAOE;AAexB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wCAFU,aAAa,CAgFpB;6BAvI0B,sCAAsC;8BAHrC,kCAAkC"}
+{"version":3,"file":"shader_brick_clipmap_free.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_free.js"],"names":[],"mappings":"AAoBA;;GAEG;AACH,kCAFU,YAAY,CAOE;AAexB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wCAFU,aAAa,CAgFpB;6BAtI0B,sCAAsC;8BAHrC,kCAAkC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_free.js

@@ -1,3 +1,4 @@
+import { MESH_SDF_BRICK_TEXEL_COUNT } from "../../../geometry/sdf/MESH_SDF.js";
 import { chunk_slot_stack } from "../../../gpu_primitive/slot_stack/chunk_slot_stack.js";
 import { chunk_folded_workgroup_index } from "../../../shader/chunk/grid/chunk_folded_workgroup_index.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
@@ -5,7 +6,6 @@ import { ComputeShader } from "../../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
 import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { MESH_SDF_BRICK_TEXEL_COUNT } from "../../../geometry/sdf/MESH_SDF.js";
 import { BRICK_CELL_WORKGROUP_SIZE } from "./BRICK_CLIPMAP.js";
 import {
     BRICK_FREE_RESOURCE,

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_movers_command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick_clipmap_movers_command.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_movers_command.js"],"names":[],"mappings":"AAiBA;;GAEG;AACH,4CAFU,YAAY,CAWW;AAUjC;;;;;;;;;GASG;AACH,kDAFU,aAAa,CAoCpB;6BA5E0B,sCAAsC;8BAJrC,kCAAkC"}
+{"version":3,"file":"shader_brick_clipmap_movers_command.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_movers_command.js"],"names":[],"mappings":"AAkBA;;GAEG;AACH,4CAFU,YAAY,CAWW;AAUjC;;;;;;;;;GASG;AACH,kDAFU,aAAa,CAqCpB;6BA7E0B,sCAAsC;8BAJrC,kCAAkC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_movers_command.js

@@ -1,5 +1,6 @@
 import { chunk_folded_dispatch } from "../../../gpu_primitive/indirect/chunk_folded_dispatch.js";
 import { SCENE_MOVERS_READ_STRUCT } from "../../../scene/movers/SCENE_MOVER_LAYOUT.js";
+import { chunk_divide_round_up_u32 } from "../../../shader/chunk/math/chunk_divide_round_up_u32.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
@@ -72,13 +73,14 @@ fn main() {
     let pairs = select(boxes * settings.block_count, 0u, everything);
     let keys = select(0u, settings.key_count, everything);
 
-    write_folded_dispatch(${BRICK_MOVERS_PAIR_DISPATCH}u, (pairs + ${BRICK_MOVERS_WORKGROUP_SIZE - 1}u) / ${BRICK_MOVERS_WORKGROUP_SIZE}u);
-    write_folded_dispatch(${BRICK_MOVERS_REQUEUE_DISPATCH}u, (keys + ${BRICK_MOVERS_WORKGROUP_SIZE - 1}u) / ${BRICK_MOVERS_WORKGROUP_SIZE}u);
+    write_folded_dispatch(${BRICK_MOVERS_PAIR_DISPATCH}u, divide_round_up_u32(pairs, ${BRICK_MOVERS_WORKGROUP_SIZE}u));
+    write_folded_dispatch(${BRICK_MOVERS_REQUEUE_DISPATCH}u, divide_round_up_u32(keys, ${BRICK_MOVERS_WORKGROUP_SIZE}u));
 
     brick_movers[${BRICK_MOVERS_BOX_COUNT}u] = select(boxes, 0u, everything);
     brick_movers[${BRICK_MOVERS_SCENE_COUNT}u] = movers;
 }
 `, [
+            chunk_divide_round_up_u32,
             chunk_folded_dispatch,
         ]),
 });

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_scroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick_clipmap_scroll.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_scroll.js"],"names":[],"mappings":"AAkBA;;GAEG;AACH,oCAFU,YAAY,CAeI;AAe1B;;;;;;;;;;;GAWG;AACH,0CAFU,aAAa,CAoEpB;6BAzH0B,sCAAsC;8BAJrC,kCAAkC"}
+{"version":3,"file":"shader_brick_clipmap_scroll.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_scroll.js"],"names":[],"mappings":"AAkBA;;GAEG;AACH,oCAFU,YAAY,CAeI;AAe1B;;;;;;;;;;;GAWG;AACH,0CAFU,aAAa,CAoEpB;6BAxH0B,sCAAsC;8BAJrC,kCAAkC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_scroll.js

@@ -1,3 +1,4 @@
+import { chunk_slot_stack } from "../../../gpu_primitive/slot_stack/chunk_slot_stack.js";
 import { chunk_clipmap_storage_coord } from "../../../shader/chunk/clipmap/chunk_clipmap_storage_coord.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../../shader/ComputeShader.js";
@@ -5,7 +6,6 @@ import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderReso
 import { u32, vec4i } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
 import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { chunk_slot_stack } from "../../../gpu_primitive/slot_stack/chunk_slot_stack.js";
 import { BRICK_OCCUPANCY_BLOCK, BRICK_THREAD_WORKGROUP_SIZE } from "./BRICK_CLIPMAP.js";
 import {
     BRICK_FREE_RESOURCE,

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick_clipmap_store.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_store.js"],"names":[],"mappings":"AAoBA;;GAEG;AACH,mCAFU,YAAY,CASG;AAgBzB;;;;;;;;;;;GAWG;AACH,yCAFU,aAAa,CAsEpB;6BAvH0B,sCAAsC;8BAJrC,kCAAkC"}
+{"version":3,"file":"shader_brick_clipmap_store.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_store.js"],"names":[],"mappings":"AAoBA;;GAEG;AACH,mCAFU,YAAY,CASG;AAgBzB;;;;;;;;;;;GAWG;AACH,yCAFU,aAAa,CAsEpB;6BAtH0B,sCAAsC;8BAJrC,kCAAkC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_store.js

@@ -1,3 +1,4 @@
+import { MESH_SDF_BRICK_TEXELS } from "../../../geometry/sdf/MESH_SDF.js";
 import { chunk_slot_stack } from "../../../gpu_primitive/slot_stack/chunk_slot_stack.js";
 import { chunk_folded_workgroup_index } from "../../../shader/chunk/grid/chunk_folded_workgroup_index.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
@@ -7,7 +8,6 @@ import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
 import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
 import { chunk_tile_atlas_slot_origin } from "../../../texture/atlas/chunk_tile_atlas_slot_origin.js";
-import { MESH_SDF_BRICK_TEXELS } from "../../../geometry/sdf/MESH_SDF.js";
 import { BRICK_CELL_WORKGROUP_SIZE } from "./BRICK_CLIPMAP.js";
 import {
     BRICK_FREE_RESOURCE,

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_take.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick_clipmap_take.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_take.js"],"names":[],"mappings":"AASA;;GAEG;AACH,kCAFU,YAAY,CAKE;AAUxB;;;;;;;;;;;GAWG;AACH,wCAFU,aAAa,CA2CpB;6BAxE0B,sCAAsC;8BAJrC,kCAAkC"}
+{"version":3,"file":"shader_brick_clipmap_take.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_take.js"],"names":[],"mappings":"AAUA;;GAEG;AACH,kCAFU,YAAY,CAKE;AAUxB;;;;;;;;;;;GAWG;AACH,wCAFU,aAAa,CA4CpB;6BAzE0B,sCAAsC;8BAJrC,kCAAkC"}

package/src/shade/renderer/global_illumination/probe_clipmap/brick/shader_brick_clipmap_take.js

@@ -1,4 +1,5 @@
 import { chunk_folded_dispatch } from "../../../gpu_primitive/indirect/chunk_folded_dispatch.js";
+import { chunk_divide_round_up_u32 } from "../../../shader/chunk/math/chunk_divide_round_up_u32.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
@@ -70,10 +71,11 @@ fn main() {
     }
 
     write_folded_dispatch(BRICK_TAKE_CELL_DISPATCH, taken);
-    write_folded_dispatch(BRICK_TAKE_WORD_DISPATCH, (taken * BRICK_STAGING_WORDS + BRICK_THREAD_WORKGROUP_SIZE - 1u) / BRICK_THREAD_WORKGROUP_SIZE);
+    write_folded_dispatch(BRICK_TAKE_WORD_DISPATCH, divide_round_up_u32(taken * BRICK_STAGING_WORDS, BRICK_THREAD_WORKGROUP_SIZE));
 }
 `, [
             chunk_brick_clipmap,
+            chunk_divide_round_up_u32,
             chunk_folded_dispatch,
         ]),
 });

package/src/shade/renderer/global_illumination/probe_clipmap/debug/graph_probe_clipmap_debug_mesh_cards.js

@@ -3,14 +3,14 @@ import { TextureResourceDescriptor } from "../../../../device/graph/TextureResou
 import { GPU_DATABASE_NULL } from "../../../buffer/table/GPU_DATABASE_NULL.js";
 import { CAMERA_UNIFORM_STRUCT } from "../../../camera/CAMERA_UNIFORM_STRUCT.js";
 import { chunk_mesh_card_surface } from "../../../geometry/sdf/cards/chunk_mesh_card_surface.js";
-import { chunk_mesh_sdf_normal } from "../../../geometry/sdf/chunk_mesh_sdf_normal.js";
-import { chunk_mesh_sdf_header } from "../../../geometry/sdf/chunk_mesh_sdf_sample.js";
 import {
     MESH_CARD_ALBEDO_RESOURCE,
     MESH_CARD_EMISSIVE_RESOURCE,
     MESH_CARD_ROWS_RESOURCE,
     MESH_CARD_SETS_RESOURCE
 } from "../../../geometry/sdf/cards/MESH_CARD_RESOURCES.js";
+import { chunk_mesh_sdf_normal } from "../../../geometry/sdf/chunk_mesh_sdf_normal.js";
+import { chunk_mesh_sdf_header } from "../../../geometry/sdf/chunk_mesh_sdf_sample.js";
 import {
     MESH_SDF_ATLAS_RESOURCE,
     MESH_SDF_HEADERS_RESOURCE,