@woosh/meep-engine 3.47.0 → 3.50.0

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_directional_cascades.js

@@ -0,0 +1,79 @@
+import { LIGHT_DATABASE_SPEC } from "../../../light/LIGHT_DATABASE_SPEC.js";
+import { INCIDENT_LIGHT_STRUCT } from "../../../shader/chunk/light/INCIDENT_LIGHT_STRUCT.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { chunk_sample_shadowmap_atlas_for_light } from "./chunk_sample_shadowmap_atlas_for_light.js";
+import { chunk_shadowmap_csm_compute_cascade_blended } from "./chunk_shadowmap_csm_compute_cascade_blended.js";
+
+const SHADOW_DIRECTIONAL_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_directional');
+const CASCADE_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_cascade');
+
+/**
+ * `shadowmap_sample_directional` under {@link ShadowDirectionalTechnique.Cascades}. The light's
+ * `shadow_directional` record names its cascades as a range of `shadow_cascade` rows (atlas +
+ * view-projection each), with CSM cascade blending: {@link shadowmap_csm_compute_cascade_blended} picks
+ * among them, and the one or two it picks are read again here to sample.
+ *
+ * A light whose record names no cascades — a frame where the renderer has just switched to virtual
+ * maps and not yet rebuilt them — finds no cascade and is lit.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_shadowmap_sample_directional_cascades = CodeChunk.from(
+    //language=WGSL
+    `
+fn shadowmap_sample_directional(
+    database: ptr<storage, array<u32>>,
+    shadow_id: u32,
+    position_ws: vec3f,
+    view_direction_ws: vec3f,
+    surface_normal_ws: vec3f,
+    light: ${INCIDENT_LIGHT_STRUCT.wgsl_ref},
+) -> f32 {
+    let shadowmap = ${SHADOW_DIRECTIONAL_DESCRIPTOR.marshalling_method_read}(database, shadow_id);
+
+    let cascade_info = shadowmap_csm_compute_cascade_blended(
+        database,
+        shadowmap.first_cascade,
+        shadowmap.cascade_count,
+        position_ws,
+        view_direction_ws,
+    );
+
+    if(cascade_info.index_0 == ~0u){
+        // not in the shadowmap, assume fully visible
+        return 1.0;
+    }
+
+    let cascade_meta_0 = ${CASCADE_DESCRIPTOR.marshalling_method_read}(database, cascade_info.index_0);
+
+    let visibility_0 = sample_shadowmap_atlas_for_light(
+        cascade_meta_0.projection,
+        position_ws,
+        surface_normal_ws,
+        light,
+        cascade_meta_0.atlas,
+    );
+
+    if(cascade_info.blend <= 0.0){
+        return visibility_0;
+    }
+
+    let cascade_meta_1 = ${CASCADE_DESCRIPTOR.marshalling_method_read}(database, cascade_info.index_1);
+
+    let visibility_1 = sample_shadowmap_atlas_for_light(
+        cascade_meta_1.projection,
+        position_ws,
+        surface_normal_ws,
+        light,
+        cascade_meta_1.atlas,
+    );
+
+    return mix(visibility_0, visibility_1, cascade_info.blend);
+}
+    `, [
+        SHADOW_DIRECTIONAL_DESCRIPTOR.chunk_read,
+        CASCADE_DESCRIPTOR.chunk_read,
+        chunk_sample_shadowmap_atlas_for_light,
+        chunk_shadowmap_csm_compute_cascade_blended,
+    ]
+);

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_shadowmap_sample_filtered.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,8CAFU,SAAS,CAmBlB;AAED;;;;GAIG;AACH,iDAFU,SAAS,CA0BlB;0BAtDyB,uCAAuC"}
+{"version":3,"file":"chunk_shadowmap_sample_filtered.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,8CAFU,SAAS,CAmBlB;AAKD;;;;GAIG;AACH,iDAFU,SAAS,CA0BlB;0BA1DyB,uCAAuC"}

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_filtered.js

@@ -1,5 +1,6 @@
 import { chunk_interpolate_bilinear_f32 } from "../../../shader/chunk/texture/sample/chunk_interpolate_bilinear_f32.js";
 import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { SHADOWMAP_ATLAS_RESOURCE, SHADOWMAP_COMPARE_SAMPLER_RESOURCE } from "../SHADOWMAP_RESOURCES.js";
 
 /**
  * see {@link SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR}
@@ -24,6 +25,9 @@ fn shadowmap_sample_filtered(
     `
 )
 
+chunk_shadowmap_sample_filtered.requireResource(SHADOWMAP_COMPARE_SAMPLER_RESOURCE);
+chunk_shadowmap_sample_filtered.requireResource(SHADOWMAP_ATLAS_RESOURCE);
+
 /**
  * WebGPU requires uniform flow for `textureSampleCompare`, which is a major limitation. `textureGatherCompare` does not have such limitation, so we use it instead.
  * see {@link SHADOWMAP_COMPARE_SAMPLER_DESCRIPTOR}
@@ -53,4 +57,7 @@ fn shadowmap_sample_filtered(
     `, [
         chunk_interpolate_bilinear_f32,
     ]
-)
+)
+
+chunk_shadowmap_sample_filtered_v2.requireResource(SHADOWMAP_COMPARE_SAMPLER_RESOURCE);
+chunk_shadowmap_sample_filtered_v2.requireResource(SHADOWMAP_ATLAS_RESOURCE);

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_shadowmap_sample_point2.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAFU,SAAS,CAqGjB;0BA/HwB,uCAAuC"}
+{"version":3,"file":"chunk_shadowmap_sample_point2.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAFU,SAAS,CAqGjB;0BAhIwB,uCAAuC"}

package/src/shade/renderer/shadow/map/shader/chunk_shadowmap_sample_point2.js

@@ -11,6 +11,7 @@ import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
 import { chunk_get_shadow_offsets } from "./chunk_get_shadow_offsets.js";
 import { chunk_contact_harden_pcf_kernel } from "./dpcf/chunk_contact_harden_pcf_kernel.js";
 import { chunk_max_penumbra_percentage } from "./dpcf/chunk_max_penumbra_percentage.js";
+import { SHADOWMAP_ATLAS_RESOURCE } from "../SHADOWMAP_RESOURCES.js";
 
 const SHADOW_POINT_DESCRIPTOR = LIGHT_DATABASE_SPEC.get('shadow_point');
 
@@ -135,3 +136,5 @@ fn shadowmap_sample_point(
         chunk_random_vec2,
     ]
 );
+
+chunk_shadowmap_sample_point2.requireResource(SHADOWMAP_ATLAS_RESOURCE);

package/src/shade/renderer/shadow/ray/shader_ray_shadow_code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_ray_shadow_code.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/ray/shader_ray_shadow_code.js"],"names":[],"mappings":"AA6KA,mDAII;8BA7J0B,+BAA+B"}
+{"version":3,"file":"shader_ray_shadow_code.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/ray/shader_ray_shadow_code.js"],"names":[],"mappings":"AA6KA,mDAII;8BA5J0B,+BAA+B"}

package/src/shade/renderer/shadow/ray/shader_ray_shadow_code.js

@@ -5,7 +5,8 @@ import { chunk_ray_shaded_query_occluded } from "../../path_tracer/shader/chunk_
 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_decode_g_buffer_normal } from "../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
-import { chunk_offset_ray } from "../../shader/chunk/geometry/ray/chunk_offset_ray.js";
+import { chunk_mat4_extract_position } from "../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
+import { chunk_offset_ray_from_depth } from "../../shader/chunk/geometry/ray/chunk_offset_ray_from_depth.js";
 import { RAY_STRUCT } from "../../shader/chunk/geometry/ray/RAY_STRUCT.js";
 import {
     chunk_directional_lights_iteration_mask
@@ -28,27 +29,25 @@ import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
+// A device offers four bind groups (`maxBindGroups`), and the RTX group takes one.
 sr_create_group_RTX(resources);
 
-resources.createGroup()
-    .addStorageBuffer("light_data", WebGPUArray.u32);
-
-resources.createGroup()
-    .addStorageTexture("i_Output", "r32uint");
-
-// Material-aware shadow attenuation: ray_shaded_query_occluded reads the
+// Lights, and the materials their shadow rays meet: ray_shaded_query_occluded reads the
 // resident-material atlas (same one the path tracer uses) so glass occluders
 // get the view-Fresnel mix instead of being treated as fully opaque.
 resources.createGroup()
+    .addStorageBuffer("light_data", WebGPUArray.u32)
     .addUniform("materials", INDIRECT_MATERIAL_ARRAY_TYPE)
-    .addTexture("textures", "unfilterable-float", "2d-array")
+    .addTexture("textures", "unfilterable-float", "2d-array");
 
+// The view: what the pass reads of it, and what it writes for it.
 resources.createGroup()
     .addTexture("texture_depth")
     .addTexture("texture_normal", "uint")
     .addTexture("texture_noise", "uint", "2d", false, HILBERT_R2_INDEX_TEXTURE)
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-    .addUniform("view", VIEW_UNIFORM_STRUCT);
+    .addUniform("view", VIEW_UNIFORM_STRUCT)
+    .addStorageTexture("i_Output", "r32uint");
 
 /**
  * @see https://www.shadertoy.com/view/3tycWd for contact shadows (screen space shadow trace)
@@ -111,7 +110,7 @@ fn main(
     
             let jitter = spatio_temporal_noise_r2_64(pixel_position, view.frame_index, texture_noise);
 
-            var ray_origin = offset_ray(position_ws, geometric_normal);
+            var ray_origin = offset_ray_from_depth(position_ws, geometric_normal, mat4_extract_position(camera.transform));
 
             // Pick the first occupied directional light from the
             // iteration mask (max 32 directionals enforced by
@@ -162,7 +161,8 @@ fn main(
         chunk_directional_lights_iteration_mask,
         chunk_sample_directional_light_record,
         chunk_spatio_temporal_noise_r2_64,
-        chunk_offset_ray,
+        chunk_mat4_extract_position,
+        chunk_offset_ray_from_depth,
         chunk_texel_coordinate_to_uv,
         chunk_project_position_from_depth,
         chunk_is_background,

package/src/shade/renderer/shadow/ray/shader_screens_space_shadows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_screens_space_shadows.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/ray/shader_screens_space_shadows.js"],"names":[],"mappings":"AA6LA,uDAWG;4BAtKyB,6BAA6B"}
+{"version":3,"file":"shader_screens_space_shadows.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/ray/shader_screens_space_shadows.js"],"names":[],"mappings":"AAgMA,uDAWG;4BAzKyB,6BAA6B"}

package/src/shade/renderer/shadow/ray/shader_screens_space_shadows.js

@@ -36,6 +36,7 @@ import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { SCREEN_HZB_RESOURCE } from "../../shader/chunk/screen_space/SCREEN_SPACE_RESOURCES.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
@@ -48,6 +49,8 @@ resources.createGroup()
     .addTexture("tNormal", "uint")
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
     .addUniform("view", VIEW_UNIFORM_STRUCT)
+    // what chunk_ffx_sssr_load_depth reads above mip 0
+    .add(SCREEN_HZB_RESOURCE)
 ;
 
 const body = CodeChunk.from(

package/src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_generate_rays.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js"],"names":[],"mappings":"AA0BA,0CAEG;AAEH;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAiHvC,iDAIE;6BArJ2B,yCAAyC;8BAmBxC,qCAAqC"}
+{"version":3,"file":"shader_generate_rays.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js"],"names":[],"mappings":"AA2BA,0CAEG;AAEH;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAkHvC,iDAIE;6BAvJ2B,yCAAyC;8BAoBxC,qCAAqC"}

package/src/shade/renderer/shadow/ray/staged/gen/shader_generate_rays.js

@@ -1,152 +1,154 @@
-import { atomic_u32, u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
-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_decode_g_buffer_normal } from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
-import { chunk_offset_ray } from "../../../../shader/chunk/geometry/ray/chunk_offset_ray.js";
-import { RAY_STRUCT } from "../../../../shader/chunk/geometry/ray/RAY_STRUCT.js";
-import { chunk_grid2d_to_index } from "../../../../shader/chunk/grid/chunk_grid2d_to_index.js";
-import {
-    chunk_directional_lights_iteration_mask
-} from "../../../../shader/chunk/light/io/chunk_directional_lights_iteration_mask.js";
-import {
-    chunk_sample_directional_light_record
-} from "../../../../shader/chunk/light/sample/chunk_sample_directional_light_record.js";
-import { chunk_spatio_temporal_noise_r2_64 } from "../../../../shader/chunk/noise/chunk_spatio_temporal_noise_r2_64.js";
-import { chunk_texel_coordinate_to_uv } from "../../../../shader/chunk/texture/chunk_texel_coordinate_to_uv.js";
-import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
-import { HILBERT_R2_INDEX_TEXTURE } from "../../../../texture/noise/HILBERT_R2_INDEX_TEXTURE.js";
-import { chunk_pack_ray } from "../chunk_pack_ray.js";
-
-export const PUSH_CONSTANTS = WebGPUStruct.from({
-    frame_index: u32
-});
-
-/**
- * How many f32's make up a single packed ray
- * @type {number}
- */
-export const PACKED_RAY_WORD_COUNT = 8;
-
-const STRUCT_OUTPUT = WebGPUStruct.from({
-    count: atomic_u32,
-    // rays are packed
-    rays: WebGPUArray.vec4f,
-});
-
-const resources = new ShaderResourceSetDescriptor();
-
-// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the struct was
-// already named PUSH_CONSTANTS. camera stays bound.
-resources.setImmediate("settings", PUSH_CONSTANTS);
-
-resources.createGroup()
-    .addStorageBuffer("light_data", WebGPUArray.u32);
-
-resources.createGroup()
-    .addTexture("texture_depth")
-    .addTexture("texture_normal", "uint")
-    .addTexture("texture_noise", "uint", "2d", false, HILBERT_R2_INDEX_TEXTURE)
-    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
-
-resources.createGroup()
-    .addStorageBuffer("output", STRUCT_OUTPUT, true);
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(8,4,1)
-fn main(
-    @builtin(global_invocation_id) global_invocation_id: vec3<u32>,
-){
-    let pixel_position = global_invocation_id.xy;
-    let texture_size = textureDimensions(texture_depth);
-  
-    if(any(pixel_position >= texture_size)){
-        // outside of the viewport
-        return;
-    }
-        
-    let texel_depth = textureLoad(
-        texture_depth,
-        pixel_position,
-        0
-    ).r;
-        
-    if(is_background(texel_depth)){
-        return;
-    }
-    
-    let uv = texel_coordinate_to_uv( vec2<f32>(pixel_position), texture_size);
-            
-    let position_ws = project_position_from_depth(
-        uv,
-        texel_depth,
-        camera.view_projection_matrix_inverse 
-    );
-    
-    let g_buffer_sample_normal = textureLoad( texture_normal,
-        pixel_position,
-        0
-    );
-    
-    let geometric_normal = decode_g_buffer_normal( g_buffer_sample_normal.zw );
-    let shading_normal = decode_g_buffer_normal( g_buffer_sample_normal.xy );
-                
-    let jitter = spatio_temporal_noise_r2_64(pixel_position, settings.frame_index, texture_noise);
-
-    var ray_origin = offset_ray(position_ws, geometric_normal);
-
-    // Pick the first occupied directional light from the iteration
-    // mask (max 32 directionals enforced by GPULightCollection). One
-    // ray per pixel; multi-directional shadowing would multiply ray
-    // budget and require the trace pass to scale accordingly.
-    let directional_bits = directional_lights_iteration_mask(&light_data);
-    if (directional_bits == 0u) {
-        return;
-    }
-    let directional_index = countTrailingZeros(directional_bits);
-    let light_record = sample_directional_light_record(&light_data, directional_index, ray_origin, jitter);
-    
-    var _ray: ${RAY_STRUCT.wgsl_ref};
-    
-    _ray.origin = ray_origin;
-    _ray.direction = light_record.direction;
-    _ray.tmax = light_record.distance;
-    
-    if(dot(_ray.direction, shading_normal) <= 0){
-        // ray points backways
-        return;
-    }
-    
-    let texel_index = grid2d_to_index(pixel_position, texture_size.x);
-    
-    let output_index = atomicAdd(&output.count, 1);
-    
-    pack_ray(&output.rays, output_index, _ray, texel_index);
-}
-    `, [
-        chunk_decode_g_buffer_normal,
-        chunk_directional_lights_iteration_mask,
-        chunk_sample_directional_light_record,
-        chunk_spatio_temporal_noise_r2_64,
-        chunk_offset_ray,
-        chunk_texel_coordinate_to_uv,
-        chunk_project_position_from_depth,
-        chunk_is_background,
-        chunk_pack_ray,
-        chunk_grid2d_to_index,
-    ]
-);
-
-export const shader_generate_rays = ComputeShader.from({
-    label: "Generate Shadow Rays",
-    body,
-    resources,
+import { atomic_u32, u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
+import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
+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_decode_g_buffer_normal } from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
+import { chunk_mat4_extract_position } from "../../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
+import { chunk_offset_ray_from_depth } from "../../../../shader/chunk/geometry/ray/chunk_offset_ray_from_depth.js";
+import { RAY_STRUCT } from "../../../../shader/chunk/geometry/ray/RAY_STRUCT.js";
+import { chunk_grid2d_to_index } from "../../../../shader/chunk/grid/chunk_grid2d_to_index.js";
+import {
+    chunk_directional_lights_iteration_mask
+} from "../../../../shader/chunk/light/io/chunk_directional_lights_iteration_mask.js";
+import {
+    chunk_sample_directional_light_record
+} from "../../../../shader/chunk/light/sample/chunk_sample_directional_light_record.js";
+import { chunk_spatio_temporal_noise_r2_64 } from "../../../../shader/chunk/noise/chunk_spatio_temporal_noise_r2_64.js";
+import { chunk_texel_coordinate_to_uv } from "../../../../shader/chunk/texture/chunk_texel_coordinate_to_uv.js";
+import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
+import { HILBERT_R2_INDEX_TEXTURE } from "../../../../texture/noise/HILBERT_R2_INDEX_TEXTURE.js";
+import { chunk_pack_ray } from "../chunk_pack_ray.js";
+
+export const PUSH_CONSTANTS = WebGPUStruct.from({
+    frame_index: u32
+});
+
+/**
+ * How many f32's make up a single packed ray
+ * @type {number}
+ */
+export const PACKED_RAY_WORD_COUNT = 8;
+
+const STRUCT_OUTPUT = WebGPUStruct.from({
+    count: atomic_u32,
+    // rays are packed
+    rays: WebGPUArray.vec4f,
+});
+
+const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the struct was
+// already named PUSH_CONSTANTS. camera stays bound.
+resources.setImmediate("settings", PUSH_CONSTANTS);
+
+resources.createGroup()
+    .addStorageBuffer("light_data", WebGPUArray.u32);
+
+resources.createGroup()
+    .addTexture("texture_depth")
+    .addTexture("texture_normal", "uint")
+    .addTexture("texture_noise", "uint", "2d", false, HILBERT_R2_INDEX_TEXTURE)
+    .addUniform("camera", CAMERA_UNIFORM_STRUCT)
+
+resources.createGroup()
+    .addStorageBuffer("output", STRUCT_OUTPUT, true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(8,4,1)
+fn main(
+    @builtin(global_invocation_id) global_invocation_id: vec3<u32>,
+){
+    let pixel_position = global_invocation_id.xy;
+    let texture_size = textureDimensions(texture_depth);
+  
+    if(any(pixel_position >= texture_size)){
+        // outside of the viewport
+        return;
+    }
+        
+    let texel_depth = textureLoad(
+        texture_depth,
+        pixel_position,
+        0
+    ).r;
+        
+    if(is_background(texel_depth)){
+        return;
+    }
+    
+    let uv = texel_coordinate_to_uv( vec2<f32>(pixel_position), texture_size);
+            
+    let position_ws = project_position_from_depth(
+        uv,
+        texel_depth,
+        camera.view_projection_matrix_inverse 
+    );
+    
+    let g_buffer_sample_normal = textureLoad( texture_normal,
+        pixel_position,
+        0
+    );
+    
+    let geometric_normal = decode_g_buffer_normal( g_buffer_sample_normal.zw );
+    let shading_normal = decode_g_buffer_normal( g_buffer_sample_normal.xy );
+                
+    let jitter = spatio_temporal_noise_r2_64(pixel_position, settings.frame_index, texture_noise);
+
+    var ray_origin = offset_ray_from_depth(position_ws, geometric_normal, mat4_extract_position(camera.transform));
+
+    // Pick the first occupied directional light from the iteration
+    // mask (max 32 directionals enforced by GPULightCollection). One
+    // ray per pixel; multi-directional shadowing would multiply ray
+    // budget and require the trace pass to scale accordingly.
+    let directional_bits = directional_lights_iteration_mask(&light_data);
+    if (directional_bits == 0u) {
+        return;
+    }
+    let directional_index = countTrailingZeros(directional_bits);
+    let light_record = sample_directional_light_record(&light_data, directional_index, ray_origin, jitter);
+    
+    var _ray: ${RAY_STRUCT.wgsl_ref};
+    
+    _ray.origin = ray_origin;
+    _ray.direction = light_record.direction;
+    _ray.tmax = light_record.distance;
+    
+    if(dot(_ray.direction, shading_normal) <= 0){
+        // ray points backways
+        return;
+    }
+    
+    let texel_index = grid2d_to_index(pixel_position, texture_size.x);
+    
+    let output_index = atomicAdd(&output.count, 1);
+    
+    pack_ray(&output.rays, output_index, _ray, texel_index);
+}
+    `, [
+        chunk_decode_g_buffer_normal,
+        chunk_directional_lights_iteration_mask,
+        chunk_sample_directional_light_record,
+        chunk_spatio_temporal_noise_r2_64,
+        chunk_mat4_extract_position,
+        chunk_offset_ray_from_depth,
+        chunk_texel_coordinate_to_uv,
+        chunk_project_position_from_depth,
+        chunk_is_background,
+        chunk_pack_ray,
+        chunk_grid2d_to_index,
+    ]
+);
+
+export const shader_generate_rays = ComputeShader.from({
+    label: "Generate Shadow Rays",
+    body,
+    resources,
 })

