@woosh/meep-engine 3.11.2 → 3.12.0

package/src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.d.ts

@@ -1,3 +1,20 @@
+/**
+ * Workgroup shape of this pass, `[x, y, z]` in froxels, stated to the `@workgroup_size` below.
+ * That attribute is where the dispatch gets the shape from in turn: `graph_build_volumetrics` asks
+ * for a thread count and `ComputeShader` divides by the size it read back out of the WGSL.
+ *
+ * Flat in z. Lights are binned into 3D clusters and the largest distance between neighbouring
+ * clusters is along depth, so a group spanning z is the one spanning the most unrelated light
+ * lists.
+ *
+ * 64 invocations — one wave64, two warps — is a deliberate trade: 16x16x1 measures faster on the
+ * RTX 4090 this was benchmarked on, and is kept off because that part's register file is unusually
+ * large and the result is not expected to generalize (AMD favours smaller groups). NOTES.md carries
+ * the numbers and the reasoning.
+ *
+ * @type {number[]}
+ */
+export const VOLUMETRICS_LIGHTING_WORKGROUP_RESOLUTION: number[];
 export const shader_volumetrics_build_lighting: ComputeShader;
 import { ComputeShader } from "../shader/ComputeShader.js";
 //# sourceMappingURL=shader_volumetrics_build_lighting.d.ts.map

