@woosh/meep-engine 3.58.0 → 3.60.0

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.d.ts

@@ -1,13 +1,28 @@
 /**
  * Words of a listed probe's maps, as accumulation writes them for projection and publish: two a
  * radiance texel, rgba as half floats; one a radiance texel, its rays this update, resolved and back
- * faces; one a depth texel, its moments as half floats.
+ * faces; one a depth texel, its moments as half floats; then one a radiance texel, how far its sample
+ * fell from its mean in its own deviation and that it blended one, as half floats, which the probe's ray
+ * request reads (`PROBE_CHANGE_SIGNIFICANCE`).
  *
  * @param {number} radiance_resolution n_r
  * @param {number} depth_resolution n_d
  * @returns {number}
  */
 export function probe_clipmap_maps_words(radiance_resolution: number, depth_resolution: number): number;
+/**
+ * Words of a listed probe's guide (`probe_guide`), as the guide passes write it, in this order:
+ * - n_r² first rays, by walk position;
+ * - n_r² texel weights, by texel;
+ * - n_r row luminances;
+ * - n_r row weights;
+ * - the total weight;
+ * - the even share of the leftover that each texel takes.
+ *
+ * @param {number} radiance_resolution n_r
+ * @returns {number}
+ */
+export function probe_clipmap_guide_words(radiance_resolution: number): number;
 /**
  * An indirection entry naming no probe: the engine's null.
  * @type {number}
@@ -60,11 +75,42 @@ export const PROBE_COUNTER_STARVED: number;
  * @type {number}
  */
 export const PROBE_COUNTER_PERIOD: number;
+/**
+ * Probes waiting for an update (§8.5): the NEW, and those wanted since their last update. Retire counts
+ * those it keeps, admit those the frame's wants add, and schedule takes the period from it and empties it.
+ * @type {number}
+ */
+export const PROBE_COUNTER_WAITING: number;
+/**
+ * Probes the frame's retire has evicted of the age bucket below those it evicts whole: it takes them while
+ * the count is under what schedule asked of that bucket (`PROBE_EVICTION_STRUCT.remaining`), and schedule
+ * empties it (§8.3).
+ * @type {number}
+ */
+export const PROBE_COUNTER_EVICTED: number;
+/**
+ * Binades of how long nothing has wanted a probe, the order eviction takes probes in (§8.3): 1 s begins the
+ * middle one, so the first holds 2⁻¹⁶ s and under and the last 2¹⁵ s, about nine hours, and over.
+ * @type {number}
+ */
+export const PROBE_AGE_BUCKETS: number;
+/**
+ * The first of {@link PROBE_AGE_BUCKETS} counters: the probes the frame's retire kept and could have evicted,
+ * by their age's bucket, which schedule reads and empties (§8.3).
+ * @type {number}
+ */
+export const PROBE_COUNTER_AGES: number;
 /**
  * Words of the counters.
  * @type {number}
  */
 export const PROBE_COUNTER_WORDS: number;
+/**
+ * The share of the slots eviction keeps free beyond the points a frame wants (§8.3): room for a burst of
+ * wanted points the frame it comes, before the next frame's eviction answers it. Alex's 5% (2026-10-30).
+ * @type {number}
+ */
+export const PROBE_FREE_SLACK: number;
 /**
  * A thread an entry of the frame's active list, once its appends are done: written by schedule, and
  * dispatched through by the next frame's retire, which reads that list.
@@ -101,6 +147,17 @@ export const PROBE_DISPATCH_ROWS: number;
  * @type {number}
  */
 export const PROBE_DISPATCH_PUBLISH: number;
+/**
+ * Listed probes a workgroup of the order pass sorts: one tile of the bitonic workgroup sort
+ * (`chunk_sort_bitonic_workgroup`), whose `SORT_TILE_SIZE` it is.
+ * @type {number}
+ */
+export const PROBE_ORDER_RUN: number;
+/**
+ * A workgroup a run of the frame's listed probes, `PROBE_ORDER_RUN` of them: the order pass.
+ * @type {number}
+ */
+export const PROBE_DISPATCH_ORDER: number;
 /**
  * Words of the dispatches.
  * @type {number}
@@ -111,11 +168,6 @@ export const PROBE_DISPATCH_WORDS: number;
  * @type {number}
  */
 export const PROBE_THREAD_WORKGROUP_SIZE: number;
