@woosh/meep-engine 3.38.0 → 3.40.0

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader_sh_exp_project.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_project.js"],"names":[],"mappings":"AAgFA;;;;;;;;;;;;;GAaG;AACH,oCAFU,aAAa,CAMpB;8BA9F2B,kCAAkC"}

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_project.js

@@ -0,0 +1,99 @@
+import { chunk_sh_band_of_index } from "../../../shader/chunk/spherical_harmonics/chunk_sh_band_of_index.js";
+import { chunk_sh_basis_function } from "../../../shader/chunk/spherical_harmonics/chunk_sh_basis_function.js";
+import { chunk_sh_vmf_window } from "../../../shader/chunk/spherical_harmonics/chunk_sh_vmf_window.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
+import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
+import { vec4f } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { chunk_sh_exp_workgroup_sum, SH_EXP_WORKGROUP_SIZE } from "./chunk_sh_exp_workgroup_sum.js";
+import { SH_EXP_ENCODE_PARAMETERS_STRUCT } from "./SH_EXP_ENCODE_PARAMETERS_STRUCT.js";
+
+const resources = new ShaderResourceSetDescriptor();
+
+resources.createGroup()
+    .addUniform("parameters", SH_EXP_ENCODE_PARAMETERS_STRUCT)
+    .addStorageBuffer("samples", WebGPUArray.from(vec4f), false)
+    .addStorageBuffer("reflectance", WebGPUArray.from(vec4f), false)
+    .addStorageBuffer("statistics", WebGPUArray.from(vec4f), false)
+    .addStorageBuffer("projection", WebGPUArray.from(vec4f), true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+const WORKGROUP_SIZE : u32 = ${SH_EXP_WORKGROUP_SIZE}u;
+
+// One workgroup per unknown of the fit.
+@compute @workgroup_size(${SH_EXP_WORKGROUP_SIZE})
+fn main(
+    @builtin(workgroup_id) workgroup_id: vec3<u32>,
+    @builtin(local_invocation_index) local_index: u32,
+) {
+    let coefficient = workgroup_id.x;
+
+    let p_count = parameters.p_band_count * parameters.p_band_count;
+    let in_p = coefficient < p_count;
+
+    // Q's band 0 is P's, so Q's unknowns start at its coefficient 1
+    let index = select(coefficient - p_count + 1u, coefficient, in_p);
+    let l = sh_band_of_index(index);
+    let m = i32(index) - i32(l * (l + 1u));
+
+    let log_floor = statistics[0].x;
+    let sample_count = parameters.sample_count;
+
+    // sixteen steps at the default 4096 samples
+    let iterations = (sample_count + WORKGROUP_SIZE - 1u) / WORKGROUP_SIZE;
+
+    var accumulated = vec3<f32>(0.0);
+
+    for (var k = 0u; k < iterations; k++) {
+        let sample_index = k * WORKGROUP_SIZE + local_index;
+
+        if (sample_index < sample_count) {
+            let normal_alpha = samples[2u * sample_index];
+            let normal = normal_alpha.xyz;
+            let view = samples[2u * sample_index + 1u].xyz;
+
+            // the reflection-half-reflection parametrization: P sees r, Q sees h_r
+            let r = reflect(-view, normal);
+            let h_r = normalize(normal + r);
+
+            let design = sh_vmf_window(f32(l), 1.0 / normal_alpha.w) * sh_basis_function(m, i32(l), select(h_r, r, in_p));
+
+            accumulated += design * log(max(reflectance[sample_index].xyz, vec3<f32>(log_floor)));
+        }
+    }
+
+    let total = sh_exp_workgroup_sum(vec4<f32>(accumulated, 0.0), local_index);
+
+    if (local_index == 0u) {
+        projection[coefficient] = vec4<f32>(total.xyz / f32(sample_count), 0.0);
+    }
+}
+`, [
+    chunk_sh_band_of_index,
+    chunk_sh_basis_function,
+    chunk_sh_vmf_window,
+    chunk_sh_exp_workgroup_sum,
+]);
+
+/**
+ * Fourth pass of the SH-exponential encoder: the right-hand side of the fit's normal equations,
+ * `Aᵀ log E0 / S` — for each unknown, the mean over the fit samples of its design-row entry times
+ * the floored log of the reference reflectance.
+ *
+ * The design row is Silvennoinen et al.'s row constraint (HPG 2025, https://doi.org/10.1111/cgf.70219):
+ * `vMF(1/alpha) ⊙ Y(r)` for P, `vMF(1/alpha) ⊙ Y(h_r)` for Q, built here one coefficient at a time by
+ * `sh_basis_function` so that one kernel serves every band count. Its CPU twin is
+ * `sh_exp_design_row`, which the solve matrix this is multiplied by was built from.
+ *
+ * Writes `(rgb, 0)` per unknown into `projection`. Dispatch `coefficient_count` workgroups.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_sh_exp_project = ComputeShader.from({
+    label: "SH exponential / project",
+    resources,
+    body,
+});

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_reference_reflectance.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Second pass of the SH-exponential encoder: the reference the fit is solved against, Silvennoinen et
+ * al.'s base reflectance
+ *
+ *     E0(v, n, alpha) = ∫ L(l) f_DV(v, n, l, alpha) <l, n> dl
+ *
+ * (HPG 2025, https://doi.org/10.1111/cgf.70219, "Our Factorization"), at every fit sample, by
+ * quadrature over the cells of `shader_sh_exp_environment_cells`. `f_DV` is the engine's GGX
+ * distribution times its height-correlated Smith visibility — the BRDF the split-sum LUT integrates —
+ * without Fresnel, which the reconstruction applies (`sh_exp_specular`).
+ *
+ * A deterministic quadrature rather than importance sampling: no noise in the fit's right-hand side,
+ * and the spec can hold it to a closed form (at `alpha = 1`, `E0` of a white environment is
+ * `1 - NoV * ln(1 + 1 / NoV)`). Cells of a 64 grid are ~3° across; fitting over it or over a 128 grid
+ * gave the same reconstruction error to the third decimal even at alpha 0.1, below the default range
+ * (f64 prototype, Venice-sunset map, 2026-10-03).
+ *
+ * Writes `(E0.rgb, 0)` per sample into `reflectance`. Dispatch `sample_count` workgroups.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_sh_exp_reference_reflectance: ComputeShader;
+import { ComputeShader } from "../../../shader/ComputeShader.js";
+//# sourceMappingURL=shader_sh_exp_reference_reflectance.d.ts.map

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_reference_reflectance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader_sh_exp_reference_reflectance.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_reference_reflectance.js"],"names":[],"mappings":"AA8EA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,kDAFU,aAAa,CAMpB;8BApG2B,kCAAkC"}

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_reference_reflectance.js

@@ -0,0 +1,104 @@
+import { chunk_D_GGX } from "../../../shader/chunk/brdf/chunk_D_GGX.js";
+import { chunk_V_GGX_SmithCorrelated } from "../../../shader/chunk/brdf/chunk_V_GGX_SmithCorrelated.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
+import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
+import { vec4f } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { chunk_sh_exp_workgroup_sum, SH_EXP_WORKGROUP_SIZE } from "./chunk_sh_exp_workgroup_sum.js";
+import { SH_EXP_ENCODE_PARAMETERS_STRUCT } from "./SH_EXP_ENCODE_PARAMETERS_STRUCT.js";
+
+const resources = new ShaderResourceSetDescriptor();
+
+resources.createGroup()
+    .addUniform("parameters", SH_EXP_ENCODE_PARAMETERS_STRUCT)
+    .addStorageBuffer("samples", WebGPUArray.from(vec4f), false)
+    .addStorageBuffer("cells", WebGPUArray.from(vec4f), false)
+    .addStorageBuffer("reflectance", WebGPUArray.from(vec4f), true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+const WORKGROUP_SIZE : u32 = ${SH_EXP_WORKGROUP_SIZE}u;
+
+// One workgroup per fit sample.
+@compute @workgroup_size(${SH_EXP_WORKGROUP_SIZE})
+fn main(
+    @builtin(workgroup_id) workgroup_id: vec3<u32>,
+    @builtin(local_invocation_index) local_index: u32,
+) {
+    let sample_index = workgroup_id.x;
+
+    let normal_alpha = samples[2u * sample_index];
+    let normal = normal_alpha.xyz;
+    let alpha = normal_alpha.w;
+    let view = samples[2u * sample_index + 1u].xyz;
+
+    // the fit samples keep dot(normal, view) at 0.01 or above
+    let NoV = dot(normal, view);
+    let alpha2 = alpha * alpha;
+
+    let cell_count = parameters.cell_resolution * parameters.cell_resolution;
+
+    // sixteen steps at the 64-cell grid
+    let iterations = (cell_count + WORKGROUP_SIZE - 1u) / WORKGROUP_SIZE;
+
+    var reflected = vec3<f32>(0.0);
+
+    for (var k = 0u; k < iterations; k++) {
+        let cell = k * WORKGROUP_SIZE + local_index;
+
+        if (cell < cell_count) {
+            let light = cells[2u * cell].xyz;
+            let NoL = dot(normal, light);
+
+            if (NoL > 0.0) {
+                let half_vector = normalize(light + view);
+                let NoH = saturate(dot(normal, half_vector));
+
+                // f_DV: the GGX microfacet BRDF with the Fresnel term left out
+                let brdf = D_GGX(alpha2, NoH * NoH) * V_GGX_SmithCorrelated(alpha, NoL, NoV);
+
+                reflected += cells[2u * cell + 1u].xyz * (brdf * NoL);
+            }
+        }
+    }
+
+    let total = sh_exp_workgroup_sum(vec4<f32>(reflected, 0.0), local_index);
+
+    if (local_index == 0u) {
+        reflectance[sample_index] = vec4<f32>(total.xyz, 0.0);
+    }
+}
+`, [
+    chunk_D_GGX,
+    chunk_V_GGX_SmithCorrelated,
+    chunk_sh_exp_workgroup_sum,
+]);
+
+/**
+ * Second pass of the SH-exponential encoder: the reference the fit is solved against, Silvennoinen et
+ * al.'s base reflectance
+ *
+ *     E0(v, n, alpha) = ∫ L(l) f_DV(v, n, l, alpha) <l, n> dl
+ *
+ * (HPG 2025, https://doi.org/10.1111/cgf.70219, "Our Factorization"), at every fit sample, by
+ * quadrature over the cells of `shader_sh_exp_environment_cells`. `f_DV` is the engine's GGX
+ * distribution times its height-correlated Smith visibility — the BRDF the split-sum LUT integrates —
+ * without Fresnel, which the reconstruction applies (`sh_exp_specular`).
+ *
+ * A deterministic quadrature rather than importance sampling: no noise in the fit's right-hand side,
+ * and the spec can hold it to a closed form (at `alpha = 1`, `E0` of a white environment is
+ * `1 - NoV * ln(1 + 1 / NoV)`). Cells of a 64 grid are ~3° across; fitting over it or over a 128 grid
+ * gave the same reconstruction error to the third decimal even at alpha 0.1, below the default range
+ * (f64 prototype, Venice-sunset map, 2026-10-03).
+ *
+ * Writes `(E0.rgb, 0)` per sample into `reflectance`. Dispatch `sample_count` workgroups.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_sh_exp_reference_reflectance = ComputeShader.from({
+    label: "SH exponential / reference reflectance",
+    resources,
+    body,
+});

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_solve.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Last pass of the SH-exponential encoder: the coefficients, `x = M⁻¹ · projection` with the solve
+ * matrix built on the CPU (`sh_exp_solve_matrix`), written as a probe in the layout
+ * `sh_exp_probe_vec4_count` describes — header, P, Q — at `output_offset`.
+ *
+ * Dispatch `coefficient_count` workgroups.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_sh_exp_solve: ComputeShader;
+import { ComputeShader } from "../../../shader/ComputeShader.js";
+//# sourceMappingURL=shader_sh_exp_solve.d.ts.map

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_solve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader_sh_exp_solve.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_solve.js"],"names":[],"mappings":"AA+EA;;;;;;;;GAQG;AACH,kCAFU,aAAa,CAMpB;8BA3F2B,kCAAkC"}

package/src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_solve.js

@@ -0,0 +1,93 @@
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import { ComputeShader } from "../../../shader/ComputeShader.js";
+import { ShaderResourceSetDescriptor } from "../../../shader/resource/ShaderResourceSetDescriptor.js";
+import { WebGPUArray } from "../../../shader/type/WebGPUArray.js";
+import { f32, vec4f } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { chunk_sh_exp_workgroup_sum } from "./chunk_sh_exp_workgroup_sum.js";
+import { SH_EXP_ENCODE_PARAMETERS_STRUCT } from "./SH_EXP_ENCODE_PARAMETERS_STRUCT.js";
+
+/**
+ * Invocations per unknown. Ten-and-ten bands is 199 unknowns, four steps each.
+ *
+ * @type {number}
+ */
+const SOLVE_WORKGROUP_SIZE = 64;
+
+const resources = new ShaderResourceSetDescriptor();
+
+resources.createGroup()
+    .addUniform("parameters", SH_EXP_ENCODE_PARAMETERS_STRUCT)
+    .addStorageBuffer("solve_matrix", WebGPUArray.from(f32), false)
+    .addStorageBuffer("projection", WebGPUArray.from(vec4f), false)
+    .addStorageBuffer("probe", WebGPUArray.from(vec4f), true);
+
+const body = CodeChunk.from(
+    //language=WGSL
+    `
+const WORKGROUP_SIZE : u32 = ${SOLVE_WORKGROUP_SIZE}u;
+
+// One workgroup per unknown of the fit.
+@compute @workgroup_size(${SOLVE_WORKGROUP_SIZE})
+fn main(
+    @builtin(workgroup_id) workgroup_id: vec3<u32>,
+    @builtin(local_invocation_index) local_index: u32,
+) {
+    let coefficient = workgroup_id.x;
+    let coefficient_count = parameters.coefficient_count;
+
+    let iterations = (coefficient_count + WORKGROUP_SIZE - 1u) / WORKGROUP_SIZE;
+
+    var accumulated = vec3<f32>(0.0);
+
+    for (var k = 0u; k < iterations; k++) {
+        let j = k * WORKGROUP_SIZE + local_index;
+
+        if (j < coefficient_count) {
+            accumulated += solve_matrix[coefficient * coefficient_count + j] * projection[j].xyz;
+        }
+    }
+
+    let total = sh_exp_workgroup_sum(vec4<f32>(accumulated, 0.0), local_index);
+
+    if (local_index != 0u) {
+        return;
+    }
+
+    let p_count = parameters.p_band_count * parameters.p_band_count;
+    let base = parameters.output_offset;
+
+    // [header][P: p_count][Q: q_count, its band 0 kept at zero]; Q's unknowns start at its coefficient 1,
+    // so unknown j >= p_count lands at 1 + p_count + (j - p_count + 1)
+    let slot = select(2u + coefficient, 1u + coefficient, coefficient < p_count);
+
+    probe[base + slot] = vec4<f32>(total.xyz, 0.0);
+
+    if (coefficient == 0u) {
+        probe[base] = vec4<f32>(
+            parameters.alpha_min,
+            parameters.alpha_max,
+            f32(parameters.p_band_count),
+            f32(parameters.q_band_count)
+        );
+
+        probe[base + 1u + p_count] = vec4<f32>(0.0);
+    }
+}
+`, [
+    chunk_sh_exp_workgroup_sum,
+]);
+
+/**
+ * Last pass of the SH-exponential encoder: the coefficients, `x = M⁻¹ · projection` with the solve
+ * matrix built on the CPU (`sh_exp_solve_matrix`), written as a probe in the layout
+ * `sh_exp_probe_vec4_count` describes — header, P, Q — at `output_offset`.
+ *
+ * Dispatch `coefficient_count` workgroups.
+ *
+ * @type {ComputeShader}
+ */
+export const shader_sh_exp_solve = ComputeShader.from({
+    label: "SH exponential / solve",
+    resources,
+    body,
+});

