@woosh/meep-engine 3.60.3 → 3.60.5

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

@@ -1,13 +0,0 @@
-/**
- * Samples per texel. Each reads the average whose texel matches the solid angle it stands for, so
- * fewer samples read coarser averages and more read finer ones, back toward point taps that catch or
- * miss a bright texel. Measured on a single bright texel of a 1024 map at 48 places, level 1 over
- * level 0 in solid-angle energy: 32 → 0.995 ± 0.014, 64 → 0.998 ± 0.008 (at most 1.005),
- * 196 → 1.001 ± 0.019 — at 196 the lod is 0.5 .. 1.7, and every read below 1 blends in level 0's
- * point taps. UE filters with 32 below roughness 0.1 and 64 above.
- * @type {number}
- */
-export const CONVOLVE_FROM_AVERAGES_SAMPLE_COUNT: number;
-export const shader_convolve_reflection_map_from_averages: ComputeShader;
-import { ComputeShader } from "../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_convolve_reflection_map_from_averages.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shader_convolve_reflection_map_from_averages.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/light/environment/shader_convolve_reflection_map_from_averages.js"],"names":[],"mappings":"AAqCA;;;;;;;;GAQG;AACH,kDAFU,MAAM,CAEsC;AAmJtD,yEAII;8BAlL0B,+BAA+B"}

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

