@woosh/meep-engine 3.12.0 → 3.13.0

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

@@ -1,113 +1,115 @@
-import { u32, vec3f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { CLIPMAP_METADATA } from "./CLIPMAP_METADATA.js";
-
-const PUSH_CONSTANTS = WebGPUStruct.from({
-    cascade_index: u32,
-    position: vec3f
-});
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addUniform("settings", PUSH_CONSTANTS)
-    .addStorageBuffer("metadata", CLIPMAP_METADATA, true)
-    .addStorageTexture("t_cascades", "r32uint", "3d", "write-only")
-;
-
-/**
- * Converts world-aligned voxel coordinate to local wrapped voxel coordinate in the 3d texture representing the cascade
- * @type {CodeChunk}
- */
-const chunk_clip_cascade_world_to_voxel = CodeChunk.from(
-    //language=WGSL
-    `
-fn cascade_voxel_wrap(
-    coord_ws: vec3<f32>,
-    world_offset : vec3<i32>,
-    voxel_size: f32,
-    resolution: u32,
-) -> vec3<u32>{
-    let coord_voxel = world_offset + coord_ws / voxel_size;
-    
-    let offset = coord_voxel + f32(resolution) * 0.5;
-    let offset_i = i32(offset);
-    
-    let wrapped_offset = ( ( offset % resolution ) + resolution ) % resolution;
-    
-    return vec3<u32>(wrapped_offset);
-}
-    `, []
-);
-
-/**
- *
- * @type {CodeChunk}
- */
-const chunk_clip_cascade_voxel_to_world = CodeChunk.from(
-//language=WGSL
-    `
-fn clip_cascade_voxel_to_world(
-    voxel_coord: vec3<u32>,
-    world_offset: vec3<i32>,
-    voxel_size: f32,
-    resolution: u32,
-) -> vec3<f32>{
-    let x = world_offset + voxel_coord - f32(resolution)*0.5;
-    
-    return x * voxel_size;
-}
-    `
-);
-
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(8,8,4)
-fn main(
-    @builtin(global_invocation_id) global_id : vec3<u32>,
-){
-    if(any(global_id >= vec3(metadata.cascade_resolution))){
-        return;
-    }
-    
-    let cascade_info = metadata.cascades[settings.cascade_index];
-    
-    // discretize position
-    let discrete_position = vec3<i32>(settings.position / cascade_info.voxel_size);
-    
-    // difference 
-    let position_delta = discrete_position - cascade_info.offset;
-    
-    let cascade_voxel_coord = global_id + discrete_position - center;
-    
-    let cascade_texture_offset = vec3<u32>( 0, 0, settings.cascade_index * metadata.cascade_resolution );
-    
-    // TODO implement
-    let voxel_cleared = false;
-    if(voxel_cleared){
-        textureStore(
-            t_cascades,
-            cascade_texture_offset + cascade_voxel_coord,
-            vec4(0)
-        );
-    }
-    
-    // set new offset
-    metadata.cascades[settings.cascade_index].offset = discrete_position;
-}
-    `
-)
-
-/**
- * Update cascade offset, and clear out any voxels that scroll out
- * @type {ComputeShader}
- */
-export const shader_update_clipmap_cascade = ComputeShader.from({
-    label: "Clipmap / update",
-    resources,
-    body
+import { u32, vec3f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
+import { CLIPMAP_METADATA } from "./CLIPMAP_METADATA.js";
+
+const PUSH_CONSTANTS = WebGPUStruct.from({
+    cascade_index: u32,
+    position: vec3f
+});
+
+const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, 32 bytes, read-only: immediate data rather than a uniform buffer
+resources.setImmediate("settings", PUSH_CONSTANTS);
+resources.createGroup()
+    .addStorageBuffer("metadata", CLIPMAP_METADATA, true)
+    .addStorageTexture("t_cascades", "r32uint", "3d", "write-only")
+;
+
+/**
+ * Converts world-aligned voxel coordinate to local wrapped voxel coordinate in the 3d texture representing the cascade
+ * @type {CodeChunk}
+ */
+const chunk_clip_cascade_world_to_voxel = CodeChunk.from(
+    //language=WGSL
+    `
+fn cascade_voxel_wrap(
+    coord_ws: vec3<f32>,
+    world_offset : vec3<i32>,
+    voxel_size: f32,
+    resolution: u32,
+) -> vec3<u32>{
+    let coord_voxel = world_offset + coord_ws / voxel_size;
+    
+    let offset = coord_voxel + f32(resolution) * 0.5;
+    let offset_i = i32(offset);
+    
+    let wrapped_offset = ( ( offset % resolution ) + resolution ) % resolution;
+    
+    return vec3<u32>(wrapped_offset);
+}
+    `, []
+);
+
+/**
+ *
+ * @type {CodeChunk}
+ */
+const chunk_clip_cascade_voxel_to_world = CodeChunk.from(
+//language=WGSL
+    `
+fn clip_cascade_voxel_to_world(
+    voxel_coord: vec3<u32>,
+    world_offset: vec3<i32>,
+    voxel_size: f32,
+    resolution: u32,
+) -> vec3<f32>{
+    let x = world_offset + voxel_coord - f32(resolution)*0.5;
+    
+    return x * voxel_size;
+}
+    `
+);
+
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(8,8,4)
+fn main(
+    @builtin(global_invocation_id) global_id : vec3<u32>,
+){
+    if(any(global_id >= vec3(metadata.cascade_resolution))){
+        return;
+    }
+    
+    let cascade_info = metadata.cascades[settings.cascade_index];
+    
+    // discretize position
+    let discrete_position = vec3<i32>(settings.position / cascade_info.voxel_size);
+    
+    // difference 
+    let position_delta = discrete_position - cascade_info.offset;
+    
+    let cascade_voxel_coord = global_id + discrete_position - center;
+    
+    let cascade_texture_offset = vec3<u32>( 0, 0, settings.cascade_index * metadata.cascade_resolution );
+    
+    // TODO implement
+    let voxel_cleared = false;
+    if(voxel_cleared){
+        textureStore(
+            t_cascades,
+            cascade_texture_offset + cascade_voxel_coord,
+            vec4(0)
+        );
+    }
+    
+    // set new offset
+    metadata.cascades[settings.cascade_index].offset = discrete_position;
+}
+    `
+)
+
+/**
+ * Update cascade offset, and clear out any voxels that scroll out
+ * @type {ComputeShader}
+ */
+export const shader_update_clipmap_cascade = ComputeShader.from({
+    label: "Clipmap / update",
+    resources,
+    body
 });

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