-/**
- * Periods between a DEAD probe's updates, so that it notices when the scene changes (§8.4).
- * @type {number}
- */
-export const PROBE_DEAD_PERIODS: number;
 /**
  * The clearance relocation pushes a probe out to, of its cascade's spacing: d_min = ¼·s_c (§8.4). It
  * keeps the probe well clear of the receiver bias and of the half-voxel expand its rays start beside.
@@ -134,7 +186,21 @@ export const PROBE_RELOCATION_LIMIT: number;
  */
 export const PROBE_RELOCATION_STEPS: number;
 /**
- * A miss's depth sample, and the most any sample is, in spacings: a cage's diagonal (D9).
+ * The radius of the ball an update's rays start in around their probe, of its spacing (§8.6): each ray from a
+ * point of its own, so the probe gathers over a small volume and not one point, as Brick4's bake jitters its
+ * probes. A sixteenth, half a brick voxel at the default sizes, well inside {@link PROBE_RELOCATION_CLEARANCE}:
+ * where relocation reached the clearance, every ray still starts outside the solid. Measured on Sponza
+ * (2026-10-29): it smooths the converged diffuse and removes sharp-contrast artifacts; a quarter kills nearly
+ * twice the probes, its rays starting by surfaces.
+ * @type {number}
+ */
+export const PROBE_RAY_ORIGIN_JITTER: number;
+/**
+ * A miss's depth sample, and the most any sample is, in spacings: the farthest a cage tests a probe's depth,
+ * (1 + {@link PROBE_RELOCATION_LIMIT})·√3 (D9). A biased point lies within a spacing of the corner's lattice
+ * point on each axis, and relocation moves the probe at most the limit further. Chebyshev asks only how many
+ * samples lie past the point, which a clamp past every point tested leaves as it was; a shorter one reads open
+ * space as an occluder. RTXGI's 1.5·|spacing| is the same reach over DDGI 2021's half-spacing relocation.
  * @type {number}
  */
 export const PROBE_DEPTH_LIMIT: number;
@@ -161,7 +227,54 @@ export const PROBE_DEAD_BACK_FACE_SHARE: number;
  */
 export const PROBE_DEPTH_TEXEL_RAYS: number;
 /**
- * Directional lights a hit traces a soft shadow toward, at most: the first that cast shadows, in the
+ * Updates between a probe's uniform ones, Enshrouded's five. An update whose count is a multiple of it
+ * casts uniform rays, one a texel or a spread subset. Every other update is guided by the probe's own
+ * radiance, a CDF walk over its history's luminance (§8.6). The uniform updates keep alive what the
+ * guide passes over: the depth moments, and a texel that stays dark until something lights it. A probe's
+ * first update is uniform, since its history is another probe's.
+ * @type {number}
+ */
+export const PROBE_UNIFORM_PERIOD: number;
+/**
+ * The fewest rays an update casts, of the radiance texels: a quarter. The settings hold R to
+ * `[n_r²/4, 4·n_r²]`, which the uniform map and the gathers are built for; a DEAD probe's updates cast
+ * the fewest, and a guided update of a probe that sees no change asks for no more (§8.6).
+ * @type {number}
+ */
+export const PROBE_RAYS_PER_TEXEL_MIN: number;
+/**
+ * The most rays an update casts, of the radiance texels: four. A guided update of a probe whose light
+ * moved asks for them, and a new probe's first guided ones (§8.6). The guide holds any one texel under
+ * `PROBE_TEXEL_RAYS`.
+ * @type {number}
+ */
+export const PROBE_RAYS_PER_TEXEL_MAX: number;
+/**
+ * How far a probe's change score may go from its own running mean, in its own running deviation, before
+ * the probe's light counts as moved (§8.6); and how far a texel's sample may fall from its mean, in its
+ * own deviation, before it counts at that. The score sums the texels' falls over the root of their
+ * count, each held to this, which the central limit makes near normal however a texel's own fall is
+ * spread. A normal score passes it on all but 0.27% of updates; Sponza's probes past 64 updates, the light
+ * still, asked for the most on 1.1–1.3% (measured, §8.6), each such update costing one at the most rays.
+ * @type {number}
+ */
+export const PROBE_CHANGE_SIGNIFICANCE: number;
+/**
+ * Rays a guided update gives one radiance texel at most, the same gather budget as a depth texel's
+ * ({@link PROBE_DEPTH_TEXEL_RAYS}). The guide holds each texel's weight down to it and spreads what it
+ * holds back over every texel (§8.6).
+ * @type {number}
+ */
+export const PROBE_TEXEL_RAYS: number;
+/**
+ * The guide's fixed point. A texel's weight is its share of the probe's luminance in units of 1/this,
+ * so the walk's sums are exact and every pass that reads them agrees on each texel's rays. A share
+ * below 1/this weighs nothing, which is under a sixteenth of a ray at the most rays an update casts.
+ * @type {number}
+ */
+export const PROBE_GUIDE_SCALE: number;
+/**
+ * Directional lights a hit traces a shadow ray toward, at most: the first that cast shadows, in the
  * table's order. Lights past them are unshadowed at hits, a chosen cap (§8.6).
  * @type {number}
  */
