@woosh/meep-engine 3.57.0 → 3.59.0

package/src/shade/playground/probe_clipmap/main.js

@@ -0,0 +1,360 @@
+import Quaternion from "../../../core/geom/Quaternion.js";
+import Vector3 from "../../../core/geom/Vector3.js";
+import { AABB3 } from "../../../core/geom/3d/aabb/AABB3.js";
+import { DEG_TO_RAD } from "../../../core/math/DEG_TO_RAD.js";
+import { EntityComponentDataset } from "../../../engine/ecs/EntityComponentDataset.js";
+import { Transform64 } from "../../../engine/ecs/transform/Transform64.js";
+import { prefab_compile } from "../../../engine/graphics3/prefab/prefab_compile.js";
+import { prefab_place } from "../../../engine/graphics3/prefab/prefab_place.js";
+import { shade_bundle_bounds } from "../../../engine/graphics3/shade_bundle_bounds.js";
+import { camera_frame_sphere } from "../../renderer/camera/camera_frame_sphere.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
+import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
+import { create_frame_loop } from "../../renderer/create_frame_loop.js";
+import { ProbeClipmapDebugView } from "../../renderer/global_illumination/probe_clipmap/debug/ProbeClipmapDebugView.js";
+import { make_sunlight } from "../../renderer/light/make_sunlight.js";
+import { PointLight } from "../../renderer/light/model/PointLight.js";
+import { place_light } from "../../renderer/light/place_light.js";
+import { load_gltf } from "../../renderer/loader/gltf/load_gltf.js";
+import { Renderer } from "../../renderer/Renderer.js";
+import { Scene } from "../../renderer/scene/Scene.js";
+import { load_scene_from_url } from "../../renderer/scene/serialization/deserialize_scene.js";
+import { ShadeIndirectLightingMode } from "../../renderer/ShadeIndirectLightingMode.js";
+import { load_default_environment } from "../load_default_environment.js";
+import { make_playground_asset_manager } from "../make_playground_asset_manager.js";
+
+/**
+ * The probe clipmap GI (`ShadeIndirectLightingMode.ProbeClipmap`, PROBE_CLIPMAP_PROPOSAL_2026_10_27.md) on
+ * Sponza, to drive by hand: the mode against IBL, its debug views, the sun moved, point lights for the hits'
+ * local lights.
+ *
+ * Runs under the dev server (`npm run dev`), which serves `test_assets/`. The panel is hand-rolled, as the
+ * other playgrounds' are.
+ */
+
+/**
+ * Served by the dev server out of `test_assets/`, which is gitignored; `test_assets/README.md` says how to put
+ * Sponza there.
+ * @type {string}
+ */
+const DEFAULT_SCENE_URL = '/test_assets/Sponza/glTF/Sponza.gltf';
+
+/**
+ * Mesh SDF bricks baked a frame while the caches fill, as this page starts. The engine's default is a frame-time
+ * knob, under which Sponza takes minutes to bake whole.
+ * @type {number}
+ */
+const PAGE_BAKE_BUDGET = 256;
+
+/**
+ * Point lights the toggle places along the scene's long axis.
+ * @type {number}
+ */
+const POINT_LIGHT_COUNT = 8;
+
+/**
+ * A frame-time readout, kept as a rolling mean so the number is readable rather than jittering.
+ */
+class FrameTimer {
+    #samples = new Float64Array(60);
+    #count = 0;
+    #cursor = 0;
+
+    /**
+     * @param {number} seconds
+     */
+    add(seconds) {
+        this.#samples[this.#cursor] = seconds * 1000;
+        this.#cursor = (this.#cursor + 1) % this.#samples.length;
+        this.#count = Math.min(this.#count + 1, this.#samples.length);
+    }
+
+    /**
+     * @returns {number} mean frame time in milliseconds, or 0 before there is anything to average
+     */
+    get mean_ms() {
+        if (this.#count === 0) {
+            return 0;
+        }
+
+        let total = 0;
+
+        for (let i = 0; i < this.#count; i++) {
+            total += this.#samples[i];
+        }
+
+        return total / this.#count;
+    }
+}
+
+/**
+ * Stand the page up. Called by the page rather than run on import, so that nothing here touches the DOM
+ * until there is one.
+ *
+ * @returns {Promise<void>}
+ */
+export async function start() {
+    const element = id => document.getElementById(id);
+
+    const status_element = element('status');
+    const stats_element = element('stats');
+
+    function set_status(text, kind = '') {
+        status_element.textContent = text;
+        status_element.className = kind;
+    }
+
+    const context = element('view').getContext('webgpu');
+
+    if (context === null) {
+        set_status('no WebGPU context — this browser has none, or the page is not a secure context', 'fail');
+        return;
+    }
+
+    const renderer = new Renderer();
+
+    set_status('acquiring a device…');
+
+    await renderer.initialize({ context });
+
+    renderer.indirect_lighting_mode = ShadeIndirectLightingMode.ProbeClipmap;
+    renderer.probe_clipmap.mesh_sdf_bake_budget = PAGE_BAKE_BUDGET;
+
+    const camera = new PerspectiveCamera();
+
+    camera.near = 0.1;
+    camera.far = 200;
+    camera.fov = 72 * DEG_TO_RAD;
+    camera.aspect = renderer.aspect_ratio;
+
+    const scene = new Scene();
+
+    // lights stand at entities, so the scene names a dataset for them
+    scene.dataset = new EntityComponentDataset();
+
+    const scene_context = renderer.scenes.obtain(scene);
+
+    // body rather than the canvas: the controller's keyboard device needs a focusable element
+    const controller = new OrbitalCameraController(camera, document.body);
+
+    // handy from the console
+    globalThis.renderer = renderer;
+    globalThis.scene = scene;
+    globalThis.camera = camera;
+
+    // ---- the scene ------------------------------------------------------------------------
+
+    const url = new URLSearchParams(location.search).get('scene') ?? DEFAULT_SCENE_URL;
+
+    set_status(`loading ${url} …`);
+
+    let bundle;
+
+    try {
+        bundle = /\.gltf$|\.glb$/i.test(url)
+            ? await load_gltf(url, { assetManager: await make_playground_asset_manager() })
+            : await load_scene_from_url(url, scene);
+    } catch (error) {
+        set_status(`could not load ${url} (${error.message}); see test_assets/README.md`, 'fail');
+        console.error(error);
+        return;
+    }
+
+    const placed = prefab_place(scene_context, scene.dataset, prefab_compile(bundle), new Transform64());
+
+    const bounds = new AABB3();
+
+    shade_bundle_bounds(bounds, bundle);
+
+    camera_frame_sphere(controller, Math.hypot(bounds.width, bounds.height, bounds.depth) * 0.5, new Vector3(bounds.centerX, bounds.centerY, bounds.centerZ));
+
+    // inside, low, looking down the long axis: where the light bounces
+    controller.look(
+        new Vector3(bounds.centerX - bounds.width * 0.3, bounds.centerY - bounds.height * 0.2, bounds.centerZ),
+        new Vector3(bounds.centerX + bounds.width * 0.3, bounds.centerY - bounds.height * 0.25, bounds.centerZ)
+    );
+    controller.movement_speed_scale = Math.max(bounds.width, bounds.height, bounds.depth) * 0.05;
+
+    // a sun the sliders turn, whatever lights the file brought
+    const sun = make_sunlight({ intensity: 7.2 });
+
+    place_light(scene, sun);
+
+    const rotation = new Quaternion();
+    const sun_direction = new Vector3();
+
+    /**
+     * The traced reference no longer matches the lights. The tracer restarts on its own when the camera
+     * moves, but not when a light does; while it is off, the restart waits for it to come back on, so that
+     * flipping it on a still camera and still lights keeps what it has accumulated.
+     */
+    let trace_stale = false;
+
+    function lights_changed() {
+        if (renderer.feature_path_tracing_enabled) {
+            renderer.path_tracer.clear_history = true;
+        } else {
+            trace_stale = true;
+        }
+    }
+
+    function aim_sun() {
+        const elevation = Number(element('sun_elevation').value) * DEG_TO_RAD;
+        const azimuth = Number(element('sun_azimuth').value) * DEG_TO_RAD;
+
+        element('sun_elevation_value').textContent = `${element('sun_elevation').value}°`;
+        element('sun_azimuth_value').textContent = `${element('sun_azimuth').value}°`;
+
+        // the light travels down toward the scene
+        sun_direction.set(Math.cos(elevation) * Math.cos(azimuth), -Math.sin(elevation), Math.cos(elevation) * Math.sin(azimuth));
+
+        rotation.fromUnitVectors(Vector3.forward, sun_direction);
+        rotation.normalize();
+
+        sun.transform.setRotation(rotation.x, rotation.y, rotation.z, rotation.w);
+        sun.transform.updateMatrix();
+    }
+
+    aim_sun();
+
+    function on_sun_input() {
+        aim_sun();
+        lights_changed();
+    }
+
+    element('sun_elevation').addEventListener('input', on_sun_input);
+    element('sun_azimuth').addEventListener('input', on_sun_input);
+
+    load_default_environment(scene);
+
+    // ---- controls -------------------------------------------------------------------------
+
+    element('indirect').addEventListener('change', event => {
+        renderer.indirect_lighting_mode = ShadeIndirectLightingMode[event.target.value];
+    });
+
+    element('debug_view').addEventListener('change', event => {
+        renderer.probe_clipmap.debug_view = ProbeClipmapDebugView[event.target.value];
+    });
+
+    const taa_toggle = element('taa');
+    const path_tracing_toggle = element('path_tracing');
+
+    taa_toggle.addEventListener('change', event => {
+        renderer.feature_taa_enabled = event.target.checked;
+    });
+
+    /**
+     * What TAA was before the tracer turned it off, to give it back when the tracer goes.
+     * @type {boolean}
+     */
+    let taa_before_tracing = taa_toggle.checked;
+
+    function set_path_tracing(enabled) {
+        if (enabled === renderer.feature_path_tracing_enabled) {
+            return;
+        }
+
+        path_tracing_toggle.checked = enabled;
+        renderer.feature_path_tracing_enabled = enabled;
+
+        // two temporal filters over one image fight; the tracer accumulates on its own
+        if (enabled) {
+            taa_before_tracing = taa_toggle.checked;
+            taa_toggle.checked = false;
+
+            if (trace_stale) {
+                renderer.path_tracer.clear_history = true;
+                trace_stale = false;
+            }
+        } else {
+            taa_toggle.checked = taa_before_tracing;
+        }
+
+        taa_toggle.disabled = enabled;
+        renderer.feature_taa_enabled = taa_toggle.checked;
+    }
+
+    path_tracing_toggle.addEventListener('change', event => set_path_tracing(event.target.checked));
+
+    document.addEventListener('keydown', event => {
+        // not while typing a number, nor in a select, where P picks an option
+        const typing = event.target === bake_budget || event.target instanceof HTMLSelectElement;
+
+        if (event.code === 'KeyP' && event.repeat === false && typing === false) {
+            set_path_tracing(!renderer.feature_path_tracing_enabled);
+        }
+    });
+
+    const bake_budget = element('bake_budget');
+
+    bake_budget.value = String(PAGE_BAKE_BUDGET);
+    bake_budget.addEventListener('change', () => {
+        const value = Math.round(Number(bake_budget.value));
+
+        if (Number.isInteger(value) && value >= 1 && value <= 8191) {
+            renderer.probe_clipmap.mesh_sdf_bake_budget = value;
+        }
+    });
+
+    /** @type {{light: PointLight, entity: number}[]} */
+    const point_lights = [];
+
+    element('point_lights').addEventListener('change', event => {
+        if (event.target.checked) {
+            for (let i = 0; i < POINT_LIGHT_COUNT; i++) {
+                const light = new PointLight();
+
+                light.intensity = 2;
+                light.distance = 0.25 * bounds.width;
+                light.radius = 0.05;
+                light.casts_shadow = true;
+                light.transform.setTranslation(bounds.x0 + (i + 0.5) / POINT_LIGHT_COUNT * bounds.width, bounds.y0 + 0.15 * bounds.height, bounds.centerZ);
+                light.transform.updateMatrix();
+
+                point_lights.push({ light, entity: place_light(scene, light) });
+            }
+        } else {
+            for (const { light, entity } of point_lights) {
+                scene.lights.remove(light);
+                scene.dataset.removeEntity(entity);
+            }
+
+            point_lights.length = 0;
+        }
+
+        lights_changed();
+    });
+
+    document.body.focus();
+
+    set_status(`loaded — ${placed.drawn} instances`, 'pass');
+
+    // ---- frame loop -----------------------------------------------------------------------
+
+    const frame_timer = new FrameTimer();
+    const sdf = scene_context.geometries.sdf;
+
+    create_frame_loop((time_delta_s, raf_time_s) => {
+        const width = window.innerWidth;
+        const height = window.innerHeight;
+
+        renderer.resize(width, height);
+        renderer.pixel_ratio = window.devicePixelRatio;
+        camera.aspect = width / height;
+
+        controller.update();
+
+        renderer.render(camera, scene, time_delta_s);
+
+        frame_timer.add(raf_time_s);
+
+        const mean = frame_timer.mean_ms;
+        const baking = sdf.baking_count + sdf.queued_count;
+
+        stats_element.textContent =
+            `${mean.toFixed(1)} ms  ·  ${mean > 0 ? (1000 / mean).toFixed(0) : '0'} fps\n`
+            + `mesh SDFs: ${sdf.resident_count} resident${baking > 0 ? `, ${baking} baking` : ''}`
+            + `${renderer.feature_path_tracing_enabled ? `\npath traced: ${renderer.path_tracer.min_sample_count} samples` : ''}`;
+    }, 60);
+}

