@woosh/meep-engine 3.49.0 → 3.51.0

package/src/shade/renderer/light/environment/resample_cube_to_octahedral.js

@@ -2,6 +2,7 @@ import { assert } from "../../../../core/assert.js";
 import { Sampler2D } from "../../../../engine/graphics/texture/sampler/Sampler2D.js";
 import { SAMPLE_OFFSETS, SAMPLE_WEIGHTS, SUPER_SAMPLE_COUNT } from "./octahedral_resample_kernel.js";
 import { octahedral_z_pole_uv_to_direction } from "./octahedral_z_pole_uv_to_direction.js";
+import { sampler2d_octahedral_skirt_fill } from "./sampler2d_octahedral_skirt_fill.js";
 
 /**
  * Standard cube-map face selection — the GL/D3D/WebGPU table — for a direction already in cube
@@ -100,28 +101,39 @@ const SCRATCH_SAMPLE = new Float64Array(3);
  *
  * @param {Sampler2D[]} faces six faces in +X, -X, +Y, -Y, +Z, -Z order — what `buildCubeURLs`
  * emits and what `CubeTextureLoader` consumes
- * @param {number} output_resolution
+ * With `skirt`, the octahedral square is resampled into the interior `output_resolution - 2` texels and
+ * a one-texel octahedral skirt is written around it — the layout the renderer requires of an
+ * environment map (see `sampler2d_octahedral_skirt_fill`).
+ *
+ * @param {number} output_resolution side of the output, skirt included
+ * @param {boolean} [skirt]
  * @returns {Sampler2D} float32 RGBA, opaque
  */