@@ -171,6 +284,12 @@ export const PROBE_SHADOWED_SUNS: number;
  * @type {number}
  */
 export const PROBE_RAY_KIND_MASK: number;
+/**
+ * The kind of a record no ray wrote: the threads past the frame's last ray, in the last workgroup of
+ * its launch, write it, so that the passes after trace stop there without the frame's count.
+ * @type {number}
+ */
+export const PROBE_RAY_NONE: number;
 /**
  * Set for a hit whose field's gradient is along the ray: it came from inside a solid (§8.4).
  * @type {number}
@@ -181,6 +300,28 @@ export const PROBE_RAY_BACK_FACE: number;
  * @type {number}
  */
 export const PROBE_RAY_CASCADE_SHIFT: number;
+/**
+ * The hit's cascade's bits once shifted down: the brick clipmap has at most
+ * `PROBE_CLIPMAP_CASCADE_COUNT_MAX` (8) cascades.
+ * @type {number}
+ */
+export const PROBE_RAY_CASCADE_MASK: number;
+/**
+ * The shift of the ray's probe, its place in the trace list: 24 bits, past any trace list.
+ * @type {number}
+ */
+export const PROBE_RAY_PROBE_SHIFT: number;
+/**
+ * Set when a pixel wanted the probe in the last frame anything did, clear when only hits did (§8.3):
+ * whether its hits want in turn.
+ * @type {number}
+ */
+export const PROBE_RECORD_SCREEN: number;
+/**
+ * The shift of the probe's cascade, the flags' top bits: six, past `PROBE_CLIPMAP_CASCADE_COUNT_MAX`.
+ * @type {number}
+ */
+export const PROBE_RECORD_CASCADE_SHIFT: number;
 /**
  * Screen pixels a side of a want tile: a tile wants one pixel's cage a frame (§8.3).
  * @type {number}
@@ -191,6 +332,13 @@ export const PROBE_WANT_TILE: number;
  * @type {number}
  */
 export const PROBE_WANT_WORKGROUP_TILES: number;
