@woosh/meep-engine 3.61.2 → 3.62.0

package/src/shade/renderer/geometry/virtual/runtime/cut/chunk_vgeo_cut_instance.js

@@ -1,4 +1,5 @@
-import { chunk_mat3_singular_values } from "../../../../shader/chunk/geometry/mat3/chunk_mat3_singular_values.js";
+import { chunk_compute_normal_matrix_from_m4 } from "../../../../shader/chunk/geometry/mat4/chunk_compute_normal_matrix_from_m4.js";
+import { chunk_mat4_extract_scale } from "../../../../shader/chunk/geometry/mat4/chunk_mat4_extract_scale.js";
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import { VGEO_GEOMETRY_ROW_OFFSET } from "../layout/VGEO_GEOMETRY_ROW_OFFSET.js";
 import { VGEO_GEOMETRY_ROW_WORDS } from "../layout/VGEO_GEOMETRY_ROW_WORDS.js";
@@ -10,15 +11,21 @@ import { VGEO_INSTANCE_WORDS } from "../layout/VGEO_INSTANCE_WORDS.js";
  *
  * ```wgsl
  * fn vg_instance_stretch(global: mat4x4<f32>) -> vec2<f32>
+ * fn vg_instance_eye(global: mat4x4<f32>, position: vec3<f32>) -> vec4<f32>
  * fn vg_instance_record(mesh_index: u32, geometry_row: u32, capacity: u32) -> u32
  * fn vg_store(base: u32, field: u32, value: f32)
  * ```
  *
- * `vg_instance_stretch` is the largest and smallest stretch the transform applies to any direction,
- * or zero for a transform that flattens the instance. `vg_instance_record` reserves a record under
+ * `vg_instance_stretch` is the longest and shortest column of the transform's linear part, or zero
+ * for a column of zeros. That is the largest and smallest stretch it applies to any direction when
+ * the columns are orthogonal, a rotation times any scale; a shear stretches beyond its columns and
+ * is not accounted for, as in Nanite. (`mat3_singular_values` accounts for it, at many times the
+ * cost.) `vg_instance_eye` is `position` in the
+ * instance's object space, scaled by w: xyz / w is the eye, and w is the |det| that division takes,
+ * not positive for a transform without an inverse. `vg_instance_record` reserves a record under
  * `capacity`, writes the instance's mesh row and its geometry's root page, lookup and claim width,
  * and returns the record's first word, or {@link VG_INSTANCE_RECORD_NONE} when the records are full.
- * What the instance is cut against (its eye, projection and volume) is the collect's own.
+ * What the instance is cut against (its projection and volume) is the collect's own.
  *
  * Requires the importing shader to declare `instances`, `claim_widths` and `vg_geometries`.
  *
