@woosh/meep-engine 3.47.0 → 3.50.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":"AAoCA;;;;;;;GAOG;AACH;IAL2C,MAAM;IACb,QAAQ;IACT,GAAG;IACF,KAAK;yBAmMxC"}
+{"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

@@ -13,6 +13,7 @@ import { BRICK4_PROBE_ENCODED_SIZE } from "../../BRICK4_PROBE_ENCODED_SIZE.js";
 import { brick4_extract_probe_locations } from "../../cpu/brick4_extract_probe_locations.js";
 import { brick4_optimize_probe_placement } from "../../cpu/brick4_optimize_probe_placement.js";
 import { shader_brick4_bake_probes } from "./shader_brick4_bake_probes.js";
+import { PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR } from "../../../../volumetrics/noise/PARTICIPATING_MEDIA_NOISE.js";
 import { shader_brick4_bake_resolve_probes } from "./shader_brick4_bake_resolve_probes.js";
 
 const QUALITY_PROFILE = {
@@ -172,6 +173,10 @@ export async function brick4_bake_basic({
                 //
                 light_data: scene.lights.buffer_data,
                 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":"AA+GA,sDAIG;8BApG2B,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

@@ -16,6 +16,8 @@ import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 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();
@@ -27,9 +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));
 
 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/brick4/gpu/draw/shader_brick4_indirect_lighting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick4_indirect_lighting.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_indirect_lighting.js"],"names":[],"mappings":"AAsMA,0DAwBE;4BAxM0B,mCAAmC"}
+{"version":3,"file":"shader_brick4_indirect_lighting.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_indirect_lighting.js"],"names":[],"mappings":"AA0MA,0DAwBE;4BA3M0B,mCAAmC"}

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

@@ -3,6 +3,7 @@ import { chunk_stbn_sample_vec2 } from "../../../../shader/chunk/noise/chunk_stb
 import { DEPTH_STENCIL_FOREGROUND_ONLY } from "../../../../depth/DEPTH_STENCIL_FOREGROUND_ONLY.js";
 import { BSDF_ROUGHNESS_MINIMUM } from "../../../../light/environment/DEFINES.js";
 import { chunk_compute_specular_occlusion_bn } from "../../../../shader/chunk/brdf/chunk_compute_specular_occlusion_bn.js";
+import { chunk_MIN_DIELECTRICS_F0 } from "../../../../shader/chunk/brdf/chunk_MIN_DIELECTRICS_F0.js";
 import {
     chunk_project_position_from_depth
 } from "../../../../shader/chunk/camera/chunk_project_position_from_depth.js";
@@ -161,6 +162,8 @@ fn main(
         view_direction,
         material_color_diffuse,
         material_specularF0,
+        vec3(MIN_DIELECTRICS_F0),
+        albedo,
         material_specularF90,
         roughness,
     );
@@ -181,6 +184,7 @@ fn main(
         chunk_decode_g_buffer_metalness,
         chunk_decode_g_buffer_roughness,
         chunk_metalness_to_specular_color,
+        chunk_MIN_DIELECTRICS_F0,
         chunk_brick4_node_by_position,
         chunk_brick4_node_sample_probes_meta,
         chunk_brick4_probe_meta_pick2,

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"}

package/src/shade/renderer/global_illumination/clipmap/shader_debug_clipmap.js

@@ -1,25 +1,40 @@
 import { CAMERA_UNIFORM_STRUCT } from "../../camera/CAMERA_UNIFORM_STRUCT.js";
-import { chunk_is_background } from "../../shader/chunk/depth/chunk_is_background.js";
 import { chunk_project_position_from_depth } from "../../shader/chunk/camera/chunk_project_position_from_depth.js";
-import { chunk_lut_inferno } from "../../shader/chunk/color/lut/chunk_lut_inferno.js";
+import { chunk_clipmap_select_finest } from "../../shader/chunk/clipmap/chunk_clipmap_select_finest.js";
+import { CLIPMAP_LEVEL_ARRAY } from "../../shader/chunk/clipmap/CLIPMAP_LEVEL_STRUCT.js";
 import { chunk_lut_viridis } from "../../shader/chunk/color/lut/chunk_lut_viridis.js";
+import { chunk_is_background } from "../../shader/chunk/depth/chunk_is_background.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
-import { chunk_clip_cascade_coord_encode } from "./chunk_clip_cascade_wrap_coord.js";
-import { CLIPMAP_METADATA } from "./CLIPMAP_METADATA.js";
+import { f32, u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+
+/**
+ * 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.from({
+    /**
+     * Levels of {@link levels} in use.
+     */
+    level_count: u32,
+    /**
+     * Cells, positive: how far into a window its edge band reaches.
+     */
+    band_width: f32,
+    levels: CLIPMAP_LEVEL_ARRAY,
+}, "ClipmapDebug");
 
 const resources = new ShaderResourceSetDescriptor();
 resources.createGroup()
     .addTexture("tDepth")
-    .addTexture("gBufferOcclusion")
-    .addUniform("clipmap_info", CLIPMAP_METADATA)
+    .addUniform("clipmap", CLIPMAP_DEBUG_STRUCT)
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
 ;
 
 /**
- *
  * @type {CodeChunk}
  */
 const body = CodeChunk.from(
@@ -33,75 +48,60 @@ fn main(
     let coord_i = vec2<i32>(coord.xy);
 
     let device_depth = textureLoad(tDepth, coord_i, 0).r;
-    
+
     if(is_background(device_depth)){
-        discard ;
+        discard;
     }
 
-    let position_ws = project_position_from_depth(uv, device_depth, camera.view_projection_matrix_inverse );
+    let position_ws = project_position_from_depth(uv, device_depth, camera.view_projection_matrix_inverse);
+
+    let selection = clipmap_select_finest(&clipmap.levels, clipmap.level_count, position_ws, clipmap.band_width);
 
-    var clip_level = clipmap_info.cascade_count;
-    var distance_to_boxel_boundary = 1.0;
-    
-    for(var i=0u; i < clipmap_info.cascade_count; i++){
-        let cascade = clipmap_info.cascades[i];
-    
-        let position_vx = (position_ws / cascade.voxel_size);
-        
-        let position_vx_i = vec3i(position_vx);
-        
-        let center = cascade.offset;
-        
-        if(any(vec3u(abs(position_vx_i - center)) >= vec3(clipmap_info.cascade_resolution/2))){
-            continue;
-        }
-        
-        let voxel_coord = clip_cascade_coord_encode(
-            position_vx_i,
-            clipmap_info.cascade_resolution,
-            center,
-        );
-        
-        let distance_to_boundary = min( fract(position_vx), 1.0 - fract(position_vx) );
-        distance_to_boxel_boundary = min(distance_to_boundary.x, min(distance_to_boundary.y, distance_to_boundary.z));
-        
-        clip_level = i;
-        break;
+    if(selection.level == CLIPMAP_LEVEL_NONE){
+        discard;
     }
-    
-    var color = viridis(1.0 - ( f32(clip_level) + 0.5) / f32(clipmap_info.cascade_count));
-    
-    
-    
-    // check out this https://gamedev.stackexchange.com/questions/183899/how-to-render-a-grid-of-dots-being-exactly-1x1-pixel-wide-using-a-shader
-    // want to draw lines such that they are readable at every distance and don't get larger as we get closer
-    let voxel_boundary = smoothstep(0.0, 0.02/clipmap_info.cascades[clip_level].voxel_size, distance_to_boxel_boundary) ;
-    
-    color = mix(vec3(0.11),color,voxel_boundary);
-    
-    let ao_term = textureLoad(gBufferOcclusion,coord_i, 0).a;
-    
-    color = color * ao_term;
-    
 
-    return vec4(color,1.0);
+    // a colour per level, finest brightest; the edge band shades toward the next level's colour
+    let level_count = f32(clipmap.level_count);
+    let own_color = viridis(1.0 - (f32(selection.level) + 0.5) / level_count);
+    let next_color = viridis(1.0 - (f32(selection.level) + 1.5) / level_count);
+
+    var color = mix(own_color, next_color, selection.edge_weight);
+
+    // lines on the level's cell faces, two centimetres wide in the world
+    let cell_size = clipmap.levels[selection.level].cell_size;
+    let position_cells = position_ws / cell_size;
+    let to_face = min(fract(position_cells), 1.0 - fract(position_cells));
+    let nearest_face = min(to_face.x, min(to_face.y, to_face.z));
+
+    color = mix(vec3(0.11), color, smoothstep(0.0, 0.02 / cell_size, nearest_face));
+
+    return vec4(color, 1.0);
 }
     `, [
         chunk_project_position_from_depth,
-        chunk_clip_cascade_coord_encode,
+        chunk_clipmap_select_finest,
         chunk_lut_viridis,
-        chunk_lut_inferno,
         chunk_is_background,
     ]
 );
 
+/**
+ * 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.from({
     descriptor: ShaderDescriptor.from({
-        label: "Clipmap3D Debug",
+        label: "Clipmap Debug",
         resources,
         body
     }),
     targets: [{
         format: "rgba16float"
     }]
-})
+})

package/src/shade/renderer/global_illumination/lpv/bake/GPULightProbeVolumeRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPULightProbeVolumeRenderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/lpv/bake/GPULightProbeVolumeRenderer.js"],"names":[],"mappings":"AAqBA;;;GAGG;AAEH;IA+GI;;;;OAIG;IACH,sBAHW,eAAe,SACf,eAAe,QAQzB;IAhCD;;;;OAIG;IACH,sBAHW,eAAe,SACf,eAAe,EAgBzB;IAtFD;;;OAGG;IACH,sCAEC;IAdD;;;OAGG;IACH,qCAEC;IAoCD;;;OAGG;IACH,6BAEC;IAYD;;;OAGG;IACH,0CASC;IAyDD;;;OAGG;IACH,gCAFW,MAAM,wEAUhB;IAED;;;;;OAKG;IACH,qBAJW,sBAAsB,gBACtB,MAAM,qBACN,MAAM,QA6ChB;IAED,aAmGC;IAED;;;OAGG;IACH,sCAFW,MAAM,QA8ChB;IAED;;;OAGG;IACH,eAFY,MAAM,CAUjB;IAED,gBACC;;CACJ;8BA7XY,OAAO,6BAA6B,EAAE,eAAe;8BACrD,OAAO,mCAAmC,EAAE,eAAe;kCAZtC,uCAAuC;uCAFlC,8CAA8C"}
+{"version":3,"file":"GPULightProbeVolumeRenderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/lpv/bake/GPULightProbeVolumeRenderer.js"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH;IA+GI;;;;OAIG;IACH,sBAHW,eAAe,SACf,eAAe,QAQzB;IAhCD;;;;OAIG;IACH,sBAHW,eAAe,SACf,eAAe,EAgBzB;IAtFD;;;OAGG;IACH,sCAEC;IAdD;;;OAGG;IACH,qCAEC;IAoCD;;;OAGG;IACH,6BAEC;IAYD;;;OAGG;IACH,0CASC;IAyDD;;;OAGG;IACH,gCAFW,MAAM,wEAUhB;IAED;;;;;OAKG;IACH,qBAJW,sBAAsB,gBACtB,MAAM,qBACN,MAAM,QA6ChB;IAED,aAuGC;IAED;;;OAGG;IACH,sCAFW,MAAM,QA8ChB;IAED;;;OAGG;IACH,eAFY,MAAM,CAUjB;IAED,gBACC;;CACJ;8BAjYY,OAAO,6BAA6B,EAAE,eAAe;8BACrD,OAAO,mCAAmC,EAAE,eAAe;kCAbtC,uCAAuC;uCAFlC,8CAA8C"}

package/src/shade/renderer/global_illumination/lpv/bake/GPULightProbeVolumeRenderer.js

@@ -18,6 +18,7 @@ import {
 } from "../deprecated/probe_trace_compute_shader_code.js";
 import { graph_generate_probe_locations } from "../placement/graph_generate_probe_locations.js";
 import { PROBE_RAYS_PER_WORKGROUP } from "./PROBE_RAYS_PER_WORKGROUP.js";
+import { PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR } from "../../../volumetrics/noise/PARTICIPATING_MEDIA_NOISE.js";
 
 /**
  * @typedef {import("../../../GraphicsContext.js").GraphicsContext} GraphicsContext
@@ -301,6 +302,10 @@ export class GPULightProbeVolumeRenderer {
                 textures: r_materials.textureView,
                 bake_settings: bake_uniform,
                 tEnvironment: this.#environment.obtainView(),
+                tParticipatingMediaNoise: scene.volumetrics.noise_atlas.texture.obtainView(),
+                sParticipatingMediaNoise: this.#graphics.samplers.obtain(PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR),
+                wind_field: scene.wind.uniform,
+                wind_field_atlas: scene.wind.atlas.texture,
                 //
                 tlas: scene.tlas.buffer,
                 blas_lookup: blas.buffer_metadata,

package/src/shade/renderer/global_illumination/lpv/deprecated/chunk_lpv_get_visibility_mask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_lpv_get_visibility_mask.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/lpv/deprecated/chunk_lpv_get_visibility_mask.js"],"names":[],"mappings":"AAQA,sDAqDE;0BAvDwB,uCAAuC"}
+{"version":3,"file":"chunk_lpv_get_visibility_mask.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/lpv/deprecated/chunk_lpv_get_visibility_mask.js"],"names":[],"mappings":"AASA,sDAqDE;0BAxDwB,uCAAuC"}

package/src/shade/renderer/global_illumination/lpv/deprecated/chunk_lpv_get_visibility_mask.js

@@ -5,6 +5,7 @@ import {
     chunk_lpv_sample_depth_atlas_native
 } from "../../../shader/chunk/light/lpv/depth/chunk_lpv_sample_depth_atlas.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { LPV_PROBES_RESOURCE } from "../../probe/octahedral/LPV_SHADER_RESOURCE_GROUP.js";
 
 export const chunk_lpv_get_visibility_mask = CodeChunk.from(
     //language=WGSL
@@ -61,3 +62,5 @@ fn lpv_get_visibility_mask(
     ]
 );
 
+chunk_lpv_get_visibility_mask.requireResource(LPV_PROBES_RESOURCE);
+

package/src/shade/renderer/global_illumination/lpv/deprecated/probe_trace_compute_shader_code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"probe_trace_compute_shader_code.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/lpv/deprecated/probe_trace_compute_shader_code.js"],"names":[],"mappings":"AAyBA,sDAIG;AAoKH,4DAIG;6BAnM0B,sCAAsC;8BAiBrC,kCAAkC"}
+{"version":3,"file":"probe_trace_compute_shader_code.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/lpv/deprecated/probe_trace_compute_shader_code.js"],"names":[],"mappings":"AA2BA,sDAIG;AAwKH,4DAIG;6BAzM0B,sCAAsC;8BAiBrC,kCAAkC"}

package/src/shade/renderer/global_illumination/lpv/deprecated/probe_trace_compute_shader_code.js

@@ -22,6 +22,8 @@ import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderReso
 import { PROBE_RAYS_PER_WORKGROUP } from "../bake/PROBE_RAYS_PER_WORKGROUP.js";
 import { LIGHT_PROBE_STRUCT } from "../LIGHT_PROBE_STRUCT.js";
 import { LIGHT_PROBE_VOLUME_METADATA_STRUCT } from "../LIGHT_PROBE_VOLUME_METADATA_STRUCT.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";
 
 export const PROBE_BAKE_UNIFORMS_STRUCT = WebGPUStruct.from({
     direction: vec3f,
@@ -35,7 +37,8 @@ export const PROBE_BAKE_UNIFORMS_STRUCT = WebGPUStruct.from({
 // deprecated progressive bake produces radiance only.
 
 const resources = new ShaderResourceSetDescriptor();
-resources.createGroup({ label: 'LPV & scene' })
+// the scene's wind, which carries the fog volumes' noise: one uniform, one texture, one sampler
+wind_field_add_resources(resources.createGroup({ label: 'LPV & scene' })
     .addUniform("lpv_metadata", LIGHT_PROBE_VOLUME_METADATA_STRUCT)
     .addStorageBuffer('lpv_probes', WebGPUArray.from(LIGHT_PROBE_STRUCT), true)
     .addUniform('materials', INDIRECT_MATERIAL_ARRAY_TYPE)
@@ -43,6 +46,9 @@ resources.createGroup({ label: 'LPV & scene' })
     .addTexture('textures', 'unfilterable-float', '2d-array', false)
     .addUniform('bake_settings', PROBE_BAKE_UNIFORMS_STRUCT)
     .addTexture('tEnvironment', 'unfilterable-float')
+    // the fog volumes' noise, read through participating_media_volume_density_at
+    .addTexture("tParticipatingMediaNoise", "float", "3d")
+    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR));
 
 sr_create_group_RTX(resources);
 

package/src/shade/renderer/global_illumination/probe/octahedral/LPV_SHADER_RESOURCE_GROUP.d.ts

@@ -1,3 +1,42 @@
+/**
+ * The light probe volume's BVH over its tetrahedral mesh.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_LOOKUP_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The light probe volume's metadata.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_METADATA_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The light probe volume's tetrahedral mesh.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_MESH_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The light probes.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_PROBES_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The probes' octahedral depth atlas.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_ATLAS_DEPTH_RESOURCE: ShaderResourceDescriptor;
+/**
+ * The probes' octahedral radiance atlas, encoded.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_ATLAS_RADIANCE_RESOURCE: ShaderResourceDescriptor;
 export const LPV_SHADER_RESOURCE_GROUP: ShaderResourceGroupDescriptor;
+/**
+ * The same bindings, each with a default, for a shader that reads the light probe volume under one
+ * indirect lighting mode and is bound under all of them (SSR's resolve, froxel GI): a frame graph pass
+ * given no volume binds transient buffers and a volume of no probes in its place.
+ *
+ * @type {ShaderResourceGroupDescriptor}
+ */
+export const LPV_SHADER_RESOURCE_GROUP_WITH_DEFAULTS: ShaderResourceGroupDescriptor;
+import { ShaderResourceDescriptor } from "../../../shader/resource/ShaderResourceDescriptor.js";
 import { ShaderResourceGroupDescriptor } from "../../../shader/resource/ShaderResourceGroupDescriptor.js";
 //# sourceMappingURL=LPV_SHADER_RESOURCE_GROUP.d.ts.map

package/src/shade/renderer/global_illumination/probe/octahedral/LPV_SHADER_RESOURCE_GROUP.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LPV_SHADER_RESOURCE_GROUP.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/LPV_SHADER_RESOURCE_GROUP.js"],"names":[],"mappings":"AAOA,sEAA6E;8CAL/B,2DAA2D"}
+{"version":3,"file":"LPV_SHADER_RESOURCE_GROUP.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/LPV_SHADER_RESOURCE_GROUP.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH,kCAFU,wBAAwB,CAEkE;AAEpG;;;GAGG;AACH,oCAFU,wBAAwB,CAEwF;AAE1H;;;GAGG;AACH,gCAFU,wBAAwB,CAEkG;AAEpI;;;GAGG;AACH,kCAFU,wBAAwB,CAE4F;AAE9H;;;GAGG;AACH,uCAFU,wBAAwB,CAEmE;AAErG;;;GAGG;AACH,0CAFU,wBAAwB,CAEwE;AAE1G,sEAA6E;AAS7E;;;;;;GAMG;AACH,sDAFU,6BAA6B,CAEoD;yCA1DlD,sDAAsD;8CACjD,2DAA2D"}

package/src/shade/renderer/global_illumination/probe/octahedral/LPV_SHADER_RESOURCE_GROUP.js

@@ -1,15 +1,68 @@
 import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
 import { BVH_STRUCT } from "../../../shader/chunk/bvh/BVH_STRUCT.js";
+import { ShaderResourceDescriptor } from "../../../shader/resource/ShaderResourceDescriptor.js";
 import { ShaderResourceGroupDescriptor } from "../../../shader/resource/ShaderResourceGroupDescriptor.js";
 import { LIGHT_PROBE_STRUCT } from "../../lpv/LIGHT_PROBE_STRUCT.js";
 import { LIGHT_PROBE_VOLUME_METADATA_STRUCT } from "../../lpv/LIGHT_PROBE_VOLUME_METADATA_STRUCT.js";
 import { TETRAHEDRAL_MESH_CELL_STRUCT } from "../../lpv/TETRAHEDRAL_MESH_CELL_STRUCT.js";
 
+/**
+ * The light probe volume's BVH over its tetrahedral mesh.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_LOOKUP_RESOURCE = ShaderResourceDescriptor.storageBuffer("lpv_lookup", BVH_STRUCT);
+
+/**
+ * The light probe volume's metadata.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_METADATA_RESOURCE = ShaderResourceDescriptor.uniform("lpv_metadata", LIGHT_PROBE_VOLUME_METADATA_STRUCT);
+
+/**
+ * The light probe volume's tetrahedral mesh.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_MESH_RESOURCE = ShaderResourceDescriptor.storageBuffer("lpv_mesh", WebGPUArray.from(TETRAHEDRAL_MESH_CELL_STRUCT));
+
+/**
+ * The light probes.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_PROBES_RESOURCE = ShaderResourceDescriptor.storageBuffer("lpv_probes", WebGPUArray.from(LIGHT_PROBE_STRUCT));
+
+/**
+ * The probes' octahedral depth atlas.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_ATLAS_DEPTH_RESOURCE = ShaderResourceDescriptor.texture("lpv_atlas_depth", "float");
+
+/**
+ * The probes' octahedral radiance atlas, encoded.
+ * @type {ShaderResourceDescriptor}
+ */
+export const LPV_ATLAS_RADIANCE_RESOURCE = ShaderResourceDescriptor.texture("lpv_atlas_radiance", "uint");
+
 export const LPV_SHADER_RESOURCE_GROUP = new ShaderResourceGroupDescriptor();
 
 LPV_SHADER_RESOURCE_GROUP
-    .addStorageBuffer("lpv_lookup", BVH_STRUCT)
-    .addUniform("lpv_metadata", LIGHT_PROBE_VOLUME_METADATA_STRUCT)
-    .addStorageBuffer("lpv_mesh", WebGPUArray.from(TETRAHEDRAL_MESH_CELL_STRUCT))
-    .addStorageBuffer("lpv_probes", WebGPUArray.from(LIGHT_PROBE_STRUCT))
+    .add(LPV_LOOKUP_RESOURCE)
+    .add(LPV_METADATA_RESOURCE)
+    .add(LPV_MESH_RESOURCE)
+    .add(LPV_PROBES_RESOURCE)
+;
+
+/**
+ * The same bindings, each with a default, for a shader that reads the light probe volume under one
+ * indirect lighting mode and is bound under all of them (SSR's resolve, froxel GI): a frame graph pass
+ * given no volume binds transient buffers and a volume of no probes in its place.
+ *
+ * @type {ShaderResourceGroupDescriptor}
+ */
+export const LPV_SHADER_RESOURCE_GROUP_WITH_DEFAULTS = new ShaderResourceGroupDescriptor();
+
+LPV_SHADER_RESOURCE_GROUP_WITH_DEFAULTS
+    .addStorageBuffer("lpv_lookup", BVH_STRUCT, false, true)
+    .addUniform("lpv_metadata", LIGHT_PROBE_VOLUME_METADATA_STRUCT, { probe_count: 0, probe_resolution: 0 })
+    .addStorageBuffer("lpv_mesh", WebGPUArray.from(TETRAHEDRAL_MESH_CELL_STRUCT), false, true)
+    .addStorageBuffer("lpv_probes", WebGPUArray.from(LIGHT_PROBE_STRUCT), false, true)
 ;