+/**
+ * A wanted list entry's top bit: a pixel wanted the point, not only hits (§8.3). Admit marks the point's
+ * probe as the screen's on it, and only the screen's probes' hits want in turn. The key is the other
+ * bits.
+ * @type {number}
+ */
+export const PROBE_WANTED_SCREEN: number;
 /**
  * Lanes of the fill, a texel of the indirection each.
  * @type {number}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PROBE_CLIPMAP.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.js"],"names":[],"mappings":"AAiNA;;;;;;;;GAQG;AACH,8DAJW,MAAM,oBACN,MAAM,GACJ,MAAM,CAIlB;AAjND;;;GAGG;AACH,iCAFU,MAAM,CAE6B;AAS7C;;;GAGG;AACH,+BAFU,MAAM,CAEkB;AAElC;;;GAGG;AACH,8BAFU,MAAM,CAEiB;AAEjC;;;GAGG;AACH,gCAFU,MAAM,CAEmB;AAEnC;;;;GAIG;AACH,+BAFU,MAAM,CAEkB;AAElC;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,wCAFU,MAAM,CAE2B;AAM3C;;;GAGG;AACH,iCAFU,MAAM,CAEoB;AAEpC;;;;GAIG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,mCAFU,MAAM,CAEsB;AAEtC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAQrC;;;;GAIG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,mCAFU,MAAM,CAEsB;AAEtC;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAErC;;;GAGG;AACH,oCAFU,MAAM,CAEwB;AAExC;;;GAGG;AACH,kCAFU,MAAM,CAEsB;AAEtC;;;GAGG;AACH,qCAFU,MAAM,CAEyB;AAEzC;;;GAGG;AACH,mCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,0CAFU,MAAM,CAE8B;AAE9C;;;GAGG;AACH,iCAFU,MAAM,CAEoB;AAEpC;;;;GAIG;AACH,yCAFU,MAAM,CAE+B;AAE/C;;;;GAIG;AACH,qCAFU,MAAM,CAE2B;AAE3C;;;GAGG;AACH,qCAFU,MAAM,CAEwB;AAExC;;;GAGG;AACH,gCAFU,MAAM,CAE8B;AAE9C;;;;GAIG;AACH,oCAFU,MAAM,CAEyB;AAEzC;;;;GAIG;AACH,2CAFU,MAAM,CAEgC;AAEhD;;;GAGG;AACH,yCAFU,MAAM,CAE+B;AAE/C;;;GAGG;AACH,qCAFU,MAAM,CAEyB;AAezC;;;;GAIG;AACH,kCAFU,MAAM,CAEqB;AAOrC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAErC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAErC;;;GAGG;AACH,sCAFU,MAAM,CAEyB;AAEzC;;;GAGG;AACH,8BAFU,MAAM,CAEiB;AAEjC;;;GAGG;AACH,yCAFU,MAAM,CAE4B;AAE5C;;;GAGG;AACH,wCAFU,MAAM,CAE4B;AAE5C;;;;GAIG;AACH,gCAFU,MAAM,CAEmB;AAEnC;;;GAGG;AACH,kCAFU,MAAM,CAEuB;AAEvC;;;;GAIG;AACH,uCAFU,MAAM,CAE4B"}
+{"version":3,"file":"PROBE_CLIPMAP.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.js"],"names":[],"mappings":"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"}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.js

@@ -82,11 +82,47 @@ export const PROBE_COUNTER_STARVED = 1;
  */
 export const PROBE_COUNTER_PERIOD = 2;
 
+/**
+ * Probes waiting for an update (§8.5): the NEW, and those wanted since their last update. Retire counts
+ * those it keeps, admit those the frame's wants add, and schedule takes the period from it and empties it.
+ * @type {number}
+ */
+export const PROBE_COUNTER_WAITING = 3;
+
+/**
+ * Probes the frame's retire has evicted of the age bucket below those it evicts whole: it takes them while
+ * the count is under what schedule asked of that bucket (`PROBE_EVICTION_STRUCT.remaining`), and schedule
+ * empties it (§8.3).
+ * @type {number}
+ */
+export const PROBE_COUNTER_EVICTED = 4;
+
+/**
+ * Binades of how long nothing has wanted a probe, the order eviction takes probes in (§8.3): 1 s begins the
+ * middle one, so the first holds 2⁻¹⁶ s and under and the last 2¹⁵ s, about nine hours, and over.
+ * @type {number}
+ */
+export const PROBE_AGE_BUCKETS = 32;
+
+/**
+ * The first of {@link PROBE_AGE_BUCKETS} counters: the probes the frame's retire kept and could have evicted,
+ * by their age's bucket, which schedule reads and empties (§8.3).
+ * @type {number}
+ */
+export const PROBE_COUNTER_AGES = 5;
+
 /**
  * Words of the counters.
  * @type {number}
  */