@@ -36,42 +43,43 @@ fn vg_store(base: u32, field: u32, value: f32) {
 }
 
 fn vg_instance_stretch(global: mat4x4<f32>) -> vec2<f32> {
-    let linear = mat3x3<f32>(global[0].xyz, global[1].xyz, global[2].xyz);
-
-    let stretch = mat3_singular_values(linear);
+    let lengths = mat4_extract_scale(global);
+    let stretch = vec2<f32>(max(lengths.x, max(lengths.y, lengths.z)), min(lengths.x, min(lengths.y, lengths.z)));
 
     /*
-     A singular transform — an instance scaled to zero in some direction. mat4_inverse says so
-     by dividing by a zero determinant, and the NaN that comes back makes **every** comparison
-     in vg_project and the culls fail open, so one zero-scaled instance draws its whole
-     resident set. It covers nothing, so dropping it is also the right picture.
-
-     **The determinant is the test, and sigma_min alone was not.** This guard used to be
-     !(sigma_min > 0) on its own, and the closed form's own doc offered sigma_min as a
-     degeneracy test — true in exact arithmetic, false in f32. An axis-aligned flatten makes
-     MtM exactly diagonal and takes the exact branch, which does return zero. A ROTATED one
-     takes the trigonometric branch, where sigma_min is a difference of nearly equal numbers
-     with an absolute error of about sqrt(eps_f32) * sigma_max — so it came back near 1e-4
-     rather than 0, and thirty-six of forty rotated zero-scale instances passed this line with
-     a NaN eye and a projection scale of 6.2e10 behind it (REVIEW_LEDGER M3, re-review
-     2026-09-12). The determinant does not have that problem: a flattened instance has one
-     exactly-zero column at every rotation, and every term of the expansion carries a factor
-     from it. It is also, exactly, the number mat4_inverse divides by.
-
-     sigma_min is kept beside it because it is not redundant: a matrix that is merely very
-     close to singular has a non-zero determinant and can still report sigma_min as zero, and
-     a ratio of the two would then be an infinity rather than a correction.
-
-     Both written as !(x > 0) rather than x <= 0 so that a NaN — which compares false against
-     everything — is caught rather than passed through.
+     A column of zeros, a scale of zero, answers zero, which the collect drops: the projection
+     divides by the shortest column. Written !(x > 0) rather than x <= 0 so that a NaN, which
+     compares false against everything, is caught rather than passed through.
      */
-    if (!(abs(determinant(linear)) > 0.0) || !(stretch.y > 0.0)) {
+    if (!(stretch.y > 0.0)) {
         return vec2<f32>(0.0);
     }
 
     return stretch;
 }
 
+fn vg_instance_eye(global: mat4x4<f32>, position: vec3<f32>) -> vec4<f32> {
+    /*
+     An affine transform's inverse has adj(L) / det(L) for its linear part, and
+     compute_normal_matrix_from_m4 is adj(L) transposed, with det's sign folded in. So the eye is
+     transpose(normal) * (position - t) / |det|, and |det| = dot(l0, normal[0]) is the number it is
+     divided by. That number is w, for the collect to test before it divides. A test of any other
+     expansion of the determinant can pass where this one is zero: under a flattened parent a
+     rotated child's columns are all non-zero yet dependent, and two expansions then disagree
+     about zero. Even the sign that orients the normal matrix is a second evaluation of this dot,
+     so where the determinant is rounding noise a backend that fuses the two differently can make
+     w negative, which drops the instance.
+
+     A singular transform has no eye. The NaN that dividing by it brings makes **every**
+     comparison in vg_project and the culls fail open, so one zero-scaled instance would draw its
+     whole resident set (REVIEW_LEDGER M3). It covers nothing, so dropping it is also the right
+     picture.
+     */
+    let normal = compute_normal_matrix_from_m4(global);
+
+    return vec4<f32>(transpose(normal) * (position - global[3].xyz), dot(global[0].xyz, normal[0]));
+}
+
 fn vg_instance_record(mesh_index: u32, geometry_row: u32, capacity: u32) -> u32 {
     let slot = atomicAdd(&claim_widths.count, 1u);
 
@@ -108,4 +116,4 @@ fn vg_instance_record(mesh_index: u32, geometry_row: u32, capacity: u32) -> u32
 
     return base;
 }
-`, [chunk_mat3_singular_values]);
+`, [chunk_mat4_extract_scale, chunk_compute_normal_matrix_from_m4]);

package/src/shade/renderer/geometry/virtual/runtime/cut/shader_vgeo_cut_collect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_vgeo_cut_collect.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/cut/shader_vgeo_cut_collect.js"],"names":[],"mappings":"AA6NA,oDAIG;8BA3N2B,qCAAqC"}
+{"version":3,"file":"shader_vgeo_cut_collect.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/geometry/virtual/runtime/cut/shader_vgeo_cut_collect.js"],"names":[],"mappings":"AA4NA,oDAIG;8BA1N2B,qCAAqC"}

package/src/shade/renderer/geometry/virtual/runtime/cut/shader_vgeo_cut_collect.js