package/src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_geometry_sdf_query_distance.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.js"],"names":[],"mappings":"AAaA,0DAmCO;AAGP;;;;GAIG;AACH,gDAFU,SAAS,CAkBjB;0BA9DwB,oCAAoC"}
+{"version":3,"file":"chunk_geometry_sdf_query_distance.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.js"],"names":[],"mappings":"AAaA,0DAmCO;AAGP;;;;GAIG;AACH,gDAFU,SAAS,CAkBjB;0BA/DwB,oCAAoC"}

package/src/shade/renderer/shadow/sdf/chunk_geometry_sdf_query_distance.js

@@ -1,4 +1,3 @@
-import { chunk_sdf_slot_index_to_texture_offset } from "../../geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js";
 import { chunk_aabb3_distance_to_ray_v2 } from "../../shader/chunk/geometry/aabb3/chunk_aabb3_distance_to_ray_v2.js";
 import {
     chunk_aabb3_nearest_point_on_surface
@@ -9,6 +8,7 @@ import {
     chunk_sdf_texture_region_sample_linear_uv
 } from "../../shader/chunk/sdf/chunk_sdf_texture_region_sample_linear_uv.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { chunk_tile_atlas_slot_origin } from "../../texture/atlas/chunk_tile_atlas_slot_origin.js";
 
 
 export const chunk_geometry_sdf_query_distance = CodeChunk.from(
@@ -34,14 +34,14 @@ fn geometry_sdf_query_distance( geometry_id:u32, position_local: vec3<f32>) -> f
         
         sdf_uv = clamped;
         
-        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 geometry_distance + sign_not_zero(geometry_distance) * length(geometry_bounds_span * uv_distance_to_box);
 }
 `, [
         chunk_array_to_aabb3,
-        chunk_sdf_slot_index_to_texture_offset,
+        chunk_tile_atlas_slot_origin,
         chunk_sdf_texture_region_sample_linear_uv,
         chunk_aabb3_nearest_point_on_surface,
         chunk_aabb3_distance_to_ray_v2,

package/src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_sdf_geometry_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.js"],"names":[],"mappings":"AAYA,oDAwEE;0BA1EwB,oCAAoC"}
+{"version":3,"file":"chunk_sdf_geometry_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.js"],"names":[],"mappings":"AAYA,oDAwEE;0BA3EwB,oCAAoC"}

package/src/shade/renderer/shadow/sdf/chunk_sdf_geometry_raymarch.js

@@ -1,4 +1,3 @@
-import { chunk_sdf_slot_index_to_texture_offset } from "../../geometry/sdf/chunk_sdf_slot_index_to_texture_offset.js";
 import { chunk_array_to_aabb3 } from "../../shader/chunk/geometry/aabb3/chunk_array_to_aabb3.js";
 import { chunk_mat4_compose_transform } from "../../shader/chunk/geometry/mat4/chunk_mat4_compose_transform.js";
 import { MAT4_IDENTITY_DEFINITION } from "../../shader/chunk/geometry/mat4/MAT4_IDENTITY_DEFINITION.js";
@@ -9,6 +8,7 @@ import { chunk_min_v3 } from "../../shader/chunk/geometry/vec3/chunk_min_v3.js";
 import { chunk_v3_matrix4_project } from "../../shader/chunk/geometry/vec3/chunk_v3_matrix4_project.js";
 import { chunk_sdf_texture_raycast } from "../../shader/chunk/sdf/chunk_sdf_texture_raycast.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { chunk_tile_atlas_slot_origin } from "../../texture/atlas/chunk_tile_atlas_slot_origin.js";
 
 export const chunk_sdf_geometry_raymarch = CodeChunk.from(
     //language=WGSL
@@ -27,7 +27,7 @@ fn sdf_geometry_raymarch(ray:${RAY_STRUCT.wgsl_ref}, geometry_index: u32) -> vec
     
     var sdf_ray = ray_transform_m4(ray, sdf_transform_inverse);
     
-    let offset = sdf_slot_index_to_texture_offset(geometry_index, settings.sdf_atlas_resolution) * settings.sdf_tile_resolution;
+    let offset = tile_atlas_slot_origin(geometry_index, settings.sdf_atlas_resolution.xy, vec3(settings.sdf_tile_resolution));
         
     const tolerance = 0.001;
         
@@ -74,7 +74,7 @@ fn sdf_geometry_raymarch(ray:${RAY_STRUCT.wgsl_ref}, geometry_index: u32) -> vec
         MAT4_IDENTITY_DEFINITION,
         RAY_HIT_INFO.declaration_chunk,
         RAY_STRUCT.declaration_chunk,
-        chunk_sdf_slot_index_to_texture_offset,
+        chunk_tile_atlas_slot_origin,
         chunk_sdf_texture_raycast,
         chunk_mat4_compose_transform,
         chunk_array_to_aabb3,

package/src/shade/renderer/shadow/vsm/VSMPageManager.d.ts

@@ -12,7 +12,8 @@
  * world units on a side, anchored to the world in light space. Each level keeps a window of
  * `pages_per_level²` pages around the camera ({@link update_windows}), and a page of the window sits
  * in cell `(x mod N, y mod N)` of the level — so a window that scrolls keeps every page still inside
- * it where it was, and gives back only the pages it left behind.
+ * it where it was, and gives back only the pages it left behind. The windows are a 2-D
+ * {@link ClipmapWindowSet}, and what a scroll leaves behind is {@link window_scroll_regions}'.
  *
  * **The pool** is a {@link VTPhysicalSlots}: VT's slot grid, least-recently-touched eviction outside
  * a protection window, and the finest page shed first on a tie.
@@ -138,7 +139,8 @@ export class VSMPageManager {
      */
     page_world_size(level: number): number;
     /**
-     * The page-table row, from the map's first, of a world page's cell.
+     * The page-table row, from the map's first, of a world page's cell: the window set's
+     * {@link ClipmapWindowSet#storage_cell}, with the window's power-of-two side taken as a mask.
      *
      * @param {number} level
      * @param {number} x world page
@@ -160,7 +162,7 @@ export class VSMPageManager {
      * @param {number} level
      * @param {number} x
      * @param {number} y
-     * @returns {boolean}
+     * @returns {boolean} whether the level's window is placed and holds the world page
      */
     window_contains(level: number, x: number, y: number): boolean;
     /**