-export const PROBE_COUNTER_WORDS = 4;
+export const PROBE_COUNTER_WORDS = PROBE_COUNTER_AGES + PROBE_AGE_BUCKETS;
+
+/**
+ * The share of the slots eviction keeps free beyond the points a frame wants (§8.3): room for a burst of
+ * wanted points the frame it comes, before the next frame's eviction answers it. Alex's 5% (2026-10-30).
+ * @type {number}
+ */
+export const PROBE_FREE_SLACK = 0.05;
 
 /*
  The dispatches, `probe_dispatch`: indirect commands the one-thread passes write for the passes after
@@ -138,22 +174,29 @@ export const PROBE_DISPATCH_ROWS = 15;
 export const PROBE_DISPATCH_PUBLISH = 18;
 
 /**
- * Words of the dispatches.
+ * Listed probes a workgroup of the order pass sorts: one tile of the bitonic workgroup sort
+ * (`chunk_sort_bitonic_workgroup`), whose `SORT_TILE_SIZE` it is.
  * @type {number}
  */
-export const PROBE_DISPATCH_WORDS = 21;
+export const PROBE_ORDER_RUN = 1024;
 
 /**
- * Lanes of the passes that run a thread a list entry: retire, admit, due, relocate.
+ * A workgroup a run of the frame's listed probes, `PROBE_ORDER_RUN` of them: the order pass.
  * @type {number}
  */
-export const PROBE_THREAD_WORKGROUP_SIZE = 64;
+export const PROBE_DISPATCH_ORDER = 21;
 
 /**
- * Periods between a DEAD probe's updates, so that it notices when the scene changes (§8.4).
+ * Words of the dispatches.
+ * @type {number}
+ */
+export const PROBE_DISPATCH_WORDS = 24;
+
+/**
+ * Lanes of the passes that run a thread a list entry: retire, admit, due, relocate.
  * @type {number}
  */
-export const PROBE_DEAD_PERIODS = 8;
+export const PROBE_THREAD_WORKGROUP_SIZE = 64;
 
 /**
  * The clearance relocation pushes a probe out to, of its cascade's spacing: d_min = ¼·s_c (§8.4). It
@@ -176,10 +219,25 @@ export const PROBE_RELOCATION_LIMIT = 0.45;
 export const PROBE_RELOCATION_STEPS = 3;
 
 /**
- * A miss's depth sample, and the most any sample is, in spacings: a cage's diagonal (D9).
+ * The radius of the ball an update's rays start in around their probe, of its spacing (§8.6): each ray from a
+ * point of its own, so the probe gathers over a small volume and not one point, as Brick4's bake jitters its
+ * probes. A sixteenth, half a brick voxel at the default sizes, well inside {@link PROBE_RELOCATION_CLEARANCE}:
+ * where relocation reached the clearance, every ray still starts outside the solid. Measured on Sponza
+ * (2026-10-29): it smooths the converged diffuse and removes sharp-contrast artifacts; a quarter kills nearly
+ * twice the probes, its rays starting by surfaces.
+ * @type {number}
+ */
+export const PROBE_RAY_ORIGIN_JITTER = 1 / 16;
+
+/**
+ * A miss's depth sample, and the most any sample is, in spacings: the farthest a cage tests a probe's depth,
+ * (1 + {@link PROBE_RELOCATION_LIMIT})·√3 (D9). A biased point lies within a spacing of the corner's lattice
+ * point on each axis, and relocation moves the probe at most the limit further. Chebyshev asks only how many
+ * samples lie past the point, which a clamp past every point tested leaves as it was; a shorter one reads open
+ * space as an occluder. RTXGI's 1.5·|spacing| is the same reach over DDGI 2021's half-spacing relocation.
  * @type {number}
  */