package/src/shade/renderer/lightmap/GPULightMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPULightMap.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/lightmap/GPULightMap.js"],"names":[],"mappings":"AAmBA;IAgCI;;;OAGG;IACH,+BA6CC;IA/ED;;;OAGG;IACH,WAFU,iBAAiB,GAAC,IAAI,CAEf;IACjB;;;OAGG;IACH,cAFU,iBAAiB,GAAC,IAAI,CAEZ;IACpB;;;OAGG;IACH,cAFU,iBAAiB,GAAC,IAAI,CAEZ;IAEpB;;;OAGG;IACH,aAFU,iBAAiB,GAAC,IAAI,CAEb;IAEnB;;;OAGG;IACH,yBAEC;IA2ED;;;;OAIG;IACH,wEAmCC;IA6BD;;OAEG;IACH,oBA0DC;IAED,iBA4EC;IAED;;;;OAIG;IACH,kEAQC;;CAEJ;kCAxViC,iCAAiC"}
+{"version":3,"file":"GPULightMap.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/lightmap/GPULightMap.js"],"names":[],"mappings":"AAmBA;IAgCI;;;OAGG;IACH,+BA6CC;IA/ED;;;OAGG;IACH,WAFU,iBAAiB,GAAC,IAAI,CAEf;IACjB;;;OAGG;IACH,cAFU,iBAAiB,GAAC,IAAI,CAEZ;IACpB;;;OAGG;IACH,cAFU,iBAAiB,GAAC,IAAI,CAEZ;IAEpB;;;OAGG;IACH,aAFU,iBAAiB,GAAC,IAAI,CAEb;IAEnB;;;OAGG;IACH,yBAEC;IA2ED;;;;OAIG;IACH,wEAmCC;IA6BD;;OAEG;IACH,oBA2DC;IAED,iBA4EC;IAED;;;;OAIG;IACH,kEAQC;;CAEJ;kCAzViC,iCAAiC"}

package/src/shade/renderer/lightmap/GPULightMap.js

@@ -227,6 +227,7 @@ export class GPULightMap {
                 viz_buffer,
 
                 materials: r_materials.buffer_materials,
+                media: r_materials.buffer_media,
                 textures: r_materials.textureView,
                 tNoise: graphics.textures.obtain(HILBERT_R2_INDEX_TEXTURE).obtainView(),
 

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

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_viz_to_irradiance_flat.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_irradiance_flat.js"],"names":[],"mappings":"AAkOA,iEASE;4BAnM0B,6BAA6B"}
+{"version":3,"file":"shader_lightmap_viz_to_irradiance_flat.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/bake/shader_lightmap_viz_to_irradiance_flat.js"],"names":[],"mappings":"AAsOA,iEASE;4BArM0B,6BAA6B"}

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 "__#259@#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"}