@woosh/meep-engine 3.56.0 → 3.58.0

package/src/shade/renderer/shader/chunk/geometry/quaternion/chunk_quat_encode_u32.d.ts

@@ -1,6 +1,6 @@
 /**
  * Based on GDC talk from Bungie on destiny, compressing quaternions for animation
- * see meep code {@link quat_encode_to_uint32}
+ * see meep code {@link quat3_encode_to_uint32}
  * @type {CodeChunk}
  */
 export const chunk_quat_encode_u32: CodeChunk;

package/src/shade/renderer/shader/chunk/geometry/quaternion/chunk_quat_encode_u32.js

@@ -4,7 +4,7 @@ import { chunk_v4_max_axis } from "../vec4/chunk_v4_max_axis.js";
 
 /**
  * Based on GDC talk from Bungie on destiny, compressing quaternions for animation
- * see meep code {@link quat_encode_to_uint32}
+ * see meep code {@link quat3_encode_to_uint32}
  * @type {CodeChunk}
  */
 export const chunk_quat_encode_u32 = CodeChunk.from(

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_interpolate_probe_irradiance8.js

@@ -1,5 +1,5 @@
 import { CodeChunk } from "../../../compiler/CodeChunk.js";
-import { chunk_sh3_color_get_irradiance_at } from "../../spherical_harmonics/chunk_sh3_color_get_irradiance_at.js";
+import { chunk_sh2_color_get_irradiance_at } from "../../spherical_harmonics/chunk_sh2_color_get_irradiance_at.js";
 import { chunk_lpv_probe_get_data } from "./chunk_lpv_probe_get_data.js";
 
 /**
@@ -15,23 +15,23 @@ fn lpv_interpolate_probe_irradiance8(
     probe_indices: array<u32, 8>
 ) -> vec3<f32> {
 
-    var combined_sh :array<vec3<f32>, 9>;
+    var combined_sh :array<vec3<f32>, 4>;
 
     for( var i = 0; i < 8; i++){
     
         let sh3 = lpv_probe_get_data(probe_indices[i]);
      
-        for( var c = 0; c < 9; c++){
+        for( var c = 0; c < 4; c++){
             combined_sh[c] += sh3[c] * weights[i];
         }
     }
 
-    let projected = sh3_color_get_irradiance_at(direction, combined_sh);
+    let projected = sh2_color_get_irradiance_at(direction, combined_sh);
     
     return projected;
 }
     `, [
-        chunk_sh3_color_get_irradiance_at,
+        chunk_sh2_color_get_irradiance_at,
         chunk_lpv_probe_get_data,
     ]
 )

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_lpv_mesh_interpolate_probe.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe.js"],"names":[],"mappings":"AAKA,+CAcE;AAEF,yDA4BE;0BAjDwB,gCAAgC"}
+{"version":3,"file":"chunk_lpv_mesh_interpolate_probe.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe.js"],"names":[],"mappings":"AAKA,+CAcE;AAEF,yDA8BE;0BAnDwB,gCAAgC"}

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe.js

@@ -22,7 +22,7 @@ fn sh3_to_sh2_color(input: array<vec3<f32>,9>) -> array< vec3<f32>, 4 >{
 export const chunk_lpv_mesh_interpolate_probe = CodeChunk.from(
     //language=WGSL
     `
-fn lpv_mesh_interpolate_probe(weights: vec4<f32>, tet:u32) -> array< vec3<f32>, 9 >{
+fn lpv_mesh_interpolate_probe(weights: vec4<f32>, tet:u32) -> array< vec3<f32>, 4 >{
     let vertices = lpv_mesh_get_vertices(tet);
 
     let probe0 = lpv_probe_get_data(vertices[0]);
@@ -30,9 +30,11 @@ fn lpv_mesh_interpolate_probe(weights: vec4<f32>, tet:u32) -> array< vec3<f32>,
     let probe2 = lpv_probe_get_data(vertices[2]);
     let probe3 = lpv_probe_get_data(vertices[3]);
 
-    var result: array<vec3<f32>,9>;
 
-    for (var i = 0; i < 9; i++) {
+
+    var result: array<vec3<f32>, 4>;
+
+    for (var i = 0; i < 4; i++) {
 
         result[i] = probe0[i] * weights[0]
         + probe1[i] * weights[1]

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe_irradiance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_lpv_mesh_interpolate_probe_irradiance.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe_irradiance.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH,0DAFU,SAAS,CAiCjB;0BA1CwB,gCAAgC"}
+{"version":3,"file":"chunk_lpv_mesh_interpolate_probe_irradiance.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe_irradiance.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH,0DAFU,SAAS,CAoCjB;0BA7CwB,gCAAgC"}

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_mesh_interpolate_probe_irradiance.js

@@ -1,6 +1,6 @@
 import { CodeChunk } from "../../../compiler/CodeChunk.js";
 import { chunk_color_mix_4_linear } from "../../color/chunk_color_mix_4_linear.js";
-import { chunk_sh3_color_get_irradiance_at } from "../../spherical_harmonics/chunk_sh3_color_get_irradiance_at.js";
+import { chunk_sh2_color_get_irradiance_at } from "../../spherical_harmonics/chunk_sh2_color_get_irradiance_at.js";
 import { chunk_lpv_mesh_get_vertices } from "./chunk_lpv_mesh_get_vertices.js";
 import { chunk_lpv_probe_get_data } from "./chunk_lpv_probe_get_data.js";
 
@@ -25,17 +25,20 @@ fn lpv_mesh_interpolate_probe_irradiance(
     let probe2 = lpv_probe_get_data(vertices[2]);
     let probe3 = lpv_probe_get_data(vertices[3]);
         
-    let irradiance_0 = sh3_color_get_irradiance_at(direction, probe0);
-    let irradiance_1 = sh3_color_get_irradiance_at(direction, probe1);
-    let irradiance_2 = sh3_color_get_irradiance_at(direction, probe2);
-    let irradiance_3 = sh3_color_get_irradiance_at(direction, probe3);
+    let irradiance_0 = sh2_color_get_irradiance_at(direction, probe0);
+    let irradiance_1 = sh2_color_get_irradiance_at(direction, probe1);
+    let irradiance_2 = sh2_color_get_irradiance_at(direction, probe2);
+    let irradiance_3 = sh2_color_get_irradiance_at(direction, probe3);
+
+
+
     
     let perceptual_mix = color_mix_4_linear(irradiance_0, irradiance_1, irradiance_2, irradiance_3, weights);
 
     return perceptual_mix;
 }
 `, [
-        chunk_sh3_color_get_irradiance_at,
+        chunk_sh2_color_get_irradiance_at,
         chunk_lpv_mesh_get_vertices,
         chunk_lpv_probe_get_data,
         chunk_color_mix_4_linear,

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_sample_sh3_at.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_lpv_sample_sh3_at.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_sample_sh3_at.js"],"names":[],"mappings":"AAKA,gDAgCE;0BArCwB,gCAAgC"}
+{"version":3,"file":"chunk_lpv_sample_sh3_at.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_sample_sh3_at.js"],"names":[],"mappings":"AAKA,gDA2BE;0BAhCwB,gCAAgC"}

package/src/shade/renderer/shader/chunk/light/lpv/chunk_lpv_sample_sh3_at.js

@@ -1,38 +1,33 @@
-import { CodeChunk } from "../../../compiler/CodeChunk.js";
-import { chunk_lpv_mesh_interpolate_probe } from "./chunk_lpv_mesh_interpolate_probe.js";
-import { chunk_lpv_mesh_lookup_nearest_cell } from "./chunk_lpv_mesh_lookup_nearest_cell.js";
-import { INVALID_TET_DECLARATION } from "./INVALID_TET_DECLARATION.js";
-
-export const chunk_lpv_sample_sh3_at = CodeChunk.from(
-    //language=WGSL
-    `
-fn lpv_sample_sh3_at(position:vec3<f32>) -> array< vec3<f32>, 9 >{
-    var barycentric_coordinates: vec4<f32>;
-    
-    let tet = lpv_mesh_lookup_nearest_cell(position, &barycentric_coordinates);
-
-    if(tet == INVALID_TET){
-    
-        return array< vec3<f32>, 9 >(
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-             vec3(0.0),
-        );
-        
-    }else{
-    
-        return lpv_mesh_interpolate_probe(barycentric_coordinates, tet);
-    }
-}
-    `, [
-        chunk_lpv_mesh_interpolate_probe,
-        chunk_lpv_mesh_lookup_nearest_cell,
-        INVALID_TET_DECLARATION,
-    ]
-);
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+import { chunk_lpv_mesh_interpolate_probe } from "./chunk_lpv_mesh_interpolate_probe.js";
+import { chunk_lpv_mesh_lookup_nearest_cell } from "./chunk_lpv_mesh_lookup_nearest_cell.js";
+import { INVALID_TET_DECLARATION } from "./INVALID_TET_DECLARATION.js";
+
+export const chunk_lpv_sample_sh3_at = CodeChunk.from(
+    //language=WGSL
+    `
+fn lpv_sample_sh3_at(position:vec3<f32>) -> array< vec3<f32>, 4 >{
+    var barycentric_coordinates: vec4<f32>;
+    
+    let tet = lpv_mesh_lookup_nearest_cell(position, &barycentric_coordinates);
+
+    if(tet == INVALID_TET){
+    
+        return array< vec3<f32>, 4 >(
+             vec3(0.0),
+             vec3(0.0),
+             vec3(0.0),
+             vec3(0.0),
+        );
+        
+    }else{
+    
+        return lpv_mesh_interpolate_probe(barycentric_coordinates, tet);
+    }
+}
+    `, [
+        chunk_lpv_mesh_interpolate_probe,
+        chunk_lpv_mesh_lookup_nearest_cell,
+        INVALID_TET_DECLARATION,
+    ]
+);

package/src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_mat2x4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_sample_discrete_wrs_mat2x4.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_mat2x4.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,+CAFU,SAAS,CA6FlB;0BApGyB,gCAAgC"}
+{"version":3,"file":"chunk_sample_discrete_wrs_mat2x4.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_mat2x4.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,+CAFU,SAAS,CAgGlB;0BAvGyB,gCAAgC"}

package/src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_mat2x4.js

@@ -18,12 +18,15 @@ fn sample_discrete_wrs_mat2x4(
     var selected_idx = 0;
     var sum_wt = weights[0].x; // Start with first weight
 
+    // while every weight so far is zero so is the sum, and its share would be NaN, which would turn the
+    // noise to NaN and leave the first item drawn whatever its weight: such a step takes nothing
+
     // Note: The loop effectively starts checking from the second item (index 1),
     // because the first item (index 0) initializes the reservoir.
     
     // Check index 1
     sum_wt += weights[0].y;
-    var p = weights[0].y / sum_wt;
+    var p = select(0.0, weights[0].y / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 1;
         *u = *u / p;
@@ -33,7 +36,7 @@ fn sample_discrete_wrs_mat2x4(
 
     // Check index 2
     sum_wt += weights[0].z;
-    p = weights[0].z / sum_wt;
+    p = select(0.0, weights[0].z / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 2;
         *u = *u / p;
@@ -43,7 +46,7 @@ fn sample_discrete_wrs_mat2x4(
 
     // Check index 3
     sum_wt += weights[0].w;
-    p = weights[0].w / sum_wt;
+    p = select(0.0, weights[0].w / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 3;
         *u = *u / p;
@@ -57,7 +60,7 @@ fn sample_discrete_wrs_mat2x4(
     
     // Check index 4
     sum_wt += weights[1].x;
-    p = weights[1].x / sum_wt;
+    p = select(0.0, weights[1].x / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 4;
         *u = *u / p;
@@ -67,7 +70,7 @@ fn sample_discrete_wrs_mat2x4(
     
     // Check index 5
     sum_wt += weights[1].y;
-    p = weights[1].y / sum_wt;
+    p = select(0.0, weights[1].y / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 5;
         *u = *u / p;
@@ -77,7 +80,7 @@ fn sample_discrete_wrs_mat2x4(
 
     // Check index 6
     sum_wt += weights[1].z;
-    p = weights[1].z / sum_wt;
+    p = select(0.0, weights[1].z / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 6;
         *u = *u / p;
@@ -87,7 +90,7 @@ fn sample_discrete_wrs_mat2x4(
 
     // Check index 7
     sum_wt += weights[1].w;
-    p = weights[1].w / sum_wt;
+    p = select(0.0, weights[1].w / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 7;
         *u = *u / p;

package/src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_vec4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_sample_discrete_wrs_vec4.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_vec4.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,6CAFU,SAAS,CA8ClB;0BArDyB,gCAAgC"}
+{"version":3,"file":"chunk_sample_discrete_wrs_vec4.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_vec4.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,6CAFU,SAAS,CAiDlB;0BAxDyB,gCAAgC"}

package/src/shade/renderer/shader/chunk/random/reservoir/chunk_sample_discrete_wrs_vec4.js

@@ -15,12 +15,15 @@ fn sample_discrete_wrs_vec4(weights: vec4<f32>, u: ptr<function,f32>) -> i32 {
     var selected_idx = 0;
     var sum_wt = weights.x; // Start with first weight
 
+    // while every weight so far is zero so is the sum, and its share would be NaN, which would turn the
+    // noise to NaN and leave the first item drawn whatever its weight: such a step takes nothing
+
     // Note: The loop effectively starts checking from the second item (index 1),
     // because the first item (index 0) initializes the reservoir.
     
     // Check index 1
     sum_wt += weights.y;
-    var p = weights.y / sum_wt;
+    var p = select(0.0, weights.y / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 1;
         *u = *u / p;
@@ -30,7 +33,7 @@ fn sample_discrete_wrs_vec4(weights: vec4<f32>, u: ptr<function,f32>) -> i32 {
 
     // Check index 2
     sum_wt += weights.z;
-    p = weights.z / sum_wt;
+    p = select(0.0, weights.z / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 2;
         *u = *u / p;
@@ -40,7 +43,7 @@ fn sample_discrete_wrs_vec4(weights: vec4<f32>, u: ptr<function,f32>) -> i32 {
 
     // Check index 3
     sum_wt += weights.w;
-    p = weights.w / sum_wt;
+    p = select(0.0, weights.w / sum_wt, sum_wt > 0.0);
     if (*u < p) {
         selected_idx = 3;
         *u = *u / p;

package/src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.d.ts

@@ -1,3 +1,25 @@
+/**
+ * The nearest hit of a ray through the meshes' fields, and the `meshes` row it is on:
+ *
+ * ```wgsl
+ * fn scene_sdf_raymarch_hit(ray: Ray) -> SceneSDFHit // t = F32_MAX for none
+ * ```
+ *
+ * The TLAS is walked nearest box first; in every instance it meets, the ray marches that geometry's
+ * sparse field at level 0 in its local space, whose t is the world one.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_scene_sdf_raymarch_hit: CodeChunk;
+/**
+ * {@link chunk_scene_sdf_raymarch_hit}'s distance alone:
+ *
+ * ```wgsl
+ * fn scene_sdf_raymarch(ray: Ray) -> f32 // F32_MAX for no hit
+ * ```
+ *
+ * @type {CodeChunk}
+ */
 export const chunk_scene_sdf_raymarch: CodeChunk;
 import { CodeChunk } from "../../compiler/CodeChunk.js";
 //# sourceMappingURL=chunk_scene_sdf_raymarch.d.ts.map

package/src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_scene_sdf_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.js"],"names":[],"mappings":"AAkBA,iDAiGE;0BAjHwB,6BAA6B"}
+{"version":3,"file":"chunk_scene_sdf_raymarch.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;GAWG;AACH,2CAFU,SAAS,CAiGjB;AAEF;;;;;;;;GAQG;AACH,uCAFU,SAAS,CAYjB;0BA5IwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/sdf/chunk_scene_sdf_raymarch.js

@@ -1,5 +1,6 @@
 import { chunk_scene_database_access } from "../../../scene/chunk_scene_database_access.js";
-import { chunk_tile_atlas_slot_origin } from "../../../texture/atlas/chunk_tile_atlas_slot_origin.js";
+import { chunk_mesh_sdf_raymarch } from "../../../geometry/sdf/chunk_mesh_sdf_raymarch.js";
+import { chunk_mesh_sdf_header } from "../../../geometry/sdf/chunk_mesh_sdf_sample.js";
 import { CodeChunk } from "../../compiler/CodeChunk.js";
 import { BVH_NULL_NODE_DEFINITION } from "../bvh/BVH_NULL_NODE_DEFINITION.js";
 import { BVH_TRAVERSAL_STACK_SIZE } from "../bvh/BVH_TRAVERSAL_STACK_SIZE.js";
@@ -7,25 +8,40 @@ import { BVH_TRAVERSAL_STACK_SIZE } from "../bvh/BVH_TRAVERSAL_STACK_SIZE.js";
 import { chunk_aabb3_distance_to_ray } from "../geometry/aabb3/chunk_aabb3_distance_to_ray.js";
 import { chunk_aabb3_unsigned_distance_to_point } from "../geometry/aabb3/chunk_aabb3_unsigned_distance_to_point.js";
 import { chunk_array_to_aabb3 } from "../geometry/aabb3/chunk_array_to_aabb3.js";
-import { chunk_mat4_extract_scale } from "../geometry/mat4/chunk_mat4_extract_scale.js";
 import { chunk_mat4_inverse } from "../geometry/mat4/chunk_mat4_inverse.js";
 import { chunk_ray_transform_m4 } from "../geometry/ray/chunk_ray_transform_m4.js";
 import { RAY_STRUCT } from "../geometry/ray/RAY_STRUCT.js";
-import { chunk_max_v3 } from "../geometry/vec3/chunk_max_v3.js";
 import { F32_MAX_DEFINITION } from "../math/F32_MAX_DEFINITION.js";
-import { chunk_sdf_raymarch } from "./chunk_sdf_texture_raycast.js";
-import { chunk_sdf_texture_region_sample_linear_uv } from "./chunk_sdf_texture_region_sample_linear_uv.js";
 
-export const chunk_scene_sdf_raymarch = CodeChunk.from(
+/**
+ * The nearest hit of a ray through the meshes' fields, and the `meshes` row it is on:
+ *
+ * ```wgsl
+ * fn scene_sdf_raymarch_hit(ray: Ray) -> SceneSDFHit // t = F32_MAX for none
+ * ```
+ *
+ * The TLAS is walked nearest box first; in every instance it meets, the ray marches that geometry's
+ * sparse field at level 0 in its local space, whose t is the world one.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_scene_sdf_raymarch_hit = CodeChunk.from(
     //language=WGSL
     `
-fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
+struct SceneSDFHit {
+    t: f32,
+    mesh: u32,
+}
+
+fn scene_sdf_raymarch_hit(ray:${RAY_STRUCT.wgsl_ref}) -> SceneSDFHit{
     var node_index = tlas.root;
 
     var stack:array<u32, ${BVH_TRAVERSAL_STACK_SIZE}>;
     var pointer  = 1u;
         
-    var best_distance = F32_MAX;
+    var best: SceneSDFHit;
+
+    best.t = F32_MAX;
         
     for(;pointer > 0 && pointer <= ${BVH_TRAVERSAL_STACK_SIZE};){
             
@@ -33,7 +49,7 @@ fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
         
         let distance_to_node = aabb_distance_to_ray(node.bounds, ray);
         
-        if(distance_to_node > best_distance){
+        if(distance_to_node > best.t){
             
             pointer --;
             node_index = stack[pointer];
@@ -64,31 +80,25 @@ fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
             let mesh = scene_read_mesh(&scene_database, mesh_id);
             let node = scene_read_node(&scene_database, mesh.node);
 
-            let geometry_ray = ray_transform_m4(ray, mat4_inverse(node.global));
+            /*
+             The ray enters the instance with its direction made unit there, so a hit's parameter
+             there is in the instance's units: a stretch of the world's, the length of the world
+             direction under the inverse. Over the stretch it is a world distance again.
+            */
+            let to_local = mat4_inverse(node.global);
+            let geometry_ray = ray_transform_m4(ray, to_local);
+            let stretch = length((to_local * vec4<f32>(ray.direction, 0.0)).xyz);
 
-            let geometry = geometries[mesh.geometry];
+            let local_t = mesh_sdf_raymarch(mesh_sdf_header(mesh.geometry), 0u, geometry_ray);
+            let distance = select(local_t / stretch, -1.0, local_t < 0.0);
 
-            let geometry_bounds = array_to_aabb3(geometry.bounding_box);
-            let geometry_bounds_span = geometry_bounds.max - geometry_bounds.min;
-
-            // normalize position
-
-            let offset = tile_atlas_slot_origin(mesh.geometry, settings.sdf_atlas_resolution.xy, vec3(settings.sdf_tile_resolution));
-            let geometry_distance = sdf_raymarch(geometry_ray, texture_sdf,  offset,  vec3(settings.sdf_tile_resolution));
-
-            // move point to world-space
-
-            let geometry_scale = max_v3( mat4_extract_scale(node.global) );
-            
-            // re-scale distance
-            let distance = geometry_scale * geometry_distance;
-            
-            if(distance >= best_distance){
+            if(distance < 0.0 || distance >= best.t){
                 continue;
             }
             
             // found a good hit
-            best_distance = distance;
+            best.t = distance;
+            best.mesh = mesh_id;
             
             
         }
@@ -96,21 +106,39 @@ fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
     }
         
        
-    return best_distance;
+    return best;
 }
     `, [
         BVH_NULL_NODE_DEFINITION,
-        chunk_max_v3,
-        chunk_mat4_extract_scale,
         chunk_mat4_inverse,
         chunk_aabb3_distance_to_ray,
         chunk_aabb3_unsigned_distance_to_point,
-        chunk_tile_atlas_slot_origin,
-        chunk_sdf_texture_region_sample_linear_uv,
         chunk_array_to_aabb3,
         chunk_ray_transform_m4,
         F32_MAX_DEFINITION,
-        chunk_sdf_raymarch,
+        chunk_mesh_sdf_header,
+        chunk_mesh_sdf_raymarch,
         chunk_scene_database_access,
     ]
+);
+
+/**
+ * {@link chunk_scene_sdf_raymarch_hit}'s distance alone:
+ *
+ * ```wgsl
+ * fn scene_sdf_raymarch(ray: Ray) -> f32 // F32_MAX for no hit
+ * ```
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_scene_sdf_raymarch = CodeChunk.from(
+    //language=WGSL
+    `
+fn scene_sdf_raymarch(ray:${RAY_STRUCT.wgsl_ref}) -> f32{
+    return scene_sdf_raymarch_hit(ray).t;
+}
+    `, [
+        RAY_STRUCT.declaration_chunk,
+        chunk_scene_sdf_raymarch_hit,
+    ]
 );

package/src/shade/renderer/shader/compiler/CodeChunk.d.ts

@@ -26,7 +26,7 @@ export class CodeChunk {
      * @param {Map<CodeChunk, CodeChunk>} memo what each chunk of this call's graph became
      * @returns {CodeChunk}
      */
-    static "__#77@#specialize"(chunk: CodeChunk, set: ShaderSwitchSet, memo: Map<CodeChunk, CodeChunk>): CodeChunk;
+    static "__#78@#specialize"(chunk: CodeChunk, set: ShaderSwitchSet, memo: Map<CodeChunk, CodeChunk>): CodeChunk;
     get isCodeChunk(): boolean;
     /**
      *

package/src/shade/renderer/shader/compiler/ShaderSwitch.d.ts

@@ -26,7 +26,7 @@ export class ShaderSwitch {
      * @param {number|boolean} default_value
      * @returns {ShaderSwitch}
      */
-    static "__#75@#make"(label: string, values: ReadonlyArray<number | boolean>, names: ReadonlyArray<string>, default_value: number | boolean): ShaderSwitch;
+    static "__#76@#make"(label: string, values: ReadonlyArray<number | boolean>, names: ReadonlyArray<string>, default_value: number | boolean): ShaderSwitch;
     /**
      * A switch over the members of an engine enum: a plain object of names to distinct integers, one of
      * which is `0` — the value every switch has until a set says otherwise.

package/src/shade/renderer/shader/compiler/ShaderSwitchSet.d.ts

@@ -17,7 +17,7 @@ export class ShaderSwitchSet {
      * @param {Array<number|boolean>} values none of them its switch's default
      * @returns {ShaderSwitchSet}
      */
-    static "__#76@#intern"(switches: ShaderSwitch[], values: Array<number | boolean>): ShaderSwitchSet;
+    static "__#77@#intern"(switches: ShaderSwitch[], values: Array<number | boolean>): ShaderSwitchSet;
     /**
      * The values as one string, the same for the same values. What interning is keyed by.
      * @returns {string}

package/src/shade/renderer/shader/resource/ShaderResourceDescriptor.d.ts

@@ -16,7 +16,7 @@ export class ShaderResourceDescriptor {
      * @param {WebGPUType|string} type
      * @returns {ShaderResourceDescriptor}
      */
-    static "__#74@#buffer"(name: string, type: WebGPUType | string): ShaderResourceDescriptor;
+    static "__#75@#buffer"(name: string, type: WebGPUType | string): ShaderResourceDescriptor;
     /**
      * A uniform buffer declaration.
      *

package/src/shade/renderer/shader/resource/ShaderResourceSetDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderResourceSetDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shader/resource/ShaderResourceSetDescriptor.js"],"names":[],"mappings":"AAyIA;IAoBI;;OAEG;IACH;cAFoB,MAAM;cAAQ,UAAU;MAI3C;IAED;;;;;OAKG;IACH,4BAMC;IAED;;;;;;;;;;;;OAYG;IACH,mBALW,MAAM,SACN,UAAU,GAAC,MAAM,GAEf,IAAI,CAoDhB;IAED;;;OAGG;IACH,8CAEC;IAGD;;;OAGG;IACH,6CAEC;IAaD;;;;OAIG;IACH;;;;;;;;;;;OAWG;IACH,sBAHW,MAAM,GACJ,OAAO,CAInB;IAED,+FAYC;IAED;;;;;;OAMG;IACH;QAJ4B,KAAK,GAAtB,MAAM;QACW,KAAK,GAAtB,MAAM;QACJ,6BAA6B,CAsBzC;IAED;;;;OAIG;IACH,gBAHW,6BAA6B,GAC3B,OAAO,CAQnB;IAED;;;OAGG;IACH,qBAFW,iBAAe,MAAM,QAW/B;IAED;;OAEG;IACH,oCAFa,wBAAwB,CAiBpC;IAED;;;OAGG;IACH,yBAFY,EAAE,EAAE,CAcf;IAED;;;;OAIG;IACH,8BAHW,iBAAe,MAAM,GACnB,wBAAwB,CAMpC;IAED;;;;;OAKG;IACH,qCAHW,sBAAsB,GACpB,oBAAoB,EAAE,CAgBlC;IAED;;;OAGG;IACH,qBAFY,SAAS,CAwGpB;IAED;;;;;;;;;;;;;;;OAeG;IACH,iCAHW,YAAY,GACV,OAAO,CAwFnB;;CACJ;;eA2BS,SAAS,2BAA2B,CAAC;;2BA5oBlC,OAAO,yCAAyC,EAAE,YAAY;qCAC9D,OAAO,2CAA2C,EAAE,sBAAsB;yBAC1E,OAAO,uBAAuB,EAAE,UAAU;8CALT,oCAAoC;yCAZzC,0DAA0D;0BAIzE,0BAA0B"}
+{"version":3,"file":"ShaderResourceSetDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shader/resource/ShaderResourceSetDescriptor.js"],"names":[],"mappings":"AA2IA;IAoBI;;OAEG;IACH;cAFoB,MAAM;cAAQ,UAAU;MAI3C;IAED;;;;;OAKG;IACH,4BAMC;IAED;;;;;;;;;;;;OAYG;IACH,mBALW,MAAM,SACN,UAAU,GAAC,MAAM,GAEf,IAAI,CAoDhB;IAED;;;OAGG;IACH,8CAEC;IAGD;;;OAGG;IACH,6CAEC;IAaD;;;;OAIG;IACH;;;;;;;;;;;OAWG;IACH,sBAHW,MAAM,GACJ,OAAO,CAInB;IAED,+FAYC;IAED;;;;;;OAMG;IACH;QAJ4B,KAAK,GAAtB,MAAM;QACW,KAAK,GAAtB,MAAM;QACJ,6BAA6B,CAsBzC;IAED;;;;OAIG;IACH,gBAHW,6BAA6B,GAC3B,OAAO,CAQnB;IAED;;;OAGG;IACH,qBAFW,iBAAe,MAAM,QAW/B;IAED;;OAEG;IACH,oCAFa,wBAAwB,CAiBpC;IAED;;;OAGG;IACH,yBAFY,EAAE,EAAE,CAcf;IAED;;;;OAIG;IACH,8BAHW,iBAAe,MAAM,GACnB,wBAAwB,CAMpC;IAED;;;;;OAKG;IACH,qCAHW,sBAAsB,GACpB,oBAAoB,EAAE,CAgBlC;IAED;;;OAGG;IACH,qBAFY,SAAS,CAqHpB;IAED;;;;;;;;;;;;;;;OAeG;IACH,iCAHW,YAAY,GACV,OAAO,CAwFnB;;CACJ;;eA2BS,SAAS,2BAA2B,CAAC;;2BAzpBlC,OAAO,yCAAyC,EAAE,YAAY;qCAC9D,OAAO,2CAA2C,EAAE,sBAAsB;yBAC1E,OAAO,uBAAuB,EAAE,UAAU;8CALT,oCAAoC;yCAdzC,0DAA0D;0BAKzE,0BAA0B"}