-export const PROBE_DEPTH_LIMIT = Math.sqrt(3);
+export const PROBE_DEPTH_LIMIT = (1 + PROBE_RELOCATION_LIMIT) * Math.sqrt(3);
 
 /**
  * A back face's depth sample, of its t: DDGI 2021's 80% shortening, so that the probe reads as occluded
@@ -210,18 +268,89 @@ export const PROBE_DEPTH_TEXEL_RAYS = 64;
 /**
  * Words of a listed probe's maps, as accumulation writes them for projection and publish: two a
  * radiance texel, rgba as half floats; one a radiance texel, its rays this update, resolved and back
- * faces; one a depth texel, its moments as half floats.
+ * faces; one a depth texel, its moments as half floats; then one a radiance texel, how far its sample
+ * fell from its mean in its own deviation and that it blended one, as half floats, which the probe's ray
+ * request reads (`PROBE_CHANGE_SIGNIFICANCE`).
  *
  * @param {number} radiance_resolution n_r
  * @param {number} depth_resolution n_d
  * @returns {number}
  */
 export function probe_clipmap_maps_words(radiance_resolution, depth_resolution) {
-    return 3 * radiance_resolution * radiance_resolution + depth_resolution * depth_resolution;
+    return 4 * radiance_resolution * radiance_resolution + depth_resolution * depth_resolution;
+}
+
+/**
+ * Updates between a probe's uniform ones, Enshrouded's five. An update whose count is a multiple of it
+ * casts uniform rays, one a texel or a spread subset. Every other update is guided by the probe's own
+ * radiance, a CDF walk over its history's luminance (§8.6). The uniform updates keep alive what the
+ * guide passes over: the depth moments, and a texel that stays dark until something lights it. A probe's
+ * first update is uniform, since its history is another probe's.
+ * @type {number}
+ */
+export const PROBE_UNIFORM_PERIOD = 5;
+
+/**
+ * The fewest rays an update casts, of the radiance texels: a quarter. The settings hold R to
+ * `[n_r²/4, 4·n_r²]`, which the uniform map and the gathers are built for; a DEAD probe's updates cast
+ * the fewest, and a guided update of a probe that sees no change asks for no more (§8.6).
+ * @type {number}
+ */
+export const PROBE_RAYS_PER_TEXEL_MIN = 1 / 4;
+
+/**
+ * The most rays an update casts, of the radiance texels: four. A guided update of a probe whose light
+ * moved asks for them, and a new probe's first guided ones (§8.6). The guide holds any one texel under
+ * `PROBE_TEXEL_RAYS`.
+ * @type {number}
+ */
+export const PROBE_RAYS_PER_TEXEL_MAX = 4;
+
+/**
+ * How far a probe's change score may go from its own running mean, in its own running deviation, before
+ * the probe's light counts as moved (§8.6); and how far a texel's sample may fall from its mean, in its
+ * own deviation, before it counts at that. The score sums the texels' falls over the root of their
+ * count, each held to this, which the central limit makes near normal however a texel's own fall is
+ * spread. A normal score passes it on all but 0.27% of updates; Sponza's probes past 64 updates, the light
+ * still, asked for the most on 1.1–1.3% (measured, §8.6), each such update costing one at the most rays.
+ * @type {number}
+ */
+export const PROBE_CHANGE_SIGNIFICANCE = 3;
+
+/**
+ * Rays a guided update gives one radiance texel at most, the same gather budget as a depth texel's
+ * ({@link PROBE_DEPTH_TEXEL_RAYS}). The guide holds each texel's weight down to it and spreads what it
+ * holds back over every texel (§8.6).
+ * @type {number}
+ */
+export const PROBE_TEXEL_RAYS = PROBE_DEPTH_TEXEL_RAYS;
+
+/**
+ * The guide's fixed point. A texel's weight is its share of the probe's luminance in units of 1/this,
+ * so the walk's sums are exact and every pass that reads them agrees on each texel's rays. A share
+ * below 1/this weighs nothing, which is under a sixteenth of a ray at the most rays an update casts.
+ * @type {number}
+ */
+export const PROBE_GUIDE_SCALE = 65536;
+
+/**
+ * Words of a listed probe's guide (`probe_guide`), as the guide passes write it, in this order:
+ * - n_r² first rays, by walk position;
+ * - n_r² texel weights, by texel;
+ * - n_r row luminances;
+ * - n_r row weights;
+ * - the total weight;
+ * - the even share of the leftover that each texel takes.
+ *
+ * @param {number} radiance_resolution n_r
+ * @returns {number}
+ */
+export function probe_clipmap_guide_words(radiance_resolution) {
+    return 2 * radiance_resolution * radiance_resolution + 2 * radiance_resolution + 2;
 }
 
 /**
- * Directional lights a hit traces a soft shadow toward, at most: the first that cast shadows, in the
+ * Directional lights a hit traces a shadow ray toward, at most: the first that cast shadows, in the
  * table's order. Lights past them are unshadowed at hits, a chosen cap (§8.6).
  * @type {number}
  */