@@ -1 +1 @@
-{"version":3,"file":"graph_lpv_store_sh.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lpv_store_sh.js"],"names":[],"mappings":"AAmFA;;;;;;;;GAQG;AACH,kIA+BC"}
+{"version":3,"file":"graph_lpv_store_sh.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lpv_store_sh.js"],"names":[],"mappings":"AAsFA;;;;;;;;GAQG;AACH,kIA+BC"}

package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lpv_store_sh.js

@@ -19,8 +19,11 @@ const PUSH_CONSTANTS = WebGPUStruct.from({
 })
 
 const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, 16 bytes, read-only: immediate data rather than a uniform buffer — the struct was
+// already named PUSH_CONSTANTS
+resources.setImmediate("settings", PUSH_CONSTANTS);
 resources.createGroup()
-    .addUniform("settings", PUSH_CONSTANTS)
     .addStorageBuffer("coefficients", WebGPUArray.f32, false)
     .addStorageBuffer("lpv_probes", WebGPUArray.from(LIGHT_PROBE_STRUCT), true)
 ;

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

@@ -1 +1 @@
-{"version":3,"file":"graph_lvp_atlas_to_sh.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.js"],"names":[],"mappings":"AAkHA;;;;;;;;;GASG;AACH,0IAFa,MAAM,CA8DlB"}
+{"version":3,"file":"graph_lvp_atlas_to_sh.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.js"],"names":[],"mappings":"AAqHA;;;;;;;;;GASG;AACH,0IAFa,MAAM,CA8DlB"}

