@woosh/meep-engine 3.49.0 → 3.50.0

package/src/shade/renderer/geometry/bvh/shader_blas_refit_batch.d.ts

@@ -21,10 +21,13 @@ export const BLAS_REFIT_BATCH_WORKGROUP_SIZE: number;
  * next tree's, and the command count is the same for one skinned mesh as for three hundred.
  *
  * Fused rather than two passes: the leaf box is stored through the same atomic words the climb
- * reads, before the lane's first arrival, so the handshake that makes an internal node's box
- * visible to the second arrival at its parent makes a leaf's visible the same way. That is the
- * builder plan's R1 assumption made one level lower, not a new one — and one pass boundary, one
- * barrier and one re-read of every leaf box fewer.
+ * reads, before the lane's first arrival, so the second arrival at its parent reads it exactly as
+ * it reads an internal node's — including when it has not arrived yet. Arriving second does not
+ * order the sibling's stores (R1 in GPU_BVH_BUILD_PLAN.md), so every bound word is seeded with
+ * {@link BVH_UNFITTED} a dispatch earlier ({@link shader_blas_refit_batch_seed}), the climb defers
+ * the nodes it cannot see whole to the list in `refit_deferred`, and
+ * {@link shader_bvh_refit_repair} grows them a dispatch later — the build's own repair, over every
+ * tree in the batch at once.
  *
  * For a skinned mesh this runs against the per-instance clone, after the skinning pass has deformed
  * its vertex region; `geometry_index` on the row is the clone's, and reading the source instead

package/src/shade/renderer/geometry/bvh/shader_blas_refit_batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_blas_refit_batch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/shader_blas_refit_batch.js"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,8CAFU,MAAM,CAEkC;AA+ElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,sCAFU,aAAa,CAMpB;8BAlI2B,+BAA+B"}
+{"version":3,"file":"shader_blas_refit_batch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/shader_blas_refit_batch.js"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,8CAFU,MAAM,CAEkC;AAmFlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,sCAFU,aAAa,CAMpB;8BAzI2B,+BAA+B"}

package/src/shade/renderer/geometry/bvh/shader_blas_refit_batch.js

@@ -40,9 +40,13 @@ resources.createGroup()
     // the start of every batch
     .addStorageBuffer("counters", WebGPUArray.from(atomic_u32), true)
     // The node arena, flat and atomic. Every word this kernel writes is communicated between
-    // workgroups — a leaf box to the second arrival at its parent, a node box to the next — so every
-    // access to it is an atomic one, the discipline the builder plan's R1 rests on.
+    // invocations — a leaf box to the second arrival at its parent, a node box to the next — so
+    // every access to it is an atomic one. Its bound words arrive seeded by
+    // shader_blas_refit_batch_seed.
     .addStorageBuffer("nodes", WebGPUArray.from(atomic_u32), true)
+    // the nodes whose children had not all reached their second arrival, every tree's, for the
+    // repair; header zero at the start of every batch
+    .addStorageBuffer("refit_deferred", WebGPUArray.from(atomic_u32), true)
     .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT), false)
     .addStorageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT), false)
     .addStorageBuffer("meshlet_data", GEOMETRY_ATTRIBUTE_DATA_TYPE, false);