@@ -229,7 +358,8 @@ export const PROBE_SHADOWED_SUNS = 2;
 
 /*
  A ray's flags, `PROBE_RAY_STRUCT.flags`: its kind in the low two bits, as the brick clipmap's tracer
- names it (miss 0, hit 1, unresolved 2), whether the hit is a back face, and the hit's cascade above.
+ names it (miss 0, hit 1, unresolved 2) or none (3), whether the hit is a back face, the hit's cascade
+ in three bits above, and the probe it belongs to, its place in the trace list, from bit 8.
 */
 
 /**
@@ -238,6 +368,13 @@ export const PROBE_SHADOWED_SUNS = 2;
  */
 export const PROBE_RAY_KIND_MASK = 3;
 
+/**
+ * The kind of a record no ray wrote: the threads past the frame's last ray, in the last workgroup of
+ * its launch, write it, so that the passes after trace stop there without the frame's count.
+ * @type {number}
+ */
+export const PROBE_RAY_NONE = 3;
+
 /**
  * Set for a hit whose field's gradient is along the ray: it came from inside a solid (§8.4).
  * @type {number}
@@ -250,6 +387,37 @@ export const PROBE_RAY_BACK_FACE = 4;
  */
 export const PROBE_RAY_CASCADE_SHIFT = 3;
 
+/**
+ * The hit's cascade's bits once shifted down: the brick clipmap has at most
+ * `PROBE_CLIPMAP_CASCADE_COUNT_MAX` (8) cascades.
+ * @type {number}
+ */
+export const PROBE_RAY_CASCADE_MASK = 7;
+
+/**
+ * The shift of the ray's probe, its place in the trace list: 24 bits, past any trace list.
+ * @type {number}
+ */
+export const PROBE_RAY_PROBE_SHIFT = 8;
+
+/*
+ A probe record's flags, `PROBE_RECORD_STRUCT.flags`: the share of its last update's resolved rays that
+ hit back faces, unorm16, in the low half; ten bits of flags above it; its cascade in the top six bits.
+*/
+
+/**
+ * Set when a pixel wanted the probe in the last frame anything did, clear when only hits did (§8.3):
+ * whether its hits want in turn.
+ * @type {number}
+ */
+export const PROBE_RECORD_SCREEN = 0x10000;
+
+/**
+ * The shift of the probe's cascade, the flags' top bits: six, past `PROBE_CLIPMAP_CASCADE_COUNT_MAX`.
+ * @type {number}
+ */
+export const PROBE_RECORD_CASCADE_SHIFT = 26;
+
 /**
  * Screen pixels a side of a want tile: a tile wants one pixel's cage a frame (§8.3).
  * @type {number}
@@ -262,6 +430,14 @@ export const PROBE_WANT_TILE = 8;
  */
 export const PROBE_WANT_WORKGROUP_TILES = 8;
 
+/**
+ * A wanted list entry's top bit: a pixel wanted the point, not only hits (§8.3). Admit marks the point's
+ * probe as the screen's on it, and only the screen's probes' hits want in turn. The key is the other
+ * bits.
+ * @type {number}
+ */
+export const PROBE_WANTED_SCREEN = 0x80000000;
+
 /**
  * Lanes of the fill, a texel of the indirection each.
  * @type {number}