-export function resample_cube_to_octahedral(faces, output_resolution) {
+export function resample_cube_to_octahedral(faces, output_resolution, skirt = true) {
     assert.equal(faces.length, 6, 'faces.length');
     assert.isNonNegativeInteger(output_resolution, 'output_resolution');
+    assert.isBoolean(skirt, 'skirt');
+
+    const border = skirt ? 1 : 0;
+    const interior = output_resolution - 2 * border;
+
+    assert.greaterThan(interior, 0, 'interior resolution');
 
     const output = Sampler2D.float32(4, output_resolution, output_resolution);
 
     // the alpha channel is written once, here
     output.data.fill(1);
 
-    for (let y = 0; y < output_resolution; y++) {
-        for (let x = 0; x < output_resolution; x++) {
+    for (let y = 0; y < interior; y++) {
+        for (let x = 0; x < interior; x++) {
 
             SCRATCH_SAMPLE.fill(0);
 
             let weight_sum = 0;
 
             for (let s = 0; s < SUPER_SAMPLE_COUNT; s++) {
-                const u = (x + SAMPLE_OFFSETS[s * 2] + 0.5) / output_resolution;
-                const v = (y + SAMPLE_OFFSETS[s * 2 + 1] + 0.5) / output_resolution;
+                const u = (x + SAMPLE_OFFSETS[s * 2] + 0.5) / interior;
+                const v = (y + SAMPLE_OFFSETS[s * 2 + 1] + 0.5) / interior;
 
                 // the direction the GPU will sample this texel for
                 octahedral_z_pole_uv_to_direction(SCRATCH_DIRECTION, u, v);
@@ -148,10 +160,14 @@ export function resample_cube_to_octahedral(faces, output_resolution) {
             }
 
             for (let i = 0; i < 3; i++) {
-                output.writeChannel(x, y, i, SCRATCH_SAMPLE[i] / weight_sum);
+                output.writeChannel(x + border, y + border, i, SCRATCH_SAMPLE[i] / weight_sum);
             }
         }
     }
 
+    if (skirt) {
+        sampler2d_octahedral_skirt_fill(output);
+    }
+
     return output;
 }

package/src/shade/renderer/light/environment/resample_equirectangular_to_octahedral.d.ts

@@ -1,8 +1,14 @@
 /**
+ * With `skirt`, the octahedral square is resampled into the interior `output_resolution - 2` texels and
+ * a one-texel octahedral skirt is written around it — the layout the renderer requires of an
+ * environment map (see `sampler2d_octahedral_skirt_fill`). Without, the square fills the whole output,
+ * which is a map the renderer will refuse.
  *
  * @param {Sampler2D} input must be a float format
- * @param {number} output_resolution
+ * @param {number} output_resolution side of the output, skirt included
+ * @param {boolean} [skirt]
+ * @returns {Sampler2D} float32 RGBA
  */
-export function resample_equirectangular_to_octahedral(input: Sampler2D, output_resolution: number): Sampler2D;
+export function resample_equirectangular_to_octahedral(input: Sampler2D, output_resolution: number, skirt?: boolean): Sampler2D;
 import { Sampler2D } from "../../../../engine/graphics/texture/sampler/Sampler2D.js";
 //# sourceMappingURL=resample_equirectangular_to_octahedral.d.ts.map

package/src/shade/renderer/light/environment/resample_equirectangular_to_octahedral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resample_equirectangular_to_octahedral.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/resample_equirectangular_to_octahedral.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,8DAHW,SAAS,qBACT,MAAM,aAoEhB;0BA5EyB,0DAA0D"}
+{"version":3,"file":"resample_equirectangular_to_octahedral.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/resample_equirectangular_to_octahedral.js"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,8DALW,SAAS,qBACT,MAAM,UACN,OAAO,GACL,SAAS,CA8ErB;0BA7FyB,0DAA0D"}

package/src/shade/renderer/light/environment/resample_equirectangular_to_octahedral.js

@@ -3,14 +3,27 @@ import { Sampler2D } from "../../../../engine/graphics/texture/sampler/Sampler2D
 import { equirectangular_zenith_first_direction_to_uv } from "./equirectangular_zenith_first_direction_to_uv.js";
 import { SAMPLE_OFFSETS, SAMPLE_WEIGHTS, SUPER_SAMPLE_COUNT } from "./octahedral_resample_kernel.js";
 import { octahedral_z_pole_uv_to_direction } from "./octahedral_z_pole_uv_to_direction.js";
+import { sampler2d_octahedral_skirt_fill } from "./sampler2d_octahedral_skirt_fill.js";
 
 /**
+ * With `skirt`, the octahedral square is resampled into the interior `output_resolution - 2` texels and
+ * a one-texel octahedral skirt is written around it — the layout the renderer requires of an
+ * environment map (see `sampler2d_octahedral_skirt_fill`). Without, the square fills the whole output,
+ * which is a map the renderer will refuse.
  *
  * @param {Sampler2D} input must be a float format
- * @param {number} output_resolution
+ * @param {number} output_resolution side of the output, skirt included
+ * @param {boolean} [skirt]
+ * @returns {Sampler2D} float32 RGBA
  */
-export function resample_equirectangular_to_octahedral(input, output_resolution) {
+export function resample_equirectangular_to_octahedral(input, output_resolution, skirt = true) {
     assert.isNonNegativeInteger(output_resolution, "output_resolution");
+    assert.isBoolean(skirt, "skirt");
+
+    const border = skirt ? 1 : 0;
+    const interior = output_resolution - 2 * border;
+
+    assert.greaterThan(interior, 0, "interior resolution");
 
     const output = Sampler2D.float32(4, output_resolution, output_resolution);
 
@@ -22,8 +35,8 @@ export function resample_equirectangular_to_octahedral(input, output_resolution)
 
     const SAMPLE = new Float32Array(SUPER_SAMPLE_COUNT * 3);
 
-    for (let y = 0; y < output_resolution; y++) {
-        for (let x = 0; x < output_resolution; x++) {
+    for (let y = 0; y < interior; y++) {
+        for (let x = 0; x < interior; x++) {
 
             SAMPLE.fill(0);
             let weight_sum = 0;
@@ -36,8 +49,8 @@ export function resample_equirectangular_to_octahedral(input, output_resolution)
                 const sample_x = x + sample_offset_x;
                 const sample_y = y + sample_offset_y;
 
-                const out_u = (sample_x + 0.5) / output_resolution;
-                const out_v = (sample_y + 0.5) / output_resolution;
+                const out_u = (sample_x + 0.5) / interior;
+                const out_v = (sample_y + 0.5) / interior;
 
                 // The direction the GPU will sample this texel for — MUST be the exact inverse of
                 // uv_octahedral_unit_encode (the previous meep Y-pole decode with a negated U
@@ -69,10 +82,14 @@ export function resample_equirectangular_to_octahedral(input, output_resolution)
             for (let i = 0; i < 3; i++) {
                 const input_value = Math.max(0, SAMPLE[i] / weight_sum);
 
-                output.writeChannel(x, y, i, input_value);
+                output.writeChannel(x + border, y + border, i, input_value);
             }
         }
     }
 
+    if (skirt) {
+        sampler2d_octahedral_skirt_fill(output);
+    }
+
     return output;
 }

package/src/shade/renderer/light/environment/sampler2d_octahedral_skirt_fill.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Writes the one-texel octahedral skirt of `sampler` from its interior: every texel of the outer ring
+ * becomes a copy, all channels, of the interior texel the octahedral fold puts next to it.
+ *
+ * Environment maps carry this skirt so the GPU can filter them in hardware (see the WGSL
+ * `texture_octahedral_skirt_uv`). A producer computes the interior, `[1, size - 1)` on both axes,
+ * then calls this.
+ *
+ * @param {import("../../../../engine/graphics/texture/sampler/Sampler2D.js").Sampler2D} sampler square, at least 3x3
+ */
+export function sampler2d_octahedral_skirt_fill(sampler: import("../../../../engine/graphics/texture/sampler/Sampler2D.js").Sampler2D): void;
+//# sourceMappingURL=sampler2d_octahedral_skirt_fill.d.ts.map

package/src/shade/renderer/light/environment/sampler2d_octahedral_skirt_fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler2d_octahedral_skirt_fill.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/sampler2d_octahedral_skirt_fill.js"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,yDAFW,OAAO,0DAA0D,EAAE,SAAS,QAmBtF"}

package/src/shade/renderer/light/environment/sampler2d_octahedral_skirt_fill.js

@@ -0,0 +1,54 @@
+import { assert } from "../../../../core/assert.js";
+import { octahedral_skirt_source_texel } from "./octahedral_skirt_source_texel.js";
+
+/**
+ * @type {Uint32Array}
+ */
+const SCRATCH_SOURCE = new Uint32Array(2);
+
+/**
+ * Writes the one-texel octahedral skirt of `sampler` from its interior: every texel of the outer ring
+ * becomes a copy, all channels, of the interior texel the octahedral fold puts next to it.
+ *
+ * Environment maps carry this skirt so the GPU can filter them in hardware (see the WGSL
+ * `texture_octahedral_skirt_uv`). A producer computes the interior, `[1, size - 1)` on both axes,
+ * then calls this.
+ *
+ * @param {import("../../../../engine/graphics/texture/sampler/Sampler2D.js").Sampler2D} sampler square, at least 3x3
+ */
+export function sampler2d_octahedral_skirt_fill(sampler) {
+    const size = sampler.width;
+
+    assert.equal(sampler.height, size, 'octahedral map must be square');
+    assert.greaterThanOrEqual(size, 3, 'a skirted map needs an interior');
+
+    const data = sampler.data;
+    const item_size = sampler.itemSize;
+    const last = size - 1;
+
+    for (let i = 0; i < size; i++) {
+        // the four sides; the corners come round twice and are written the same both times
+        copy_from_source(data, item_size, size, i, 0);
+        copy_from_source(data, item_size, size, i, last);
+        copy_from_source(data, item_size, size, 0, i);
+        copy_from_source(data, item_size, size, last, i);
+    }
+}
+
+/**
+ * @param {ArrayLike<number>} data
+ * @param {number} item_size
+ * @param {number} size
+ * @param {number} x
+ * @param {number} y
+ */
+function copy_from_source(data, item_size, size, x, y) {
+    octahedral_skirt_source_texel(SCRATCH_SOURCE, x, y, size);
+
+    const target = (y * size + x) * item_size;
+    const source = (SCRATCH_SOURCE[1] * size + SCRATCH_SOURCE[0]) * item_size;
+
+    for (let c = 0; c < item_size; c++) {
+        data[target + c] = data[source + c];
+    }
+}

package/src/shade/renderer/light/environment/sh_exponential/README.md

@@ -75,7 +75,8 @@ views cosine-weighted about the normal (the screen footprint of a sphere), by α
    tabulates it, Lazarov fits it analytically). `sh_exp_specular` is single
    scattering; handing `sh_exp_radiance` to `compute_indirect_specular` adds the engine's
    multiple-scattering term on top. The engine's `split_sum.bin` weights its scale and bias both by
-   Hauber's fourth power, so its `A + B` is the albedo to within 0.06% (measured; see the chunk).
+   Schlick's fifth power, the direct lobe's Fresnel, and its `A + B` is the albedo to within 0.06% (measured;
+   see the chunk).
 3. **A fixed, deterministic sample set** (5-D Halton) instead of fresh random samples per encode: the
    least-squares matrix then depends on the configuration only, and is inverted once on the CPU in f64
    (8–14 ms for 33 unknowns at 4096 samples, 141 ms for 199 at 8192). The GPU does a reduction and a

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

@@ -10,8 +10,8 @@
  */
 export const SH_EXP_MAX_TEXELS_PER_CELL_SIDE: number;
 /**
- * First pass of the SH-exponential encoder: integrates the octahedral environment's level 0 down to a
- * coarse octahedral grid of `cell_resolution²` cells, each a direction and its radiance times solid
+ * First pass of the SH-exponential encoder: integrates the octahedral environment's level 0 — the
+ * square inside its one-texel skirt, so no texel is counted twice — down to a coarse octahedral grid of `cell_resolution²` cells, each a direction and its radiance times solid
  * angle — the quadrature the reference reflectance is integrated over.
  *
  * Writes two `vec4` per cell into `cells`: `(direction, 0)`, then `(radiance * solid_angle, solid_angle)`.

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

@@ -1 +1 @@
-{"version":3,"file":"shader_sh_exp_environment_cells.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_environment_cells.js"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,8CAFU,MAAM,CAEkC;AA0GlD;;;;;;;;;;;;;;;GAeG;AACH,8CAFU,aAAa,CAMpB;8BA/I2B,kCAAkC"}
+{"version":3,"file":"shader_sh_exp_environment_cells.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/light/environment/sh_exponential/shader_sh_exp_environment_cells.js"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,8CAFU,MAAM,CAEkC;AA2GlD;;;;;;;;;;;;;;;GAeG;AACH,8CAFU,aAAa,CAMpB;8BAhJ2B,kCAAkC"}

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

@@ -59,7 +59,8 @@ fn main(
     let cell_x = cell % resolution;
     let cell_y = cell / resolution;
 
-    let source_resolution = textureDimensions(tEnvironment, 0).x;
+    // the octahedral square only: the one-texel skirt around it repeats texels already counted
+    let source_resolution = textureDimensions(tEnvironment, 0).x - 2u;
     let inverse_source_resolution = 1.0 / f32(source_resolution);
 
     // The source texels whose centres fall in this cell. A source coarser than the grid has none in
@@ -97,7 +98,7 @@ fn main(
             let uv = (vec2<f32>(texel) + 0.5) * inverse_source_resolution;
 
             let solid_angle = octahedral_solid_angle(uv, inverse_source_resolution) * f32(block_size.x * block_size.y);
-            let radiance = textureLoad(tEnvironment, texel, 0).rgb;
+            let radiance = textureLoad(tEnvironment, texel + 1u, 0).rgb;
 
             accumulated += vec4<f32>(radiance * solid_angle, solid_angle);
         }
@@ -125,8 +126,8 @@ fn main(
 ]);
 
 /**
- * First pass of the SH-exponential encoder: integrates the octahedral environment's level 0 down to a
- * coarse octahedral grid of `cell_resolution²` cells, each a direction and its radiance times solid
+ * First pass of the SH-exponential encoder: integrates the octahedral environment's level 0 — the
+ * square inside its one-texel skirt, so no texel is counted twice — down to a coarse octahedral grid of `cell_resolution²` cells, each a direction and its radiance times solid
  * angle — the quadrature the reference reflectance is integrated over.
  *
  * Writes two `vec4` per cell into `cells`: `(direction, 0)`, then `(radiance * solid_angle, solid_angle)`.

package/src/shade/renderer/light/environment/shader_convolve_reflection_map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_convolve_reflection_map.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/shader_convolve_reflection_map.js"],"names":[],"mappings":"AA6HA,2DAII;8BA/G0B,+BAA+B"}
+{"version":3,"file":"shader_convolve_reflection_map.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/shader_convolve_reflection_map.js"],"names":[],"mappings":"AAiIA,2DAII;8BAnH0B,+BAA+B"}

package/src/shade/renderer/light/environment/shader_convolve_reflection_map.js

@@ -11,10 +11,10 @@ import {
 import { chunk_uniform_sample_cone } from "../../shader/chunk/geometry/ray/chunk_uniform_sample_cone.js";
 import { chunk_safe_rcp } from "../../shader/chunk/math/chunk_safe_rcp.js";
 import { chunk_hammersley_2d } from "../../shader/chunk/noise/chunk_hammersley_2d.js";
-import { chunk_texel_coordinate_to_uv } from "../../shader/chunk/texture/chunk_texel_coordinate_to_uv.js";
 import {
-    chunk_texture_octahedral_sample_bilinear
-} from "../../shader/chunk/texture/octahedral/chunk_texture_octahedral_sample_bilinear.js";
+    chunk_texture_octahedral_skirt_texel_uv
+} from "../../shader/chunk/texture/octahedral/chunk_texture_octahedral_skirt_texel_uv.js";
+import { chunk_texture_octahedral_skirt_uv } from "../../shader/chunk/texture/octahedral/chunk_texture_octahedral_skirt_uv.js";
 import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
 import { ComputeShader } from "../../shader/ComputeShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
@@ -23,6 +23,7 @@ import { chunk_reflection_sample_weight } from "./chunk_reflection_sample_weight
 import { chunk_roughness_from_relative_mip } from "./chunk_roughness_from_relative_mip.js";
 import { chunk_sphere_probe_lod_to_roughness } from "./chunk_sphere_probe_lod_to_roughness.js";
 import { BSDF_ROUGHNESS_MINIMUM } from "./DEFINES.js";
+import { ENVIRONMENT_MAP_SAMPLER_RESOURCE } from "./ENVIRONMENT_MAP_SAMPLER_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
@@ -32,8 +33,9 @@ const resources = new ShaderResourceSetDescriptor();
 resources.setImmediate("read_lod", "u32");
 
 resources.createGroup()
-    .addTexture("input")
+    .addTexture("input", "float")
     .addStorageTexture("output", "rgba16float")
+    .add(ENVIRONMENT_MAP_SAMPLER_RESOURCE)
 ;
 
 /**
@@ -78,7 +80,8 @@ fn main(
     let mip_roughness_clamped = max(mip_roughness, ${BSDF_ROUGHNESS_MINIMUM});
     let cone_cos = cone_cosine_from_roughness(mip_roughness_clamped);
 
-    let out_uv = texel_coordinate_to_uv(vec2<f32>(output_texel_i), output_size);
+    // the skirt too: a skirt texel takes its interior twin's uv, so it is that texel, computed again
+    let out_uv = texture_octahedral_skirt_texel_uv(output_texel_i, output_size.x);
     let out_direction = uv_octahedral_unit_decode( out_uv );
 
     let basis = build_orthonormal_matrix_n(out_direction);
@@ -88,14 +91,15 @@ fn main(
 
     const sample_count = ${SAMPLE_COUNT};
 
-    let input_size = textureDimensions(input).xy;
+    let input_size = f32(textureDimensions(input).x);
 
     for (var i = 0u; i < sample_count; i++) {
         let rand = hammersley_2d(i, sample_count);
 
         let in_direction = normalize(basis * uniform_sample_cone(rand, cone_cos));
 
-        let radiance = texture_octahedral_sample_bilinear(input, vec2(0u), input_size.x, in_direction, 0);
+        let in_uv = texture_octahedral_skirt_uv(uv_octahedral_unit_encode(in_direction), input_size);
+        let radiance = textureSampleLevel(input, sEnvironment, in_uv, 0.0);
 
         let weight = reflection_sample_weight(out_direction, in_direction, mip_roughness_clamped);
 
@@ -113,10 +117,10 @@ fn main(
         chunk_build_orthonormal_matrix_n,
         chunk_safe_rcp,
         chunk_uniform_sample_cone,
-        chunk_texel_coordinate_to_uv,
+        chunk_texture_octahedral_skirt_texel_uv,
+        chunk_texture_octahedral_skirt_uv,
         chunk_uv_octahedral_unit_decode,
         chunk_uv_octahedral_unit_encode,
-        chunk_texture_octahedral_sample_bilinear,
         chunk_reflection_sample_weight,
         chunk_cone_cosine_from_roughness,
         chunk_roughness_from_relative_mip

package/src/shade/renderer/light/environment/shader_project_environment_sh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_project_environment_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/shader_project_environment_sh.js"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,kCAFU,WAAW,CAEyC;AAE9D;;;;;;GAMG;AACH,0CAFU,MAAM,CAE+B;AAuF/C;;;;;;;;;;;;;;GAcG;AACH,4CAFU,aAAa,CAMpB;4BA/HyB,kCAAkC;8BAFhC,+BAA+B"}
+{"version":3,"file":"shader_project_environment_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/shader_project_environment_sh.js"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,kCAFU,WAAW,CAEyC;AAE9D;;;;;;GAMG;AACH,0CAFU,MAAM,CAE+B;AAwF/C;;;;;;;;;;;;;;GAcG;AACH,4CAFU,aAAa,CAMpB;4BAjIyB,kCAAkC;8BAFhC,+BAA+B"}

package/src/shade/renderer/light/environment/shader_project_environment_sh.js

@@ -8,6 +8,7 @@ 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 { ENVIRONMENT_MAP_SAMPLER_RESOURCE } from "./ENVIRONMENT_MAP_SAMPLER_RESOURCE.js";
 
 /**
  * The layout {@link shader_project_environment_sh} writes: the environment's radiance as RGB SH2,
@@ -33,7 +34,8 @@ const resources = new ShaderResourceSetDescriptor();
 
 resources.createGroup()
     // read texel by texel (texture_octahedral_sample_bilinear), as the forward path reads it
-    .addTexture("tEnvironment")
+    .addTexture("tEnvironment", "float")
+    .add(ENVIRONMENT_MAP_SAMPLER_RESOURCE)
     .addStorageBuffer("output", ENVIRONMENT_SH_TYPE, true);
 
 const body = CodeChunk.from(

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":"AAoBA;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,oBA6DC;IAED,iBA4EC;IAED;;;;OAIG;IACH,kEAQC;;CAEJ;kCA5ViC,iCAAiC"}
+{"version":3,"file":"GPULightMap.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/lightmap/GPULightMap.js"],"names":[],"mappings":"AAoBA;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,oBA+DC;IAED,iBA4EC;IAED;;;;OAIG;IACH,kEAQC;;CAEJ;kCA9ViC,iCAAiC"}

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

@@ -236,6 +236,8 @@ export class GPULightMap {
                 tEnvironment: scene_ctx.lights.environment.obtainView(),
                 tParticipatingMediaNoise: scene_ctx.volumetrics.noise_atlas.texture.obtainView(),
                 sParticipatingMediaNoise: graphics.samplers.obtain(PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR),
+                wind_field: scene_ctx.wind.uniform,
+                wind_field_atlas: scene_ctx.wind.atlas.texture,
 
                 tlas: scene_ctx.tlas.buffer,
                 blas_lookup: scene_ctx.geometries.blas.buffer_metadata,

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":"AA0OA,iEASE;4BAzM0B,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":"AA8OA,iEASE;4BA7M0B,6BAA6B"}

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

@@ -45,7 +45,9 @@ import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourc
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { sr_create_group_RTX } from "../../geometry/sr_create_group_RTX.js";
 import { PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR } from "../../volumetrics/noise/PARTICIPATING_MEDIA_NOISE.js";
+import { wind_field_add_resources } from "../../wind/wind_field_add_resources.js";
 import { chunk_lightmap_geometry_uv_to_atlas } from "../chunk_lightmap_geometry_uv_to_atlas.js";
+import { ENVIRONMENT_MAP_SAMPLER_RESOURCE } from "../../light/environment/ENVIRONMENT_MAP_SAMPLER_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 sr_create_group_RTX(resources);
@@ -56,12 +58,14 @@ resources.createGroup()
     .addTexture("textures", "unfilterable-float", "2d-array")
     .addTexture("tNoise", "uint")
 
-resources.createGroup()
+// the scene's wind, which carries the fog volumes' noise: one uniform, one texture, one sampler
+wind_field_add_resources(resources.createGroup()
     .addStorageBuffer("light_data", WebGPUArray.u32)
-    .addTexture("tEnvironment", "unfilterable-float", "2d")
+    .addTexture("tEnvironment", "float", "2d")
+    .add(ENVIRONMENT_MAP_SAMPLER_RESOURCE)
     // the fog volumes' noise, read through participating_media_volume_density_at
     .addTexture("tParticipatingMediaNoise", "float", "3d")
-    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR)
+    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR));
 
 resources.createGroup()
     .addTexture("viz_mesh", "uint")

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":"AAuOA,oDAOE;4BAtM0B,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":"AA2OA,oDAOE;4BA1M0B,6BAA6B"}

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

@@ -46,6 +46,8 @@ import { chunk_lightmap_geometry_uv_to_atlas } from "../chunk_lightmap_geometry_
 import { LIGHTMAP_SH_COLOR_TARGETS_DESCRIPTOR } from "./LIGHTMAP_SH_COLOR_TARGETS_DESCRIPTOR.js";
 import { LIGHTMAP_SH_FRAGMENT_OUTPUT } from "./LIGHTMAP_SH_FRAGMENT_OUTPUT.js";
 import { PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR } from "../../volumetrics/noise/PARTICIPATING_MEDIA_NOISE.js";
+import { wind_field_add_resources } from "../../wind/wind_field_add_resources.js";
+import { ENVIRONMENT_MAP_SAMPLER_RESOURCE } from "../../light/environment/ENVIRONMENT_MAP_SAMPLER_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 sr_create_group_RTX(resources);
@@ -56,12 +58,14 @@ resources.createGroup()
     .addTexture("textures", "unfilterable-float", "2d-array")
     .addTexture("tNoise", "uint")
 
-resources.createGroup()
+// the scene's wind, which carries the fog volumes' noise: one uniform, one texture, one sampler
+wind_field_add_resources(resources.createGroup()
     .addStorageBuffer("light_data", WebGPUArray.u32)
-    .addTexture("tEnvironment", "unfilterable-float", "2d")
+    .addTexture("tEnvironment", "float", "2d")
+    .add(ENVIRONMENT_MAP_SAMPLER_RESOURCE)
     // the fog volumes' noise, read through participating_media_volume_density_at
     .addTexture("tParticipatingMediaNoise", "float", "3d")
-    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR)
+    .addSampler("sParticipatingMediaNoise", "filtering", PARTICIPATING_MEDIA_NOISE_SAMPLER_DESCRIPTOR));
 
 resources.createGroup()
     .addTexture("viz_buffer", "uint") // [mesh, triangle]

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_density.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_debug_density.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_density.js"],"names":[],"mappings":"AAuIA,wDAWE;4BAlI0B,6BAA6B"}
+{"version":3,"file":"shader_lightmap_debug_density.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_density.js"],"names":[],"mappings":"AA2IA,wDAWE;4BAtI0B,6BAA6B"}

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_density.js

@@ -18,6 +18,8 @@ import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { GEOMETRY_ATTRIBUTE_DATA_RESOURCE } from "../../geometry/GEOMETRY_ATTRIBUTE_DATA_RESOURCE.js";
+import { MESHLET_METADATA_RESOURCE } from "../../geometry/meshlet/MESHLET_METADATA_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 resources.createGroup()
@@ -28,6 +30,8 @@ resources.createGroup()
 resources.createGroup()
     .addStorageBuffer("scene_database", WebGPUArray.from(u32))
     .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+    .add(MESHLET_METADATA_RESOURCE)
+    .add(GEOMETRY_ATTRIBUTE_DATA_RESOURCE)
 
 const body = CodeChunk.from(
     //language=WGSL

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_uv_checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_debug_uv_checker.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_uv_checker.js"],"names":[],"mappings":"AAqIA,2DAWE;4BAnI0B,6BAA6B"}
+{"version":3,"file":"shader_lightmap_debug_uv_checker.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_uv_checker.js"],"names":[],"mappings":"AAyIA,2DAWE;4BAvI0B,6BAA6B"}

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_uv_checker.js

@@ -15,6 +15,8 @@ import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { GEOMETRY_ATTRIBUTE_DATA_RESOURCE } from "../../geometry/GEOMETRY_ATTRIBUTE_DATA_RESOURCE.js";
+import { MESHLET_METADATA_RESOURCE } from "../../geometry/meshlet/MESHLET_METADATA_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 
@@ -28,6 +30,8 @@ resources.createGroup()
 resources.createGroup()
     .addStorageBuffer("scene_database", WebGPUArray.from(u32))
     .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+    .add(MESHLET_METADATA_RESOURCE)
+    .add(GEOMETRY_ATTRIBUTE_DATA_RESOURCE)
 
 const chunk_coord_to_checkers = CodeChunk.from(
     //language=WGSL

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_flat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_debug_view_flat.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_flat.js"],"names":[],"mappings":"AA2JA,0DAWE;4BA3I0B,6BAA6B"}
+{"version":3,"file":"shader_lightmap_debug_view_flat.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_flat.js"],"names":[],"mappings":"AA+JA,0DAWE;4BA/I0B,6BAA6B"}

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_flat.js

@@ -29,6 +29,8 @@ import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { GEOMETRY_ATTRIBUTE_DATA_RESOURCE } from "../../geometry/GEOMETRY_ATTRIBUTE_DATA_RESOURCE.js";
+import { MESHLET_METADATA_RESOURCE } from "../../geometry/meshlet/MESHLET_METADATA_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 resources.createGroup()
@@ -51,6 +53,8 @@ resources.createGroup()
 resources.createGroup()
     .addStorageBuffer("scene_database", WebGPUArray.from(u32))
     .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+    .add(MESHLET_METADATA_RESOURCE)
+    .add(GEOMETRY_ATTRIBUTE_DATA_RESOURCE)
 
 const body = CodeChunk.from(
     //language=WGSL

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_sh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_debug_view_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_sh.js"],"names":[],"mappings":"AA6KA,wDAWE;4BAvJ0B,6BAA6B"}
+{"version":3,"file":"shader_lightmap_debug_view_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_sh.js"],"names":[],"mappings":"AAiLA,wDAWE;4BA3J0B,6BAA6B"}

package/src/shade/renderer/lightmap/debug/shader_lightmap_debug_view_sh.js

@@ -35,6 +35,8 @@ import { ImageShader } from "../../shader/ImageShader.js";
 import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
 import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
 import { VIEW_UNIFORM_STRUCT } from "../../view/VIEW_UNIFORM_STRUCT.js";
+import { GEOMETRY_ATTRIBUTE_DATA_RESOURCE } from "../../geometry/GEOMETRY_ATTRIBUTE_DATA_RESOURCE.js";
+import { MESHLET_METADATA_RESOURCE } from "../../geometry/meshlet/MESHLET_METADATA_RESOURCE.js";
 
 const resources = new ShaderResourceSetDescriptor();
 resources.createGroup()
@@ -58,6 +60,8 @@ resources.createGroup()
 resources.createGroup()
     .addStorageBuffer("scene_database", WebGPUArray.from(u32))
     .addStorageBuffer("geometries", WebGPUArray.from(GEOMETRY_METADATA_STRUCT))
+    .add(MESHLET_METADATA_RESOURCE)
+    .add(GEOMETRY_ATTRIBUTE_DATA_RESOURCE)
 
 const body = CodeChunk.from(
     //language=WGSL

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

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

package/src/shade/renderer/material/standard/SHADING_MATERIAL_RESOURCE_GROUP.d.ts

@@ -1,3 +1,24 @@
+/**
+ * The standard material's uniform.
+ * @type {ShaderResourceDescriptor}
+ */
+export const MATERIAL_INFO_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_DIFFUSE_TEXTURE_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_DIFFUSE_SAMPLER_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_NORMAL_TEXTURE_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_NORMAL_SAMPLER_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_ORM_TEXTURE_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_ORM_SAMPLER_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_EMISSIVE_TEXTURE_RESOURCE: ShaderResourceDescriptor;
+/** @type {ShaderResourceDescriptor} */
+export const MATERIAL_EMISSIVE_SAMPLER_RESOURCE: ShaderResourceDescriptor;
 /**
  * Group 0 of the standard material template: its uniform and its four textures.
  *
@@ -9,5 +30,6 @@
  * @type {ShaderResourceGroupDescriptor}
  */
 export const SHADING_MATERIAL_RESOURCE_GROUP: ShaderResourceGroupDescriptor;
+import { ShaderResourceDescriptor } from "../../shader/resource/ShaderResourceDescriptor.js";
 import { ShaderResourceGroupDescriptor } from "../../shader/resource/ShaderResourceGroupDescriptor.js";
 //# sourceMappingURL=SHADING_MATERIAL_RESOURCE_GROUP.d.ts.map

package/src/shade/renderer/material/standard/SHADING_MATERIAL_RESOURCE_GROUP.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SHADING_MATERIAL_RESOURCE_GROUP.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/standard/SHADING_MATERIAL_RESOURCE_GROUP.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,8CAFU,6BAA6B,CAE4C;8CAbrC,wDAAwD"}
+{"version":3,"file":"SHADING_MATERIAL_RESOURCE_GROUP.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/standard/SHADING_MATERIAL_RESOURCE_GROUP.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qCAFU,wBAAwB,CAEgF;AAElH,uCAAuC;AACvC,gDADW,wBAAwB,CAC2E;AAC9G,uCAAuC;AACvC,gDADW,wBAAwB,CAC0E;AAC7G,uCAAuC;AACvC,+CADW,wBAAwB,CACyE;AAC5G,uCAAuC;AACvC,+CADW,wBAAwB,CACwE;AAC3G,uCAAuC;AACvC,4CADW,wBAAwB,CACmE;AACtG,uCAAuC;AACvC,4CADW,wBAAwB,CACkE;AACrG,uCAAuC;AACvC,iDADW,wBAAwB,CAC6E;AAChH,uCAAuC;AACvC,iDADW,wBAAwB,CAC4E;AAE/G;;;;;;;;;GASG;AACH,8CAFU,6BAA6B,CAE4C;yCArC1C,mDAAmD;8CAC9C,wDAAwD"}