@drawcall/lod 0.2.0 → 0.3.0

package/dist/levels/manager.js

@@ -0,0 +1,339 @@
+import { nextTask } from "../task.js";
+import { isObject3D, isScene, rootOf } from "../three.js";
+import { CameraRenders } from "./cameras.js";
+import { has } from "./draw.js";
+import { LoadingItem } from "./item.js";
+import { CameraRequests } from "./requests.js";
+import { ChunkWait } from "./wait.js";
+import { ContextCompiles } from "./compiles.js";
+/** How long an arriving level fades in for, over what drew in its place. */
+export const ARRIVAL_MS = 200;
+/**
+ * Loads a Lod's or InstancedLod's levels as its cameras request them, never blocking a render. The coarsest level that
+ * draws something loads first, as nothing draws before it has (see levelsToDraw); the other levels a camera wants
+ * start loading once it has loaded. Each level's load runs once; once the render that asked for it has ended, the Lod
+ * prepares it (`prepare`), it compiles for the render context of every camera rendering the Lod and joins the loaded
+ * levels. Levels join only between arrivals, each of which fades in for ARRIVAL_MS from the levels loaded `before` it.
+ * Each render context seen for the first time compiles in the background every loaded level that draws something,
+ * given ones included, that no camera rendering the Lod wants: three skips a draw whose pipeline a compileAsync is
+ * still building, in any context that shares it, so a level a camera may draw now builds as it first draws instead.
+ * Nothing is evicted: a level stays loaded until the Lod is disposed.
+ *
+ * A Lod draws with its LodGpu's renderer, whose renders it learns its cameras from. It holds an item on its LoadingManager while anything a camera wants is missing, compiling or arriving,
+ * and an InstancedLod's while the GPU has not shown its chunks taken in (see `chunksChanged`).
+ */
+export class LodLevelLoadManager {
+    lod;
+    gpu;
+    name;
+    levels;
+    prepare;
+    drawnBy;
+    /** The bits of the levels that draw: given ones from the start, deferred ones once loaded and compiled. */
+    loaded = 0;
+    /** The bits loaded before the latest arrival (see `progress`). */
+    before = 0;
+    /** The first failure; it stops further loading. */
+    error;
+    /** Whether a render has updated the Lod: its shaders are being or have been built. */
+    started = false;
+    /** What draws the Lod: its LodGpu's renderer. */
+    renderer;
+    /** The cameras rendering the Lod, and what they asked for. */
+    requests;
+    /** Its item on a LoadingManager. */
+    item;
+    /**
+     * The bits of the levels that draw nothing, the coarsest level that draws something, and the order levels load in: it
+     * first, then coarse to fine.
+     */
+    empty;
+    coarsest;
+    order;
+    /** When the latest arrival began. */
+    arrival;
+    /** Compiled levels waiting for the arrival under way to end. */
+    ready = new Map();
+    /** Levels being prepared and compiled to join the loaded ones. */
+    arriving = new Map();
+    /** The background compiles of loaded levels, per render context. */
+    compiles;
+    /** Per level, its load once started. */
+    loads = new Map();
+    /** What renders told of the cameras that drew the Lod. */
+    seen = new CameraRenders();
+    disposed = false;
+    /** What `LodLevel.hold` answered, each called once the Lod is disposed. */
+    releases;
+    /** An InstancedLod's chunks, while they wait to be shown taken in (see `chunksChanged`); null for a Lod. */
+    wait;
+    constructor(lod, gpu, 
+    /** The LoadingManager item's name, which errors name too: the kind of Lod and its uuid. */
+    name, 
+    /** The levels as the Lod was given them: it holds them (see `LodLevel.hold`) until it is disposed. */
+    levels, 
+    /** The levels as levelsToDraw reads them, for the ones that draw nothing and the coarsest that draws something. */
+    { empty, coarsest }, prepare, 
+    /** What draws a loaded level, compiled for each render context it is wanted in. */
+    drawnBy, 
+    /** An InstancedLod's read of whether the GPU shows every chunk taken in (see `ChunkWait`); null for a Lod. */
+    readChunks) {
+        this.lod = lod;
+        this.gpu = gpu;
+        this.name = name;
+        this.levels = levels;
+        this.prepare = prepare;
+        this.drawnBy = drawnBy;
+        if (gpu.disposed)
+            throw new Error("LodGpu: disposed");
+        this.loaded = this.before = levels.reduce((bits, level, i) => (level.object ? bits | (1 << i) : bits), 0);
+        this.empty = empty;
+        this.coarsest = coarsest;
+        this.order = levels.length === 0 ? [] : [coarsest, ...[...levels.keys()].reverse().filter((level) => level !== coarsest)];
+        this.releases = [...new Set(levels.flatMap(({ hold }) => (hold ? [hold] : [])))].map((hold) => hold());
+        this.renderer = gpu.renderer;
+        this.requests = new CameraRequests(this.renderer, this.seen);
+        this.compiles = new ContextCompiles((context, bits) => this.compileLevels(context, bits), (error) => this.report(error));
+        this.item = new LoadingItem(lod, name, this.renderer);
+        this.wait =
+            readChunks &&
+                new ChunkWait(readChunks, () => this.sync(), (error) => this.report(error));
+    }
+    /** How far the latest arrival has faded in, in [0, 1]: 1 once it has. */
+    get progress() {
+        if (this.arrival === undefined)
+            return 1;
+        return Math.min((performance.now() - this.arrival) / ARRIVAL_MS, 1);
+    }
+    get pending() {
+        if (this.disposed || this.error)
+            return false;
+        if (this.arriving.size > 0 || this.ready.size > 0 || (this.requests.needed() & ~this.loaded) !== 0)
+            return true;
+        return this.compiles.running(this.requests);
+    }
+    /**
+     * `camera`, a shadow map's when `shadow`, wants the levels of the bits `wanted` (see levelsToLoad): load what is
+     * missing, and answer the bits of the levels loaded now. Outside a Scene a missing level is an error, as no render of it would load it.
+     */
+    request(camera, wanted, shadow) {
+        this.started = true;
+        const scene = rootOf(this.lod);
+        if (this.disposed || this.error)
+            return this.loaded;
+        if (!isScene(scene)) {
+            if ((wanted & ~this.loaded) !== 0)
+                throw new Error(`${this.name}: render a Scene that holds it to load the levels it needs`);
+            return this.loaded;
+        }
+        this.item.touch();
+        const frame = this.requests.set(scene, camera, wanted, shadow);
+        this.load(camera, shadow, frame);
+        this.wait?.render();
+        this.sync();
+        return this.loaded;
+    }
+    /**
+     * An InstancedLod's chunks were added or removed: hold the item until, a few renders later, the GPU shows each taken
+     * in, so that a host waiting for its LoadingManager sees them drawn. A chunk the pool lacks room for is the
+     * InstancedLod's error.
+     */
+    chunksChanged() {
+        if (!this.wait)
+            throw new Error(`LodLevelLoadManager: chunksChanged on ${this.name}, a Lod without chunks`);
+        this.wait.changed();
+        this.sync();
+    }
+    /**
+     * The height `camera`, a shadow map's when `shadow`, draws at (see CameraRenders.heightOf), which levels are chosen
+     * at.
+     */
+    heightOf(camera, shadow) {
+        return this.seen.heightOf(camera, this.renderer, shadow);
+    }
+    /** What compiles for `cameras` are for: the shadow maps they drew, and the targets disposed. */
+    compileFor(cameras) {
+        return { shadows: this.seen.shadowsOf(cameras), isDisposed: (target) => this.seen.isDisposed(target) };
+    }
+    /**
+     * Load what the cameras still rendering the Lod want, in `order`, compile for `camera`'s render context every loaded
+     * level that draws something, none of them wants and is not yet compiled for it, and prepare the levels that have
+     * loaded. `shadow` is whether a shadow map renders it, in the renderer's `frame`.
+     */
+    load(camera, shadow, frame) {
+        const needed = this.requests.needed();
+        const coarsestLoaded = !this.levelAt(this.coarsest).load || this.loads.get(this.coarsest)?.object !== undefined;
+        for (const level of this.order) {
+            const { load } = this.levelAt(level);
+            if (!load || !has(needed, level) || this.loads.has(level) || (!coarsestLoaded && level !== this.coarsest))
+                continue;
+            this.start(level, load);
+        }
+        // What draws never changes halfway through a frame: once a camera updated the Lod in it, as for an InstancedLod
+        // its indirect draws, a shadow map rendered later joins nothing. The camera's next update does; a Lod only shadow
+        // maps update joins in theirs.
+        if (!shadow || this.requests.cameraFrame !== frame)
+            this.join();
+        const context = this.seen.contextOf(camera);
+        if (!context)
+            return;
+        this.compiles.compile(context, this.compiles.claim(context, this.loaded & ~this.empty & ~needed));
+        const missing = needed & ~this.loaded;
+        for (const level of this.order) {
+            if (!has(missing, level) || !this.loads.get(level)?.object || this.arriving.has(level) || this.ready.has(level))
+                continue;
+            this.arrive(level, context);
+        }
+    }
+    /** Run level `level`'s `load`, holding the object it makes. */
+    start(level, load) {
+        const entry = {
+            promise: Promise.resolve()
+                .then(load)
+                .then((object) => {
+                if (!isObject3D(object))
+                    throw new Error(`${this.name}: level ${level}'s load must return an Object3D`);
+                entry.object = object;
+                return object;
+            })
+                .catch((error) => {
+                entry.error = error instanceof Error ? error : new Error(`${this.name}: level ${level} failed to load`, { cause: error });
+                throw entry.error;
+            }),
+        };
+        this.loads.set(level, entry);
+        void entry.promise.catch((error) => this.report(error));
+    }
+    levelAt(level) {
+        const found = this.levels[level];
+        if (!found)
+            throw new Error(`${this.name}: no level ${level}`);
+        return found;
+    }
+    /** Compile the loaded levels of `bits` for `context`: a background compile (see ContextCompiles). */
+    async compileLevels(context, bits) {
+        // A context whose target was disposed meanwhile is dropped: compiling would revive the target.
+        if (this.disposed || !this.seen.holds(context))
+            return;
+        const objects = this.order.filter((level) => has(bits, level)).flatMap((level) => this.drawnBy(level));
+        const compileFor = this.compileFor(this.requests.cameras());
+        await Promise.all(objects.map((object) => this.gpu.compiler.compileAsync(object, context, compileFor)));
+    }
+    /**
+     * Prepare `level` once the render that asked for it has ended, if a camera still wants it then, and compile it for
+     * the render context of every camera still rendering the Lod, `context` among them, to join the loaded levels: a
+     * slow level never holds another's, and no camera draws it uncompiled.
+     */
+    arrive(level, context) {
+        // A render runs within one task: the next starts after it has ended.
+        const done = nextTask()
+            .then(async () => {
+            const object = this.loads.get(level)?.object;
+            if (this.disposed || !object || !has(this.requests.needed(), level))
+                return;
+            const cameras = this.requests.cameras();
+            // Contexts whose targets were disposed meanwhile are dropped. A camera that starts rendering the Lod while it
+            // arrives draws it with pipelines built in that frame.
+            const seen = [context, ...cameras.flatMap((camera) => this.seen.contextOf(camera) ?? [])];
+            const contexts = new Set(seen.filter((other) => this.seen.holds(other)));
+            for (const other of contexts)
+                this.compiles.claim(other, 1 << level);
+            const prepared = this.prepare(level, object);
+            try {
+                const compileFor = this.compileFor(cameras);
+                await Promise.all([...contexts].map((other) => this.gpu.compiler.compileAsync(prepared.object, other, compileFor)));
+            }
+            catch (error) {
+                prepared.discard();
+                throw error;
+            }
+            if (this.disposed)
+                return prepared.discard();
+            this.ready.set(level, prepared);
+        })
+            .catch((error) => this.report(error))
+            .finally(() => {
+            this.arriving.delete(level);
+            this.join();
+        });
+        this.arriving.set(level, done);
+    }
+    /** Let compiled levels join the loaded ones, between arrivals: what draws never changes halfway through a fade. */
+    join() {
+        if (this.disposed || this.ready.size === 0 || this.progress < 1)
+            return;
+        this.before = this.loaded;
+        for (const [level, prepared] of this.ready) {
+            prepared.join();
+            this.loaded |= 1 << level;
+        }
+        this.ready.clear();
+        this.arrival = performance.now();
+        queueMicrotask(() => {
+            if (!this.disposed)
+                this.lod.dispatchEvent({ type: "levelschange" });
+        });
+    }
+    /**
+     * Hold the item while levels a camera wants are missing, compiling or arriving, or chunks wait to be shown taken in,
+     * and end it once they are done, so a host waiting for its LoadingManager renders its cameras complete. Called at
+     * the end of each request.
+     */
+    sync() {
+        this.item.sync(!this.disposed && !this.error && (this.pending || (this.wait !== null && this.wait.waiting) || this.progress < 1));
+    }
+    /**
+     * The one failure rule, for a level that fails and for anything that throws while three renders, where a throw would
+     * leave its internal target bound: note the error, log it, report it on the LoadingManager the item is held on and
+     * end the item, and dispatch `levelserror`. Only the first is reported; it stops further loading.
+     */
+    report(error) {
+        if (this.disposed || this.error)
+            return;
+        const failure = (this.error = error instanceof Error ? error : new Error("Lod: level failed", { cause: error }));
+        console.error(failure);
+        this.item.fail();
+        this.lod.dispatchEvent({ type: "levelserror", error: failure });
+    }
+    /** Run `action`, part of an update or a draw callback, reporting what it throws instead. */
+    guard(action) {
+        try {
+            action();
+        }
+        catch (error) {
+            this.report(error);
+        }
+    }
+    /**
+     * Stop loading, then `release` what the Lod made of its levels and let go of what it holds of them (see
+     * `LodLevel.hold`), once nothing preparing, compiling or loading still uses them. What the levels gave or loaded is
+     * not freed: it is whoever made it's.
+     */
+    dispose(release) {
+        this.disposed = true;
+        this.item.sync(false);
+        this.seen.dispose();
+        for (const prepared of this.ready.values())
+            prepared.discard();
+        this.ready.clear();
+        const free = () => {
+            release();
+            for (const letGo of this.releases)
+                letGo();
+        };
+        const finish = () => {
+            const unsettled = [...this.loads.values()].flatMap((entry) => (!entry.object && !entry.error ? [entry.promise] : []));
+            // A mesh decode can begin its source-material dependency after disposal starts.
+            if (unsettled.length)
+                void Promise.allSettled(unsettled).then(free);
+            else
+                free();
+        };
+        const tasks = [...this.arriving.values(), ...this.compiles.tasks()];
+        if (tasks.length > 0)
+            void Promise.all(tasks).then(finish);
+        else
+            finish();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/levels/manager.js.map

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

package/dist/{material.js → levels/material.js}

@@ -1,8 +1,9 @@
 import { Fn, output, positionLocal, vec4 } from "three/tsl";
 import { castPosition, keepsPixel, placeInstances, tint } from "./fade.js";
-import { toNodeMaterial } from "./three.js";
-import { isNodeOf } from "./tsl.js";
-import { sway } from "./wind/sway.js";
+import { toNodeMaterial } from "../three.js";
+import { isNodeOf } from "../tsl.js";
+import { sway } from "../wind/sway.js";
+// Side tables, as three's Material has no typed place for a package's state (userData is the app's).
 /** Copy → the material it copies. */
 const originals = new WeakMap();
 /** Original → its copies, still and swaying. */

package/dist/levels/material.js.map

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

package/dist/levels/renderer.d.ts

@@ -0,0 +1,29 @@
+import type { LoadingManager, Object3D, Renderer } from "three/webgpu";
+/** A Lod or an InstancedLod: what has a LoadingManager, which items for its levels go to. */
+export declare const hasLoadingManager: (node: Object3D) => node is Object3D & {
+    readonly manager: LoadingManager;
+};
+/**
+ * How deep in renders `renderer` is: -1 outside them, 0 in a render of its own, 1 in one it draws inside another, as it
+ * draws shadow maps and post-processing. Read from r186's `_callDepth`: three keeps a draw's built shader per depth,
+ * and no public API tells which.
+ */
+export declare function callDepth(renderer: Renderer): number;
+/**
+ * Whether `renderer` is rendering or compiling now, as it is while it updates what it draws; not while an app calls
+ * `update` itself or another renderer draws. A compile is told by r186's `_compilationPromises`, which no public API
+ * shows.
+ */
+export declare const busy: (renderer: Renderer) => boolean;
+/**
+ * Whether the scene `node` is in is being drawn into a shadow map: three's shadow map render
+ * draws it with its own override material, and calls `update` on every LOD with the
+ * light's camera, which must not switch the levels the scene's camera chose.
+ */
+export declare function inShadowMap(node: Object3D): boolean;
+/**
+ * Whether `target` is the framebuffer target r186 draws the canvas (or output target) through when tone mapping or
+ * the output colour space needs a final pass. A draw meant for the output sees it as the active target; a compile for
+ * the output leaves the target unset and lets three resolve it.
+ */
+export declare const isOutputPass: (target: unknown) => boolean;

package/dist/levels/renderer.js

@@ -0,0 +1,41 @@
+import { isLOD, isScene, isShadowPass } from "../three.js";
+// What a Lod learns of the renderer drawing it, and when. three r186 shows much of it through no public API: each
+// read of one of its private fields below says why none serves.
+/** A Lod or an InstancedLod: what has a LoadingManager, which items for its levels go to. */
+export const hasLoadingManager = (node) => isLOD(node) && "manager" in node && isLoadingManager(node.manager);
+const isLoadingManager = (value) => typeof value === "object" && value !== null && "itemStart" in value && "itemEnd" in value;
+/**
+ * How deep in renders `renderer` is: -1 outside them, 0 in a render of its own, 1 in one it draws inside another, as it
+ * draws shadow maps and post-processing. Read from r186's `_callDepth`: three keeps a draw's built shader per depth,
+ * and no public API tells which.
+ */
+export function callDepth(renderer) {
+    const depth = Reflect.get(renderer, "_callDepth");
+    if (typeof depth !== "number")
+        throw new Error("Lod: three's renderer keeps no call depth (lod mirrors three r186)");
+    return depth;
+}
+/**
+ * Whether `renderer` is rendering or compiling now, as it is while it updates what it draws; not while an app calls
+ * `update` itself or another renderer draws. A compile is told by r186's `_compilationPromises`, which no public API
+ * shows.
+ */
+export const busy = (renderer) => callDepth(renderer) >= 0 || Reflect.get(renderer, "_compilationPromises") != null;
+/**
+ * Whether the scene `node` is in is being drawn into a shadow map: three's shadow map render
+ * draws it with its own override material, and calls `update` on every LOD with the
+ * light's camera, which must not switch the levels the scene's camera chose.
+ */
+export function inShadowMap(node) {
+    for (let scene = node; scene; scene = scene.parent)
+        if (isScene(scene) && isShadowPass(scene.overrideMaterial))
+            return true;
+    return false;
+}
+/**
+ * Whether `target` is the framebuffer target r186 draws the canvas (or output target) through when tone mapping or
+ * the output colour space needs a final pass. A draw meant for the output sees it as the active target; a compile for
+ * the output leaves the target unset and lets three resolve it.
+ */
+export const isOutputPass = (target) => typeof target === "object" && target !== null && Reflect.get(target, "isPostProcessingRenderTarget") === true;
+//# sourceMappingURL=renderer.js.map

package/dist/levels/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/levels/renderer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D,kHAAkH;AAClH,gEAAgE;AAEhE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAc,EAA2D,EAAE,CAC3G,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrE,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,CAAC;AAEhK;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAkB;IAC1C,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACrH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,QAAkB,EAAW,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,sBAAsB,CAAC,IAAI,IAAI,CAAC;AAEvI;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,KAAK,IAAI,KAAK,GAAoB,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM;QAAE,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,gBAAgB,CAAC;YAAE,OAAO,IAAI,CAAC;IAC7I,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAe,EAAW,EAAE,CACvD,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,8BAA8B,CAAC,KAAK,IAAI,CAAC"}

package/dist/levels/requests.d.ts

@@ -0,0 +1,49 @@
+import type { Camera, Renderer, Scene } from "three/webgpu";
+import type { CameraRenders } from "./cameras.js";
+/**
+ * What the cameras rendering a Lod asked of it: per camera the levels it wants, and whether it still renders the Lod.
+ * The renderer's updates of the Lod are counted in rounds: a round ends when a camera updates it a second time, so a
+ * round holds one update by each camera that renders it once a frame, whatever their order. Shadow maps do not count.
+ */
+export declare class CameraRequests {
+    private readonly renderer;
+    /** What renders told of the cameras that drew the Lod. */
+    private readonly seen;
+    /** The frame a camera, not a shadow map's, last updated the Lod in. */
+    cameraFrame: number | null;
+    /** The cameras still rendering the Lod (see `fresh`), and what they asked for. */
+    private readonly requests;
+    private round;
+    /** The cameras that updated the Lod in the round under way. */
+    private readonly inRound;
+    constructor(renderer: Renderer, 
+    /** What renders told of the cameras that drew the Lod. */
+    seen: CameraRenders);
+    /**
+     * `camera`, a shadow map's when `shadow`, rendering `scene`, wants the levels of the bits `wanted`: note it, drop the
+     * cameras that stopped rendering the Lod, and answer the renderer's frame.
+     */
+    set(scene: Scene, camera: Camera, wanted: number, shadow: boolean): number;
+    /** Note what a render of `scene` with `camera` tells: nothing outside the renderer's renders. */
+    private see;
+    /** The cameras still rendering the Lod. */
+    cameras(): Camera[];
+    /**
+     * The bits of the levels wanted by the cameras still rendering the Lod (see `rendering`): each camera that renders
+     * the scene once a frame counts, whatever their order, and one that stopped rendering it drops out.
+     */
+    needed(): number;
+    /**
+     * Whether `camera` still renders the Lod: it updated it in the current or last round, or it is a shadow map's whose
+     * target is not disposed (see `fresh`).
+     */
+    rendering(camera: Camera): boolean;
+    /**
+     * Whether `camera`'s `request` still counts: made in the current or last round, or a shadow map's while its map's
+     * target is not disposed, as the scene's cameras draw what its last update filled however seldom it is redrawn
+     * (three redraws a map whose `autoUpdate` is off only when asked). A shadow map's made this frame counts too, before
+     * a render notes its target: three draws a map at most once a frame, so a camera rendered again in the frame draws
+     * the map the update filled.
+     */
+    private fresh;
+}

package/dist/levels/requests.js

@@ -0,0 +1,95 @@
+import { busy, inShadowMap } from "./renderer.js";
+/**
+ * What the cameras rendering a Lod asked of it: per camera the levels it wants, and whether it still renders the Lod.
+ * The renderer's updates of the Lod are counted in rounds: a round ends when a camera updates it a second time, so a
+ * round holds one update by each camera that renders it once a frame, whatever their order. Shadow maps do not count.
+ */
+export class CameraRequests {
+    renderer;
+    seen;
+    /** The frame a camera, not a shadow map's, last updated the Lod in. */
+    cameraFrame = null;
+    /** The cameras still rendering the Lod (see `fresh`), and what they asked for. */
+    requests = new Map();
+    round = 0;
+    /** The cameras that updated the Lod in the round under way. */
+    inRound = new Set();
+    constructor(renderer, 
+    /** What renders told of the cameras that drew the Lod. */
+    seen) {
+        this.renderer = renderer;
+        this.seen = seen;
+    }
+    /**
+     * `camera`, a shadow map's when `shadow`, rendering `scene`, wants the levels of the bits `wanted`: note it, drop the
+     * cameras that stopped rendering the Lod, and answer the renderer's frame.
+     */
+    set(scene, camera, wanted, shadow) {
+        this.see(scene, camera);
+        for (const [other, request] of this.requests)
+            if (!this.fresh(other, request))
+                this.requests.delete(other);
+        let request = this.requests.get(camera);
+        if (!request)
+            this.requests.set(camera, (request = { levels: 0, round: this.round, frame: null }));
+        request.round = this.round;
+        const frame = this.renderer.info.frame;
+        request.frame = shadow ? frame : null;
+        if (!shadow)
+            this.cameraFrame = frame;
+        request.levels = wanted;
+        return frame;
+    }
+    /** Note what a render of `scene` with `camera` tells: nothing outside the renderer's renders. */
+    see(scene, camera) {
+        const { renderer } = this;
+        if (!busy(renderer))
+            return;
+        this.seen.note(renderer, scene, camera);
+        if (inShadowMap(scene))
+            return;
+        if (this.inRound.has(camera)) {
+            this.round++;
+            this.inRound.clear();
+        }
+        this.inRound.add(camera);
+    }
+    /** The cameras still rendering the Lod. */
+    cameras() {
+        return [...this.requests].flatMap(([camera, request]) => (this.fresh(camera, request) ? [camera] : []));
+    }
+    /**
+     * The bits of the levels wanted by the cameras still rendering the Lod (see `rendering`): each camera that renders
+     * the scene once a frame counts, whatever their order, and one that stopped rendering it drops out.
+     */
+    needed() {
+        let bits = 0;
+        for (const [camera, request] of this.requests)
+            if (this.fresh(camera, request))
+                bits |= request.levels;
+        return bits;
+    }
+    /**
+     * Whether `camera` still renders the Lod: it updated it in the current or last round, or it is a shadow map's whose
+     * target is not disposed (see `fresh`).
+     */
+    rendering(camera) {
+        const request = this.requests.get(camera);
+        return request !== undefined && this.fresh(camera, request);
+    }
+    /**
+     * Whether `camera`'s `request` still counts: made in the current or last round, or a shadow map's while its map's
+     * target is not disposed, as the scene's cameras draw what its last update filled however seldom it is redrawn
+     * (three redraws a map whose `autoUpdate` is off only when asked). A shadow map's made this frame counts too, before
+     * a render notes its target: three draws a map at most once a frame, so a camera rendered again in the frame draws
+     * the map the update filled.
+     */
+    fresh(camera, request) {
+        if (request.round >= this.round - 1)
+            return true;
+        if (request.frame === null)
+            return false;
+        return request.frame === this.renderer.info.frame || this.seen.drawsShadowMap(camera);
+    }
+}
+//# sourceMappingURL=requests.js.map

package/dist/levels/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../src/levels/requests.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAUlD;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAUN;IAEA;IAXnB,uEAAuE;IACvE,WAAW,GAAkB,IAAI,CAAC;IAClC,kFAAkF;IACjE,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC/C,KAAK,GAAG,CAAC,CAAC;IAClB,+DAA+D;IAC9C,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YACmB,QAAkB;IACnC,0DAA0D;IACzC,IAAmB;QAFnB,aAAQ,GAAR,QAAQ,CAAU;QAElB,SAAI,GAAJ,IAAI,CAAe;IACnC,CAAC;IAEJ;;;OAGG;IACH,GAAG,CAAC,KAAY,EAAE,MAAc,EAAE,MAAc,EAAE,MAAe;QAC/D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3G,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACnG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QACvC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACtC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iGAAiG;IACzF,GAAG,CAAC,KAAY,EAAE,MAAc;QACtC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,2CAA2C;IAC3C,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1G,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;gBAAE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;QACvG,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAc;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,MAAc,EAAE,OAAgB;QAC5C,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACzC,OAAO,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACxF,CAAC;CACF"}

package/dist/levels/screen.d.ts

@@ -0,0 +1,14 @@
+import { Vector3, type Camera, type Matrix4, type Sphere } from "three/webgpu";
+/** How a camera measures heights: from where, and pixels per unit of subtense (perspective) or of size (orthographic). */
+export interface Screen {
+    readonly eye: Vector3;
+    ortho: boolean;
+    scale: number;
+}
+/** `camera`'s screen at `height`, the one it draws at, into `out`. */
+export declare function screenOf(camera: Camera, height: number, out?: Screen): Screen;
+/**
+ * The height on `screen` of `sphere`, given in the space `root` maps to world: its diameter, scaled by the largest axis
+ * scale of `root`, over its distance (small-angle), or its diameter alone in an orthographic camera.
+ */
+export declare function screenHeight(sphere: Sphere, root: Matrix4, screen: Screen): number;

package/dist/levels/screen.js

@@ -0,0 +1,21 @@
+import { Vector3 } from "three/webgpu";
+/** `camera`'s screen at `height`, the one it draws at, into `out`. */
+export function screenOf(camera, height, out = { eye: new Vector3(), ortho: false, scale: 0 }) {
+    const projection = camera.projectionMatrix.elements;
+    out.ortho = projection[15] === 1;
+    out.scale = ((projection[5] ?? 0) * height) / 2;
+    out.eye.setFromMatrixPosition(camera.matrixWorld);
+    return out;
+}
+const centre = new Vector3();
+/**
+ * The height on `screen` of `sphere`, given in the space `root` maps to world: its diameter, scaled by the largest axis
+ * scale of `root`, over its distance (small-angle), or its diameter alone in an orthographic camera.
+ */
+export function screenHeight(sphere, root, screen) {
+    const size = 2 * sphere.radius * root.getMaxScaleOnAxis();
+    if (screen.ortho)
+        return size * screen.scale;
+    return (size * screen.scale) / Math.max(screen.eye.distanceTo(centre.copy(sphere.center).applyMatrix4(root)), 1e-6);
+}
+//# sourceMappingURL=screen.js.map