@@ -1,198 +0,0 @@
-import { chunk_cone_cosine_from_roughness } from "../../shader/chunk/brdf/chunk_cone_cosine_from_roughness.js";
-import {
-    chunk_build_orthonormal_matrix_n
-} from "../../shader/chunk/geometry/normal/chunk_build_orthonormal_matrix_n.js";
-import {
-    chunk_uv_octahedral_unit_decode
-} from "../../shader/chunk/geometry/octahedron/chunk_uv_octahedral_unit_decode.js";
-import {
-    chunk_uv_octahedral_unit_encode
-} from "../../shader/chunk/geometry/octahedron/chunk_uv_octahedral_unit_encode.js";
-import { chunk_uniform_sample_cone } from "../../shader/chunk/geometry/ray/chunk_uniform_sample_cone.js";
-import { chunk_pow2 } from "../../shader/chunk/math/chunk_pow2.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_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";
-import { ShaderDescriptor } from "../../shader/ShaderDescriptor.js";
-import { chunk_reflection_sample_weight } from "./chunk_reflection_sample_weight.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();
-
-resources.createGroup()
-    // the map's level 0, and its plain averages from level 1 down (see shader_downsample_environment_map)
-    .addTexture("level_0", "float")
-    .addTexture("averages", "float")
-    .addStorageTexture("output", "rgba16float")
-    .add(ENVIRONMENT_MAP_SAMPLER_RESOURCE)
-;
-
-/**
- * Samples per texel. Each reads the average whose texel matches the solid angle it stands for, so
- * fewer samples read coarser averages and more read finer ones, back toward point taps that catch or
- * miss a bright texel. Measured on a single bright texel of a 1024 map at 48 places, level 1 over
- * level 0 in solid-angle energy: 32 → 0.995 ± 0.014, 64 → 0.998 ± 0.008 (at most 1.005),
- * 196 → 1.001 ± 0.019 — at 196 the lod is 0.5 .. 1.7, and every read below 1 blends in level 0's
- * point taps. UE filters with 32 below roughness 0.1 and 64 above.
- * @type {number}
- */
-export const CONVOLVE_FROM_AVERAGES_SAMPLE_COUNT = 64;
-
-/**
- * How much a read of the averages widens the lobe, as mean squared angle per steradian a sample
- * stands for. The lobe exp(2 (N·H - 1) / r^4) is a Gaussian of mean squared angle 4 r^4 (N·H =
- * cos(θ/2), so N·H - 1 ≈ -θ²/8), and convolving adds variances, so the lobe is narrowed to
- * r^4 - k Ω_s / 4 and lands at the width it is asked for.
- *
- * A box over the texel plus the bilinear tent across its neighbours predicts 1/2; 1 is measured. On
- * a 1024 map's sun against level 1 from 8192 point taps (1.315° rms): k = 0 → 1.436°, 1/2 → 1.380°,
- * 1 → 1.317°; the sun's tail error 110% → 49%. The two reads a lod between levels blends, and an
- * average's footprint 2 + 2/n texels of the one above rather than 2, are the likely difference.
- * Matching the width leaves the shape: the core is flatter than a Gaussian, and the sky's rms error
- * against the reference goes 0.166 → 0.222.
- * @type {number}
- */
-const AVERAGES_BLUR_PER_SOLID_ANGLE = 1;
-
-/**
- * Level 1 of the prefilter, by filtered importance sampling: each sample reads the plain average of
- * level 0 whose texel is the solid angle the sample stands for, so a texel brighter than its
- * neighbours is averaged into the coarser texel the sample reads instead of being hit or missed by
- * the sample pattern. Point taps into level 0 — 196 of them over a cone of 639 level-0 texels — put
- * one bright texel's share of level 1 anywhere from 0.79 to 1.21 of its energy, and an HDR sun
- * came out 0.66% brighter than it went in.
- *
- * Samples are uniform in the cone, so each stands for the same solid angle and reads the same
- * average: the averages blur the lobe by one fixed amount, which the lobe gives back by narrowing
- * (see AVERAGES_BLUR_PER_SOLID_ANGLE). UE's importance sampling read fine averages in the lobe's core
- * and coarse ones in its tail, and the sun came out in blocks.
- *
- * Level 1 only. The levels after it read the level above, already smooth at their sample spacing
- * (see shader_convolve_reflection_map). Read from level 0 instead, their samples land on averages
- * 8 to 16 texels a side, too coarse an octahedral grid to keep a bright texel's energy: ±11% at
- * level 4, and a sky 11% brighter.
- *
- * @see https://developer.nvidia.com/gpugems/gpugems3/part-iii-rendering/chapter-20-gpu-based-importance-sampling
- * @see https://github.com/EpicGames/UnrealEngine/blob/5.4/Engine/Shaders/Private/ReflectionEnvironmentShaders.usf FilterPS
- * @see https://projects.blender.org/blender/blender/src/commit/866ef5b468589587395b1ee7480ea75b4c0fbc26/source/blender/draw/engines/eevee_next/shaders/eevee_lightprobe_sphere_convolve_comp.glsl for the lobe
- * @type {CodeChunk}
- */
-const body = CodeChunk.from(
-    //language=WGSL
-    `
-/// level 0 is the map's own, the levels below it are the averages
-fn sample_source_level(direction: vec3<f32>, level: u32) -> vec4<f32> {
-    let uv = uv_octahedral_unit_encode(direction);
-
-    if (level == 0u) {
-        let size = f32(textureDimensions(level_0).x);
-
-        return textureSampleLevel(level_0, sEnvironment, texture_octahedral_skirt_uv(uv, size), 0.0);
-    }
-
-    let average_level = level - 1u;
-    let size = f32(textureDimensions(averages, average_level).x);
-
-    return textureSampleLevel(averages, sEnvironment, texture_octahedral_skirt_uv(uv, size), f32(average_level));
-}
-
-@compute @workgroup_size(16,16,1)
-fn main(
-    @builtin(global_invocation_id) global_invocation_id : vec3<u32>,
-){
-    let output_size = textureDimensions(output);
-
-    let output_texel_i = global_invocation_id.xy;
-
-    if(any(output_texel_i >= output_size)){
-        return;
-    }
-
-    /* From mip to linear roughness (same as UI). */
-    let roughness = max(sphere_probe_lod_to_roughness(1.0), ${BSDF_ROUGHNESS_MINIMUM});
-    let cone_cos = cone_cosine_from_roughness(roughness);
-
-    // 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);
-
-    var weight_accum = 0.0;
-    var radiance_accum = vec4(0.0);
-
-    const sample_count = ${CONVOLVE_FROM_AVERAGES_SAMPLE_COUNT};
-
-    // uniform in the cone, so every sample stands for the same solid angle
-    let sample_solid_angle = 2.0 * PI * (1.0 - cone_cos) / f32(sample_count);
-
-    // narrowed by the blur the averages add, so the lobe comes out at the roughness asked for
-    let lobe_roughness = sqrt(sqrt(max(
-        pow2(pow2(roughness)) - ${AVERAGES_BLUR_PER_SOLID_ANGLE.toFixed(6)} * sample_solid_angle / 4.0,
-        pow2(pow2(${BSDF_ROUGHNESS_MINIMUM}))
-    )));
-
-    // level 0's octahedral square, n texels a side, spans 2 in octahedron coordinates; a texel there
-    // covers (2/n)^2 of it, and the octahedron's solid angle per unit area is |d|_1^3 along unit d
-    let level_0_interior = f32(textureDimensions(level_0).x) - 2.0;
-    let level_0_texel_area = 4.0 / (level_0_interior * level_0_interior);
-
-    let last_level = f32(textureNumLevels(averages));
-
-    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 l1 = dot(abs(in_direction), vec3(1.0));
-        let texel_solid_angle = level_0_texel_area * l1 * l1 * l1;
-
-        let lod = clamp(0.5 * log2(sample_solid_angle / texel_solid_angle), 0.0, last_level);
-        let lod_floor = floor(lod);
-        let level = u32(lod_floor);
-
-        let radiance = mix(
-            sample_source_level(in_direction, level),
-            sample_source_level(in_direction, min(level + 1u, u32(last_level))),
-            lod - lod_floor
-        );
-
-        let weight = reflection_sample_weight(out_direction, in_direction, lobe_roughness);
-
-        radiance_accum += radiance * weight;
-        weight_accum += weight;
-    }
-
-    let out_radiance = radiance_accum * safe_rcp(weight_accum);
-
-    textureStore(output, output_texel_i, out_radiance);
-}
-    `, [
-        chunk_sphere_probe_lod_to_roughness,
-        chunk_hammersley_2d,
-        chunk_build_orthonormal_matrix_n,
-        chunk_safe_rcp,
-        chunk_pow2,
-        chunk_uniform_sample_cone,
-        chunk_texture_octahedral_skirt_texel_uv,
-        chunk_texture_octahedral_skirt_uv,
-        chunk_uv_octahedral_unit_decode,
-        chunk_uv_octahedral_unit_encode,
-        chunk_reflection_sample_weight,
-        chunk_cone_cosine_from_roughness,
-    ]
-);
-
-export const shader_convolve_reflection_map_from_averages = new ComputeShader(ShaderDescriptor.from({
-    label: 'Convolve reflection map from averages',
-    body,
-    resources
-}));

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