package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_lvp_atlas_to_sh.js

@@ -1,185 +1,188 @@
-import { BufferResourceDescriptor } from "../../../../../device/graph/BufferResourceDescriptor.js";
-import { u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
-import {
-    chunk_octahedral_solid_angle
-} from "../../../../shader/chunk/geometry/octahedron/chunk_octahedral_solid_angle.js";
-import {
-    chunk_uv_octahedral_unit_decode
-} from "../../../../shader/chunk/geometry/octahedron/chunk_uv_octahedral_unit_decode.js";
-import { chunk_grid2d_to_index } from "../../../../shader/chunk/grid/chunk_grid2d_to_index.js";
-import { PI_DECLARATION } from "../../../../shader/chunk/math/PI_DECLARATION.js";
-import { chunk_sh2_basis_at } from "../../../../shader/chunk/spherical_harmonics/chunk_sh2_basis_at.js";
-import { chunk_sh2_multiply_scalar } from "../../../../shader/chunk/spherical_harmonics/chunk_sh2_multiply_scalar.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 { chunk_lpv_atlas_read_patch_texel } from "../sample/chunk_lpv_atlas_read_patch_texel.js";
-import { chunk_compute_coefficient_address } from "./chunk_compute_coefficient_address.js";
-
-const PUSH_CONSTANTS = WebGPUStruct.from({
-    probe_index_offset: u32,
-    probe_update_count: u32,
-    probe_resolution: u32,
-    probe_count: u32,
-    probes_per_row: u32, // in g-buffer space
-})
-
-const resources = new ShaderResourceSetDescriptor();
-resources.createGroup()
-    .addUniform("settings", PUSH_CONSTANTS)
-
-resources.createGroup()
-    .addStorageBuffer("coefficients", WebGPUArray.f32, true)
-    .addTexture("tAtlas_radiance", "uint");
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-@compute @workgroup_size(16,16,1)
-fn main(
-    @builtin(global_invocation_id) global_id : vec3<u32>,
-){
-   
-    let g_buffer_texel = global_id.xy;
-    
-    let probe_resolution = settings.probe_resolution;
-    
-    let probe_texel = g_buffer_texel % probe_resolution;
-
-    let g_buffer_probe_index = grid2d_to_index(g_buffer_texel / probe_resolution, settings.probes_per_row);
-    
-    if(g_buffer_probe_index >= settings.probe_update_count){
-        // out of bounds
-        return;
-    }
-    
-    let global_probe_index = (g_buffer_probe_index + settings.probe_index_offset) % settings.probe_count;
-    
-    let radiance = lpv_atlas_read_patch_texel(global_probe_index, probe_texel + 1, tAtlas_radiance, probe_resolution + 2);
-    
-    let probe_texel_uv = texel_coordinate_to_uv(vec2<f32>(probe_texel), vec2(probe_resolution));
-    
-    let direction = uv_octahedral_unit_decode(probe_texel_uv);
-        
-    let sh3_basis = sh2_basis_at(direction);
-    
-    let local_texel_index = grid2d_to_index(probe_texel, probe_resolution);
-    
-    let coefficients_address = compute_coefficient_address(g_buffer_probe_index, probe_texel);
-    
-    // adjust by solid angle
-    let solid_angle = octahedral_solid_angle(probe_texel_uv, 1.0 / f32(probe_resolution));
-    
-    let sh_coefficients = sh2_multiply_scalar(sh3_basis, solid_angle);
-    
-    // NOTE: we do not convolve with cosine kernel here, this is done during sampling.
-    // what is stored is radiance projected to SH
-    
-    // store coefficients for this texel.
-    // NOTE: no accumulation here, done in a separate pass.
-    for(var i=0u; i< 4; i++){
-        let coefficient = sh_coefficients[i];
-      
-        let convolved = radiance * coefficient;
-      
-        let offset = coefficients_address + i * 3;
-        
-        coefficients[ offset ] = convolved.r;
-        coefficients[ offset + 1 ] = convolved.g;
-        coefficients[ offset + 2 ] = convolved.b;
-    }
-        
-}
-    `, [
-        chunk_sh2_basis_at,
-        chunk_grid2d_to_index,
-        chunk_uv_octahedral_unit_decode,
-        chunk_texel_coordinate_to_uv,
-        chunk_lpv_atlas_read_patch_texel,
-        chunk_compute_coefficient_address,
-        chunk_octahedral_solid_angle,
-        chunk_sh2_multiply_scalar,
-        PI_DECLARATION,
-    ]
-);
-
-const shader = ComputeShader.from({
-    label: "Radiance Atlas / convert to SH",
-    body,
-    resources,
-});
-
-/**
- * Convolve part of the atlas to Spherical Harmonics
- * @param {FrameGraph} graph
- * @param {GPUProbeAtlas} atlas
- * @param {GPUSceneContext} scene
- * @param {number} probe_index_offset
- * @param {number} probe_update_count
- * @param {number[]} g_buffer_resolution In texels
- * @returns {number} buffer resource with SH3-encoded texels
- */
-export function graph_lvp_atlas_to_sh({
-                                          graph,
-                                          atlas,
-                                          scene,
-                                          probe_index_offset,
-                                          probe_update_count,
-                                          g_buffer_resolution,
-                                      }) {
-
-    // first convert rasterized probes to SH
-    const probe_resolution = atlas.probe_resolution;
-
-    /**
-     *
-     * @param data
-     * @param {FramePassResources} resources
-     * @param {GraphicsExecutionContext} context
-     */
-    function execute(data, resources, context) {
-        /**
-         *
-         * @type {GPUBuffer}
-         */
-        const output = resources.get(data.output);
-
-        const settings = context.encoder.allocateTransientValueBuffer(PUSH_CONSTANTS, {
-            probe_index_offset,
-            probe_update_count,
-            probe_resolution: probe_resolution,
-            probe_count: scene.light_probe_volume.source.probe_count,
-            probes_per_row: Math.round(g_buffer_resolution[0] / probe_resolution)
-        });
-
-        shader.dispatchThreads({
-            encoder: context.encoder,
-            bindings: {
-                settings,
-                coefficients: output,
-                tAtlas_radiance: atlas.texture_radiance.obtainView(),
-            },
-            thread_count_x: g_buffer_resolution[0],
-            thread_count_y: g_buffer_resolution[1],
-        });
-    }
-
-    const pass_data = {};
-
-    const pass = graph.add("Atlas to SH", pass_data, execute);
-
-    const probe_texel_count = probe_resolution * probe_resolution;
-    const total_updated_texel_count = probe_texel_count * probe_update_count;
-    const buffer_spec = BufferResourceDescriptor.from(
-        12 * total_updated_texel_count * Float32Array.BYTES_PER_ELEMENT,
-        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC
-    );
-    const r_sh_buffer = pass.create("sh", buffer_spec);
-
-    pass_data.output = r_sh_buffer;
-
-    return r_sh_buffer;
+import { BufferResourceDescriptor } from "../../../../../device/graph/BufferResourceDescriptor.js";
+import { u32 } from "../../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { WebGPUArray } from "../../../../shader/type/WebGPUArray.js";
+import { WebGPUStruct } from "../../../../shader/type/WebGPUStruct.js";
+import {
+    chunk_octahedral_solid_angle
+} from "../../../../shader/chunk/geometry/octahedron/chunk_octahedral_solid_angle.js";
+import {
+    chunk_uv_octahedral_unit_decode
+} from "../../../../shader/chunk/geometry/octahedron/chunk_uv_octahedral_unit_decode.js";
+import { chunk_grid2d_to_index } from "../../../../shader/chunk/grid/chunk_grid2d_to_index.js";
+import { PI_DECLARATION } from "../../../../shader/chunk/math/PI_DECLARATION.js";
+import { chunk_sh2_basis_at } from "../../../../shader/chunk/spherical_harmonics/chunk_sh2_basis_at.js";
+import { chunk_sh2_multiply_scalar } from "../../../../shader/chunk/spherical_harmonics/chunk_sh2_multiply_scalar.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 { chunk_lpv_atlas_read_patch_texel } from "../sample/chunk_lpv_atlas_read_patch_texel.js";
+import { chunk_compute_coefficient_address } from "./chunk_compute_coefficient_address.js";
+
+const PUSH_CONSTANTS = WebGPUStruct.from({
+    probe_index_offset: u32,
+    probe_update_count: u32,
+    probe_resolution: u32,
+    probe_count: u32,
+    probes_per_row: u32, // in g-buffer space
+})
+
+const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, 20 bytes, read-only: immediate data rather than a uniform buffer — the struct was
+// already named PUSH_CONSTANTS
+resources.setImmediate("settings", PUSH_CONSTANTS);
+resources.createGroup()
+
+resources.createGroup()
+    .addStorageBuffer("coefficients", WebGPUArray.f32, true)
+    .addTexture("tAtlas_radiance", "uint");
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+@compute @workgroup_size(16,16,1)
+fn main(
+    @builtin(global_invocation_id) global_id : vec3<u32>,
+){
+   
+    let g_buffer_texel = global_id.xy;
+    
+    let probe_resolution = settings.probe_resolution;
+    
+    let probe_texel = g_buffer_texel % probe_resolution;
+
+    let g_buffer_probe_index = grid2d_to_index(g_buffer_texel / probe_resolution, settings.probes_per_row);
+    
+    if(g_buffer_probe_index >= settings.probe_update_count){
+        // out of bounds
+        return;
+    }
+    
+    let global_probe_index = (g_buffer_probe_index + settings.probe_index_offset) % settings.probe_count;
+    
+    let radiance = lpv_atlas_read_patch_texel(global_probe_index, probe_texel + 1, tAtlas_radiance, probe_resolution + 2);
+    
+    let probe_texel_uv = texel_coordinate_to_uv(vec2<f32>(probe_texel), vec2(probe_resolution));
+    
+    let direction = uv_octahedral_unit_decode(probe_texel_uv);
+        
+    let sh3_basis = sh2_basis_at(direction);
+    
+    let local_texel_index = grid2d_to_index(probe_texel, probe_resolution);
+    
+    let coefficients_address = compute_coefficient_address(g_buffer_probe_index, probe_texel);
+    
+    // adjust by solid angle
+    let solid_angle = octahedral_solid_angle(probe_texel_uv, 1.0 / f32(probe_resolution));
+    
+    let sh_coefficients = sh2_multiply_scalar(sh3_basis, solid_angle);
+    
+    // NOTE: we do not convolve with cosine kernel here, this is done during sampling.
+    // what is stored is radiance projected to SH
+    
+    // store coefficients for this texel.
+    // NOTE: no accumulation here, done in a separate pass.
+    for(var i=0u; i< 4; i++){
+        let coefficient = sh_coefficients[i];
+      
+        let convolved = radiance * coefficient;
+      
+        let offset = coefficients_address + i * 3;
+        
+        coefficients[ offset ] = convolved.r;
+        coefficients[ offset + 1 ] = convolved.g;
+        coefficients[ offset + 2 ] = convolved.b;
+    }
+        
+}
+    `, [
+        chunk_sh2_basis_at,
+        chunk_grid2d_to_index,
+        chunk_uv_octahedral_unit_decode,
+        chunk_texel_coordinate_to_uv,
+        chunk_lpv_atlas_read_patch_texel,
+        chunk_compute_coefficient_address,
+        chunk_octahedral_solid_angle,
+        chunk_sh2_multiply_scalar,
+        PI_DECLARATION,
+    ]
+);
+
+const shader = ComputeShader.from({
+    label: "Radiance Atlas / convert to SH",
+    body,
+    resources,
+});
+
+/**
+ * Convolve part of the atlas to Spherical Harmonics
+ * @param {FrameGraph} graph
+ * @param {GPUProbeAtlas} atlas
+ * @param {GPUSceneContext} scene
+ * @param {number} probe_index_offset
+ * @param {number} probe_update_count
+ * @param {number[]} g_buffer_resolution In texels
+ * @returns {number} buffer resource with SH3-encoded texels
+ */
+export function graph_lvp_atlas_to_sh({
+                                          graph,
+                                          atlas,
+                                          scene,
+                                          probe_index_offset,
+                                          probe_update_count,
+                                          g_buffer_resolution,
+                                      }) {
+
+    // first convert rasterized probes to SH
+    const probe_resolution = atlas.probe_resolution;
+
+    /**
+     *
+     * @param data
+     * @param {FramePassResources} resources
+     * @param {GraphicsExecutionContext} context
+     */
+    function execute(data, resources, context) {
+        /**
+         *
+         * @type {GPUBuffer}
+         */
+        const output = resources.get(data.output);
+
+        const settings = {
+            probe_index_offset,
+            probe_update_count,
+            probe_resolution: probe_resolution,
+            probe_count: scene.light_probe_volume.source.probe_count,
+            probes_per_row: Math.round(g_buffer_resolution[0] / probe_resolution)
+        };
+
+        shader.dispatchThreads({
+            encoder: context.encoder,
+            bindings: {
+                settings,
+                coefficients: output,
+                tAtlas_radiance: atlas.texture_radiance.obtainView(),
+            },
+            thread_count_x: g_buffer_resolution[0],
+            thread_count_y: g_buffer_resolution[1],
+        });
+    }
+
+    const pass_data = {};
+
+    const pass = graph.add("Atlas to SH", pass_data, execute);
+
+    const probe_texel_count = probe_resolution * probe_resolution;
+    const total_updated_texel_count = probe_texel_count * probe_update_count;
+    const buffer_spec = BufferResourceDescriptor.from(
+        12 * total_updated_texel_count * Float32Array.BYTES_PER_ELEMENT,
+        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC
+    );
+    const r_sh_buffer = pass.create("sh", buffer_spec);
+
+    pass_data.output = r_sh_buffer;
+
+    return r_sh_buffer;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"graph_reduce_atlas_to_sh.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_reduce_atlas_to_sh.js"],"names":[],"mappings":"AA6GA;;;;;;;;;GASG;AACH,mKAsDC;AA5ID,sCAaM;0BArCoB,0CAA0C"}
+{"version":3,"file":"graph_reduce_atlas_to_sh.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_reduce_atlas_to_sh.js"],"names":[],"mappings":"AAgHA;;;;;;;;;GASG;AACH,mKAsDC;AA5ID,sCAaM;0BAxCoB,0CAA0C"}

package/src/shade/renderer/global_illumination/probe/octahedral/convolve/graph_reduce_atlas_to_sh.js

@@ -25,8 +25,11 @@ const PUSH_CONSTANTS = WebGPUStruct.from({
 })
 
 const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, 24 bytes, read-only: immediate data rather than a uniform buffer. The reduce runs
+// one dispatch per mip level, so the buffer was allocated per level to carry six integers.
+resources.setImmediate("settings", PUSH_CONSTANTS);
 resources.createGroup()
-    .addUniform("settings", PUSH_CONSTANTS)
 
 resources.createGroup({ label: "source" })
     .addStorageBuffer("coefficients", WebGPUArray.f32, true)