@@ -6,7 +6,6 @@ import { COLLECTION_U32_STRUCT_READ } from "../../../../gpu_primitive/COLLECTION
 import { COLLECTION_U32_STRUCT_WRITE } from "../../../../gpu_primitive/COLLECTION_U32_STRUCT_WRITE.js";
 import { ComputeShader } from "../../../../shader/ComputeShader.js";
 import { GEOMETRY_METADATA_STRUCT } from "../../../GEOMETRY_METADATA_STRUCT.js";
-import { chunk_mat4_inverse } from "../../../../shader/chunk/geometry/mat4/chunk_mat4_inverse.js";
 import { chunk_scene_database_access } from "../../../../scene/chunk_scene_database_access.js";
 import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
 import { VGEO_CUT_STAT } from "../layout/VGEO_CUT_STAT.js";
@@ -131,19 +130,25 @@ fn main(@builtin(global_invocation_id) global_id: vec3<u32>) {
     /*
      In perspective, error and distance are both object-space, so a **uniform** scale cancels out of
      r_e * k / d exactly and needs no term at all. A non-uniform one does not, and the correction is
-     the ratio of the largest stretch this transform applies to any direction to the smallest —
-     which is the ratio of its singular values, not of its column lengths. A shear has unit columns
-     and stretches space without bound, so column lengths report 1 and under-refine, which is the
-     direction a conservative correction is not allowed to fail in.
+     the ratio of the longest column to the shortest. Those are the transform's largest and smallest
+     stretch exactly when the columns are orthogonal, a rotation times any scale. A shear stretches
+     space beyond its columns, so a sheared instance under-refines: accepted, as Nanite accepts it,
+     for a correction that costs three lengths.
 
      An orthographic view has no distance for a scale to cancel against: an object-space error
-     becomes world units by the largest stretch, and the correction is sigma_max alone. The weight
-     picks between them without a branch, and at w = 1 the expression is today's x / y exactly.
+     becomes world units by the largest stretch, and the correction is the longest column alone. The
+     weight picks between them without a branch, and at w = 1 the expression is x / y exactly.
      */
     let stretch = vg_instance_stretch(node.global);
 
-    // a transform that flattens the instance, which vg_instance_stretch answers with zero
-    if (!(stretch.y > 0.0)) {
+    // the camera's position in this instance's object space, out of the camera's own world transform
+    let eye = vg_instance_eye(node.global, camera.transform[3].xyz);
+
+    /*
+     A transform that flattens the instance, which vg_instance_stretch answers with zero, or that
+     has no inverse to take the eye through: eye.w is the very determinant the eye is divided by.
+     */
+    if (!(stretch.y > 0.0) || !(eye.w > 0.0)) {
         atomicAdd(
             &feedback[params.stats_base + ${VGEO_CUT_STAT.INSTANCES_DROPPED}u], 1u
         );
@@ -167,11 +172,6 @@ fn main(@builtin(global_invocation_id) global_id: vec3<u32>) {
         return;
     }
 
-    let to_object = mat4_inverse(node.global);
-
-    // the camera's position in this instance's object space, out of the camera's own world transform
-    let eye = to_object * vec4<f32>(camera.transform[3].xyz, 1.0);
-
     vg_store(base, ${VGEO_INSTANCE_OFFSET.EYE}u, eye.x / eye.w);
     vg_store(base, ${VGEO_INSTANCE_OFFSET.EYE + 1}u, eye.y / eye.w);
     vg_store(base, ${VGEO_INSTANCE_OFFSET.EYE + 2}u, eye.z / eye.w);
@@ -216,7 +216,6 @@ fn main(@builtin(global_invocation_id) global_id: vec3<u32>) {
 `, [
     chunk_scene_database_access,
     chunk_vgeo_cut_instance,
-    chunk_mat4_inverse,
 ]);
 
 export const shader_vgeo_cut_collect = ComputeShader.from({

package/src/shade/renderer/geometry/virtual/sdf/VGeoSDFProxies.d.ts

@@ -1,16 +1,16 @@
 /**
- * The geometry caches and cards of virtual geometry (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §7.8, §17).
- * {@link GPUGeometrySDFManager} bakes a geometry's field from its tree and captures its cards through its meshlets, and
- * a virtual geometry has neither.
+ * The geometry caches and surface caches of virtual geometry (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §7.8, §17).
+ * {@link GPUGeometrySDFManager} bakes a geometry's field and its surface caches from its tree, and a virtual geometry
+ * has none.
  *
  * Each virtual geometry whose cache is asked for gets its proxy ({@link VirtualGeometry#get_proxy}): an ordinary
  * geometry in the same local space, with its attributes. The proxy is added to the geometry manager and the virtual
  * geometry aliased to it ({@link GPUGeometrySDFManager#alias}). From there the proxy is any geometry: the virtual
- * geometry's holders hold its cache, baked from its tree, and the virtual geometry's card sets capture its layout,
- * drawn through its meshlets with the virtual geometry's own materials.
+ * geometry's holders hold its cache, baked from its tree, and the virtual geometry's surface caches follow its field,
+ * baked from its triangles with the virtual geometry's own materials.
  *
  * **The proxy's detail is its own**, not the cache's voxel's: a proxy coarser than the voxel bakes a coarser field and
- * coarser cards than the asset would. A known discrepancy, kept: a hit on virtual geometry has a material at all.
+ * coarser surface caches than the asset would. A known discrepancy, kept: a hit on virtual geometry has a material at all.
  *
  * A proxy is applied as it arrives, which is between frames: adding a geometry grows the geometry manager's buffers,
  * which a frame's passes must not find replaced under them. A virtual geometry the geometry manager lets go takes its

package/src/shade/renderer/geometry/virtual/sdf/VGeoSDFProxies.js

@@ -21,18 +21,18 @@ class VGeoProxyEntry {
 }
 
 /**
- * The geometry caches and cards of virtual geometry (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §7.8, §17).
- * {@link GPUGeometrySDFManager} bakes a geometry's field from its tree and captures its cards through its meshlets, and
- * a virtual geometry has neither.
+ * The geometry caches and surface caches of virtual geometry (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §7.8, §17).
+ * {@link GPUGeometrySDFManager} bakes a geometry's field and its surface caches from its tree, and a virtual geometry
+ * has none.
  *
  * Each virtual geometry whose cache is asked for gets its proxy ({@link VirtualGeometry#get_proxy}): an ordinary
  * geometry in the same local space, with its attributes. The proxy is added to the geometry manager and the virtual
  * geometry aliased to it ({@link GPUGeometrySDFManager#alias}). From there the proxy is any geometry: the virtual
- * geometry's holders hold its cache, baked from its tree, and the virtual geometry's card sets capture its layout,
- * drawn through its meshlets with the virtual geometry's own materials.
+ * geometry's holders hold its cache, baked from its tree, and the virtual geometry's surface caches follow its field,
+ * baked from its triangles with the virtual geometry's own materials.
  *
  * **The proxy's detail is its own**, not the cache's voxel's: a proxy coarser than the voxel bakes a coarser field and
- * coarser cards than the asset would. A known discrepancy, kept: a hit on virtual geometry has a material at all.
+ * coarser surface caches than the asset would. A known discrepancy, kept: a hit on virtual geometry has a material at all.
  *
  * A proxy is applied as it arrives, which is between frames: adding a geometry grows the geometry manager's buffers,
  * which a frame's passes must not find replaced under them. A virtual geometry the geometry manager lets go takes its
@@ -133,7 +133,7 @@ export class VGeoSDFProxies {
                     this.#asked.delete(record.index);
                     this.#failed_count++;
 
-                    console.warn('vgeo: no proxy, the geometry has no cache or cards', error);
+                    console.warn('vgeo: no proxy, the geometry has no cache or surface caches', error);
                 }
             }
         );

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_debug_draw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick4_debug_draw.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_debug_draw.js"],"names":[],"mappings":"AAoEA,mDAUE;4BAtE0B,mCAAmC"}
+{"version":3,"file":"shader_brick4_debug_draw.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_debug_draw.js"],"names":[],"mappings":"AAwEA,mDAUE;4BAvE0B,mCAAmC"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_debug_draw.js

@@ -5,6 +5,9 @@ import {
 } from "../../../../shader/chunk/camera/chunk_project_position_from_depth.js";
 import { chunk_mat4_extract_position } from "../../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import { chunk_decode_g_buffer_normal } from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
+import {
+    chunk_decode_g_buffer_face_normal
+} from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_face_normal.js";
 import { CodeChunk } from "../../../../shader/compiler/CodeChunk.js";
 import { ImageShader } from "../../../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../../../shader/resource/ShaderResourceSetDescriptor.js";
@@ -17,6 +20,7 @@ const resources = new ShaderResourceSetDescriptor();
 resources.createGroup()
     .addTexture("tDepth")
     .addTexture("tNormals", "uint")
+    .addTexture("tPBR")
     .addUniform("camera", CAMERA_UNIFORM_STRUCT)
 
 resources.createGroup()
@@ -45,10 +49,9 @@ fn main(
     
     let view_direction = normalize(camera_position_ws - position_ws);
     
-    let g_buffer_sample_normal = textureLoad(tNormals, i_coord, 0);
     
-    let shading_normal = decode_g_buffer_normal(g_buffer_sample_normal.xy);
-    let geometric_normal = decode_g_buffer_normal(g_buffer_sample_normal.zw);
+    let shading_normal = decode_g_buffer_normal(textureLoad(tNormals, i_coord, 0).x);
+    let geometric_normal = decode_g_buffer_face_normal(textureLoad(tPBR, i_coord, 0));
     
     let c = brick4_sample(
         position_ws,
@@ -62,6 +65,7 @@ fn main(
         chunk_project_position_from_depth,
         chunk_mat4_extract_position,
         chunk_decode_g_buffer_normal,
+        chunk_decode_g_buffer_face_normal,
         chunk_brick4_sample,
     ]
 );

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_diffuse.js

@@ -60,7 +60,7 @@ fn main(
     
     let g_buffer_sample_normal = textureLoad(tBentNormals, i_coord, 0);
     
-    let bent_normal = decode_g_buffer_normal(g_buffer_sample_normal.xy);
+    let bent_normal = decode_g_buffer_normal(g_buffer_sample_normal.x);
     
     let node = brick4_node_by_position(position_ws);
     

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_indirect_lighting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick4_indirect_lighting.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_indirect_lighting.js"],"names":[],"mappings":"AA0MA,0DAwBE;4BA3M0B,mCAAmC"}
+{"version":3,"file":"shader_brick4_indirect_lighting.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_indirect_lighting.js"],"names":[],"mappings":"AA4MA,0DAwBE;4BA5M0B,mCAAmC"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_indirect_lighting.js

@@ -10,6 +10,7 @@ import {
 import { chunk_mat4_extract_position } from "../../../../shader/chunk/geometry/mat4/chunk_mat4_extract_position.js";
 import { chunk_decode_g_buffer_normal } from "../../../../shader/chunk/geometry/normal/chunk_decode_g_buffer_normal.js";
 import { chunk_compute_indirect_specular } from "../../../../shader/chunk/material/chunk_compute_indirect_specular.js";
+import { chunk_decode_g_buffer_albedo } from "../../../../shader/chunk/material/chunk_decode_g_buffer_albedo.js";
 import { chunk_decode_g_buffer_metalness } from "../../../../shader/chunk/material/chunk_decode_g_buffer_metalness.js";
 import { chunk_decode_g_buffer_roughness } from "../../../../shader/chunk/material/chunk_decode_g_buffer_roughness.js";
 import { chunk_metalness_to_specular_color } from "../../../../shader/chunk/material/chunk_metalness_to_specular_color.js";
@@ -70,7 +71,7 @@ fn main(
     let g_buffer_sample_normal = textureLoad(tGBufferNormals, i_coord, 0);
     let g_buffer_bent_normal = textureLoad(tBentNormals, i_coord, 0);
 
-    let albedo = albedo_ao_sample.rgb;
+    let albedo = decode_g_buffer_albedo(albedo_ao_sample.rgb);
     let occlusion = albedo_ao_sample.a;
 
     let f_metalness = decode_g_buffer_metalness(texel_pbr);
@@ -83,8 +84,8 @@ fn main(
     let material_specularF0 = metalness_to_specular_color(f_metalness, albedo);
     let material_specularF90 = 1.0;
 
-    let shading_normal = decode_g_buffer_normal(g_buffer_sample_normal.xy);
-    let bent_normal = decode_g_buffer_normal(g_buffer_bent_normal.xy);
+    let shading_normal = decode_g_buffer_normal(g_buffer_sample_normal.x);
+    let bent_normal = decode_g_buffer_normal(g_buffer_bent_normal.x);
 
     let position_ws = project_position_from_depth(uv, texel_depth, camera.view_projection_matrix_inverse);
     let camera_position_ws = mat4_extract_position(camera.transform);
@@ -181,6 +182,7 @@ fn main(
         chunk_project_position_from_depth,
         chunk_mat4_extract_position,
         chunk_decode_g_buffer_normal,
+        chunk_decode_g_buffer_albedo,
         chunk_decode_g_buffer_metalness,
         chunk_decode_g_buffer_roughness,
         chunk_metalness_to_specular_color,

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_specular.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_brick4_specular.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_specular.js"],"names":[],"mappings":"AAwEA,iDAaE;4BA3E0B,mCAAmC"}
+{"version":3,"file":"shader_brick4_specular.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_specular.js"],"names":[],"mappings":"AAsEA,iDAaE;4BAzE0B,mCAAmC"}

package/src/shade/renderer/global_illumination/brick4/gpu/draw/shader_brick4_specular.js

@@ -48,10 +48,8 @@ fn main(
     
     let view_direction = normalize(camera_position_ws - position_ws);
     
-    let g_buffer_sample_normal = textureLoad(tNormals, i_coord, 0);
     
-    let shading_normal = decode_g_buffer_normal(g_buffer_sample_normal.xy);
-    let geometric_normal = decode_g_buffer_normal(g_buffer_sample_normal.zw);
+    let shading_normal = decode_g_buffer_normal(textureLoad(tNormals, i_coord, 0).x);
     
     let roughness = decode_g_buffer_roughness(textureLoad(tPBR, i_coord, 0));
     

package/src/shade/renderer/global_illumination/ibl/shader_diffuse_IBL.js

@@ -23,7 +23,7 @@ fn main(
 ) -> @location(0) vec4<f32> {
     let coord_i = vec2u(coord.xy);
 
-    let bent_normal_encoded = textureLoad(tBentNormals, coord_i, 0).rg;
+    let bent_normal_encoded = textureLoad(tBentNormals, coord_i, 0).x;
 
     let bent_normal = decode_g_buffer_normal(bent_normal_encoded);
 

package/src/shade/renderer/global_illumination/ibl/shader_specular_IBL.js

@@ -35,12 +35,12 @@ fn main(
     
     let roughness = decode_g_buffer_roughness(texel_pbr);
     
-    let bent_normal_encoded = textureLoad(tBentNormals, coord_i, 0).rg;
+    let bent_normal_encoded = textureLoad(tBentNormals, coord_i, 0).x;
     
     let bent_normal = decode_g_buffer_normal(bent_normal_encoded);
     
     let shading_normal = decode_g_buffer_normal(
-        textureLoad(tNormals, coord_i, 0).rg
+        textureLoad(tNormals, coord_i, 0).x
     );
     
     let texel_depth = textureLoad(tDepth,

package/src/shade/renderer/global_illumination/lpv/shader_diffuse_LPV.js

@@ -42,7 +42,7 @@ fn main(
     
     let coord_i = vec2u(coord.xy);
     
-    let bent_normal_encoded = textureLoad(tBentNormals, coord_i, 0).rg;
+    let bent_normal_encoded = textureLoad(tBentNormals, coord_i, 0).x;
     
     let bent_normal = decode_g_buffer_normal(bent_normal_encoded);
     

package/src/shade/renderer/global_illumination/probe_clipmap/GPUProbeClipmapGI.d.ts

@@ -20,10 +20,11 @@
  * readers bind while there are no probes ({@link write_sampling_bindings}): seven objects of a few bytes,
  * made on the first ask and kept until {@link destroy}.
  *
- * Each frame it holds the geometry caches and card sets its scene's SDF world draws
- * ({@link ProbeClipmapSceneHolds}), trims the caches nothing holds, and records their bake and the
- * cards' capture (§6). Leaving the mode lets go of the holds and trims nothing, so the caches are
- * there when the mode comes back (D28); the card sets go, and are captured again.
+ * Each frame it holds the geometry caches and the Model Surface Caches its scene's SDF world draws
+ * ({@link ProbeClipmapSceneHolds}), trims the geometry caches nothing holds, and records their bakes
+ * (§6). The bricks' material is gathered from the surface caches as each brick is built
+ * ({@link GPUBrickMaterial}). Leaving the mode lets go of the holds and trims nothing, so the geometry
+ * caches are there when the mode comes back (D28); the surface caches go, and are baked again.
  *
  * Until its probes are traced (§13, S4) the mode lights as IBL.
  */
@@ -33,7 +34,7 @@ export class GPUProbeClipmapGI {
      * @param {ProbeClipmapSettings} settings
      * @returns {boolean} whether it is what the settings' world cache describes, in their frustum's windows
      */
-    static "__#208@#world_cache_built_for"(world_cache: GPUProbeClipmap, settings: ProbeClipmapSettings): boolean;
+    static "__#210@#world_cache_built_for"(world_cache: GPUProbeClipmap, settings: ProbeClipmapSettings): boolean;
     /**
      * @param {GraphicsContext} graphics
      */
@@ -102,18 +103,25 @@ export class GPUProbeClipmapGI {
      * The debug view the settings ask for, in place of the frame's colour. Record it after
      * {@link graph_update} in the same frame.
      *
+     * The indirect views draw the fused indirect pass (`shader_probe_clipmap_indirect_lighting`) with one lobe
+     * alone, from `indirect`, the inputs the frame's own fused pass takes, to which they add the probes' sampling
+     * bindings ({@link write_sampling_bindings}).
+     *
      * @param {Object} options
      * @param {FrameGraph} options.graph
      * @param {GPUViewContext} options.view
      * @param {ProbeClipmapSettings} options.settings
      * @param {number[]} options.resolution
-     * @returns {number} graph handle of an `rgba8unorm` image
+     * @param {Object} options.indirect the fused indirect pass's inputs this frame, without the probes' bindings
+     * @returns {number} graph handle of the image: `rgba8unorm` for the geometry views, `rgba16float` for the
+     * indirect ones
      */
-    graph_debug_view({ graph, view, settings, resolution }: {
+    graph_debug_view({ graph, view, settings, resolution, indirect }: {
         graph: FrameGraph;
         view: GPUViewContext;
         settings: ProbeClipmapSettings;
         resolution: number[];
+        indirect: any;
     }): number;
     /**
      * Have a plugin write the world's bricks too, after the mesh provider and every provider added

package/src/shade/renderer/global_illumination/probe_clipmap/GPUProbeClipmapGI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUProbeClipmapGI.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/probe_clipmap/GPUProbeClipmapGI.js"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAwSI;;;;OAIG;IACH,oDAJW,eAAe,YACf,oBAAoB,GAClB,OAAO,CAUnB;IAzOD;;OAEG;IACH,sBAFW,eAAe,EAMzB;IAED;;OAEG;IACH,qCAEC;IAED;;OAEG;IACH,qCAEC;IAED;;OAEG;IACH,mCAEC;IAED;;OAEG;IACH,oCAEC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH;QAZ+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QACgB,QAAQ,EAAtC,oBAAoB;QACJ,KAAK,EAArB,MAAM;QACU,MAAM,EAAtB,MAAM;QACK,IAAI;QACE,MAAM,GAAvB,MAAM;QAEU,QAAQ,EAAxB,MAAM;aAmIhB;IAqDD;;;OAGG;IACH,0BAEC;IAED;;;;;;;;;OASG;IACH,4CAUC;IAwDD;;;;;;;;;;OAUG;IACH;QAN+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QACgB,QAAQ,EAAtC,oBAAoB;QACF,UAAU,EAA5B,MAAM,EAAE;QACN,MAAM,CAmBlB;IAED;;;;;OAKG;IACH,uBAFW,aAAa,QASvB;IAED;;;OAGG;IACH,0BAHW,aAAa,GACX,OAAO,CAanB;IAgED;;;OAGG;IACH,gBAuBC;IAED,gBAcC;;CACJ;yBAhlBY,OAAO,8DAA8D,EAAE,UAAU;8BACjF,OAAO,0BAA0B,EAAE,eAAe;6BAClD,OAAO,8BAA8B,EAAE,cAAc;mCACrD,OAAO,2BAA2B,EAAE,oBAAoB;4BACxD,OAAO,4BAA4B,EAAE,aAAa;gCAnB/B,4BAA4B;gCAQ5B,4BAA4B;uCAIrB,6BAA6B"}
+{"version":3,"file":"GPUProbeClipmapGI.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/global_illumination/probe_clipmap/GPUProbeClipmapGI.js"],"names":[],"mappings":"AA8BA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IAwTI;;;;OAIG;IACH,oDAJW,eAAe,YACf,oBAAoB,GAClB,OAAO,CAUnB;IA5OD;;OAEG;IACH,sBAFW,eAAe,EAMzB;IAED;;OAEG;IACH,qCAEC;IAED;;OAEG;IACH,qCAEC;IAED;;OAEG;IACH,mCAEC;IAED;;OAEG;IACH,oCAEC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH;QAZ+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QACgB,QAAQ,EAAtC,oBAAoB;QACJ,KAAK,EAArB,MAAM;QACU,MAAM,EAAtB,MAAM;QACK,IAAI;QACE,MAAM,GAAvB,MAAM;QAEU,QAAQ,EAAxB,MAAM;aAsIhB;IAqDD;;;OAGG;IACH,0BAEC;IAED;;;;;;;;;OASG;IACH,4CAUC;IAwDD;;;;;;;;;;;;;;;;OAgBG;IACH;QAR+B,KAAK,EAAzB,UAAU;QACc,IAAI,EAA5B,cAAc;QACgB,QAAQ,EAAtC,oBAAoB;QACF,UAAU,EAA5B,MAAM,EAAE;QACQ,QAAQ;QACtB,MAAM,CA8ClB;IAED;;;;;OAKG;IACH,uBAFW,aAAa,QASvB;IAED;;;OAGG;IACH,0BAHW,aAAa,GACX,OAAO,CAanB;IAqED;;;OAGG;IACH,gBA2BC;IAED,gBAcC;;CACJ;yBA1oBY,OAAO,8DAA8D,EAAE,UAAU;8BACjF,OAAO,0BAA0B,EAAE,eAAe;6BAClD,OAAO,8BAA8B,EAAE,cAAc;mCACrD,OAAO,2BAA2B,EAAE,oBAAoB;4BACxD,OAAO,4BAA4B,EAAE,aAAa;gCA1B/B,4BAA4B;gCAa5B,4BAA4B;uCAKrB,6BAA6B"}