@@ -1,24 +0,0 @@
-/**
- * @type {WebGPUStruct}
- */
-export const RESIDENT_TEXTURE_MEANS_SETTINGS: WebGPUStruct;
-/**
- * The rows' sums (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.6): a workgroup a texture slot, a lane a row of
- * its {@link SLOT_TEXELS}, which sums the row's texels into `texture_rows[slot · 64 + row]`. The launch
- * is the slots, folded over x then y past the per-dimension limit.
- *
- * @type {ComputeShader}
- */
-export const shader_resident_texture_rows: ComputeShader;
-/**
- * The slots' means (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.6): a thread a texture slot, the mean of its
- * rows' sums over the slot's texels, into `texture_means[slot]`, as the atlas stores it: an albedo's
- * colour premultiplied by its coverage, so `rgb / a` is the mean colour of what the slot covers. A
- * workgroup of 64 slots.
- *
- * @type {ComputeShader}
- */
-export const shader_resident_texture_means: ComputeShader;
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-//# sourceMappingURL=shader_resident_texture_means.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shader_resident_texture_means.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/material/resident/shader_resident_texture_means.js"],"names":[],"mappings":"AAyBA;;GAEG;AACH,8CAFU,YAAY,CAKa;AAUnC;;;;;;GAMG;AACH,2CAFU,aAAa,CAgCpB;AAUH;;;;;;;GAOG;AACH,4CAFU,aAAa,CAyBpB;6BAjH0B,mCAAmC;8BAJlC,+BAA+B"}

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