@@ -114,10 +118,13 @@ fn main(
  * next tree's, and the command count is the same for one skinned mesh as for three hundred.
  *
  * Fused rather than two passes: the leaf box is stored through the same atomic words the climb
- * reads, before the lane's first arrival, so the handshake that makes an internal node's box
- * visible to the second arrival at its parent makes a leaf's visible the same way. That is the
- * builder plan's R1 assumption made one level lower, not a new one — and one pass boundary, one
- * barrier and one re-read of every leaf box fewer.
+ * reads, before the lane's first arrival, so the second arrival at its parent reads it exactly as
+ * it reads an internal node's — including when it has not arrived yet. Arriving second does not
+ * order the sibling's stores (R1 in GPU_BVH_BUILD_PLAN.md), so every bound word is seeded with
+ * {@link BVH_UNFITTED} a dispatch earlier ({@link shader_blas_refit_batch_seed}), the climb defers
+ * the nodes it cannot see whole to the list in `refit_deferred`, and
+ * {@link shader_bvh_refit_repair} grows them a dispatch later — the build's own repair, over every
+ * tree in the batch at once.
  *
  * For a skinned mesh this runs against the per-instance clone, after the skinning pass has deformed
  * its vertex region; `geometry_index` on the row is the clone's, and reading the source instead

package/src/shade/renderer/geometry/bvh/shader_blas_refit_batch_seed.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Seed every bound word of every tree in a batch with {@link BVH_UNFITTED}, a dispatch ahead of
+ * {@link shader_blas_refit_batch}.
+ *
+ * The batch refit hands boxes between invocations through relaxed atomics — leaf boxes included,
+ * since it writes them in the same dispatch — and a store need not reach the reader before the
+ * dispatch ends. What this leaves behind is what such a read returns, so the climb can see a box
+ * that has not arrived instead of taking last frame's for it. For a skinned mesh last frame's box
+ * is close to this frame's, so taking it would go unnoticed.
+ *
+ * One lane per node slot, holes included: the arena's trees keep the slots their builder allocated,
+ * and seeding a hole costs six stores where telling it apart would cost a walk. The bounds words are
+ * all it touches; children and payloads are the tree's topology and stay as they are.
+ *
+ * Recorded by {@link GPUBLASRefitBatch}, paginated as the refit is.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_blas_refit_batch_seed: ComputeShader;
+import { ComputeShader } from "../../shader/ComputeShader.js";
+//# sourceMappingURL=shader_blas_refit_batch_seed.d.ts.map

package/src/shade/renderer/geometry/bvh/shader_blas_refit_batch_seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader_blas_refit_batch_seed.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/bvh/shader_blas_refit_batch_seed.js"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;GAiBG;AACH,2CAFU,aAAa,CAMpB;8BAvE2B,+BAA+B"}

package/src/shade/renderer/geometry/bvh/shader_blas_refit_batch_seed.js

