@woosh/meep-engine 3.11.3 → 3.13.0

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

@@ -1,130 +1,130 @@
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { BVH2_NODE_STRUCT } from "../../shader/chunk/bvh/BVH2_NODE_STRUCT.js";
-import { BVH_TRAVERSAL_STACK_SIZE } from "../../shader/chunk/bvh/BVH_TRAVERSAL_STACK_SIZE.js";
-import { AABB3_STRUCT } from "../../shader/chunk/geometry/aabb3/AABB3_STRUCT.js";
-import { chunk_array_to_aabb3 } from "../../shader/chunk/geometry/aabb3/chunk_array_to_aabb3.js";
-import { F32_MAX_DEFINITION } from "../../shader/chunk/math/F32_MAX_DEFINITION.js";
-import { SURFACE_POINT_3D } from "../../shader/chunk/sdf/SURFACE_POINT_3D.js";
-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 { 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";
-
-const resources = new ShaderResourceSetDescriptor();
-
-resources.createGroup()
-    .addUniform("settings", SDF_BUILD_SETTINGS_STRUCT);
-
-resources.createGroup()
-    .addStorageBuffer("blas_lookup", WebGPUArray.u32)
-    .addStorageBuffer("blas_data", WebGPUArray.from(BVH2_NODE_STRUCT))
-    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
-
-resources.createGroup()
-    .addStorageTexture("output_texture", "r32float", "3d");
-
-/**
- * To support non-maniforld (open) meshes, we wrap negative distances after a number of voxels
- * @type {number}
- */
-const NEGATIVE_WRAP_DISTANCE = 4;
-
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-
-@compute @workgroup_size(${SFD_BUILD_WORKGROUP_SIZE.join(',')})
-fn main(
-    @builtin(global_invocation_id) global_id : vec3<u32>,
-){
-    let slot_resolution = settings.slot_resolution;
-    
-    if(any(global_id >= vec3(slot_resolution))){
-        // outside of the slot
-        return;
-    }
-    
-    let slot_index = settings.slot_index;
-    
-    let slice_size = slot_resolution * slot_resolution;
-    
-    let slot_offset_z = slot_index / slice_size;
-    
-    let index_in_slice = slot_index - slot_offset_z*slice_size;
-    
-    let slot_offset_y = index_in_slice / slot_resolution;
-    let slot_offset_x = slot_index % slot_resolution;
-    
-    let texel_offset = sdf_slot_index_to_texture_offset(slot_index, settings.atlas_resolution_in_slots) * slot_resolution;
-    
-    let texel_coordinate = texel_offset + global_id;
-    
-    let slot_resolution_v3f32 = vec3(f32(slot_resolution));
-    
-    // 0.5 is to move to the center of voxel
-    let local_uv = (vec3<f32>(global_id) + 0.5) / slot_resolution_v3f32;
-    
-    // get AABB from geometry's BVH
-    let blas_address = blas_lookup[slot_index];
-    
-    let bounds = array_to_aabb3(blas_data[blas_address].bounds);
-    let tight_bounds_span = (bounds.max - bounds.min);
-    
-    // figure out extents of a single sdf texel
-    let texel_size = tight_bounds_span / (slot_resolution_v3f32);
-    
-    // expand bounds by 1 texel to prevent clipping
-    let expanded_bounds = ${AABB3_STRUCT.wgsl_ref}(
-        bounds.min - texel_size*0.5,
-        bounds.max + texel_size*0.5
-    );
-    
-    let extended_bounds_span = (expanded_bounds.max - expanded_bounds.min);
-    
-    let sample_point = expanded_bounds.min + extended_bounds_span * local_uv;
-    
-    var traversal_stack:array<u32, ${BVH_TRAVERSAL_STACK_SIZE}>;
-    
-    var contact_point: ${SURFACE_POINT_3D.wgsl_ref};
-                
-    // note that distances are normalized to UV space, so no value will be greater than +/- sqrt(2)
-    var sdf_distance = blas_query_sdf(sample_point, slot_index, &contact_point, &traversal_stack, 0u);
-    
-    let voxel_size = extended_bounds_span / slot_resolution_v3f32;
-    
-    // convert distance to voxels
-    let voxel_path = ( (sample_point - contact_point.position) / voxel_size );
-    
-    let voxel_distance = length(voxel_path);
-    
-    if(sdf_distance < 0 && voxel_distance > ${NEGATIVE_WRAP_DISTANCE}){
-        let voxel_compensation = max(0.0, voxel_distance - ${NEGATIVE_WRAP_DISTANCE});
-        sdf_distance = sdf_distance + voxel_compensation * length(voxel_size) * 2.0;
-    }
-        
-    textureStore(
-        output_texture,
-        texel_coordinate,            
-        vec4(sdf_distance,0,0,0)
-    );
-}
-`, [
-        AABB3_STRUCT.declaration_chunk,
-        chunk_sdf_slot_index_to_texture_offset,
-        F32_MAX_DEFINITION,
-        chunk_array_to_aabb3,
-        chunk_blas_query_sdf,
-    ]);
-
-const descriptor = ShaderDescriptor.from({
-    label: "Geometry SDF/ build",
-    resources,
-    body
-});
-
+import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
+import { BVH2_NODE_STRUCT } from "../../shader/chunk/bvh/BVH2_NODE_STRUCT.js";
+import { BVH_TRAVERSAL_STACK_SIZE } from "../../shader/chunk/bvh/BVH_TRAVERSAL_STACK_SIZE.js";
+import { AABB3_STRUCT } from "../../shader/chunk/geometry/aabb3/AABB3_STRUCT.js";
+import { chunk_array_to_aabb3 } from "../../shader/chunk/geometry/aabb3/chunk_array_to_aabb3.js";
+import { F32_MAX_DEFINITION } from "../../shader/chunk/math/F32_MAX_DEFINITION.js";
+import { SURFACE_POINT_3D } from "../../shader/chunk/sdf/SURFACE_POINT_3D.js";
+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 { 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";
+
+const resources = new ShaderResourceSetDescriptor();
+
+// per-dispatch, 32 bytes, read-only: immediate data rather than a uniform buffer
+resources.setImmediate("settings", SDF_BUILD_SETTINGS_STRUCT);
+
+resources.createGroup()
+    .addStorageBuffer("blas_lookup", WebGPUArray.u32)
+    .addStorageBuffer("blas_data", WebGPUArray.from(BVH2_NODE_STRUCT))
+    .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+
+resources.createGroup()
+    .addStorageTexture("output_texture", "r32float", "3d");
+
+/**
+ * To support non-maniforld (open) meshes, we wrap negative distances after a number of voxels
+ * @type {number}
+ */
+const NEGATIVE_WRAP_DISTANCE = 4;
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+
+@compute @workgroup_size(${SFD_BUILD_WORKGROUP_SIZE.join(',')})
+fn main(
+    @builtin(global_invocation_id) global_id : vec3<u32>,
+){
+    let slot_resolution = settings.slot_resolution;
+    
+    if(any(global_id >= vec3(slot_resolution))){
+        // outside of the slot
+        return;
+    }
+    
+    let slot_index = settings.slot_index;
+    
+    let slice_size = slot_resolution * slot_resolution;
+    
+    let slot_offset_z = slot_index / slice_size;
+    
+    let index_in_slice = slot_index - slot_offset_z*slice_size;
+    
+    let slot_offset_y = index_in_slice / slot_resolution;
+    let slot_offset_x = slot_index % slot_resolution;
+    
+    let texel_offset = sdf_slot_index_to_texture_offset(slot_index, settings.atlas_resolution_in_slots) * slot_resolution;
+    
+    let texel_coordinate = texel_offset + global_id;
+    
+    let slot_resolution_v3f32 = vec3(f32(slot_resolution));
+    
+    // 0.5 is to move to the center of voxel
+    let local_uv = (vec3<f32>(global_id) + 0.5) / slot_resolution_v3f32;
+    
+    // get AABB from geometry's BVH
+    let blas_address = blas_lookup[slot_index];
+    
+    let bounds = array_to_aabb3(blas_data[blas_address].bounds);
+    let tight_bounds_span = (bounds.max - bounds.min);
+    
+    // figure out extents of a single sdf texel
+    let texel_size = tight_bounds_span / (slot_resolution_v3f32);
+    
+    // expand bounds by 1 texel to prevent clipping
+    let expanded_bounds = ${AABB3_STRUCT.wgsl_ref}(
+        bounds.min - texel_size*0.5,
+        bounds.max + texel_size*0.5
+    );
+    
+    let extended_bounds_span = (expanded_bounds.max - expanded_bounds.min);
+    
+    let sample_point = expanded_bounds.min + extended_bounds_span * local_uv;
+    
+    var traversal_stack:array<u32, ${BVH_TRAVERSAL_STACK_SIZE}>;
+    
+    var contact_point: ${SURFACE_POINT_3D.wgsl_ref};
+                
+    // note that distances are normalized to UV space, so no value will be greater than +/- sqrt(2)
+    var sdf_distance = blas_query_sdf(sample_point, slot_index, &contact_point, &traversal_stack, 0u);
+    
+    let voxel_size = extended_bounds_span / slot_resolution_v3f32;
+    
+    // convert distance to voxels
+    let voxel_path = ( (sample_point - contact_point.position) / voxel_size );
+    
+    let voxel_distance = length(voxel_path);
+    
+    if(sdf_distance < 0 && voxel_distance > ${NEGATIVE_WRAP_DISTANCE}){
+        let voxel_compensation = max(0.0, voxel_distance - ${NEGATIVE_WRAP_DISTANCE});
+        sdf_distance = sdf_distance + voxel_compensation * length(voxel_size) * 2.0;
+    }
+        
+    textureStore(
+        output_texture,
+        texel_coordinate,            
+        vec4(sdf_distance,0,0,0)
+    );
+}
+`, [
+        AABB3_STRUCT.declaration_chunk,
+        chunk_sdf_slot_index_to_texture_offset,
+        F32_MAX_DEFINITION,
+        chunk_array_to_aabb3,
+        chunk_blas_query_sdf,
+    ]);
+
+const descriptor = ShaderDescriptor.from({
+    label: "Geometry SDF/ build",
+    resources,
+    body
+});
+
 export const shader_build_sdf = new ComputeShader(descriptor);

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