package/src/shade/playground/sh_exponential/main.js

@@ -280,7 +280,7 @@ async function main() {
 
         const image = texture.image;
 
-        environment.resize(image.width, image.height);
+        environment.descriptor.size = [image.width, image.height, 1];
         environment.descriptor.mipLevelCount = texture_mip_level_count(image.width, image.height, 1, '2d');
         environment.allocate();
 

package/src/shade/playground/skinned_blas_refit/main.js

@@ -5,7 +5,7 @@ import { GPUProfileLevel } from "../../device/timing/profile/GPUProfileLevel.js"
 import { GPUProfileSession } from "../../device/timing/profile/GPUProfileSession.js";
 import { AnimationClipFlags } from "../../renderer/animation/AnimationClipFlags.js";
 import { camera_frame_sphere } from "../../renderer/camera/camera_frame_sphere.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { make_sunlight } from "../../renderer/light/make_sunlight.js";

package/src/shade/playground/skinned_mesh_soup/main.js

@@ -15,7 +15,7 @@ import { AnimationClips } from "../../../engine/graphics3/animation/AnimationCli
 import { prefab_compile } from "../../../engine/graphics3/prefab/prefab_compile.js";
 import { AnimationClipFlags } from "../../renderer/animation/AnimationClipFlags.js";
 import { camera_frame_sphere } from "../../renderer/camera/camera_frame_sphere.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { make_sunlight } from "../../renderer/light/make_sunlight.js";

package/src/shade/playground/sponza_path_trace/main.js

@@ -3,7 +3,7 @@ import { DEG_TO_RAD } from "../../../core/math/DEG_TO_RAD.js";
 import { NumericInterval } from "../../../core/math/interval/NumericInterval.js";
 import { seededRandom } from "../../../core/math/random/seededRandom.js";
 import { camera_frame_sphere } from "../../renderer/camera/camera_frame_sphere.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { BoxGeometry } from "../../renderer/geometry/BoxGeometry.js";

package/src/shade/playground/ssr_motion/main.js

@@ -1,6 +1,6 @@
 import Vector3 from "../../../core/geom/Vector3.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { Renderer } from "../../renderer/Renderer.js";
 import { ShadeIndirectLightingMode } from "../../renderer/ShadeIndirectLightingMode.js";
 import { FixedProjection } from "../ssr_variance/capture.js";

package/src/shade/playground/ssr_reprojection/main.js

@@ -1,7 +1,7 @@
 import { SpatialFilterProbe } from "./SpatialFilterProbe.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { Renderer } from "../../renderer/Renderer.js";
 import { ShadeIndirectLightingMode } from "../../renderer/ShadeIndirectLightingMode.js";

package/src/shade/playground/tonemap_sdr/main.js

@@ -1,5 +1,5 @@
 import Vector3 from "../../../core/geom/Vector3.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { Renderer } from "../../renderer/Renderer.js";
 import { ShadeIndirectLightingMode } from "../../renderer/ShadeIndirectLightingMode.js";

package/src/shade/playground/vgeo_runtime/main.js

@@ -2,7 +2,7 @@ import { Color } from "../../../core/color/Color.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import { EntityComponentDataset } from "../../../engine/ecs/EntityComponentDataset.js";
 import { Transform64 } from "../../../engine/ecs/transform/Transform64.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { VGEO_CUT_STAT } from "../../renderer/geometry/virtual/runtime/layout/VGEO_CUT_STAT.js";
 import { VirtualGeometry } from "../../renderer/geometry/virtual/runtime/VirtualGeometry.js";

package/src/shade/playground/vgeo_scene/main.js

@@ -4,7 +4,7 @@ import Vector3 from "../../../core/geom/Vector3.js";
 import { GIGABYTE } from "../../../core/science/units/memory/GIGABYTE.js";
 import { EntityComponentDataset } from "../../../engine/ecs/EntityComponentDataset.js";
 import { Transform64 } from "../../../engine/ecs/transform/Transform64.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import {
     vgeo_byte_source_over_url

package/src/shade/playground/volumetrics_froxel/main.js

@@ -6,7 +6,7 @@ import { MIE_PARTICLES_STANDARD_PRECOMPUTED } from "../../../core/math/physics/m
 import { t64_set_rotation_axis_angle } from "../../../engine/ecs/transform/t64_set_rotation_axis_angle.js";
 import { GPUProfileLevel } from "../../device/timing/profile/GPUProfileLevel.js";
 import { GPUProfileSession } from "../../device/timing/profile/GPUProfileSession.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { make_sunlight } from "../../renderer/light/make_sunlight.js";

package/src/shade/playground/vsm/index.html

@@ -71,7 +71,10 @@
         <input id="budget" type="range" min="0" max="64" step="1" value="8">
     </label>
     <label><span>LOD bias (coarser →) <output id="bias-value">0.0</output></span>
-        <input id="bias" type="range" min="-2" max="3" step="0.5" value="0">
+        <input id="bias" type="range" min="-2" max="3" step="0.5" value="0">
+    </label>
+    <label><span>Max pool load (0 = off) <output id="max-load-value">0.85</output></span>
+        <input id="max-load" type="range" min="0" max="1" step="0.05" value="0.85">
     </label>
     <label><span>Finest texel</span>
         <select id="texel">

package/src/shade/playground/vsm/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/vsm/main.js"],"names":[],"mappings":"AAsCA,uCA8VC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/vsm/main.js"],"names":[],"mappings":"AAsCA,uCAiWC"}

package/src/shade/playground/vsm/main.js

@@ -1,5 +1,5 @@
 import Vector3 from "../../../core/geom/Vector3.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { PerspectiveCamera } from "../../renderer/camera/PerspectiveCamera.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { Renderer } from "../../renderer/Renderer.js";
@@ -140,7 +140,8 @@ export async function start() {
     function apply_settings() {
         renderer.feature_virtual_shadow_maps = element('technique').value === 'vsm';
         renderer.shadow_virtual_page_budget = element('pause').checked ? 0 : Number(element('budget').value);
-        renderer.shadow_virtual_lod_bias = Number(element('bias').value);
+        renderer.shadow_virtual_lod_bias = Number(element('bias').value);
+        renderer.shadow_virtual_max_load_factor = Number(element('max-load').value);
         renderer.shadow_virtual_first_texel_size = Number(element('texel').value);
         renderer.feature_taa_enabled = element('taa').checked;
 
@@ -148,11 +149,12 @@ export async function start() {
         overlay.inset = element('inset').checked;
 
         element('budget-value').textContent = element('budget').value;
-        element('bias-value').textContent = Number(element('bias').value).toFixed(1);
+        element('bias-value').textContent = Number(element('bias').value).toFixed(1);
+        element('max-load-value').textContent = Number(element('max-load').value).toFixed(2);
         element('crowd-value').textContent = element('crowd').value;
     }
 
-    for (const id of ['technique', 'budget', 'bias', 'texel', 'debug', 'inset', 'pause', 'taa']) {
+    for (const id of ['technique', 'budget', 'bias', 'max-load', 'texel', 'debug', 'inset', 'pause', 'taa']) {
         element(id).addEventListener('input', apply_settings);
     }
 
@@ -201,7 +203,8 @@ export async function start() {
 
             lines.push(
                 `movers in scene: ${world.mover_count}`,
-                `pages: ${slots.used} / ${slots.capacity} resident`,
+                `pages: ${slots.used} / ${slots.capacity} resident (demand ${(s.load * 100).toFixed(1)}%)`,
+                `lod bias: ${map.lod_bias.toFixed(2)} + ${s.dynamic_lod_bias.toFixed(2)} dyn = ${map.effective_lod_bias.toFixed(2)}`,
                 `this frame: ${s.renders} rendered, ${s.backlog} waiting`,
                 `reading: ${s.wants} wanted, ${s.uncovered} uncovered, ${s.requests_dropped} dropped`,
                 `movers: ${s.movers}${s.movers > 4096 ? ' (overflow: all stale)' : ''}`,

package/src/shade/playground/water_refraction/main.js

@@ -20,7 +20,7 @@ import { FluidEffectorsComponent } from "../../../engine/physics/fluid/ecs/Fluid
 import { FluidEffectorsSystem } from "../../../engine/physics/fluid/ecs/FluidEffectorsSystem.js";
 import { GPUFluidComponent } from "../../../engine/physics/fluid/ecs/GPUFluidComponent.js";
 import { GlobalFluidEffector } from "../../../engine/physics/fluid/effector/GlobalFluidEffector.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { DynamicMeshAVBOITChannel } from "../../renderer/dynamic/DynamicMeshAVBOITChannel.js";
 import { Scene } from "../../renderer/scene/Scene.js";

package/src/shade/playground/water_surface/main.js

@@ -18,7 +18,7 @@ import { GlobalFluidEffector } from "../../../engine/physics/fluid/effector/Glob
 import { GPUProfileLevel } from "../../device/timing/profile/GPUProfileLevel.js";
 import { GPUProfileSession } from "../../device/timing/profile/GPUProfileSession.js";
 import { sgpt_read_capture } from "../../device/timing/profile/sgpt_read_capture.js";
-import { OrbitalCameraController } from "../../renderer/camera/OrbitalCameraController.js";
+import { OrbitalCameraController } from "../../renderer/camera/orbital/OrbitalCameraController.js";
 import { create_frame_loop } from "../../renderer/create_frame_loop.js";
 import { Scene } from "../../renderer/scene/Scene.js";
 import { load_default_environment } from "../load_default_environment.js";

package/src/shade/renderer/Renderer.d.ts

@@ -29,6 +29,12 @@ export class Renderer {
      * @type {ShadeIndirectLightingMode}
      */
     indirect_lighting_mode: ShadeIndirectLightingMode;
+    /**
+     * Settings of {@link ShadeIndirectLightingMode.ProbeClipmap}, read every frame it runs. A change to
+     * one of its structural fields builds the mode's clipmaps again; see {@link ProbeClipmapSettings}.
+     * @type {ProbeClipmapSettings}
+     */
+    probe_clipmap: ProbeClipmapSettings;
     /**
      * Which order-independent transparency technique draws the transparent buckets. Both modes
      * are wired at the single transparency call site and take the same inputs, so this is safe to
@@ -103,6 +109,12 @@ export class Renderer {
      * @type {number}
      */
     shadow_virtual_lod_bias: number;
+    set shadow_virtual_max_load_factor(v: number);
+    get shadow_virtual_max_load_factor(): number;
+    set shadow_virtual_low_load_factor(v: number);
+    get shadow_virtual_low_load_factor(): number;
+    set shadow_virtual_max_dynamic_lod_bias(v: number);
+    get shadow_virtual_max_dynamic_lod_bias(): number;
     set shadow_virtual_first_texel_size(v: number);
     get shadow_virtual_first_texel_size(): number;
     feature_bloom_enabled: boolean;
@@ -132,7 +144,9 @@ export class Renderer {
     /**
      * While TAA is off nothing writes the history textures, but the frame counter that
      * indexes them keeps advancing — re-enabling would blend with arbitrarily stale
-     * history of arbitrary parity. Reset temporal history on the transition.
+     * history of arbitrary parity. Reset temporal history on the transition — but not the path
+     * tracer's accumulation, which TAA does not feed: a page flipping between the traced reference
+     * and the rasterized image turns TAA off and back on each time, and would lose the reference.
      * @param {boolean} v
      */
     set feature_taa_enabled(v: boolean);
@@ -542,6 +556,7 @@ export type GPUSceneContext = import("./scene/GPUSceneContext.js").GPUSceneConte
 export type Scene = import("./scene/Scene.js").Scene;
 import { SceneManager } from "./scene/SceneManager.js";
 import { ShadeIndirectLightingMode } from "./ShadeIndirectLightingMode.js";
+import { ProbeClipmapSettings } from "./global_illumination/probe_clipmap/ProbeClipmapSettings.js";
 import { ShadeTransparencyMode } from "./ShadeTransparencyMode.js";
 import { ShadeToneMappingMode } from "./ShadeToneMappingMode.js";
 import { AVBOITSettings } from "./rasterize/native/avboit/AVBOITSettings.js";

package/src/shade/renderer/Renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/Renderer.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../../../src/shade/renderer/Renderer.js"],"names":[],"mappings":"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"}