@woosh/meep-engine 3.38.0 → 3.39.0

package/src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_irradiance_flat.js

@@ -3,6 +3,7 @@ import {
     VIZ_BUFFER_INVALID_MESH_VALUE
 } from "../../rasterize/native/viz/VIZ_BUFFER_INVALID_MESH_VALUE.js";
 import { INDIRECT_MATERIAL_ARRAY_TYPE } from "../../material/resident/INDIRECT_MATERIAL_ARRAY_TYPE.js";
+import { MEDIA_TABLE_STRUCT } from "../../medium/MEDIA_TABLE_STRUCT.js";
 import { chunk_render_trace_path } from "../../path_tracer/shader/chunk_render_trace_path.js";
 import { chunk_sample_material } from "../../path_tracer/shader/chunk_sample_material.js";
 import { chunk_rgb_to_luminance } from "../../shader/chunk/color/chunk_rgb_to_luminance.js";
@@ -10,6 +11,7 @@ import { chunk_rgb_to_YCoCg } from "../../shader/chunk/color/YCoCg/chunk_rgb_to_
 import {
     chunk_geometry_read_triangle_vertices
 } from "../../shader/chunk/geometry/format/chunk_geometry_read_triangle_vertices.js";
+import { chunk_get_biased_normal_sample } from "../../shader/chunk/geometry/ray/chunk_get_biased_normal_sample.js";
 import { chunk_offset_ray } from "../../shader/chunk/geometry/ray/chunk_offset_ray.js";
 import { RAY_STRUCT } from "../../shader/chunk/geometry/ray/RAY_STRUCT.js";
 import {
@@ -49,6 +51,7 @@ sr_create_group_RTX(resources);
 
 resources.createGroup()
     .addUniform("materials", INDIRECT_MATERIAL_ARRAY_TYPE)
+    .addUniform("media", MEDIA_TABLE_STRUCT)
     .addTexture("textures", "unfilterable-float", "2d-array")
     .addTexture("tNoise", "uint")
 
@@ -218,6 +221,7 @@ fn main(
         PI_DECLARATION,
         chunk_rgb_to_YCoCg,
         chunk_offset_ray,
+        chunk_get_biased_normal_sample,
         chunk_sh3_color_unroll,
         chunk_sh3_color_rollup,
         chunk_sh3_dering_optimize_positive,

package/src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_sh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_viz_to_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_sh.js"],"names":[],"mappings":"AA+NA,oDAOE;4BAhM0B,6BAA6B"}
+{"version":3,"file":"shader_lightmap_viz_to_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_sh.js"],"names":[],"mappings":"AAmOA,oDAOE;4BAlM0B,6BAA6B"}

package/src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_sh.js

@@ -3,12 +3,14 @@ import {
     VIZ_BUFFER_INVALID_MESH_VALUE
 } from "../../rasterize/native/viz/VIZ_BUFFER_INVALID_MESH_VALUE.js";
 import { INDIRECT_MATERIAL_ARRAY_TYPE } from "../../material/resident/INDIRECT_MATERIAL_ARRAY_TYPE.js";
+import { MEDIA_TABLE_STRUCT } from "../../medium/MEDIA_TABLE_STRUCT.js";
 import { chunk_render_trace_path } from "../../path_tracer/shader/chunk_render_trace_path.js";
 import { chunk_sample_material } from "../../path_tracer/shader/chunk_sample_material.js";
 import { chunk_rgb_to_YCoCg } from "../../shader/chunk/color/YCoCg/chunk_rgb_to_YCoCg.js";
 import {
     chunk_geometry_read_triangle_vertices
 } from "../../shader/chunk/geometry/format/chunk_geometry_read_triangle_vertices.js";
+import { chunk_get_biased_normal_sample } from "../../shader/chunk/geometry/ray/chunk_get_biased_normal_sample.js";
 import { chunk_offset_ray } from "../../shader/chunk/geometry/ray/chunk_offset_ray.js";
 import { RAY_STRUCT } from "../../shader/chunk/geometry/ray/RAY_STRUCT.js";
 import {
@@ -49,6 +51,7 @@ sr_create_group_RTX(resources);
 
 resources.createGroup()
     .addUniform("materials", INDIRECT_MATERIAL_ARRAY_TYPE)
+    .addUniform("media", MEDIA_TABLE_STRUCT)
     .addTexture("textures", "unfilterable-float", "2d-array")
     .addTexture("tNoise", "uint")
 
@@ -215,6 +218,7 @@ fn main(
         PI_DECLARATION,
         chunk_rgb_to_YCoCg,
         chunk_offset_ray,
+        chunk_get_biased_normal_sample,
         chunk_sh3_color_unroll,
         chunk_sh3_color_rollup,
         chunk_sh3_dering_optimize_positive,

package/src/shade/renderer/loader/gltf/tiny-gltf.d.ts

@@ -13,7 +13,7 @@ export class TinyGltf {
      * @readonly
      * @type {TextureFormat}
      */
-    static readonly "__#254@#UNCOMPRESSED_TARGET": TextureFormat;
+    static readonly "__#258@#UNCOMPRESSED_TARGET": TextureFormat;
     /**
      * @param {AssetManager} assetManager
      * @param {AssetRequestScope} [scope]

package/src/shade/renderer/material/PIXEL_TEXTURE_ORM.d.ts

@@ -1,2 +1,2 @@
-export const PIXEL_TEXTURE_ORM: import("../texture/ShadeTexture.js").ShadeTexture;
+export const PIXEL_TEXTURE_ORM: ShadeTexture;
 //# sourceMappingURL=PIXEL_TEXTURE_ORM.d.ts.map

package/src/shade/renderer/material/PIXEL_TEXTURE_ORM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PIXEL_TEXTURE_ORM.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/material/PIXEL_TEXTURE_ORM.js"],"names":[],"mappings":"AAGA,kFAAiF"}
+{"version":3,"file":"PIXEL_TEXTURE_ORM.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/material/PIXEL_TEXTURE_ORM.js"],"names":[],"mappings":"AAGA,6CAAiF"}

package/src/shade/renderer/material/StandardShadeMaterial.d.ts

@@ -1,6 +1,7 @@
 /**
  * @typedef {import("../texture/ShadeTexture.js").ShadeTexture} ShadeTexture
  * @typedef {import("../texture/virtual/VirtualTextureStack.js").VirtualTextureStack} VirtualTextureStack
+ * @typedef {import("../medium/ParticipatingMedium.js").ParticipatingMedium} ParticipatingMedium
  */
 export class StandardShadeMaterial extends ShadeMaterial {
     /**
@@ -67,6 +68,19 @@ export class StandardShadeMaterial extends ShadeMaterial {
      * @type {number}
      */
     ior_factor: number;
+    /**
+     * What fills the inside of the surface, or null for nothing. With a medium, the transmissive
+     * part of the surface ({@link transmission_factor}) is a refracting interface into it, at
+     * {@link ior_factor} against whatever the light comes from, and the mesh has to be closed:
+     * its outward faces say which side is inside. Without one, transmission is thin-walled — a
+     * sheet the light passes straight through.
+     *
+     * Shared by reference: glass panes and a glass bottle can name the same medium. Read by the
+     * ray passes (the path tracer and the bakes); the rasterizer does not use it.
+     *
+     * @type {ParticipatingMedium|null}
+     */
+    medium: ParticipatingMedium | null;
     /**
      * Multiplied with the emissive texture
      * @type {Color}
@@ -103,6 +117,7 @@ export class StandardShadeMaterial extends ShadeMaterial {
 }
 export type ShadeTexture = import("../texture/ShadeTexture.js").ShadeTexture;
 export type VirtualTextureStack = import("../texture/virtual/VirtualTextureStack.js").VirtualTextureStack;
+export type ParticipatingMedium = import("../medium/ParticipatingMedium.js").ParticipatingMedium;
 import { ShadeMaterial } from "./ShadeMaterial.js";
 import { Color } from "../../../core/color/Color.js";
 import LinearModifier from "../../../core/model/stat/LinearModifier.js";

package/src/shade/renderer/material/StandardShadeMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StandardShadeMaterial.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/material/StandardShadeMaterial.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;IACI;;;OAGG;IACH,gBAFU,YAAY,CAEP;IAEf;;;OAGG;IACH,eAFU,KAAK,CAEsB;IAErC;;OAEG;IACH,gBAFU,YAAY,CAEP;IAEf;;;;;;OAMG;IACH,aAFU,YAAY,CAEV;IAEZ;;OAEG;IACH,kBAFU,YAAY,CAEL;IAEjB;;;;;;;;OAQG;IACH,UAFU,mBAAmB,GAAC,SAAS,CAE9B;IAET;;;OAGG;IACH,kBAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB;;;;;;;;OAQG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;;;;OAMG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,iBAFU,KAAK,CAE4B;IAE3C;;;OAGG;IACH,iBAFU,cAAc,CAEmB;IAW3C;;;;;OAKG;IACH,YAFW,qBAAqB,QAmB/B;IAED;;;OAGG;IACH,SAFa,qBAAqB,CAQjC;IAaD;;;;OAIG;IACH,cAHW,qBAAqB,GACnB,OAAO,CA8BnB;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;2BAtLY,OAAO,4BAA4B,EAAE,YAAY;kCACjD,OAAO,2CAA2C,EAAE,mBAAmB;8BAJtD,oBAAoB;sBAJ5B,8BAA8B;2BACzB,4CAA4C"}
+{"version":3,"file":"StandardShadeMaterial.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/material/StandardShadeMaterial.js"],"names":[],"mappings":"AAOA;;;;GAIG;AAEH;IACI;;;OAGG;IACH,gBAFU,YAAY,CAEP;IAEf;;;OAGG;IACH,eAFU,KAAK,CAEsB;IAErC;;OAEG;IACH,gBAFU,YAAY,CAEP;IAEf;;;;;;OAMG;IACH,aAFU,YAAY,CAEV;IAEZ;;OAEG;IACH,kBAFU,YAAY,CAEL;IAEjB;;;;;;;;OAQG;IACH,UAFU,mBAAmB,GAAC,SAAS,CAE9B;IAET;;;OAGG;IACH,kBAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB;;;;;;;;OAQG;IACH,qBAFU,MAAM,CAEQ;IAExB;;;;;;OAMG;IACH,YAFU,MAAM,CAEC;IAEjB;;;;;;;;;;;OAWG;IACH,QAFU,mBAAmB,GAAC,IAAI,CAEpB;IAEd;;;OAGG;IACH,iBAFU,KAAK,CAE4B;IAE3C;;;OAGG;IACH,iBAFU,cAAc,CAEmB;IAW3C;;;;;OAKG;IACH,YAFW,qBAAqB,QAoB/B;IAED;;;OAGG;IACH,SAFa,qBAAqB,CAQjC;IAaD;;;;OAIG;IACH,cAHW,qBAAqB,GACnB,OAAO,CA+BnB;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;2BAvMY,OAAO,4BAA4B,EAAE,YAAY;kCACjD,OAAO,2CAA2C,EAAE,mBAAmB;kCACvE,OAAO,kCAAkC,EAAE,mBAAmB;8BAL7C,oBAAoB;sBAJ5B,8BAA8B;2BACzB,4CAA4C"}

package/src/shade/renderer/material/StandardShadeMaterial.js

@@ -8,6 +8,7 @@ import { ShadeMaterial } from "./ShadeMaterial.js";
 /**
  * @typedef {import("../texture/ShadeTexture.js").ShadeTexture} ShadeTexture
  * @typedef {import("../texture/virtual/VirtualTextureStack.js").VirtualTextureStack} VirtualTextureStack
+ * @typedef {import("../medium/ParticipatingMedium.js").ParticipatingMedium} ParticipatingMedium
  */
 
 export class StandardShadeMaterial extends ShadeMaterial {
@@ -85,6 +86,20 @@ export class StandardShadeMaterial extends ShadeMaterial {
      */
     ior_factor = 1.5;
 
+    /**
+     * What fills the inside of the surface, or null for nothing. With a medium, the transmissive
+     * part of the surface ({@link transmission_factor}) is a refracting interface into it, at
+     * {@link ior_factor} against whatever the light comes from, and the mesh has to be closed:
+     * its outward faces say which side is inside. Without one, transmission is thin-walled — a
+     * sheet the light passes straight through.
+     *
+     * Shared by reference: glass panes and a glass bottle can name the same medium. Read by the
+     * ray passes (the path tracer and the bakes); the rasterizer does not use it.
+     *
+     * @type {ParticipatingMedium|null}
+     */
+    medium = null;
+
     /**
      * Multiplied with the emissive texture
      * @type {Color}
@@ -129,6 +144,7 @@ export class StandardShadeMaterial extends ShadeMaterial {
         this.metallic_factor = other.metallic_factor;
         this.transmission_factor = other.transmission_factor;
         this.ior_factor = other.ior_factor;
+        this.medium = other.medium;
     }
 
     /**
@@ -178,6 +194,7 @@ export class StandardShadeMaterial extends ShadeMaterial {
             && this.metallic_factor === other.metallic_factor
             && this.transmission_factor === other.transmission_factor
             && this.ior_factor === other.ior_factor
+            && this.medium === other.medium
             && this.vt_stack === other.vt_stack
             && optional_equality(this.texture_albedo, other.texture_albedo)
             && this.diffuse_color.equals(other.diffuse_color)

package/src/shade/renderer/material/resident/GPUResidentMaterialContext.d.ts

@@ -30,6 +30,26 @@ export class GPUResidentMaterialContext {
      */
     get textureView(): GPUTextureView;
     /**
+     * How many media the table can hold: what {@link MEDIA_TABLE_STRUCT} addresses, within the
+     * device's uniform binding size.
+     *
+     * @returns {number}
+     */
+    get media_limit(): number;
+    /**
+     * The media table, {@link MEDIA_TABLE_STRUCT}: how many media are resident, then one
+     * {@link MEDIUM_STRUCT} per slot, the slot a material row names in its `medium` field. A uniform
+     * buffer, written in place as media change.
+     *
+     * @returns {GPUBuffer}
+     */
+    get buffer_media(): GPUBuffer;
+    /**
+     * Make a material resident, or repack it if its {@link ShadeMaterial#version} has moved since —
+     * the same contract {@link GPUMaterialManager} restages by. A hit used to be final, so a factor
+     * set after the first pack never reached the row. Every caller re-obtains what it needs before
+     * {@link update}: the scene's drawn list, and the manager's materials whenever its version
+     * moves, so the check rides on walks that already happen.
      *
      * @param {ShadeMaterial} material
      * @returns {MaterialInfo}
@@ -58,6 +78,7 @@ export type GPUSceneContext = import("../../scene/GPUSceneContext.js").GPUSceneC
 export type ShadeTexture = import("../../texture/ShadeTexture.js").ShadeTexture;
 export type ShadeMaterial = import("../ShadeMaterial.js").ShadeMaterial;
 export type StandardShadeMaterial = import("../StandardShadeMaterial.js").StandardShadeMaterial;
+export type ParticipatingMedium = import("../../medium/ParticipatingMedium.js").ParticipatingMedium;
 import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
 /**
  * @typedef {import("../../GraphicsContext.js").GraphicsContext} GraphicsContext
@@ -65,9 +86,15 @@ import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
  * @typedef {import("../../texture/ShadeTexture.js").ShadeTexture} ShadeTexture
  * @typedef {import("../ShadeMaterial.js").ShadeMaterial} ShadeMaterial
  * @typedef {import("../StandardShadeMaterial.js").StandardShadeMaterial} StandardShadeMaterial
+ * @typedef {import("../../medium/ParticipatingMedium.js").ParticipatingMedium} ParticipatingMedium
  */
 declare class MaterialInfo {
     id: number;
+    /**
+     * The {@link ShadeMaterial#version} the row was packed at; -1 before the first pack.
+     * @type {number}
+     */
+    version: number;
     /**
      * @type {StandardShadeMaterial}
      */
@@ -81,13 +108,20 @@ declare class MaterialInfo {
      */
     texture_orm: TextureInfo;
     /**
-     * @type {TextureInfo}
+     * The material's normal map, or null for none — see {@link INDIRECT_MATERIAL_STRUCT}'s
+     * `texture_normal`.
+     * @type {TextureInfo|null}
      */
-    texture_normal: TextureInfo;
+    texture_normal: TextureInfo | null;
     /**
      * @type {TextureInfo}
      */
     texture_emissive: TextureInfo;
+    /**
+     * Slot of the material's medium in the media table, or GPU_DATABASE_NULL for none.
+     * @type {number}
+     */
+    medium_slot: number;
 }
 declare class TextureInfo {
     id: number;

package/src/shade/renderer/material/resident/GPUResidentMaterialContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUResidentMaterialContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/resident/GPUResidentMaterialContext.js"],"names":[],"mappings":"AAgFA,sDAAuD;AAEvD,wDAAyD;AAEzD,+DAAiJ;AAEjJ,+DAA+I;AAE/I;IA8GI;;;;OAIG;IACH,yCAFW,eAAe,EAsCzB;IA3HD;;;OAGG;IACH,6BAEC;IAQD;;;OAGG;IACH,kCAEC;IAQD;;;OAGG;IACH,yCAEC;IAED;;;OAGG;IACH,kCAIC;IA0GD;;;;OAIG;IACH,0BAHW,aAAa,GACX,YAAY,CAIxB;IAgBD;;;;OAIG;IACH,wBAHW,YAAY,GACV,WAAW,CAIvB;IAGD,uBA+HC;IAED,wBA6EC;IAED;;;;OAIG;IACH,sCAFW,eAAe,QAUzB;IAoCD,eASC;IAGD,gBAGC;;CACJ;8BAziBY,OAAO,0BAA0B,EAAE,eAAe;8BAClD,OAAO,gCAAgC,EAAE,eAAe;2BACxD,OAAO,+BAA+B,EAAE,YAAY;4BACpD,OAAO,qBAAqB,EAAE,aAAa;oCAC3C,OAAO,6BAA6B,EAAE,qBAAqB;kCAZtC,oCAAoC;AAOtE;;;;;;GAMG;AAEH;IACI,WAAM;IAEN;;OAEG;IACH,QAFU,qBAAqB,CAExB;IAEP;;OAEG;IACH,gBAFU,WAAW,CAEP;IAEd;;OAEG;IACH,aAFU,WAAW,CAEV;IAEX;;OAEG;IACH,gBAFU,WAAW,CAEP;IACd;;OAEG;IACH,kBAFU,WAAW,CAEL;CACnB;AAED;IACI,WAAO;IAEP;;OAEG;IACH,QAFU,YAAY,CAEf;CACV"}
+{"version":3,"file":"GPUResidentMaterialContext.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/resident/GPUResidentMaterialContext.js"],"names":[],"mappings":"AA0HA,sDAAuD;AAEvD,wDAAyD;AAEzD,+DAAiJ;AAEjJ,+DAA+I;AAE/I;IAqKI;;;;OAIG;IACH,yCAFW,eAAe,EAiDzB;IA7LD;;;OAGG;IACH,6BAEC;IAQD;;;OAGG;IACH,kCAEC;IAQD;;;OAGG;IACH,yCAEC;IAED;;;OAGG;IACH,kCAIC;IAmED;;;;;OAKG;IACH,0BAEC;IAOD;;;;;;OAMG;IACH,8BAEC;IAqJD;;;;;;;;;OASG;IACH,0BAHW,aAAa,GACX,YAAY,CAmBxB;IAgBD;;;;OAIG;IACH,wBAHW,YAAY,GACV,WAAW,CAIvB;IAGD,uBA+HC;IAED,wBA8EC;IAED;;;;OAIG;IACH,sCAFW,eAAe,QAUzB;IAoCD,eAWC;IAGD,gBAIC;;CACJ;8BA/uBY,OAAO,0BAA0B,EAAE,eAAe;8BAClD,OAAO,gCAAgC,EAAE,eAAe;2BACxD,OAAO,+BAA+B,EAAE,YAAY;4BACpD,OAAO,qBAAqB,EAAE,aAAa;oCAC3C,OAAO,6BAA6B,EAAE,qBAAqB;kCAC3D,OAAO,qCAAqC,EAAE,mBAAmB;kCAZ5C,oCAAoC;AAMtE;;;;;;;GAOG;AAEH;IACI,WAAM;IAEN;;;OAGG;IACH,SAFU,MAAM,CAEJ;IAEZ;;OAEG;IACH,QAFU,qBAAqB,CAExB;IAEP;;OAEG;IACH,gBAFU,WAAW,CAEP;IAEd;;OAEG;IACH,aAFU,WAAW,CAEV;IAEX;;;;OAIG;IACH,gBAFU,WAAW,GAAC,IAAI,CAEZ;IACd;;OAEG;IACH,kBAFU,WAAW,CAEL;IAEhB;;;OAGG;IACH,aAFU,MAAM,CAEe;CAClC;AAqBD;IACI,WAAO;IAEP;;OAEG;IACH,QAFU,YAAY,CAEf;CACV"}

package/src/shade/renderer/material/resident/GPUResidentMaterialContext.js

@@ -5,13 +5,15 @@ import { isPowerOfTwo } from "../../../../core/math/isPowerOfTwo.js";
 import { round_up } from "../../../../core/math/round_up.js";
 import { TextureViewDescriptor } from "../../../descriptor/texture/TextureViewDescriptor.js";
 import { ShadeGPUCommandContext } from "../../../device/ShadeGPUCommandContext.js";
+import { GPU_DATABASE_NULL } from "../../buffer/table/GPU_DATABASE_NULL.js";
+import { MEDIA_TABLE_CAPACITY, MEDIA_TABLE_STRUCT } from "../../medium/MEDIA_TABLE_STRUCT.js";
+import { MEDIUM_STRUCT } from "../../medium/MEDIUM_STRUCT.js";
 import { write_gpu_typed_buffer } from "../../shader/type/serde/write_gpu_typed_buffer.js";
 import { ColorSpace } from "../../texture/ColorSpace.js";
 import { PIXEL_TEXTURE_ORM } from "../PIXEL_TEXTURE_ORM.js";
 import { render_copy_texture } from "../../postprocess/gtao/render_copy_texture.js";
 import { GPUTextureContext } from "../../texture/GPUTextureContext.js";
 import { sampler_descriptor_pack } from "../../texture/format/sampler_descriptor_pack.js";
-import { PIXEL_TEXTURE_NORMAL } from "../../texture/util/PIXEL_TEXTURE_NORMAL.js";
 import { WHITE_PIXEL_TEXTURE } from "../../texture/util/WHITE_PIXEL_TEXTURE.js";
 import { INDIRECT_MATERIAL_ARRAY_TYPE } from "./INDIRECT_MATERIAL_ARRAY_TYPE.js";
 import { INDIRECT_MATERIAL_STRUCT } from "./INDIRECT_MATERIAL_STRUCT.js";
@@ -22,11 +24,18 @@ import { INDIRECT_MATERIAL_STRUCT } from "./INDIRECT_MATERIAL_STRUCT.js";
  * @typedef {import("../../texture/ShadeTexture.js").ShadeTexture} ShadeTexture
  * @typedef {import("../ShadeMaterial.js").ShadeMaterial} ShadeMaterial
  * @typedef {import("../StandardShadeMaterial.js").StandardShadeMaterial} StandardShadeMaterial
+ * @typedef {import("../../medium/ParticipatingMedium.js").ParticipatingMedium} ParticipatingMedium
  */
 
 class MaterialInfo {
     id = 0
 
+    /**
+     * The {@link ShadeMaterial#version} the row was packed at; -1 before the first pack.
+     * @type {number}
+     */
+    version = -1
+
     /**
      * @type {StandardShadeMaterial}
      */
@@ -43,13 +52,40 @@ class MaterialInfo {
     texture_orm
 
     /**
-     * @type {TextureInfo}
+     * The material's normal map, or null for none — see {@link INDIRECT_MATERIAL_STRUCT}'s
+     * `texture_normal`.
+     * @type {TextureInfo|null}
      */
     texture_normal
     /**
      * @type {TextureInfo}
      */
     texture_emissive
+
+    /**
+     * Slot of the material's medium in the media table, or GPU_DATABASE_NULL for none.
+     * @type {number}
+     */
+    medium_slot = GPU_DATABASE_NULL
+}
+
+class MediumInfo {
+    /**
+     * Row of the media table this medium is written at.
+     * @type {number}
+     */
+    slot = 0
+
+    /**
+     * The {@link ParticipatingMedium#version} the row was written at; -1 until it first is.
+     * @type {number}
+     */
+    version = -1
+
+    /**
+     * @type {ParticipatingMedium}
+     */
+    source;
 }
 
 class TextureInfo {
@@ -61,6 +97,12 @@ class TextureInfo {
     source;
 }
 
+/**
+ * Byte offset of the media table's first record, after its count.
+ * @type {number}
+ */
+const MEDIA_TABLE_RECORDS_OFFSET = MEDIA_TABLE_STRUCT.fields.find(f => f.name === 'records').offset;
+
 /**
  * What a material that is not standard contributes to the ray passes: white, opaque, fully rough,
  * not metallic, not transmissive, not emissive — through the default textures its missing slots
@@ -161,10 +203,14 @@ export class GPUResidentMaterialContext {
     }
 
     /**
+     * One entry per material object, never one per equal value: a mesh row names its own
+     * material's id and the shaders read `materials[mesh.material]`, so a material that only
+     * equals another — a clone — still needs the row at its own id. Shared by `equals()`, that row
+     * was never written: zeroed, opacity 0, a surface rays passed through.
      *
-     * @type {HashMap<ShadeMaterial, MaterialInfo>}
+     * @type {Map<ShadeMaterial, MaterialInfo>}
      */
-    #material_cache = new HashMap();
+    #material_cache = new Map();
 
     /**
      *
@@ -196,6 +242,57 @@ export class GPUResidentMaterialContext {
      */
     #version_managed_materials = 0;
 
+    /**
+     * The media the resident materials fill their insides with, one row each, shared by every
+     * material that names the same medium. Rows are dense ({@link #media_slots}), unlike material
+     * rows, which sit at the material's own id. Like materials, a medium stays resident once seen.
+     *
+     * @type {Map<ParticipatingMedium, MediumInfo>}
+     */
+    #media = new Map();
+
+    /**
+     * @type {IdPool}
+     */
+    #media_slots = new IdPool();
+
+    /**
+     * Whether the table's count is the number of resident media.
+     * @type {boolean}
+     */
+    #media_count_written = false;
+
+    /**
+     * @type {number}
+     */
+    #media_limit = 0;
+
+    /**
+     * How many media the table can hold: what {@link MEDIA_TABLE_STRUCT} addresses, within the
+     * device's uniform binding size.
+     *
+     * @returns {number}
+     */
+    get media_limit() {
+        return this.#media_limit;
+    }
+
+    /**
+     * @type {GPUBuffer}
+     */
+    #buffer_media;
+
+    /**
+     * The media table, {@link MEDIA_TABLE_STRUCT}: how many media are resident, then one
+     * {@link MEDIUM_STRUCT} per slot, the slot a material row names in its `medium` field. A uniform
+     * buffer, written in place as media change.
+     *
+     * @returns {GPUBuffer}
+     */
+    get buffer_media() {
+        return this.#buffer_media;
+    }
+
     /**
      *
      * @param {GPUDevice} device
@@ -227,6 +324,17 @@ export class GPUResidentMaterialContext {
             size: INDIRECT_MATERIAL_STRUCT.size * this.#material_limit,
         });
 
+        this.#media_limit = Math.min(
+            Math.floor((limits.maxUniformBufferBindingSize - MEDIA_TABLE_RECORDS_OFFSET) / MEDIUM_STRUCT.size),
+            MEDIA_TABLE_CAPACITY
+        );
+
+        this.#buffer_media = device.createBuffer({
+            label: 'Participating Media',
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            size: MEDIA_TABLE_STRUCT.size,
+        });
+
         this.#buffer_textures = new GPUTextureContext(device);
         const descriptor = this.#buffer_textures.descriptor;
 
@@ -241,36 +349,124 @@ export class GPUResidentMaterialContext {
 
 
     /**
+     * Pack a material's row from its current fields, and remember the version that was.
      *
-     * @param {StandardShadeMaterial} material
-     * @returns {MaterialInfo}
+     * @param {MaterialInfo} info
      */
-    #pack_material(material) {
-        const r = new MaterialInfo();
+    #pack_material(info) {
+        const material = info.source;
 
+        info.texture_albedo = this.obtain_texture(material.texture_albedo ?? WHITE_PIXEL_TEXTURE);
+        info.texture_orm = this.obtain_texture(material.texture_orm ?? PIXEL_TEXTURE_ORM);
+        // no default stands in for a missing normal map: the atlas cannot hold the flat texel
+        const texture_normal = material.texture_normal ?? null;
 
-        r.id = material.id;
+        info.texture_normal = texture_normal === null ? null : this.obtain_texture(texture_normal);
+        info.texture_emissive = this.obtain_texture(material.texture_emissive ?? WHITE_PIXEL_TEXTURE);
 
-        r.source = material;
+        const medium = material.isStandardShadeMaterial === true ? material.medium : null;
 
-        r.texture_albedo = this.obtain_texture(material.texture_albedo ?? WHITE_PIXEL_TEXTURE);
-        r.texture_orm = this.obtain_texture(material.texture_orm ?? PIXEL_TEXTURE_ORM);
-        r.texture_normal = this.obtain_texture(material.texture_normal ?? PIXEL_TEXTURE_NORMAL);
-        r.texture_emissive = this.obtain_texture(material.texture_emissive ?? WHITE_PIXEL_TEXTURE);
+        info.medium_slot = medium === null ? GPU_DATABASE_NULL : this.#obtain_medium(medium).slot;
 
+        info.version = material.version;
 
         this.#version++;
+    }
 
-        return r;
+    /**
+     * Give a medium its row, once. Its record is written by {@link #write_media}, which also
+     * rewrites it whenever its version moves.
+     *
+     * @param {ParticipatingMedium} medium
+     * @returns {MediumInfo}
+     */
+    #obtain_medium(medium) {
+        assert.equal(medium.isParticipatingMedium, true, 'medium.isParticipatingMedium !== true');
+
+        let info = this.#media.get(medium);
+
+        if (info === undefined) {
+            info = new MediumInfo();
+
+            info.slot = this.#media_slots.get();
+            info.source = medium;
+
+            assert.lessThan(
+                info.slot,
+                this.#media_limit,
+                `medium slot ${info.slot} exceeds the media limit (=${this.#media_limit})`
+            );
+
+            this.#media.set(medium, info);
+
+            this.#media_count_written = false;
+        }
+
+        return info;
     }
 
     /**
+     * Write every resident medium whose version has moved since its row was last written — new
+     * ones included. Media are few and shared, so this looks at each of them per update rather than
+     * hearing from the materials that name them: an edit to a medium changes no material.
+     */
+    #write_media() {
+        if (!this.#media_count_written) {
+            // slots are dense and never given back, so the count is how many there are
+            this.#device.queue.writeBuffer(this.#buffer_media, 0, new Uint32Array([this.#media.size]));
+
+            this.#media_count_written = true;
+        }
+
+        /** @type {ArrayBuffer|null} */
+        let bytes = null;
+
+        for (const info of this.#media.values()) {
+            const medium = info.source;
+
+            if (info.version === medium.version) {
+                continue;
+            }
+
+            if (bytes === null) {
+                bytes = new ArrayBuffer(MEDIUM_STRUCT.size);
+            }
+
+            write_gpu_typed_buffer(medium.to_gpu_record(), MEDIUM_STRUCT, bytes, 0);
+
+            this.#device.queue.writeBuffer(this.#buffer_media, MEDIA_TABLE_RECORDS_OFFSET + info.slot * MEDIUM_STRUCT.size, bytes);
+
+            info.version = medium.version;
+        }
+    }
+
+    /**
+     * Make a material resident, or repack it if its {@link ShadeMaterial#version} has moved since —
+     * the same contract {@link GPUMaterialManager} restages by. A hit used to be final, so a factor
+     * set after the first pack never reached the row. Every caller re-obtains what it needs before
+     * {@link update}: the scene's drawn list, and the manager's materials whenever its version
+     * moves, so the check rides on walks that already happen.
      *
      * @param {ShadeMaterial} material
      * @returns {MaterialInfo}
      */
     obtain_material(material) {
-        return this.#material_cache.getOrCompute(material, this.#pack_material, this);
+        let info = this.#material_cache.get(material);
+
+        if (info === undefined) {
+            info = new MaterialInfo();
+
+            info.id = material.id;
+            info.source = material;
+
+            this.#material_cache.set(material, info);
+
+            this.#pack_material(info);
+        } else if (info.version !== material.version) {
+            this.#pack_material(info);
+        }
+
+        return info;
     }
 
     /**
@@ -481,11 +677,11 @@ export class GPUResidentMaterialContext {
                 {
                     texture_albedo: info.texture_albedo.id,
                     texture_orm: info.texture_orm.id,
-                    texture_normal: info.texture_normal.id,
+                    texture_normal: info.texture_normal === null ? GPU_DATABASE_NULL : info.texture_normal.id,
                     texture_emissive: info.texture_emissive.id,
                     sampler_albedo: sampler_descriptor_pack(info.texture_albedo.source),
                     sampler_orm: sampler_descriptor_pack(info.texture_orm.source),
-                    sampler_normal: sampler_descriptor_pack(info.texture_normal.source),
+                    sampler_normal: info.texture_normal === null ? 0 : sampler_descriptor_pack(info.texture_normal.source),
                     sampler_emissive: sampler_descriptor_pack(info.texture_emissive.source),
                     color_albedo: surface.diffuse_color,
                     roughness_factor: surface.roughness_factor,
@@ -493,6 +689,7 @@ export class GPUResidentMaterialContext {
                     transmission_factor: surface.transmission_factor,
                     ior_factor: surface.ior_factor,
                     emissive_factor: surface.emissive_factor,
+                    medium: info.medium_slot,
                 },
                 INDIRECT_MATERIAL_STRUCT,
                 mapped_buffer_materials,
@@ -558,6 +755,8 @@ export class GPUResidentMaterialContext {
 
         this.#update_from_manager();
 
+        this.#write_media();
+
         if (this.#version === this.#version_commited) {
             return;
         }
@@ -568,6 +767,7 @@ export class GPUResidentMaterialContext {
 
     destroy() {
         this.#buffer_materials.destroy();
+        this.#buffer_media.destroy();
         this.#buffer_textures.destroy();
     }
 }

package/src/shade/renderer/material/resident/INDIRECT_MATERIAL_STRUCT.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"INDIRECT_MATERIAL_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/resident/INDIRECT_MATERIAL_STRUCT.js"],"names":[],"mappings":"AAGA,oDA0B2B;6BA5BE,mCAAmC"}
+{"version":3,"file":"INDIRECT_MATERIAL_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/resident/INDIRECT_MATERIAL_STRUCT.js"],"names":[],"mappings":"AAGA,oDAoC2B;6BAtCE,mCAAmC"}

package/src/shade/renderer/material/resident/INDIRECT_MATERIAL_STRUCT.js

@@ -4,6 +4,11 @@ import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
 export const INDIRECT_MATERIAL_STRUCT = WebGPUStruct.from({
     texture_albedo: u32,
     texture_orm: u32,
+    /**
+     * Atlas slot of the material's normal map, or GPU_DATABASE_NULL for none, which shades with the
+     * geometric normal. Not a default texture, as the other slots have: the atlas is rgba8unorm, and
+     * the flat texel is 0.5, which 8 bits store as 128/255 — a normal leaning 0.32 degrees.
+     */
     texture_normal: u32,
     texture_emissive: u32,
 
@@ -27,4 +32,9 @@ export const INDIRECT_MATERIAL_STRUCT = WebGPUStruct.from({
      */
     ior_factor: f32,
     emissive_factor: vec3f,
+    /**
+     * Slot of the material's {@link StandardShadeMaterial.medium} in the resident media table, or
+     * GPU_DATABASE_NULL for none. Sits in what was the struct's tail padding.
+     */
+    medium: u32,
 }, "IndirectMaterialInfo");

package/src/shade/renderer/medium/MEDIA_TABLE_STRUCT.d.ts

@@ -0,0 +1,17 @@
+/**
+ * How many media the resident media table holds: what fits in the baseline 65536-byte uniform
+ * binding after the table's 16-byte header.
+ * @type {number}
+ */
+export const MEDIA_TABLE_CAPACITY: number;
+/**
+ * The resident media table as the ray passes bind it, as the uniform `media`: how many media are
+ * resident, and one {@link MEDIUM_STRUCT} per slot, the slot a material row names in its `medium`
+ * field. The count lets a pass skip everything media cost it — the probe for which media a path
+ * starts inside — in a scene that has none. Uniform rather than storage because every pass tracing
+ * with `render_trace_path` binds it, and the Brick4 probe bake already uses all ten storage buffers
+ * the engine requires.
+ */
+export const MEDIA_TABLE_STRUCT: WebGPUStruct;
+import { WebGPUStruct } from "../shader/type/WebGPUStruct.js";
+//# sourceMappingURL=MEDIA_TABLE_STRUCT.d.ts.map

package/src/shade/renderer/medium/MEDIA_TABLE_STRUCT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MEDIA_TABLE_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/medium/MEDIA_TABLE_STRUCT.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,mCAFU,MAAM,CAEkE;AAElF;;;;;;;GAOG;AACH,8CAG8B;6BArBD,gCAAgC"}