@@ -1 +1 @@
-{"version":3,"file":"shader_sdf_visualize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/shader_sdf_visualize.js"],"names":[],"mappings":"AAiKA;;;;;;;;;GASG;AACH,kHAFa,MAAM,CAsGlB"}
+{"version":3,"file":"shader_sdf_visualize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/shader_sdf_visualize.js"],"names":[],"mappings":"AAmKA;;;;;;;;;GASG;AACH,kHAFa,MAAM,CAsGlB"}

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

@@ -25,8 +25,10 @@ import { dynamic_chunk_sdf_construct_normal } from "./dynamic_chunk_sdf_construc
 
 const resources = new ShaderResourceSetDescriptor();
 
+// per-draw, 32 bytes, read-only: immediate data rather than a uniform buffer. camera stays bound.
+resources.setImmediate("settings", SDF_DRAW_SETTINGS_STRUCT);
+
 resources.createGroup()
-    .addUniform("settings", SDF_DRAW_SETTINGS_STRUCT)
     .addTexture("texture_sdf", "unfilterable-float", "3d")
     .addTexture("gBufferDepth")
     .addTexture("gBufferNormals", "uint")
@@ -213,11 +215,11 @@ export function graph_draw_sdf_normals({
          */
         const viz_mesh = resources.get(data.viz_mesh);
 
-        const buffer_settings = encoder.allocateTransientValueBuffer(SDF_DRAW_SETTINGS_STRUCT, {
+        const buffer_settings = {
             sdf_tile_resolution: sdf.tile_resolution,
             sdf_atlas_resolution: sdf.atlas_resolution_in_tiles,
             slice: pingpong(current_time_in_seconds() / 5, 1),
-        }, GPUBufferUsage.UNIFORM);
+        };
 
         /**
          *

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":"AA0GA,sDAIG;8BAhG2B,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":"AA6GA,sDAIG;8BAnG2B,qCAAqC"}

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

@@ -36,9 +36,12 @@ const BRICK4_BAKE_SETTINGS_STRUCT = WebGPUStruct.from({
     path_depth: u32,
 });
 
+// per-dispatch, 16 bytes, read-only: immediate data rather than a uniform buffer. The material
+// table beside it is scene state and stays bound.
+resources.setImmediate("settings", BRICK4_BAKE_SETTINGS_STRUCT);
+
 
 resources.createGroup()
-    .addUniform("settings", BRICK4_BAKE_SETTINGS_STRUCT)
     .addStorageBuffer("probe_positions", WebGPUArray.f32)
     .addStorageBuffer("output", WebGPUArray.u32, true)
 

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

@@ -1 +1 @@
-{"version":3,"file":"shader_brick4_bake_resolve_probes.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_resolve_probes.js"],"names":[],"mappings":"AAqCA,gDAuCC;AAiLD,8DAIE;0BA/OwB,0CAA0C;8BACtC,qCAAqC"}
+{"version":3,"file":"shader_brick4_bake_resolve_probes.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/shader_brick4_bake_resolve_probes.js"],"names":[],"mappings":"AAuCA,gDAuCC;AAiLD,8DAIE;0BAjPwB,0CAA0C;8BACtC,qCAAqC"}

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

@@ -30,8 +30,10 @@ const SETTINGS_STRUCT = WebGPUStruct.from({
 
 const resources = new ShaderResourceSetDescriptor();
 
+// per-dispatch, 12 bytes, read-only: immediate data rather than a uniform buffer
+resources.setImmediate("settings", SETTINGS_STRUCT);
+
 resources.createGroup()
-    .addUniform("settings", SETTINGS_STRUCT)
     .addStorageBuffer("input", WebGPUArray.u32)
     .addStorageBuffer("output", WebGPUArray.u32, true)
 

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

@@ -1 +1 @@
-{"version":3,"file":"shader_update_clipmap_cascade.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.js"],"names":[],"mappings":"AAwGA;;;GAGG;AACH,4CAFU,aAAa,CAMpB;8BA7G2B,+BAA+B"}
+{"version":3,"file":"shader_update_clipmap_cascade.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/clipmap/shader_update_clipmap_cascade.js"],"names":[],"mappings":"AA0GA;;;GAGG;AACH,4CAFU,aAAa,CAMpB;8BA/G2B,+BAA+B"}

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
 });