@@ -1,120 +0,0 @@
-import { chunk_folded_workgroup_index } from "../../shader/chunk/grid/chunk_folded_workgroup_index.js";
-import { CodeChunk } from "../../shader/compiler/CodeChunk.js";
-import { ComputeShader } from "../../shader/ComputeShader.js";
-import { ShaderResourceSetDescriptor } from "../../shader/resource/ShaderResourceSetDescriptor.js";
-import { u32, vec4f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { WebGPUArray } from "../../shader/type/WebGPUArray.js";
-import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
-import {
-    RESIDENT_MATERIAL_TEXTURE_RESOLUTION,
-    RESIDENT_MATERIAL_TEXTURE_SLOT_RESOLUTION,
-    RESIDENT_MATERIAL_TEXTURE_SLOTS_PER_LAYER
-} from "./RESIDENT_MATERIAL_TEXTURE_LAYOUT.js";
-
-/*
- A texture slot's mean (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.6): what a GI hit no card sees takes
- of its material. Two passes, so that no thread reads more than a row: the rows of every slot, then
- every slot from its rows.
-*/
-
-/**
- * The rows a slot has, and the texels a row.
- * @type {number}
- */
-const SLOT_TEXELS = RESIDENT_MATERIAL_TEXTURE_RESOLUTION;
-
-/**
- * @type {WebGPUStruct}
- */
-export const RESIDENT_TEXTURE_MEANS_SETTINGS = WebGPUStruct.from({
-    /** texture slots, the highest one's id and one */
-    slot_count: u32,
-}, "ResidentTextureMeansSettings");
-
-const row_resources = new ShaderResourceSetDescriptor();
-
-row_resources.setImmediate("settings", RESIDENT_TEXTURE_MEANS_SETTINGS);
-
-row_resources.createGroup()
-    .addTexture("textures", "unfilterable-float", "2d-array")
-    .addStorageBuffer("texture_rows", WebGPUArray.from(vec4f), true);
-
-/**
- * The rows' sums (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.6): a workgroup a texture slot, a lane a row of
- * its {@link SLOT_TEXELS}, which sums the row's texels into `texture_rows[slot · 64 + row]`. The launch
- * is the slots, folded over x then y past the per-dimension limit.
- *
- * @type {ComputeShader}
- */
-export const shader_resident_texture_rows = ComputeShader.from({
-    label: "Resident Texture Rows",
-    resources: row_resources,
-    body: CodeChunk.from(
-        //language=WGSL
-        `
-@compute @workgroup_size(${SLOT_TEXELS})
-fn main(
-    @builtin(workgroup_id) workgroup_id: vec3<u32>,
-    @builtin(local_invocation_index) row: u32,
-) {
-    let slot = folded_workgroup_index(workgroup_id);
-
-    if (slot >= settings.slot_count) {
-        return;
-    }
-
-    let layer = slot / ${RESIDENT_MATERIAL_TEXTURE_SLOTS_PER_LAYER}u;
-    let in_layer = slot % ${RESIDENT_MATERIAL_TEXTURE_SLOTS_PER_LAYER}u;
-    let origin = vec2<u32>(in_layer % ${RESIDENT_MATERIAL_TEXTURE_SLOT_RESOLUTION}u, in_layer / ${RESIDENT_MATERIAL_TEXTURE_SLOT_RESOLUTION}u) * ${SLOT_TEXELS}u;
-
-    var sum = vec4<f32>(0.0);
-
-    for (var x = 0u; x < ${SLOT_TEXELS}u; x++) {
-        sum += textureLoad(textures, origin + vec2<u32>(x, row), layer, 0);
-    }
-
-    texture_rows[slot * ${SLOT_TEXELS}u + row] = sum;
-}
-`, [chunk_folded_workgroup_index]),
-});
-
-const mean_resources = new ShaderResourceSetDescriptor();
-
-mean_resources.setImmediate("settings", RESIDENT_TEXTURE_MEANS_SETTINGS);
-
-mean_resources.createGroup()
-    .addStorageBuffer("texture_rows", WebGPUArray.from(vec4f))
-    .addStorageBuffer("texture_means", WebGPUArray.from(vec4f), true);
-
-/**
- * The slots' means (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §6.6): a thread a texture slot, the mean of its
- * rows' sums over the slot's texels, into `texture_means[slot]`, as the atlas stores it: an albedo's
- * colour premultiplied by its coverage, so `rgb / a` is the mean colour of what the slot covers. A
- * workgroup of 64 slots.
- *
- * @type {ComputeShader}
- */
-export const shader_resident_texture_means = ComputeShader.from({
-    label: "Resident Texture Means",
-    resources: mean_resources,
-    body: CodeChunk.from(
-        //language=WGSL
-        `
-@compute @workgroup_size(64)
-fn main(@builtin(global_invocation_id) id: vec3<u32>) {
-    let slot = id.x;
-
-    if (slot >= settings.slot_count) {
-        return;
-    }
-
-    var sum = vec4<f32>(0.0);
-
-    for (var row = 0u; row < ${SLOT_TEXELS}u; row++) {
-        sum += texture_rows[slot * ${SLOT_TEXELS}u + row];
-    }
-
-    texture_means[slot] = sum / ${SLOT_TEXELS * SLOT_TEXELS}.0;
-}
-`),
-});