package/src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_volumetrics_build_lighting.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.js"],"names":[],"mappings":"AA6ZA,8DAIE;8BA7Y4B,4BAA4B"}
+{"version":3,"file":"shader_volumetrics_build_lighting.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.js"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;;;GAeG;AACH,wDAFU,MAAM,EAAE,CAEiD;AAkXnE,8DAIE;8BA/Z4B,4BAA4B"}

package/src/shade/renderer/volumetrics/shader_volumetrics_build_lighting.js

@@ -43,6 +43,24 @@ import { chunk_volumetrics_column_jitter } from "./chunk_volumetrics_column_jitt
 import { chunk_volumetrics_local_light_shadow } from "./chunk_volumetrics_local_light_shadow.js";
 import { VOLUMETRICS_METADATA_STRUCT } from "./VOLUMETRICS_METADATA_STRUCT.js";
 
+/**
+ * Workgroup shape of this pass, `[x, y, z]` in froxels, stated to the `@workgroup_size` below.
+ * That attribute is where the dispatch gets the shape from in turn: `graph_build_volumetrics` asks
+ * for a thread count and `ComputeShader` divides by the size it read back out of the WGSL.
+ *
+ * Flat in z. Lights are binned into 3D clusters and the largest distance between neighbouring
+ * clusters is along depth, so a group spanning z is the one spanning the most unrelated light
+ * lists.
+ *
+ * 64 invocations — one wave64, two warps — is a deliberate trade: 16x16x1 measures faster on the
+ * RTX 4090 this was benchmarked on, and is kept off because that part's register file is unusually
+ * large and the result is not expected to generalize (AMD favours smaller groups). NOTES.md carries
+ * the numbers and the reasoning.
+ *
+ * @type {number[]}
+ */
+export const VOLUMETRICS_LIGHTING_WORKGROUP_RESOLUTION = [8, 8, 1];
+
 const resources = new ShaderResourceSetDescriptor();
 
 const primary_group = resources.createGroup()
@@ -80,7 +98,7 @@ resources.createGroup()
 const body = CodeChunk.from(
     //language=WGSL
     `
-@compute @workgroup_size(16,16)
+@compute @workgroup_size(${VOLUMETRICS_LIGHTING_WORKGROUP_RESOLUTION.join(",")})
 fn main(
     @builtin(global_invocation_id) voxel_coord : vec3<u32>
 ){
@@ -213,7 +231,7 @@ fn main(
 
             let sun = get_directional_light_info_by_index(&light_data, directional_index);
 
-            let sun_lut_uv = sky_lut_compute_uv(position_ws, sun.direction);
+            let sun_lut_uv = sky_lut_compute_uv(position_ws, sun.direction, vec2<f32>(textureDimensions(tSunTransmittance)));
 
             let shadow_term = shadowmap_get_directional_light_visibility(
                 &light_data,

package/src/shade/renderer/volumetrics/shader_volumetrics_build_participating_media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_volumetrics_build_participating_media.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/shader_volumetrics_build_participating_media.js"],"names":[],"mappings":"AA2LA,yEAIE;8BA5K4B,4BAA4B"}
+{"version":3,"file":"shader_volumetrics_build_participating_media.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/volumetrics/shader_volumetrics_build_participating_media.js"],"names":[],"mappings":"AAsMA,yEAIE;8BArL4B,4BAA4B"}

package/src/shade/renderer/volumetrics/shader_volumetrics_build_participating_media.js

@@ -12,7 +12,9 @@ import { chunk_rgb_to_luminance } from "../shader/chunk/color/chunk_rgb_to_lumin
 import { AABB3_STRUCT } from "../shader/chunk/geometry/aabb3/AABB3_STRUCT.js";
 import { chunk_aabb3_intersects_frustum } from "../shader/chunk/geometry/aabb3/chunk_aabb3_intersects_frustum.js";
 import { chunk_frustum_slice } from "../shader/chunk/geometry/frustum/chunk_frustum_slice.js";
-import { chunk_frustum_transform_m4 } from "../shader/chunk/geometry/frustum/chunk_frustum_transform_m4.js";
+import {
+    chunk_frustum_transform_plane_matrix
+} from "../shader/chunk/geometry/frustum/chunk_frustum_transform_plane_matrix.js";
 import { chunk_mat4_extract_scale } from "../shader/chunk/geometry/mat4/chunk_mat4_extract_scale.js";
 import { chunk_random } from "../shader/chunk/random/chunk_random.js";
 import { chunk_random_initialize } from "../shader/chunk/random/chunk_random_initialize.js";
@@ -101,44 +103,53 @@ fn main(
     var particle_diameter = 0.0;
     var scattering_luma_sum = 0.0;
     var anisotropic_g = 0.0;
-            
+
     for(var i=0u; i < scene_volumetrics_metadata.instance_count; i++){
-        
+
         let volume = scene_volumes[i];
-        
-        // transform froxel into volume's coordinate space
-        let local_frustum = frustum_transform_m4(froxel_frustum, volume.transform_inverse);
-                
+
+        // Transform froxel into volume's coordinate space. Points go world -> local through
+        // transform_inverse, so planes go by the transpose of *its* inverse, which is just
+        // transpose(transform) — already resident, where deriving it costs a generic 4x4 inverse.
+        // Full 4x4 rather than a 3x3 basis: the last row carries the translation, and that is what
+        // supplies each transformed plane's distance term.
+        let local_frustum = frustum_transform_plane_matrix(froxel_frustum, transpose(volume.transform));
+
         const unit_bounds = ${AABB3_STRUCT.make({
             min: "vec3(-0.5)",
             max: "vec3(0.5)",
         })};
-        
-        // TODO we can check intersection degree, if froxel is 100% inside the volume - we can skip costly coverage computation.
-        
+
         let aabb_intersects = aabb3_intersects_frustum(unit_bounds, local_frustum);
-        
+
         if(!aabb_intersects){
              // skip
              continue;
         }
-        
+
+        // A froxel proved to lie entirely inside the volume has a coverage of exactly 1.0 and, deep
+        // enough in, a fade of exactly 1.0 — both skippable. It is not done here because it does not
+        // pay: proving it needs the froxel's 8 vertices, which cost the same 8 three-plane
+        // intersections the coverage estimator spends, and only 7 to 33 percent of froxels qualify.
+        // NOTES.md has the measured hit rates and the arithmetic, and
+        // volumetrics_froxel_containment.spec.js keeps the geometry proven if the balance changes.
+
         // estimate volume coverage to avoid aliasing and get a better overlap test
         var volume_coverage = frustum_unit_box_coverage(local_frustum);
-                        
+
         if(volume_coverage == 0.0){
             // skip
             continue;
         }
-        
+
         let world_scale = mat4_extract_scale(volume.transform);
-        
+
         let edge_fade_factor = compute_volume_fade_factor(
             local_frustum,
             world_scale,
-            volume.fade_distance    
+            volume.fade_distance
         );
-                        
+
         let weight = volume.density * volume_coverage * edge_fade_factor;
         
         let volume_scattering = volume.particle_spec.scattering * weight;
@@ -172,7 +183,7 @@ fn main(
         chunk_density_mie,
         chunk_cluster_depth_from_z_slice,
         chunk_frustum_slice,
-        chunk_frustum_transform_m4,
+        chunk_frustum_transform_plane_matrix,
         chunk_aabb3_intersects_frustum,
         chunk_compute_near_far_from_projection,
         chunk_random_initialize,