@@ -0,0 +1,75 @@
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { BVH_NODE_LAYOUT_DEFINITION } from "../../gpu_primitive/bvh/BVH_NODE_LAYOUT_DEFINITION.js";
+import { BVH_REFIT_DEFERRED_DEFINITION } from "../../gpu_primitive/bvh/BVH_REFIT_DEFERRED_DEFINITION.js";
+import { BLAS_REFIT_TARGET_STRUCT } from "./BLAS_REFIT_TARGET_STRUCT.js";
+import { BLAS_REFIT_BATCH_WORKGROUP_SIZE } from "./shader_blas_refit_batch.js";
+
+const resources = new ShaderResourceSetDescriptor();
+
+// see shader_blas_refit_batch: workgroups covered by earlier pages of the same batch
+resources.setImmediate("dispatch_offset", u32);
+
+resources.createGroup()
+    .addStorageBuffer("targets", WebGPUArray.from(BLAS_REFIT_TARGET_STRUCT), false)
+    // `(target_index, slot_base)` per workgroup, flat: runs of node slots rather than of leaves
+    .addStorageBuffer("lookup", WebGPUArray.from(u32), false)
+    .addStorageBuffer("nodes", WebGPUArray.from(u32), true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(${BLAS_REFIT_BATCH_WORKGROUP_SIZE}, 1, 1)
+fn main(
+    @builtin(workgroup_id) wg: vec3<u32>,
+    @builtin(local_invocation_id) lid: vec3<u32>,
+) {
+    let pair = (wg.x + dispatch_offset) * 2u;
+
+    // ("target" is a reserved word in WGSL)
+    let tree = targets[lookup[pair]];
+
+    let slot = lookup[pair + 1u] + lid.x;
+
+    if (slot >= tree.node_count) {
+        // the tail of a tree's last run; the next workgroup is another tree's
+        return;
+    }
+
+    let bounds_word = tree.node_word_offset + slot * BVH_NODE_STRIDE + BVH_NODE_BOUNDS;
+
+    for (var w = 0u; w < 6u; w += 1u) {
+        nodes[bounds_word + w] = BVH_UNFITTED;
+    }
+}
+`, [
+    BVH_NODE_LAYOUT_DEFINITION,
+    BVH_REFIT_DEFERRED_DEFINITION,
+]);
+
+/**
+ * Seed every bound word of every tree in a batch with {@link BVH_UNFITTED}, a dispatch ahead of
+ * {@link shader_blas_refit_batch}.
+ *
+ * The batch refit hands boxes between invocations through relaxed atomics — leaf boxes included,
+ * since it writes them in the same dispatch — and a store need not reach the reader before the
+ * dispatch ends. What this leaves behind is what such a read returns, so the climb can see a box
+ * that has not arrived instead of taking last frame's for it. For a skinned mesh last frame's box
+ * is close to this frame's, so taking it would go unnoticed.
+ *
+ * One lane per node slot, holes included: the arena's trees keep the slots their builder allocated,
+ * and seeding a hole costs six stores where telling it apart would cost a walk. The bounds words are
+ * all it touches; children and payloads are the tree's topology and stay as they are.
+ *
+ * Recorded by {@link GPUBLASRefitBatch}, paginated as the refit is.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_blas_refit_batch_seed = ComputeShader.from({
+    label: "BLAS/RefitBatchSeed",
+    resources,
+    body,
+});

package/src/shade/renderer/geometry/meshlet/MESHLET_METADATA_RESOURCE.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Every meshlet's metadata (`MESHLET_METADATA_STRUCT`).
+ * @type {ShaderResourceDescriptor}
+ */
+export const MESHLET_METADATA_RESOURCE: ShaderResourceDescriptor;
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+//# sourceMappingURL=MESHLET_METADATA_RESOURCE.d.ts.map

package/src/shade/renderer/geometry/meshlet/MESHLET_METADATA_RESOURCE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MESHLET_METADATA_RESOURCE.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/meshlet/MESHLET_METADATA_RESOURCE.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wCAFU,wBAAwB,CAE6G;yCARtG,mDAAmD"}

package/src/shade/renderer/geometry/meshlet/MESHLET_METADATA_RESOURCE.js

@@ -0,0 +1,9 @@
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { MESHLET_METADATA_STRUCT } from "./encoding/MESHLET_METADATA_STRUCT.js";
+
+/**
+ * Every meshlet's metadata (`MESHLET_METADATA_STRUCT`).
+ * @type {ShaderResourceDescriptor}
+ */
+export const MESHLET_METADATA_RESOURCE = ShaderResourceDescriptor.storageBuffer("meshlet_metadata", WebGPUArray.from(MESHLET_METADATA_STRUCT));

package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.d.ts

@@ -30,13 +30,13 @@ export class GPUGeometrySDFManager {
      */
     get texture(): import("../../texture/GPUTextureContext.js").GPUTextureContext;
     /**
-     * Resolution in SDF texels for a single geometry, which is also the stride between tiles: the
-     * atlas holds them with no border.
+     * Resolution in SDF texels for a single geometry along each axis — the tile is a cube — which is
+     * also the stride between tiles: the atlas holds them with no border.
      * @return {number}
      */
     get tile_resolution(): number;
     /**
-     * Tiles along x, y and z — what `sdf_slot_index_to_texture_offset` takes to place a slot. Read it
+     * Tiles along x, y and z — x and y are what `tile_atlas_slot_origin` takes to place a slot. Read it
      * after {@link build_slots}: when the atlas widens, x or y changes and every tile moves.
      * @return {number[]}
      */

package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUGeometrySDFManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;GAYG;AACH;IAaI;;;OAGG;IACH,+BAeC;IAED;;;;OAIG;IACH,4BAEC;IAED;;;;OAIG;IACH,8EAEC;IAED;;;;OAIG;IACH,8BAEC;IAED;;;;OAIG;IACH,0CASC;IAED;;;OAGG;IACH,uBAEC;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAYhB;IAED,gBAEC;IAGD;;;;;OAKG;IACH,yBAJW,sBAAsB,gBACtB,MAAM,EAAE,cACR,kBAAkB,QAyD5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,QAAQ,YAAY,CAAC,CAOhC;;CACJ;qCA3NY,OAAO,2CAA2C,EAAE,sBAAsB;iCAC1E,OAAO,0BAA0B,EAAE,kBAAkB;oCACrD,OAAO,iCAAiC,EAAE,qBAAqB;+BAP7C,uCAAuC"}
+{"version":3,"file":"GPUGeometrySDFManager.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;GAYG;AACH;IAaI;;;OAGG;IACH,+BAgBC;IAED;;;;OAIG;IACH,4BAEC;IAED;;;;OAIG;IACH,8EAEC;IAED;;;;OAIG;IACH,8BAEC;IAED;;;;OAIG;IACH,0CASC;IAED;;;OAGG;IACH,uBAEC;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAYhB;IAED,gBAEC;IAGD;;;;;OAKG;IACH,yBAJW,sBAAsB,gBACtB,MAAM,EAAE,cACR,kBAAkB,QA4D5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,QAAQ,YAAY,CAAC,CAKhC;;CACJ;qCA7NY,OAAO,2CAA2C,EAAE,sBAAsB;iCAC1E,OAAO,0BAA0B,EAAE,kBAAkB;oCACrD,OAAO,iCAAiC,EAAE,qBAAqB;+BAP7C,uCAAuC"}

package/src/shade/renderer/geometry/sdf/GPUGeometrySDFManager.js

@@ -66,7 +66,8 @@ export class GPUGeometrySDFManager {
         this.#atlas = new GPUTileAtlas3D({
             device,
             format: "r32float",
-            content_size: DEFAULT_MESH_RESOLUTION,
+            // a cube: the build and every reader take one resolution for all three axes
+            content_size: [DEFAULT_MESH_RESOLUTION, DEFAULT_MESH_RESOLUTION, DEFAULT_MESH_RESOLUTION],
             border: 0,
             slots_x: ATLAS_SLOTS_X,
             slots_y: ATLAS_SLOTS_Y,
@@ -96,16 +97,16 @@ export class GPUGeometrySDFManager {
     }
 
     /**
-     * Resolution in SDF texels for a single geometry, which is also the stride between tiles: the
-     * atlas holds them with no border.
+     * Resolution in SDF texels for a single geometry along each axis — the tile is a cube — which is
+     * also the stride between tiles: the atlas holds them with no border.
      * @return {number}
      */
     get tile_resolution() {
-        return this.#atlas.tile_size;
+        return DEFAULT_MESH_RESOLUTION;
     }
 
     /**
-     * Tiles along x, y and z — what `sdf_slot_index_to_texture_offset` takes to place a slot. Read it
+     * Tiles along x, y and z — x and y are what `tile_atlas_slot_origin` takes to place a slot. Read it
      * after {@link build_slots}: when the atlas widens, x or y changes and every tile moves.
      * @return {number[]}
      */
@@ -173,7 +174,7 @@ export class GPUGeometrySDFManager {
 
         // TODO spread work over multiple frames
 
-        const slot_resolution = this.#atlas.content_size;
+        const slot_resolution = this.tile_resolution;
         const atlas_resolution_in_slots = this.atlas_resolution_in_tiles;
 
         for (let i = 0; i < slot_indices.length; i++) {
@@ -203,6 +204,9 @@ export class GPUGeometrySDFManager {
                     blas_lookup: blas.buffer_metadata,
                     blas_data: blas.buffer_data,
                     geometries: geometries.buffer_metadata,
+                    // the triangles the query reads, through their meshlets
+                    meshlet_metadata: geometries.meshlets.buffer_metadata,
+                    meshlet_data: geometries.meshlets.buffer_data,
                     output_texture: this.#atlas.texture.obtainView(),
                 },
                 group_count_x: wgx,
@@ -220,8 +224,6 @@ export class GPUGeometrySDFManager {
      */
     async download_slot(slot) {
         const atlas = this.#atlas;
-        const t = atlas.tile_size;
-
-        return /** @type {Promise<Float32Array>} */ (atlas.texture.download_region(atlas.slot_origin(slot, [0, 0, 0]), [t, t, t]));
+        return /** @type {Promise<Float32Array>} */ (atlas.texture.download_region(atlas.slot_origin(slot, [0, 0, 0]), atlas.tile_size));
     }
 }

package/src/shade/renderer/geometry/sdf/shader_build_sdf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_build_sdf.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/shader_build_sdf.js"],"names":[],"mappings":"AAyHA,6CAA8D;8BAjHhC,+BAA+B"}
+{"version":3,"file":"shader_build_sdf.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/shader_build_sdf.js"],"names":[],"mappings":"AA6HA,6CAA8D;8BArHhC,+BAA+B"}

package/src/shade/renderer/geometry/sdf/shader_build_sdf.js

@@ -9,11 +9,13 @@ import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
+import { chunk_tile_atlas_slot_origin } from "../../texture/atlas/chunk_tile_atlas_slot_origin.js";
 import { GEOMETRY_METADATA_STRUCT } from "../GEOMETRY_METADATA_STRUCT.js";
 import { chunk_blas_query_sdf } from "./chunk_blas_query_sdf.js";
-import { chunk_sdf_slot_index_to_texture_offset } from "./chunk_sdf_slot_index_to_texture_offset.js";
 import { SDF_BUILD_SETTINGS_STRUCT } from "./SDF_BUILD_SETTINGS_STRUCT.js";
 import { SFD_BUILD_WORKGROUP_SIZE } from "./SFD_BUILD_WORKGROUP_SIZE.js";
+import { GEOMETRY_ATTRIBUTE_DATA_RESOURCE } from "../GEOMETRY_ATTRIBUTE_DATA_RESOURCE.js";
+import { MESHLET_METADATA_RESOURCE } from "../meshlet/MESHLET_METADATA_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
@@ -24,6 +26,8 @@ resources.createGroup()
     .addStorageBuffer("blas_lookup", WebGPUArray.u32)
     .addStorageBuffer("blas_data", WebGPUArray.from(BVH2_NODE_STRUCT))
     .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+    .add(MESHLET_METADATA_RESOURCE)
+    .add(GEOMETRY_ATTRIBUTE_DATA_RESOURCE)
 
 resources.createGroup()
     .addStorageTexture("output_texture", "r32float", "3d");
@@ -52,7 +56,7 @@ fn main(
     let slot_index = settings.slot_index;
 
     // the slot's corner in the atlas: its grid cell, a whole tile per cell (no border)
-    let texel_offset = sdf_slot_index_to_texture_offset(slot_index, settings.atlas_resolution_in_slots) * slot_resolution;
+    let texel_offset = tile_atlas_slot_origin(slot_index, settings.atlas_resolution_in_slots.xy, vec3(slot_resolution));
     
     let texel_coordinate = texel_offset + global_id;
     
@@ -107,7 +111,7 @@ fn main(
 }
 `, [
         AABB3_STRUCT.declaration_chunk,
-        chunk_sdf_slot_index_to_texture_offset,
+        chunk_tile_atlas_slot_origin,
         F32_MAX_DEFINITION,
         chunk_array_to_aabb3,
         chunk_blas_query_sdf,

package/src/shade/renderer/geometry/sdf/shader_sdf_visualize.js

@@ -74,7 +74,7 @@ fn main(
 //    
 //        let sdf_uv = (vec3(vec2(vec2f(coord_i)/SLICE_ZOOM), settings.slice * f32(settings.sdf_tile_resolution - 1u)) + 0.5) / f32(settings.sdf_tile_resolution);
 //   
-//        let offset = sdf_slot_index_to_texture_offset(geometry_id, settings.sdf_atlas_resolution) * settings.sdf_tile_resolution;
+//        let offset = tile_atlas_slot_origin(geometry_id, settings.sdf_atlas_resolution.xy, vec3(settings.sdf_tile_resolution));
 //        let geometry_distance = sdf_texture_region_sample_linear_uv(texture_sdf,  offset,  vec3(settings.sdf_tile_resolution), sdf_uv);
 //        return vec4(select(vec3(geometry_distance*scale, 0.0, 0.0), vec3(0.0, 0.0, geometry_distance*scale), geometry_distance >= 0), 1.0);
 ////        return vec4(vec3( geometry_distance ), 1.0);

package/src/shade/renderer/global_illumination/brick4/gpu/BRICK4_RESOURCE.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Brick4's light map.
+ * @type {ShaderResourceDescriptor}
+ */
+export const BRICK4_RESOURCE: ShaderResourceDescriptor;
+import { ShaderResourceDescriptor } from "../../../shader/resource/ShaderResourceDescriptor.js";
+//# sourceMappingURL=BRICK4_RESOURCE.d.ts.map

package/src/shade/renderer/global_illumination/brick4/gpu/BRICK4_RESOURCE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BRICK4_RESOURCE.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/BRICK4_RESOURCE.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,8BAFU,wBAAwB,CAEkE;yCAP3D,sDAAsD"}

package/src/shade/renderer/global_illumination/brick4/gpu/BRICK4_RESOURCE.js

@@ -0,0 +1,8 @@
+import { ShaderResourceDescriptor } from "../../../shader/resource/ShaderResourceDescriptor.js";
+import { BRICK4_DATA_STRUCT } from "./BRICK4_DATA_STRUCT.js";
+
+/**
+ * Brick4's light map.
+ * @type {ShaderResourceDescriptor}
+ */
+export const BRICK4_RESOURCE = ShaderResourceDescriptor.storageBuffer("brick4", BRICK4_DATA_STRUCT);

package/src/shade/renderer/global_illumination/brick4/gpu/bake/brick4_bake_basic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brick4_bake_basic.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/brick4_bake_basic.js"],"names":[],"mappings":"AAqCA;;;;;;;GAOG;AACH;IAL2C,MAAM;IACb,QAAQ;IACT,GAAG;IACF,KAAK;yBAqMxC"}
+{"version":3,"file":"brick4_bake_basic.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/brick4_bake_basic.js"],"names":[],"mappings":"AAqCA;;;;;;;GAOG;AACH;IAL2C,MAAM;IACb,QAAQ;IACT,GAAG;IACF,KAAK;yBAuMxC"}

package/src/shade/renderer/global_illumination/brick4/gpu/bake/brick4_bake_basic.js

@@ -175,6 +175,8 @@ export async function brick4_bake_basic({
                 tEnvironment: scene.lights.environment.obtainView(),
                 tParticipatingMediaNoise: scene.volumetrics.noise_atlas.texture.obtainView(),
                 sParticipatingMediaNoise: graphics.samplers.obtain(PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR),
+                wind_field: scene.wind.uniform,
+                wind_field_atlas: scene.wind.atlas.texture,
                 //
                 probe_positions: gr_cycle_probe_positions,
                 output: gr_cycle_trace_data,

package/src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_probes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick4_bake_probes.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_probes.js"],"names":[],"mappings":"AAmHA,sDAIG;8BAxG2B,qCAAqC"}
+{"version":3,"file":"shader_brick4_bake_probes.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_probes.js"],"names":[],"mappings":"AAqHA,sDAIG;8BA1G2B,qCAAqC"}

package/src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_probes.js

@@ -17,6 +17,7 @@ import { ComputeShader } from "../../../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
 import { RESOURCE_GROUP_RTX } from "../../../../geometry/sr_create_group_RTX.js";
 import { PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR } from "../../../../volumetrics/noise/PARTICIPATING_MEDIA_NOISE.js";
+import { wind_field_add_resources } from "../../../../wind/wind_field_add_resources.js";
 import { chunk_direction_by_index_rand1 } from "./sampling/chunk_direction_by_index_rand1.js";
 
 const resources = new ShaderResourceSetDescriptor();
@@ -28,12 +29,13 @@ resources.createGroup()
     .addUniform("media", MEDIA_TABLE_STRUCT)
     .addTexture("textures", "unfilterable-float", "2d-array")
 
-resources.createGroup()
+// the scene's wind, which carries the fog volumes' noise: one uniform, one texture, one sampler
+wind_field_add_resources(resources.createGroup()
     .addStorageBuffer("light_data", WebGPUArray.u32)
     .addTexture("tEnvironment", "unfilterable-float", "2d")
     // the fog volumes' noise, read through participating_media_volume_density_at
     .addTexture("tParticipatingMediaNoise", "float", "3d")
-    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR)
+    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR));
 
 const BRICK4_BAKE_SETTINGS_STRUCT = WebGPUStruct.from({
     sample_count: u32,

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_load_probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick4_load_probe.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_load_probe.js"],"names":[],"mappings":"AAGA,gDAWC;0BAdyB,0CAA0C"}
+{"version":3,"file":"chunk_brick4_load_probe.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_load_probe.js"],"names":[],"mappings":"AAIA,gDAWC;0BAfyB,0CAA0C"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_load_probe.js

@@ -1,5 +1,6 @@
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import { chunk_brick4_sh3_color_decode } from "../encoding/v2/chunk_brick4_sh3_color_decode.js";
+import { BRICK4_RESOURCE } from "../BRICK4_RESOURCE.js";
 
 export const chunk_brick4_load_probe = CodeChunk.from(
     //language=WGSL
@@ -12,4 +13,6 @@ fn brick4_load_probe( address: u32 ) -> array< vec3<f32>, 9 >{
     `, [
         chunk_brick4_sh3_color_decode
     ]
-)
+)
+
+chunk_brick4_load_probe.requireResource(BRICK4_RESOURCE);

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_by_position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick4_node_by_position.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_by_position.js"],"names":[],"mappings":"AAWA,sDAqFC;0BA7FyB,0CAA0C"}
+{"version":3,"file":"chunk_brick4_node_by_position.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_by_position.js"],"names":[],"mappings":"AAYA,sDAqFC;0BA9FyB,0CAA0C"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_by_position.js

@@ -3,6 +3,7 @@ import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
 import { AABB3_STRUCT } from "../../../../shader/chunk/geometry/aabb3/AABB3_STRUCT.js";
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import { BRICK4_BRANCH_FACTOR } from "../../BRICK4_BRANCH_FACTOR.js";
+import { BRICK4_RESOURCE } from "../BRICK4_RESOURCE.js";
 
 const BRICK4_NODE_DESCRIPTOR_STRUCT = WebGPUStruct.from({
     bounds: AABB3_STRUCT,
@@ -94,4 +95,6 @@ fn brick4_node_by_position(
     `, [
         BRICK4_NODE_DESCRIPTOR_STRUCT.declaration_chunk,
     ]
-)
+)
+
+chunk_brick4_node_by_position.requireResource(BRICK4_RESOURCE);

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_sample_probes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick4_node_sample_probes.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_sample_probes.js"],"names":[],"mappings":"AASA,wDA6EC;0BArFyB,0CAA0C"}
+{"version":3,"file":"chunk_brick4_node_sample_probes.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_sample_probes.js"],"names":[],"mappings":"AAUA,wDA6EC;0BAtFyB,0CAA0C"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_node_sample_probes.js

@@ -4,6 +4,7 @@ import { BRICK4_PROBE_RESOLUTION } from "../../BRICK4_PROBE_RESOLUTION.js";
 import { chunk_brick4_load_probe } from "./chunk_brick4_load_probe.js";
 import { chunk_brick4_probe_compute_weight_by_normal } from "./chunk_brick4_probe_compute_weight_by_normal.js";
 import { chunk_brick4_probe_coord_to_index } from "./chunk_brick4_probe_coord_to_index.js";
+import { BRICK4_RESOURCE } from "../BRICK4_RESOURCE.js";
 
 const PROBE_COORD_MAX = BRICK4_PROBE_RESOLUTION - 1;
 
@@ -86,4 +87,6 @@ fn brick4_node_sample_probes(
     ]
 )
 
+chunk_brick4_node_sample_probes.requireResource(BRICK4_RESOURCE);
+
 

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_probe_meta_pick2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick4_probe_meta_pick2.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_probe_meta_pick2.js"],"names":[],"mappings":"AAeA;;;;;;;;;;GAUG;AACH,4CAFU,SAAS,CAkDlB;0BArEyB,0CAA0C"}
+{"version":3,"file":"chunk_brick4_probe_meta_pick2.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_probe_meta_pick2.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,4CAFU,SAAS,CAkDlB;0BAtEyB,0CAA0C"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_probe_meta_pick2.js

@@ -5,6 +5,7 @@ import {
 } from "../../../../shader/chunk/random/reservoir/chunk_sample_discrete_wrs_mat2x4.js";
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import { BRICK4_PROBE_SAMPLE_META_STRUCT } from "./BRICK4_PROBE_SAMPLE_META_STRUCT.js";
+import { BRICK4_RESOURCE } from "../BRICK4_RESOURCE.js";
 
 const BRICK4_PROBE_SAMPLE2_META_STRUCT = WebGPUStruct.from({
     global_indices: vec2u,
@@ -72,4 +73,6 @@ fn brick4_probe_meta_pick2(
         BRICK4_PROBE_SAMPLE2_META_STRUCT.declaration_chunk,
         chunk_sample_discrete_wrs_mat2x4,
     ]
-)
+)
+
+chunk_brick4_probe_meta_pick2.requireResource(BRICK4_RESOURCE);

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_sample_forward_indirect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_brick4_sample_forward_indirect.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_sample_forward_indirect.js"],"names":[],"mappings":"AAmCA,6DAqEC;0BAhGyB,0CAA0C"}
+{"version":3,"file":"chunk_brick4_sample_forward_indirect.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_sample_forward_indirect.js"],"names":[],"mappings":"AAsCA,6DAqEC;0BAnGyB,0CAA0C"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/chunk_brick4_sample_forward_indirect.js

@@ -11,6 +11,7 @@ import { chunk_brick4_load_probe } from "./chunk_brick4_load_probe.js";
 import { chunk_brick4_node_by_position } from "./chunk_brick4_node_by_position.js";
 import { chunk_brick4_node_sample_probes_meta } from "./chunk_brick4_node_sample_probes_meta.js";
 import { chunk_brick4_probe_meta_pick2 } from "./chunk_brick4_probe_meta_pick2.js";
+import { VIEW_RESOURCE } from "../../../../view/VIEW_RESOURCE.js";
 
 const chunk_jitter_from_vectors = CodeChunk.from(
     //language=WGSL
@@ -33,6 +34,8 @@ fn jitter_from_vectors(v0:vec3<f32>, v1: vec3<f32>) -> vec2<f32>{
     ]
 )
 
+chunk_jitter_from_vectors.requireResource(VIEW_RESOURCE);
+
 export const chunk_brick4_sample_forward_indirect = CodeChunk.from(
     //language=WGSL
     `

package/src/shade/renderer/global_illumination/clipmap/shader_debug_clipmap.d.ts

@@ -1,3 +1,18 @@
+/**
+ * What the overlay draws: a clipmap's levels, finest first, and the width of their edge bands.
+ * @type {WebGPUStruct}
+ */
+export const CLIPMAP_DEBUG_STRUCT: WebGPUStruct;
+/**
+ * A debug overlay for any clipmap of cascades: each surface pixel takes the colour of the finest
+ * level whose window holds it, shaded toward the next level's colour across that window's edge band,
+ * with lines on the level's cell faces. Pixels no level holds, and the background, are discarded.
+ *
+ * Reads the scene depth, a {@link CLIPMAP_DEBUG_STRUCT} and the camera.
+ *
+ * @type {ImageShader}
+ */
 export const shader_debug_clipmap: ImageShader;
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
 import { ImageShader } from "../../shader/ImageShader.js";
 //# sourceMappingURL=shader_debug_clipmap.d.ts.map

package/src/shade/renderer/global_illumination/clipmap/shader_debug_clipmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_debug_clipmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/shader_debug_clipmap.js"],"names":[],"mappings":"AAiGA,+CASE;4BApG0B,6BAA6B"}
+{"version":3,"file":"shader_debug_clipmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/shader_debug_clipmap.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH,mCAFU,YAAY,CAYH;AA6DnB;;;;;;;;GAQG;AACH,mCAFU,WAAW,CAWnB;6BA/F2B,mCAAmC;4BAJpC,6BAA6B"}