@woosh/meep-engine 3.38.0 → 3.39.0

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_color_evaluate_vmf.js

@@ -0,0 +1,240 @@
+// GENERATED by tools/codegen/spherical_harmonics/generate_sh_chunks.mjs — do not edit by hand.
+// Regenerate from packages/meep-engine with: node tools/codegen/spherical_harmonics/generate_sh_chunks.mjs
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+
+/**
+ * A 9-band RGB spherical-harmonic function convolved with a von Mises-Fisher lobe of
+ * concentration `kappa`, evaluated at a unit `direction`:
+ * `sum over l, m of exp(-l(l+1) / (2 kappa)) * Y(l, m)(direction) * sh[l * (l + 1) + m]`.
+ *
+ * The band window is the large-kappa vMF form of Ref-NeRF's integrated directional encoding [VHM*22];
+ * with `kappa = 1 / alpha` it is how Silvennoinen, Sloan, Iwanicki and Nowrouzezahrai encode roughness in
+ * "Spherical Harmonic Exponentials for Efficient Glossy Reflections" (HPG 2025,
+ * https://doi.org/10.1111/cgf.70219, talk: https://www.youtube.com/watch?v=THVMMNZ68iA). Their P and Q
+ * terms are each `exp` of one of these; see `sh_exponential/` beside the environment light code.
+ *
+ * **Not clamped.** Unlike `sh3_color_evaluate`, this returns the signed value: the SH-exponential
+ * representation stores log radiance, where negative is ordinary.
+ *
+ * Coefficients are band-major in the engine's all-positive convention (`sh_index`); per band the
+ * weight is `sh_vmf_window(l, kappa)`, folded here as powers of one `exp`. `kappa` must be > 0;
+ * as it grows the result tends to plain evaluation of `sh`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sh9_color_evaluate_vmf = CodeChunk.from(
+    //language=WGSL
+    `
+fn sh9_color_evaluate_vmf(sh: array<vec3<f32>, 81>, direction: vec3<f32>, kappa: f32) -> vec3<f32> {
+    let x = direction.x;
+    let y = direction.y;
+    let z = direction.z;
+
+    // m = 0
+    let q0_0 = 0.28209479177387814;
+    let q1_0 = 0.48860251190291987 * z;
+    let q2_0 = 1.9364916731037085 * z * q1_0 - 1.118033988749895 * q0_0;
+    let q3_0 = 1.9720265943665387 * z * q2_0 - 1.018350154434631 * q1_0;
+    let q4_0 = 1.984313483298443 * z * q3_0 - 1.0062305898749055 * q2_0;
+    let q5_0 = 1.98997487421324 * z * q4_0 - 1.002853072844814 * q3_0;
+    let q6_0 = 1.9930434571835665 * z * q5_0 - 1.0015420209622192 * q4_0;
+    let q7_0 = 1.9948914348241344 * z * q6_0 - 1.0009272139219583 * q5_0;
+    let q8_0 = 1.996089927833914 * z * q7_0 - 1.0006007810695146 * q6_0;
+
+    // m = 1, (x + iy)^1
+    let c1 = x;
+    let s1 = y;
+    let q1_1 = 0.48860251190292;
+    let q2_1 = 1.0925484305920792 * z;
+    let q3_1 = 2.091650066335189 * z * q2_1 - 0.9354143466934853 * q1_1;
+    let q4_1 = 2.04939015319192 * z * q3_1 - 0.9797958971132713 * q2_1;
+    let q5_1 = 2.03100960115899 * z * q4_1 - 0.991031208965115 * q3_1;
+    let q6_1 = 2.0213149892370277 * z * q5_1 - 0.9952267030562386 * q4_1;
+    let q7_1 = 2.0155644370746373 * z * q6_1 - 0.9971550440218321 * q5_1;
+    let q8_1 = 2.011869540407391 * z * q7_1 - 0.9981668178901743 * q6_1;
+
+    // m = 2, (x + iy)^2
+    let c2 = x * c1 - y * s1;
+    let s2 = x * s1 + y * c1;
+    let q2_2 = 0.5462742152960396;
+    let q3_2 = 1.4453057213202773 * z;
+    let q4_2 = 2.29128784747792 * z * q3_2 - 0.8660254037844386 * q2_2;
+    let q5_2 = 2.1712405933672376 * z * q4_2 - 0.9476070829586856 * q3_2;
+    let q6_2 = 2.1139418156609704 * z * q5_2 - 0.9736101204623269 * q4_2;
+    let q7_2 = 2.0816659994661326 * z * q6_2 - 0.9847319278346618 * q5_2;
+    let q8_2 = 2.0615528128088303 * z * q7_2 - 0.9903379376602872 * q6_2;
+
+    // m = 3, (x + iy)^3
+    let c3 = x * c2 - y * s2;
+    let s3 = x * s2 + y * c2;
+    let q3_3 = 0.5900435899266436;
+    let q4_3 = 1.770130769779931 * z;
+    let q5_3 = 2.48746859276655 * z * q4_3 - 0.82915619758885 * q3_3;
+    let q6_3 = 2.301368353023109 * z * q5_3 - 0.9251848886516146 * q4_3;
+    let q7_3 = 2.207940216581962 * z * q6_3 - 0.959403223600247 * q5_3;
+    let q8_3 = 2.15322168769582 * z * q7_3 - 0.9752173865600177 * q6_3;
+
+    // m = 4, (x + iy)^4
+    let c4 = x * c3 - y * s3;
+    let s4 = x * s3 + y * c3;
+    let q4_4 = 0.6258357354491763;
+    let q5_4 = 2.0756623148810416 * z;
+    let q6_4 = 2.6739483914241875 * z * q5_4 - 0.806225774829855 * q4_4;
+    let q7_4 = 2.4308621740219887 * z * q6_4 - 0.9090909090909092 * q5_4;
+    let q8_4 = 2.3048861143232218 * z * q7_4 - 0.9481763873554654 * q6_4;
+
+    // m = 5, (x + iy)^5
+    let c5 = x * c4 - y * s4;
+    let s5 = x * s4 + y * c4;
+    let q5_5 = 0.6563820568401703;
+    let q6_5 = 2.3666191622317525 * z;
+    let q7_5 = 2.850438562747845 * z * q6_5 - 0.7905694150420949 * q5_5;
+    let q8_5 = 2.557041559783794 * z * q7_5 - 0.8970695222838923 * q6_5;
+
+    // m = 6, (x + iy)^6
+    let c6 = x * c5 - y * s5;
+    let s6 = x * s5 + y * c5;
+    let q6_6 = 0.6831841051919145;
+    let q7_6 = 2.645960661801901 * z;
+    let q8_6 = 3.017804310611087 * z * q7_6 - 0.7791937224739796 * q6_6;
+
+    // m = 7, (x + iy)^7
+    let c7 = x * c6 - y * s6;
+    let s7 = x * s6 + y * c6;
+    let q7_7 = 0.7071627325245964;
+    let q8_7 = 2.9157066406993204 * z;
+
+    // m = 8, (x + iy)^8
+    let c8 = x * c7 - y * s7;
+    let s8 = x * s7 + y * c7;
+    let q8_8 = 0.7289266601748301;
+
+    // band l is attenuated by exp(-l(l+1) / (2 kappa)) = t^(l(l+1)), t = exp(-1 / (2 kappa)),
+    // built up as w(l) = w(l-1) * t^(2l)
+    let t = exp(-0.5 / kappa);
+    let t2 = t * t;
+    let w1 = t2;
+    let t4 = t2 * t2;
+    let w2 = w1 * t4;
+    let t6 = t4 * t2;
+    let w3 = w2 * t6;
+    let t8 = t6 * t2;
+    let w4 = w3 * t8;
+    let t10 = t8 * t2;
+    let w5 = w4 * t10;
+    let t12 = t10 * t2;
+    let w6 = w5 * t12;
+    let t14 = t12 * t2;
+    let w7 = w6 * t14;
+    let t16 = t14 * t2;
+    let w8 = w7 * t16;
+
+    var result = sh[0] * q0_0;
+
+    result += w1 * (
+        sh[1] * (q1_1 * s1)
+        + sh[2] * (q1_0)
+        + sh[3] * (q1_1 * c1)
+    );
+
+    result += w2 * (
+        sh[4] * (q2_2 * s2)
+        + sh[5] * (q2_1 * s1)
+        + sh[6] * (q2_0)
+        + sh[7] * (q2_1 * c1)
+        + sh[8] * (q2_2 * c2)
+    );
+
+    result += w3 * (
+        sh[9] * (q3_3 * s3)
+        + sh[10] * (q3_2 * s2)
+        + sh[11] * (q3_1 * s1)
+        + sh[12] * (q3_0)
+        + sh[13] * (q3_1 * c1)
+        + sh[14] * (q3_2 * c2)
+        + sh[15] * (q3_3 * c3)
+    );
+
+    result += w4 * (
+        sh[16] * (q4_4 * s4)
+        + sh[17] * (q4_3 * s3)
+        + sh[18] * (q4_2 * s2)
+        + sh[19] * (q4_1 * s1)
+        + sh[20] * (q4_0)
+        + sh[21] * (q4_1 * c1)
+        + sh[22] * (q4_2 * c2)
+        + sh[23] * (q4_3 * c3)
+        + sh[24] * (q4_4 * c4)
+    );
+
+    result += w5 * (
+        sh[25] * (q5_5 * s5)
+        + sh[26] * (q5_4 * s4)
+        + sh[27] * (q5_3 * s3)
+        + sh[28] * (q5_2 * s2)
+        + sh[29] * (q5_1 * s1)
+        + sh[30] * (q5_0)
+        + sh[31] * (q5_1 * c1)
+        + sh[32] * (q5_2 * c2)
+        + sh[33] * (q5_3 * c3)
+        + sh[34] * (q5_4 * c4)
+        + sh[35] * (q5_5 * c5)
+    );
+
+    result += w6 * (
+        sh[36] * (q6_6 * s6)
+        + sh[37] * (q6_5 * s5)
+        + sh[38] * (q6_4 * s4)
+        + sh[39] * (q6_3 * s3)
+        + sh[40] * (q6_2 * s2)
+        + sh[41] * (q6_1 * s1)
+        + sh[42] * (q6_0)
+        + sh[43] * (q6_1 * c1)
+        + sh[44] * (q6_2 * c2)
+        + sh[45] * (q6_3 * c3)
+        + sh[46] * (q6_4 * c4)
+        + sh[47] * (q6_5 * c5)
+        + sh[48] * (q6_6 * c6)
+    );
+
+    result += w7 * (
+        sh[49] * (q7_7 * s7)
+        + sh[50] * (q7_6 * s6)
+        + sh[51] * (q7_5 * s5)
+        + sh[52] * (q7_4 * s4)
+        + sh[53] * (q7_3 * s3)
+        + sh[54] * (q7_2 * s2)
+        + sh[55] * (q7_1 * s1)
+        + sh[56] * (q7_0)
+        + sh[57] * (q7_1 * c1)
+        + sh[58] * (q7_2 * c2)
+        + sh[59] * (q7_3 * c3)
+        + sh[60] * (q7_4 * c4)
+        + sh[61] * (q7_5 * c5)
+        + sh[62] * (q7_6 * c6)
+        + sh[63] * (q7_7 * c7)
+    );
+
+    result += w8 * (
+        sh[64] * (q8_8 * s8)
+        + sh[65] * (q8_7 * s7)
+        + sh[66] * (q8_6 * s6)
+        + sh[67] * (q8_5 * s5)
+        + sh[68] * (q8_4 * s4)
+        + sh[69] * (q8_3 * s3)
+        + sh[70] * (q8_2 * s2)
+        + sh[71] * (q8_1 * s1)
+        + sh[72] * (q8_0)
+        + sh[73] * (q8_1 * c1)
+        + sh[74] * (q8_2 * c2)
+        + sh[75] * (q8_3 * c3)
+        + sh[76] * (q8_4 * c4)
+        + sh[77] * (q8_5 * c5)
+        + sh[78] * (q8_6 * c6)
+        + sh[79] * (q8_7 * c7)
+        + sh[80] * (q8_8 * c8)
+    );
+
+    return result;
+}
+`);

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

@@ -1,9 +1,3 @@
-/**
- * @typedef {import("../../../descriptor/texture/SamplerDescriptor.js").SamplerDescriptor} SamplerDescriptor
- * @typedef {import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext} ShadeGPUCommandContext
- * @typedef {import("../../texture/ShadeTexture.js").ShadeTexture} ShadeTexture
- * @typedef {import("../type/WebGPUType.js").WebGPUType} WebGPUType
- */
 export class ShaderResourceGroupDescriptor {
     /**
      *

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

@@ -1 +1 @@
-{"version":3,"file":"ShaderResourceGroupDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shader/resource/ShaderResourceGroupDescriptor.js"],"names":[],"mappings":"AAeA;;;;;GAKG;AAEH;IAEI;;;OAGG;IACH,OAFU,MAAM,CAEN;IAQV;;OAEG;IACH,4CAEC;IAED;;;;;OAKG;IACH,qCAHW,sBAAsB,GACpB,oBAAoB,CAoHhC;IAED;;;OAGG;IACH,qBAFW,iBAAe,MAAM,QAc/B;IAED;;;;OAIG;IACH,6CAFa,mBAAmB,CA6B/B;IAED;;;OAGG;IACH,mDAHW,iBAAe,MAAM,GACnB,yBAAyB,CAqBrC;IAED;;;OAGG;IACH,gBAFY,MAAM,CAWjB;IAED;;;;OAIG;IACH,WAHW,MAAM,YACN,wBAAwB,QAUlC;IAED;;;;OAIG;IACH,UAHW,MAAM,GACJ,wBAAwB,GAAC,SAAS,CAiB9C;IAqDD;;;;;;OAMG;IACH,iBALW,MAAM,SACN,UAAU,GAAC,MAAM,wBAEf,IAAI,CAqChB;IAED;;;;;;OAMG;IACH,uBALW,MAAM,QACN,UAAU,kBACV,OAAO,GACL,IAAI,CAmBhB;IAED;;;;;;;;OAQG;IACH,iBAPW,MAAM,mFAGN,OAAO,kBACP,YAAY,GACV,IAAI,CA8ChB;IAED;;;;;;;OAOG;IACH,wBANW,MAAM,qGAIL,6BAA6B,CAyBxC;IAED;;;;;;OAMG;IACH,iBALW,MAAM,gDAEN,iBAAiB,GACf,6BAA6B,CA4BzC;;CAEJ;gCA1gBY,OAAO,kDAAkD,EAAE,iBAAiB;qCAC5E,OAAO,2CAA2C,EAAE,sBAAsB;2BAC1E,OAAO,+BAA+B,EAAE,YAAY;yBACpD,OAAO,uBAAuB,EAAE,UAAU;yCANd,+BAA+B;0CAV9B,0DAA0D"}
+{"version":3,"file":"ShaderResourceGroupDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shader/resource/ShaderResourceGroupDescriptor.js"],"names":[],"mappings":"AAqCA;IAEI;;;OAGG;IACH,OAFU,MAAM,CAEN;IAQV;;OAEG;IACH,4CAEC;IAED;;;;;OAKG;IACH,qCAHW,sBAAsB,GACpB,oBAAoB,CAkJhC;IAED;;;OAGG;IACH,qBAFW,iBAAe,MAAM,QAc/B;IAED;;;;OAIG;IACH,6CAFa,mBAAmB,CA6B/B;IAED;;;OAGG;IACH,mDAHW,iBAAe,MAAM,GACnB,yBAAyB,CAqBrC;IAED;;;OAGG;IACH,gBAFY,MAAM,CAWjB;IAED;;;;OAIG;IACH,WAHW,MAAM,YACN,wBAAwB,QAUlC;IAED;;;;OAIG;IACH,UAHW,MAAM,GACJ,wBAAwB,GAAC,SAAS,CAiB9C;IAqDD;;;;;;OAMG;IACH,iBALW,MAAM,SACN,UAAU,GAAC,MAAM,wBAEf,IAAI,CAqChB;IAED;;;;;;OAMG;IACH,uBALW,MAAM,QACN,UAAU,kBACV,OAAO,GACL,IAAI,CAmBhB;IAED;;;;;;;;OAQG;IACH,iBAPW,MAAM,mFAGN,OAAO,kBACP,YAAY,GACV,IAAI,CA8ChB;IAED;;;;;;;OAOG;IACH,wBANW,MAAM,qGAIL,6BAA6B,CAyBxC;IAED;;;;;;OAMG;IACH,iBALW,MAAM,gDAEN,iBAAiB,GACf,6BAA6B,CA4BzC;;CAEJ;gCAvjBY,OAAO,kDAAkD,EAAE,iBAAiB;qCAC5E,OAAO,2CAA2C,EAAE,sBAAsB;2BAC1E,OAAO,+BAA+B,EAAE,YAAY;yBACpD,OAAO,uBAAuB,EAAE,UAAU;yCANd,+BAA+B;0CAV9B,0DAA0D"}

package/src/shade/renderer/shader/resource/ShaderResourceGroupDescriptor.js

@@ -20,6 +20,21 @@ import { ShaderResourceDescriptor } from "./ShaderResourceDescriptor.js";
  * @typedef {import("../type/WebGPUType.js").WebGPUType} WebGPUType
  */
 
+/**
+ * What a binding was given, for an error message: the class of an object, since its string form is
+ * `[object Object]`.
+ *
+ * @param {*} value
+ * @returns {string}
+ */
+function describe_binding_value(value) {
+    if (typeof value === "object") {
+        return `a ${value.constructor?.name ?? "prototype-less object"}`;
+    }
+
+    return `${typeof value} '${value}'`;
+}
+
 export class ShaderResourceGroupDescriptor {
 
     /**
@@ -152,7 +167,37 @@ export class ShaderResourceGroupDescriptor {
                 } else if (binding_value.isGPUTextureContext === true) {
                     binding_value = binding_value.obtainView();
                 } else {
-                    throw new Error(`Unexpected texture value '${binding_value}'`)
+                    throw new Error(`Texture '${resource.name}' was given ${describe_binding_value(binding_value)}, which is neither a GPUTextureView, a GPUTextureContext nor a ShadeTexture`);
+                }
+
+            } else if (resource.type === ResourceType.Sampler) {
+
+                // Resolved here as the frame graph does in `encoder_prepare_shader_binding`. Passed
+                // through, a descriptor reaches createBindGroup, which reads it as a GPUBufferBinding
+                // with no buffer and says only that — not which binding, nor that it was a sampler.
+                if (binding_value.isSamplerDescriptor === true) {
+                    // not an assert, for the same reason as the ShadeTexture branch above
+                    if (encoder === undefined || encoder === null) {
+                        throw new Error(
+                            `Binding '${resource.name}' is a SamplerDescriptor, which only the encoder can`
+                            + ` resolve to a sampler, and generateBindings was called without one`
+                        );
+                    }
+
+                    binding_value = encoder.graphics.samplers.obtain(binding_value);
+                } else if (!(binding_value instanceof GPUSampler)) {
+                    throw new Error(`Sampler '${resource.name}' was given ${describe_binding_value(binding_value)}, which is neither a GPUSampler nor a SamplerDescriptor`);
+                }
+
+            } else if (resource.type === ResourceType.StorageTexture) {
+
+                // as above: a texture context passed through fails in createBindGroup the same way
+                if (binding_value.isGPUTextureContext === true) {
+                    assert.notEqual(binding_value.descriptor.usage & GPUTextureUsage.STORAGE_BINDING, 0, `storage texture '${resource.name}' does not declare STORAGE_BINDING`);
+
+                    binding_value = binding_value.obtainView();
+                } else if (!(binding_value instanceof GPUTextureView)) {
+                    throw new Error(`Storage texture '${resource.name}' was given ${describe_binding_value(binding_value)}, which is neither a GPUTextureView nor a GPUTextureContext`);
                 }
 
             }

package/src/shade/renderer/shadow/map/DEFAULT_SHADOWMAP_UPDATE_BUDGET.d.ts

@@ -1,14 +1,14 @@
 /**
  * Default per-frame shadow refresh budget, measured in **views** (one cube face counts as one
  * view, one CSM cascade counts as one view, etc.). A point light costs 6 views, a spot light 1, a
- * directional SHADOWMAP_CSM_CASCADE_COUNT. A bigger light consumes more of the budget, which
- * keeps the cost of the refresh step roughly proportional to how much work we're asking the
- * GPU to do — a single point light running the meshlet rasterization pipeline 6 times is
- * equivalent work to 6 spot lights.
+ * directional one per cascade ({@link GPUSceneShadowmapContext.cascade_count}). A bigger light
+ * consumes more of the budget, which keeps the cost of the refresh step roughly proportional to
+ * how much work we're asking the GPU to do — a single point light running the meshlet
+ * rasterization pipeline 6 times is equivalent work to 6 spot lights.
  *
- * Directional lights are always refreshed unconditionally (they drive the whole scene) and
- * their view cost is charged against the budget, so they effectively reduce the pool available
- * for local lights that frame.
+ * Directional lights are always refreshed unconditionally (they drive the whole scene), and their
+ * views are not charged against the budget: they cannot be refused, so charging them could only
+ * shrink the pool the local lights compete for — see {@link ShadowmapDrawSelector}.
  *
  * Unused budget is carried over between frames when demand exceeds supply. This lets a light
  * that's too expensive to fit in a single frame (e.g. a point needing 6 views when only 2 are

package/src/shade/renderer/shadow/map/DEFAULT_SHADOWMAP_UPDATE_BUDGET.js

@@ -1,14 +1,14 @@
 /**
  * Default per-frame shadow refresh budget, measured in **views** (one cube face counts as one
  * view, one CSM cascade counts as one view, etc.). A point light costs 6 views, a spot light 1, a
- * directional SHADOWMAP_CSM_CASCADE_COUNT. A bigger light consumes more of the budget, which
- * keeps the cost of the refresh step roughly proportional to how much work we're asking the
- * GPU to do — a single point light running the meshlet rasterization pipeline 6 times is
- * equivalent work to 6 spot lights.
+ * directional one per cascade ({@link GPUSceneShadowmapContext.cascade_count}). A bigger light
+ * consumes more of the budget, which keeps the cost of the refresh step roughly proportional to
+ * how much work we're asking the GPU to do — a single point light running the meshlet
+ * rasterization pipeline 6 times is equivalent work to 6 spot lights.
  *
- * Directional lights are always refreshed unconditionally (they drive the whole scene) and
- * their view cost is charged against the budget, so they effectively reduce the pool available
- * for local lights that frame.
+ * Directional lights are always refreshed unconditionally (they drive the whole scene), and their
+ * views are not charged against the budget: they cannot be refused, so charging them could only
+ * shrink the pool the local lights compete for — see {@link ShadowmapDrawSelector}.
  *
  * Unused budget is carried over between frames when demand exceeds supply. This lets a light
  * that's too expensive to fit in a single frame (e.g. a point needing 6 views when only 2 are

package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.d.ts

@@ -1,4 +1,8 @@
 export class DirectionalLightShadowmap extends Shadowmap {
+    /**
+     * @param {number} cascade_count how many cascades to split the view range into
+     */
+    constructor(cascade_count: number);
     /**
      * The closest depth that is covered by the shadow cascades
      * @type {number}
@@ -9,14 +13,27 @@ export class DirectionalLightShadowmap extends Shadowmap {
      * @type {number}
      */
     distance_max: number;
+    /**
+     * How many cascades the map was built with. Fixed for its life: a different count is a
+     * different map, which the shadow context builds in its place.
+     *
+     * @type {number}
+     */
+    cascade_count: number;
+    /**
+     * Per cascade, how far its slice reaches into the view range, as a fraction of it.
+     *
+     * @type {Float32Array}
+     */
     splits: Float32Array;
     /**
-     * The row of the light database's `shadow_csm_caster_range` table this map's caster range is
-     * published into, claimed by the shadow context with the map; -1 until then.
+     * The row of the map's nearest cascade in the light database's `shadow_cascade` table — its
+     * cascades are {@link cascade_count} rows from here — claimed by the shadow context with the
+     * map; -1 until then and after it is given back.
      *
      * @type {number}
      */
-    caster_row: number;
+    first_cascade: number;
     /**
      * Per cascade, the nearest caster along the light's axis that the GPU measured — from the
      * world origin, the previous frame's cascade frusta — as the readback delivered it. NaN until
@@ -34,22 +51,37 @@ export class DirectionalLightShadowmap extends Shadowmap {
     caster_range_valid: boolean;
     /**
      * What the accumulate pass measures this frame's casters against: the light's axis and each
-     * cascade's four side planes, as {@link update} fitted them. `base` is the shadow context's.
-     *
-     * `planes` is what is marshalled — a vec4 per plane — and `planes_words` the one buffer those
-     * are views over, which {@link update} writes.
+     * cascade's four side planes, as {@link update} fitted them, inward, a vec4 per plane and four
+     * planes per cascade. `base` is the shadow context's.
      *
-     * @type {{z_axis: Float32Array, planes: Float32Array[], planes_words: Float32Array, base: number, cascade_count: number}}
+     * @type {{z_axis: Float32Array, planes_words: Float32Array, base: number, cascade_count: number}}
      */
     caster_settings: {
         z_axis: Float32Array;
-        planes: Float32Array[];
         planes_words: Float32Array;
         base: number;
         cascade_count: number;
     };
     update(main_camera: any, scene_ctx: any): void;
-    make_record(): any[];
+    make_record(): {
+        first_cascade: number;
+        cascade_count: number;
+    };
+    /**
+     * The CPU's half of cascade `index`'s `shadow_cascade` row: where it is in the atlas, and the
+     * view-projection it was drawn with. The other half, `caster_near`, is the GPU's.
+     *
+     * @param {number} index
+     * @param {{atlas: number[], projection: ArrayLike<number>}} result written into and returned
+     * @returns {{atlas: number[], projection: ArrayLike<number>}}
+     */
+    make_cascade_record(index: number, result: {
+        atlas: number[];
+        projection: ArrayLike<number>;
+    }): {
+        atlas: number[];
+        projection: ArrayLike<number>;
+    };
     #private;
 }
 import { Shadowmap } from "./Shadowmap.js";

package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectionalLightShadowmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DirectionalLightShadowmap.js"],"names":[],"mappings":"AAiGA;IACI;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB,qBAAuD;IAEvD;;;;;OAKG;IACH,YAFU,MAAM,CAEA;IAEhB;;;;;;;OAOG;IACH,cAFU,YAAY,CAEiD;IASvE;;;;OAIG;IACH,oBAFU,OAAO,CAEU;IAE3B;;;;;;;;OAQG;IACH,iBAFU;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAC,CAYpH;IAEL,+CAiQC;IAED,qBAYC;;CAEJ;0BA5ZyB,gBAAgB"}
+{"version":3,"file":"DirectionalLightShadowmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DirectionalLightShadowmap.js"],"names":[],"mappings":"AAwGA;IAsEI;;OAEG;IACH,2BAFW,MAAM,EAiBhB;IAvFD;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;;;OAKG;IACH,eAFU,MAAM,CAEF;IAEd;;;;OAIG;IACH,QAFU,YAAY,CAEf;IAEP;;;;;;OAMG;IACH,eAFU,MAAM,CAEG;IAEnB;;;;;;;OAOG;IACH,cAFU,YAAY,CAET;IASb;;;;OAIG;IACH,oBAFU,OAAO,CAEU;IAE3B;;;;;;OAMG;IACH,iBAFU;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAC,CAEjF;IAsBhB,+CA0QC;IAED;;;MAKC;IAED;;;;;;;OAOG;IACH,2BAJW,MAAM,UACN;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,GAC9C;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,CAiB5D;;CAEJ;0BArdyB,gBAAgB"}