@woosh/meep-engine 3.38.0 → 3.40.0

package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.d.ts

@@ -65,6 +65,13 @@ export class GPUMeshSkinningContext {
      * @returns {GPUBuffer|null}
      */
     get bindings_buffer(): any;
+    /**
+     * Bound {@link SkinnedMesh}es — the records {@link bindings_buffer} holds once {@link update} has
+     * uploaded them, which it does on the frame they change.
+     *
+     * @returns {number}
+     */
+    get binding_count(): number;
     /**
      * Per-meshlet base offsets into {@link prev_positions_buffer},
      * indexed by absolute meshlet metadata row. Non-clone meshlets

package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUMeshSkinningContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js"],"names":[],"mappings":"AAmFA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAgNI;;;;;;;OAOG;IACH,sEAPW;QACV,UAAgB,EAAE,kBAAkB,CAAC;QACrC,iBAAuB,EAAE,mBAAmB,CAAC;QAC7C,aAAmB,EAAE,eAAe,CAAC;QACrC,MAAY,YAAY;KACrB,EAcH;IAED;;;;;;OAMG;IACH,iCAEC;IAED;;;;;;;OAOG;IACH,yCAEC;IAED;;;;;;OAMG;IACH,2BAEC;IAED;;;;;;;OAOG;IACH,wCAEC;IAED;;;;;;;;;;;;OAYG;IACH,qBAJW,MAAM,YACN,eAAe,GACb,mBAAmB,CAqB/B;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GACJ,mBAAmB,GAAC,SAAS,CAMzC;IAED;;;;;;;;;;OAUG;IACH,aAHW,MAAM,WACN,MAAM,QAwBhB;IAED;;;;;;;OAOG;IACH,oBAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CAI5B;IAED;;;;;;;;;;OAUG;IACH,eAFW,MAAM,QAYhB;IAED;;;;;;;;OAQG;IACH,4BAFW,MAAM,QAUhB;IA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,sBAFW,MAAM,QAqBhB;IAuBD;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAJW,sBAAsB,GACpB,OAAO,CA0NnB;IAkXD;;;;;;;OAOG;IACH,gBA+BC;;CACJ;qCA/wCY,OAAO,2CAA2C,EAAE,sBAAsB;iCAC1E,OAAO,sCAAsC,EAAE,kBAAkB;8BACjE,OAAO,gCAAgC,EAAE,eAAe;8BACxD,OAAO,mCAAmC,EAAE,eAAe;kCAC3D,OAAO,uCAAuC,EAAE,mBAAmB;kCACnE,OAAO,2BAA2B,EAAE,mBAAmB"}
+{"version":3,"file":"GPUMeshSkinningContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js"],"names":[],"mappings":"AAmFA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAgNI;;;;;;;OAOG;IACH,sEAPW;QACV,UAAgB,EAAE,kBAAkB,CAAC;QACrC,iBAAuB,EAAE,mBAAmB,CAAC;QAC7C,aAAmB,EAAE,eAAe,CAAC;QACrC,MAAY,YAAY;KACrB,EAcH;IAED;;;;;;OAMG;IACH,iCAEC;IAED;;;;;;;OAOG;IACH,yCAEC;IAED;;;;;;OAMG;IACH,2BAEC;IAED;;;;;OAKG;IACH,4BAEC;IAED;;;;;;;OAOG;IACH,wCAEC;IAED;;;;;;;;;;;;OAYG;IACH,qBAJW,MAAM,YACN,eAAe,GACb,mBAAmB,CAqB/B;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GACJ,mBAAmB,GAAC,SAAS,CAMzC;IAED;;;;;;;;;;OAUG;IACH,aAHW,MAAM,WACN,MAAM,QAwBhB;IAED;;;;;;;OAOG;IACH,oBAHW,MAAM,GACJ,MAAM,GAAC,SAAS,CAI5B;IAED;;;;;;;;;;OAUG;IACH,eAFW,MAAM,QAYhB;IAED;;;;;;;;OAQG;IACH,4BAFW,MAAM,QAUhB;IA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,sBAFW,MAAM,QAqBhB;IAuBD;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAJW,sBAAsB,GACpB,OAAO,CA0NnB;IAmXD;;;;;;;OAOG;IACH,gBA+BC;;CACJ;qCA1xCY,OAAO,2CAA2C,EAAE,sBAAsB;iCAC1E,OAAO,sCAAsC,EAAE,kBAAkB;8BACjE,OAAO,gCAAgC,EAAE,eAAe;8BACxD,OAAO,mCAAmC,EAAE,eAAe;kCAC3D,OAAO,uCAAuC,EAAE,mBAAmB;kCACnE,OAAO,2BAA2B,EAAE,mBAAmB"}

package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js

@@ -372,6 +372,16 @@ export class GPUMeshSkinningContext {
         return this.#bindings_buffer;
     }
 
+    /**
+     * Bound {@link SkinnedMesh}es — the records {@link bindings_buffer} holds once {@link update} has
+     * uploaded them, which it does on the frame they change.
+     *
+     * @returns {number}
+     */
+    get binding_count() {
+        return this.#bindings.length;
+    }
+
     /**
      * Per-meshlet base offsets into {@link prev_positions_buffer},
      * indexed by absolute meshlet metadata row. Non-clone meshlets
@@ -1233,6 +1243,7 @@ export class GPUMeshSkinningContext {
 
             write_gpu_typed_buffer({
                 skin_matrix_offset: this.#animation_manager.get_skin_matrix_offset(b.skin_id),
+                skin_matrix_count: this.#animation_manager.get_skin_joint_count(b.skin_id),
                 source_meshlet_metadata_offset: b.source_meshlet_metadata_offset,
                 clone_meshlet_metadata_offset: b.clone_meshlet_metadata_offset,
                 meshlet_count: b.meshlet_count,

package/src/shade/renderer/animation/skinning/SKINNING_BINDING_STRUCT.d.ts

@@ -9,7 +9,9 @@
  *  - `skin_matrix_offset` is the skin's first joint row, read from the
  *    animation manager's {@link GPUAnimationManager#get_skin_matrix_offset}
  *    — a joint's matrix sits at its row — so the shader can index
- *    `skin_matrices` directly without dereferencing the skin record.
+ *    `skin_matrices` directly without dereferencing the skin record;
+ *    `skin_matrix_count`, its number of joints, from
+ *    {@link GPUAnimationManager#get_skin_joint_count}.
  *  - The two `*_meshlet_metadata_offset` values are the starts of the
  *    source's and clone's meshlet ranges in the meshlet metadata
  *    buffer; combined with `meshlet_count`, they bound the per-binding

package/src/shade/renderer/animation/skinning/SKINNING_BINDING_STRUCT.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SKINNING_BINDING_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/animation/skinning/SKINNING_BINDING_STRUCT.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,mDAwDsB;6BA3EO,mCAAmC"}
+{"version":3,"file":"SKINNING_BINDING_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/animation/skinning/SKINNING_BINDING_STRUCT.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,mDA+DsB;6BApFO,mCAAmC"}

package/src/shade/renderer/animation/skinning/SKINNING_BINDING_STRUCT.js

@@ -12,7 +12,9 @@ import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
  *  - `skin_matrix_offset` is the skin's first joint row, read from the
  *    animation manager's {@link GPUAnimationManager#get_skin_matrix_offset}
  *    — a joint's matrix sits at its row — so the shader can index
- *    `skin_matrices` directly without dereferencing the skin record.
+ *    `skin_matrices` directly without dereferencing the skin record;
+ *    `skin_matrix_count`, its number of joints, from
+ *    {@link GPUAnimationManager#get_skin_joint_count}.
  *  - The two `*_meshlet_metadata_offset` values are the starts of the
  *    source's and clone's meshlet ranges in the meshlet metadata
  *    buffer; combined with `meshlet_count`, they bound the per-binding
@@ -26,6 +28,13 @@ export const SKINNING_BINDING_STRUCT = WebGPUStruct.from({
      */
     skin_matrix_offset: u32,
 
+    /**
+     * How many joints the skin has: its matrices are `skin_matrix_count` rows from
+     * `skin_matrix_offset`. The skinning shader needs no count — a vertex names its joints — but a
+     * pass over the skin's pose does, such as the virtual shadow map's test of whether it moved.
+     */
+    skin_matrix_count: u32,
+
     /**
      * First source meshlet record in the meshlet metadata buffer. The
      * skinning shader reads attributes (position / normal / tangent /

package/src/shade/renderer/buffer/table/serde/table_wgsl_gen_read_code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table_wgsl_gen_read_code.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/buffer/table/serde/table_wgsl_gen_read_code.js"],"names":[],"mappings":"AAyKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,uEAZW,MAAM,eACN,MAAM,qBAEJ,IAAI,CA8BhB"}
+{"version":3,"file":"table_wgsl_gen_read_code.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/buffer/table/serde/table_wgsl_gen_read_code.js"],"names":[],"mappings":"AAqMA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,uEAZW,MAAM,eACN,MAAM,qBAEJ,IAAI,CA8BhB"}

package/src/shade/renderer/buffer/table/serde/table_wgsl_gen_read_code.js

@@ -1,13 +1,17 @@
 import { assert } from "../../../../../core/assert.js";
 import {
     f32,
+    i32,
     mat4x4f,
     u32,
     vec2f,
+    vec2i,
     vec2u,
     vec3f,
+    vec3i,
     vec3u,
     vec4f,
+    vec4i,
     vec4u
 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 
@@ -50,6 +54,30 @@ function table_wgsl_gen_read_code_primitive(
         case f32:
             builder.extend(`bitcast<f32>(${buffer_name}[base_offset + ${offset}])`);
             return;
+        case i32:
+            builder.extend(`bitcast<i32>(${buffer_name}[base_offset + ${offset}])`);
+            return;
+        case vec2i:
+            builder.extend(`vec2<i32>(`);
+            builder.indent();
+            read_multiple(builder, offset, buffer_name, i32, 2);
+            builder.dedent();
+            builder.extend(')');
+            return;
+        case vec3i:
+            builder.extend(`vec3<i32>(`);
+            builder.indent();
+            read_multiple(builder, offset, buffer_name, i32, 3);
+            builder.dedent();
+            builder.extend(')');
+            return;
+        case vec4i:
+            builder.extend(`vec4<i32>(`);
+            builder.indent();
+            read_multiple(builder, offset, buffer_name, i32, 4);
+            builder.dedent();
+            builder.extend(')');
+            return;
         case vec2f:
             builder.extend(`vec2<f32>(`);
             builder.indent();

package/src/shade/renderer/buffer/table/serde/table_wgsl_gen_write_code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table_wgsl_gen_write_code.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/buffer/table/serde/table_wgsl_gen_write_code.js"],"names":[],"mappings":"AAoHA;;;;;;;;;;;;;;GAcG;AACH,wEANW,MAAM,eACN,MAAM,iCAEN,MAAM,GACJ,IAAI,CAyBhB"}
+{"version":3,"file":"table_wgsl_gen_write_code.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/buffer/table/serde/table_wgsl_gen_write_code.js"],"names":[],"mappings":"AAkJA;;;;;;;;;;;;;;GAcG;AACH,wEANW,MAAM,eACN,MAAM,iCAEN,MAAM,GACJ,IAAI,CAyBhB"}

package/src/shade/renderer/buffer/table/serde/table_wgsl_gen_write_code.js

@@ -1,5 +1,19 @@
 import { assert } from "../../../../../core/assert.js";
-import { f32, mat4x4f, u32, vec2f, vec2u, vec3f, vec3u, vec4f, vec4u } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import {
+    f32,
+    i32,
+    mat4x4f,
+    u32,
+    vec2f,
+    vec2i,
+    vec2u,
+    vec3f,
+    vec3i,
+    vec3u,
+    vec4f,
+    vec4i,
+    vec4u
+} from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 
 /**
  *
@@ -21,8 +35,24 @@ function table_wgsl_gen_write_code_primitive(
             builder.add(`${buffer_name}[base_offset + ${offset}] = ${value_expr};`);
             return;
         case f32:
+        case i32:
             builder.add(`${buffer_name}[base_offset + ${offset}] = bitcast<u32>(${value_expr});`);
             return;
+        case vec2i:
+            for (let i = 0; i < 2; i++) {
+                table_wgsl_gen_write_code_primitive(builder, offset + i, buffer_name, i32, `${value_expr}[${i}]`);
+            }
+            return;
+        case vec3i:
+            for (let i = 0; i < 3; i++) {
+                table_wgsl_gen_write_code_primitive(builder, offset + i, buffer_name, i32, `${value_expr}[${i}]`);
+            }
+            return;
+        case vec4i:
+            for (let i = 0; i < 4; i++) {
+                table_wgsl_gen_write_code_primitive(builder, offset + i, buffer_name, i32, `${value_expr}[${i}]`);
+            }
+            return;
         case vec2f:
             for (let i = 0; i < 2; i++) {
                 table_wgsl_gen_write_code_primitive(builder, offset + i, buffer_name, f32, `${value_expr}[${i}]`);

package/src/shade/renderer/dynamic/shader_dynamic_mesh_avboit_draw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_dynamic_mesh_avboit_draw.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/dynamic/shader_dynamic_mesh_avboit_draw.js"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,uDAFU,MAAM,CAE0C;AAyF1D;;;;GAIG;AACH,gDAFU,wBAAwB,CAc/B;AAEH,8EAA8E;AAC9E,6EAA4D;AAE5D,mDAAmD;AACnD,+DAA0D;yCA5IjB,8DAA8D;4CAU3D,mDAAmD;iCAC9D,+BAA+B"}
+{"version":3,"file":"shader_dynamic_mesh_avboit_draw.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/dynamic/shader_dynamic_mesh_avboit_draw.js"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,uDAFU,MAAM,CAE0C;AA+F1D;;;;GAIG;AACH,gDAFU,wBAAwB,CAc/B;AAEH,8EAA8E;AAC9E,6EAA4D;AAE5D,mDAAmD;AACnD,+DAA0D;yCApJjB,8DAA8D;4CAY3D,mDAAmD;iCAC9D,+BAA+B"}

package/src/shade/renderer/dynamic/shader_dynamic_mesh_avboit_draw.js

@@ -7,6 +7,8 @@ import { AVBOIT_DRAW_TARGETS } from "../rasterize/native/avboit/avboit_draw_frag
 import {
     chunk_avboit_premultiplied_contribution
 } from "../rasterize/native/avboit/chunk_avboit_premultiplied_contribution.js";
+import { chunk_avboit_view_depth_to_virtual } from "../rasterize/native/avboit/chunk_avboit_view_depth_to_virtual.js";
+import { chunk_avboit_footprint_bias } from "../rasterize/native/avboit/chunk_avboit_footprint_bias.js";
 import { chunk_avboit_sample_transmittance } from "../rasterize/native/avboit/chunk_avboit_sample_transmittance.js";
 import { CodeChunk } from "../shader/compiler/CodeChunk.js";
 import { ShaderResourceSetDescriptor } from "../shader/resource/ShaderResourceSetDescriptor.js";
@@ -78,6 +80,10 @@ fn vs_main(@builtin(vertex_index) vi : u32, @builtin(instance_index) draw_index
 
 @fragment
 fn fs_main(in : DynamicMeshAVBOITVertexOut) -> DynamicMeshAVBOITDrawOutput {
+    // a ribbon seen at an angle runs through depth across a voxel; see avboit_footprint_bias. Taken
+    // first, in uniform control flow
+    let footprint = avboit_footprint_bias(&warp, fwidth(avboit_view_depth_to_virtual(&warp, in.view_depth)));
+
     if (in.color.a <= 0.0) {
         // faded out: covers nothing, and straight alpha carries no light without coverage
         discard;
@@ -85,7 +91,7 @@ fn fs_main(in : DynamicMeshAVBOITVertexOut) -> DynamicMeshAVBOITDrawOutput {
 
     let screen_uv = in.clip.xy / vec2<f32>(f32(view.width), f32(view.height));
 
-    let transmittance = avboit_sample_transmittance(&warp, tIntegral, sLinear, screen_uv, in.view_depth);
+    let transmittance = avboit_sample_transmittance(&warp, tIntegral, sLinear, screen_uv, in.view_depth, footprint);
 
     if (all(transmittance <= vec3<f32>(${AVBOIT_EXTINCT_TRANSMITTANCE}))) {
         // nothing this fragment contributes survives what is in front of it; skip the shading
@@ -109,6 +115,8 @@ fn fs_main(in : DynamicMeshAVBOITVertexOut) -> DynamicMeshAVBOITDrawOutput {
 }
 `, [
     chunk_dynamic_mesh_avboit_vertex,
+    chunk_avboit_view_depth_to_virtual,
+    chunk_avboit_footprint_bias,
     chunk_avboit_sample_transmittance,
     chunk_sample_volumetrics,
     chunk_avboit_premultiplied_contribution,

package/src/shade/renderer/geometry/MeshletGeometry.d.ts

@@ -35,5 +35,8 @@ export class MeshletGeometry {
     equals(other: MeshletGeometry): boolean;
     isMeshletGeometry: boolean;
 }
+export namespace MeshletGeometry {
+    let typeName: string;
+}
 import { MeshletBatch } from "./meshlet/MeshletBatch.js";
 //# sourceMappingURL=MeshletGeometry.d.ts.map

package/src/shade/renderer/geometry/MeshletGeometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MeshletGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/MeshletGeometry.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IACI,WAAkB;IAElB;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV,2BAAmC;IACnC,8BAAsC;IAEtC;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB,wBAGC;IAED;;OAEG;IACH,UAFU,YAAY,CAEQ;IAE9B;;;;OAIG;IACH,KAFU,WAAW,CAEG;IAExB,eAEC;IAED;;;OAGG;IACH,cAFW,eAAe,WAMzB;IAGL,2BAA2C;CAF1C;6BAxD4B,2BAA2B"}
+{"version":3,"file":"MeshletGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/MeshletGeometry.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH;IACI,WAAkB;IAElB;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV,2BAAmC;IACnC,8BAAsC;IAEtC;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB,wBAGC;IAED;;OAEG;IACH,UAFU,YAAY,CAEQ;IAE9B;;;;OAIG;IACH,KAFU,WAAW,CAEG;IAExB,eAEC;IAED;;;OAGG;IACH,cAFW,eAAe,WAMzB;IAGL,2BAA2C;CAF1C;;;;6BAxD4B,2BAA2B"}

package/src/shade/renderer/geometry/MeshletGeometry.js

@@ -57,4 +57,5 @@ export class MeshletGeometry {
 }
 
 MeshletGeometry.prototype.isMeshletGeometry = true;
+MeshletGeometry.typeName = "MeshletGeometry";
 

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

@@ -1 +1 @@
-{"version":3,"file":"chunk_scene_point_query_volume_sign.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/chunk_scene_point_query_volume_sign.js"],"names":[],"mappings":"AAoBA,4DAoEE;0BA5EwB,oCAAoC"}
+{"version":3,"file":"chunk_scene_point_query_volume_sign.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/sdf/chunk_scene_point_query_volume_sign.js"],"names":[],"mappings":"AAoBA,4DAsEE;0BA9EwB,oCAAoC"}

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

@@ -9,7 +9,7 @@ import { chunk_ray_query_nearest } from "../../shader/chunk/geometry/ray/chunk_r
 import { RAY_STRUCT } from "../../shader/chunk/geometry/ray/RAY_STRUCT.js";
 import { chunk_sphere_fibonacci_point } from "../../shader/chunk/geometry/sphere/chunk_sphere_fibonacci_point.js";
 import { chunk_f32_array_as_vec3 } from "../../shader/chunk/geometry/vec3/chunk_f32_array_as_vec3.js";
-import { chunk_v3_matrix4_rotate } from "../../shader/chunk/geometry/vec3/chunk_v3_matrix4_rotate.js";
+import { chunk_compute_normal_matrix_from_m4 } from "../../shader/chunk/geometry/mat4/chunk_compute_normal_matrix_from_m4.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 
 /**
@@ -57,10 +57,12 @@ fn scene_point_query_volume_sign(position_ws: vec3<f32>, max_distance: f32) -> f
         
         let normal = compute_triangle_face_normal(a,b,c);
         
-        // localize ray direction
+        // into the world by the normal matrix, not the instance matrix: under a non-uniform scale
+        // the two tilt a slanted face's normal opposite ways. Only its side is wanted, so it stays
+        // unnormalized
         let mesh = scene_read_mesh(&scene_database, hit.instance);
         let node = scene_read_node(&scene_database, mesh.node);
-        let normal_ws = v3_matrix4_rotate(normal, node.global);
+        let normal_ws = compute_normal_matrix_from_m4(node.global) * normal;
         
         if(dot(normal_ws, ray.direction) > 0.0){
             // back-facing
@@ -83,7 +85,7 @@ fn scene_point_query_volume_sign(position_ws: vec3<f32>, max_distance: f32) -> f
         chunk_geometry_read_triangle_vertices,
         chunk_f32_array_as_vec3,
         chunk_compute_triangle_face_normal,
-        chunk_v3_matrix4_rotate,
+        chunk_compute_normal_matrix_from_m4,
         chunk_scene_database_access,
     ]
 );

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;yBAkMxC"}
+{"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"}

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

@@ -156,6 +156,7 @@ export async function brick4_bake_basic({
                 },
 
                 materials: r_materials.buffer_materials,
+                media: r_materials.buffer_media,
                 textures: r_materials.textureView,
 
                 //

package/src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_rand1.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Fibonacci point `index` of `limit`, turned by a frame around a uniformly random axis.
+ *
+ * The axis must be uniform on the sphere: the resolve buckets samples by contiguous index, which is a
+ * latitude band in the frame, and only an isotropic axis makes every band isotropic in the world.
+ * @type {CodeChunk}
+ */
 export const chunk_direction_by_index_rand1: CodeChunk;
 import { CodeChunk } from "../../../../../shader/compiler/CodeChunk.js";
 //# sourceMappingURL=chunk_direction_by_index_rand1.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chunk_direction_by_index_rand1.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_rand1.js"],"names":[],"mappings":"AAaA,uDAuBC;0BAzByB,6CAA6C"}
+{"version":3,"file":"chunk_direction_by_index_rand1.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_rand1.js"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,6CAFU,SAAS,CAqBlB;0BA5ByB,6CAA6C"}

package/src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_rand1.js

@@ -1,25 +1,26 @@
 import {
     chunk_build_orthonormal_matrix_n
 } from "../../../../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_n.js";
+import { chunk_uniform_sample_cone } from "../../../../../shader/chunk/geometry/ray/chunk_uniform_sample_cone.js";
 import {
     chunk_sphere_fibonacci_point
 } from "../../../../../shader/chunk/geometry/sphere/chunk_sphere_fibonacci_point.js";
-import {
-    chunk_spherical_to_cartesian
-} from "../../../../../shader/chunk/geometry/sphere/chunk_spherical_to_cartesian.js";
-import { PI_DECLARATION } from "../../../../../shader/chunk/math/PI_DECLARATION.js";
 import { chunk_random } from "../../../../../shader/chunk/random/chunk_random.js";
 import { CodeChunk } from "../../../../../shader/compiler/CodeChunk.js";
 
+/**
+ * Fibonacci point `index` of `limit`, turned by a frame around a uniformly random axis.
+ *
+ * The axis must be uniform on the sphere: the resolve buckets samples by contiguous index, which is a
+ * latitude band in the frame, and only an isotropic axis makes every band isotropic in the world.
+ * @type {CodeChunk}
+ */
 export const chunk_direction_by_index_rand1 = CodeChunk.from(
     //language=WGSL
     `
 fn direction_by_index(index : u32, limit: u32) -> vec3<f32>{
-    let phi = random() * 2.0 * PI;
-    let cos_theta = random() * 2.0 - 1.0;
-    let theta = acos(cos_theta);
-    
-    let random_direction = spherical_to_cartesian(theta, phi);
+    // a cone of cos(theta_max) = -1 is the whole sphere
+    let random_direction = uniform_sample_cone(vec2(random(), random()), -1.0);
     
     let tbn = build_orthonormal_matrix_n(random_direction);
     
@@ -28,10 +29,9 @@ fn direction_by_index(index : u32, limit: u32) -> vec3<f32>{
     return normalize(tbn * fixed_direction);
 }
     `, [
-        chunk_spherical_to_cartesian,
-        PI_DECLARATION,
+        chunk_uniform_sample_cone,
         chunk_sphere_fibonacci_point,
         chunk_build_orthonormal_matrix_n,
         chunk_random,
     ]
-)
+)

package/src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_spherical.d.ts

@@ -1,3 +1,7 @@
+/**
+ * A uniformly random direction on the sphere; `index` and `limit` are ignored.
+ * @type {CodeChunk}
+ */
 export const chunk_direction_by_index_spherical: CodeChunk;
 import { CodeChunk } from "../../../../../shader/compiler/CodeChunk.js";
 //# sourceMappingURL=chunk_direction_by_index_spherical.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chunk_direction_by_index_spherical.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_spherical.js"],"names":[],"mappings":"AAEA,2DAaC;0BAfyB,6CAA6C"}
+{"version":3,"file":"chunk_direction_by_index_spherical.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_spherical.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,iDAFU,SAAS,CAalB;0BAjByB,6CAA6C"}

package/src/shade/renderer/global_illumination/brick4/gpu/bake/sampling/chunk_direction_by_index_spherical.js

@@ -1,16 +1,20 @@
+import { chunk_uniform_sample_cone } from "../../../../../shader/chunk/geometry/ray/chunk_uniform_sample_cone.js";
+import { chunk_random } from "../../../../../shader/chunk/random/chunk_random.js";
 import { CodeChunk } from "../../../../../shader/compiler/CodeChunk.js";
 
+/**
+ * A uniformly random direction on the sphere; `index` and `limit` are ignored.
+ * @type {CodeChunk}
+ */
 export const chunk_direction_by_index_spherical = CodeChunk.from(
     //language=WGSL
     `
 fn direction_by_index(index : u32, limit: u32) -> vec3<f32>{
-    let phi = random() * 2.0 * PI;
-    let cos_theta = random() * 2.0 - 1.0;
-    let theta = acos(cos_theta);
-    
-    let ray_direction = spherical_to_cartesian(theta, phi);
-    
-    return ray_direction;
+    // a cone of cos(theta_max) = -1 is the whole sphere
+    return uniform_sample_cone(vec2(random(), random()), -1.0);
 }
-    `
-)
+    `, [
+        chunk_uniform_sample_cone,
+        chunk_random,
+    ]
+)

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":"AA6GA,sDAIG;8BAnG2B,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":"AA+GA,sDAIG;8BApG2B,qCAAqC"}

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

@@ -2,6 +2,7 @@ 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 { INDIRECT_MATERIAL_ARRAY_TYPE } from "../../../../material/resident/INDIRECT_MATERIAL_ARRAY_TYPE.js";
+import { MEDIA_TABLE_STRUCT } from "../../../../medium/MEDIA_TABLE_STRUCT.js";
 import { chunk_render_trace_path } from "../../../../path_tracer/shader/chunk_render_trace_path.js";
 import { chunk_rgbe9995_encode } from "../../../../shader/chunk/color/rgbe9995/chunk_rgbe9995_encode.js";
 import {
@@ -23,6 +24,7 @@ resources.addGroup(RESOURCE_GROUP_RTX);
 
 resources.createGroup()
     .addUniform("materials", INDIRECT_MATERIAL_ARRAY_TYPE)
+    .addUniform("media", MEDIA_TABLE_STRUCT)
     .addTexture("textures", "unfilterable-float", "2d-array")
 
 resources.createGroup()

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,aAgGC;IAED;;;OAGG;IACH,sCAFW,MAAM,QA8ChB;IAED;;;OAGG;IACH,eAFY,MAAM,CAUjB;IAED,gBACC;;CACJ;8BA1XY,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":"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"}

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

@@ -297,6 +297,7 @@ export class GPULightProbeVolumeRenderer {
                 lpv_metadata: lpv.buffer_metadata.buffer,
                 lpv_probes: lpv.buffer_probes,
                 materials: r_materials.buffer_materials,
+                media: r_materials.buffer_media,
                 textures: r_materials.textureView,
                 bake_settings: bake_uniform,
                 tEnvironment: this.#environment.obtainView(),
@@ -306,6 +307,8 @@ export class GPULightProbeVolumeRenderer {
                 blas_data: blas.buffer_data,
                 scene_database: scene.scene_database_buffer,
                 geometries: geometries.buffer_metadata,
+                meshlet_metadata: geometries.meshlets.buffer_metadata,
+                meshlet_data: geometries.meshlets.buffer_data,
                 //
                 light_data: scene.lights.buffer_data,
             }

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":"AA0BA,sDAIG;AAwKH,4DAIG;6BAxM0B,sCAAsC;8BAkBrC,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":"AAyBA,sDAIG;AAoKH,4DAIG;6BAnM0B,sCAAsC;8BAiBrC,kCAAkC"}

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

@@ -1,11 +1,10 @@
 import { u32, vec3f } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
 import { WebGPUStruct } from "../../../shader/type/WebGPUStruct.js";
-import { GEOMETRY_METADATA_STRUCT } from "../../../geometry/GEOMETRY_METADATA_STRUCT.js";
+import { sr_create_group_RTX } from "../../../geometry/sr_create_group_RTX.js";
 import { INDIRECT_MATERIAL_ARRAY_TYPE } from "../../../material/resident/INDIRECT_MATERIAL_ARRAY_TYPE.js";
+import { MEDIA_TABLE_STRUCT } from "../../../medium/MEDIA_TABLE_STRUCT.js";
 import { chunk_render_trace_path } from "../../../path_tracer/shader/chunk_render_trace_path.js";
-import { BVH2_NODE_STRUCT } from "../../../shader/chunk/bvh/BVH2_NODE_STRUCT.js";
-import { BVH_STRUCT } from "../../../shader/chunk/bvh/BVH_STRUCT.js";
 import {
     chunk_build_orthonormal_matrix_n
 } from "../../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_n.js";
@@ -40,16 +39,12 @@ 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)
+    .addUniform('media', MEDIA_TABLE_STRUCT)
     .addTexture('textures', 'unfilterable-float', '2d-array', false)
     .addUniform('bake_settings', PROBE_BAKE_UNIFORMS_STRUCT)
     .addTexture('tEnvironment', 'unfilterable-float')
 
-resources.createGroup({ label: 'RTX' })
-    .addStorageBuffer('tlas', BVH_STRUCT)
-    .addStorageBuffer('blas_lookup', WebGPUArray.u32)
-    .addStorageBuffer('blas_data', WebGPUArray.from(BVH2_NODE_STRUCT))
-    .addStorageBuffer('scene_database', WebGPUArray.from(u32))
-    .addStorageBuffer('geometries', WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+sr_create_group_RTX(resources);
 
 resources.createGroup({ label: 'lights' })
     .addStorageBuffer('light_data', WebGPUArray.u32)

package/src/shade/renderer/light/LIGHT_DATABASE_SPEC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LIGHT_DATABASE_SPEC.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/light/LIGHT_DATABASE_SPEC.js"],"names":[],"mappings":"AAWA,wDAiBG;sCA1BmC,0CAA0C"}
+{"version":3,"file":"LIGHT_DATABASE_SPEC.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/light/LIGHT_DATABASE_SPEC.js"],"names":[],"mappings":"AAYA,wDAkCG;sCA7CmC,0CAA0C"}