@drawcall/lod 0.1.2 → 0.3.0

package/dist/instanced/shape.js.map

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

package/dist/instanced/sort.d.ts

@@ -0,0 +1,63 @@
+import { StorageInstancedBufferAttribute, type Camera, type Frustum, type Renderer, type Sphere, type Vector3 } from "three/webgpu";
+import type { d } from "typegpu";
+import type { DrawLevels } from "../levels/draw.js";
+import type { InstanceSlots } from "../levels/fade.js";
+import type { Cull } from "./cull.js";
+import { type InstancePagePool } from "./pages/index.js";
+import { type IndirectDraw } from "./rows.js";
+/** What one InstancedLod sorts by for a camera, everything in its space. */
+export interface RowValues {
+    levels: d.Infer<typeof DrawLevels>;
+    /** The level loading state levelsToDraw reads (see LodLevelLoadManager). */
+    loaded: number;
+    before: number;
+    progress: number;
+    eye: Vector3;
+    /** Pixels per unit of subtense (or of size, for an orthographic camera). */
+    scale: number;
+    ortho: boolean;
+    cull: Cull | null;
+    /** One instance's source sphere, and how far its levels and their sway reach. */
+    source: Sphere;
+    reach: number;
+    frustum: Frustum;
+}
+/** The rows of every InstancedLod of a LodGpu, every camera's buffers, and the passes sorting into them. */
+export declare class Sorter {
+    private readonly renderer;
+    private readonly pool;
+    private readonly layout;
+    private readonly cameras;
+    /** Survivors' scaled matrices, made once a row scales them; their CPU array is dropped once a pass wrote them. */
+    private scaled;
+    /** Where survivors' scaled matrices go while none scale: never written, as no survivor scales. */
+    private readonly unscaled;
+    private passes;
+    private isDisposed;
+    constructor(renderer: Renderer, pool: InstancePagePool);
+    /** A row for an InstancedLod whose levels of `listed`, a mask, list up to `listSize` instances each. */
+    register(listed: number, listSize: number): number;
+    /** Free `row`: its InstancedLod is disposed. */
+    unregister(row: number): void;
+    /** `row` draws `draws` too, after those it has; where they start among its draws. */
+    appendDraws(row: number, draws: readonly IndirectDraw[]): number;
+    /** Survivors' scaled matrices, every pool index's: one buffer, as pool indices are unique to their InstancedLod. */
+    get scaledMatrices(): StorageInstancedBufferAttribute;
+    /** An InstancedLod draws for `camera`: its buffers are made with the first. */
+    hold(camera: Camera): void;
+    /** An InstancedLod stops drawing for `camera`, its row `row` dropped from it; the last frees its buffers. */
+    release(camera: Camera, row: number): void;
+    /** Where `row`'s lists and draws lie for `camera`. */
+    slotsOf(camera: Camera, row: number): InstanceSlots;
+    /** Write `values` as what `row` sorts by for `camera`, sorted at the camera's next draw. */
+    write(camera: Camera, row: number, values: RowValues): void;
+    /** Sort every row due for `camera`, in one compute call: before a level mesh draws for it. */
+    run(camera: Camera): void;
+    /** Whether it was disposed: then it takes no InstancedLod and no camera. */
+    get disposed(): boolean;
+    dispose(): void;
+    private check;
+    private layOut;
+    private buffersOf;
+    private sortBuffers;
+}

package/dist/instanced/sort.js

@@ -0,0 +1,162 @@
+import { StorageInstancedBufferAttribute } from "three/webgpu";
+import { releaseArrays } from "./pages/index.js";
+import { FLOATS_AT, FLOAT_ROW, INTS_AT, INT_ROW, RowLayout, disposeBuffers, floatsOf, forcedWord, markWords, setSorting, wordsOf, } from "./rows.js";
+import { sortPasses } from "./update.js";
+/** The rows of every InstancedLod of a LodGpu, every camera's buffers, and the passes sorting into them. */
+export class Sorter {
+    renderer;
+    pool;
+    layout = new RowLayout();
+    cameras = new Map();
+    /** Survivors' scaled matrices, made once a row scales them; their CPU array is dropped once a pass wrote them. */
+    scaled = null;
+    /** Where survivors' scaled matrices go while none scale: never written, as no survivor scales. */
+    unscaled = new StorageInstancedBufferAttribute(new Float32Array(16), 16);
+    passes = null;
+    isDisposed = false;
+    constructor(renderer, pool) {
+        this.renderer = renderer;
+        this.pool = pool;
+    }
+    /** A row for an InstancedLod whose levels of `listed`, a mask, list up to `listSize` instances each. */
+    register(listed, listSize) {
+        this.check();
+        return this.layout.register(listed, listSize);
+    }
+    /** Free `row`: its InstancedLod is disposed. */
+    unregister(row) {
+        for (const buffers of this.cameras.values())
+            idle(buffers, row);
+        this.layout.unregister(row);
+    }
+    /** `row` draws `draws` too, after those it has; where they start among its draws. */
+    appendDraws(row, draws) {
+        return this.layout.appendDraws(row, draws);
+    }
+    /** Survivors' scaled matrices, every pool index's: one buffer, as pool indices are unique to their InstancedLod. */
+    get scaledMatrices() {
+        return (this.scaled ??= new StorageInstancedBufferAttribute(new Float32Array(this.pool.capacity * 16), 16));
+    }
+    /** An InstancedLod draws for `camera`: its buffers are made with the first. */
+    hold(camera) {
+        this.check();
+        this.layOut();
+        const buffers = this.cameras.get(camera) ?? this.layout.makeBuffers();
+        buffers.users++;
+        this.cameras.set(camera, buffers);
+    }
+    /** An InstancedLod stops drawing for `camera`, its row `row` dropped from it; the last frees its buffers. */
+    release(camera, row) {
+        const buffers = this.cameras.get(camera);
+        if (!buffers)
+            return;
+        idle(buffers, row);
+        if (--buffers.users > 0)
+            return;
+        this.cameras.delete(camera);
+        disposeBuffers(buffers);
+    }
+    /** Where `row`'s lists and draws lie for `camera`. */
+    slotsOf(camera, row) {
+        this.layOut();
+        const { indices, fades, args } = this.buffersOf(camera);
+        return { indices, fades, args: { attribute: args, offset: this.layout.argsOffset(row) } };
+    }
+    /** Write `values` as what `row` sorts by for `camera`, sorted at the camera's next draw. */
+    write(camera, row, values) {
+        this.layOut();
+        const buffers = this.buffersOf(camera);
+        const { levels, loaded, before, progress, eye, scale, ortho, cull, source, reach, frustum } = values;
+        const words = wordsOf(buffers);
+        const base = row * INT_ROW * 4;
+        words.set([levels.count, levels.coarsest, forcedWord(levels.forced)], base + INTS_AT.levels * 4);
+        words.set([levels.empty, levels.fades, loaded, before], base + INTS_AT.masks * 4);
+        words.set([Number(ortho), Number(cull !== null), Number(cull?.survivors ?? false)], base + INTS_AT.flags * 4);
+        this.layout.place(buffers, row);
+        setSorting(buffers, row, 1);
+        markWords(buffers, base, INT_ROW * 4);
+        const floats = floatsOf(buffers);
+        const at = row * FLOAT_ROW * 4;
+        floats.set(levels.maxPixels, at + FLOATS_AT.low * 4);
+        floats.set([eye.x, eye.y, eye.z, scale], at + FLOATS_AT.eye * 4);
+        floats.set([source.center.x, source.center.y, source.center.z, source.radius], at + FLOATS_AT.source * 4);
+        floats.set([progress, reach, cull?.near ?? 0, cull?.far ?? 1], at + FLOATS_AT.values * 4);
+        if (cull)
+            floats.set([cull.eye.x, cull.eye.y, cull.eye.z, 0], at + FLOATS_AT.cullEye * 4);
+        frustum.planes.forEach(({ normal, constant }, i) => floats.set([normal.x, normal.y, normal.z, constant], at + (FLOATS_AT.planes + i) * 4));
+        buffers.floats.addUpdateRange(at, FLOAT_ROW * 4);
+        buffers.floats.needsUpdate = true;
+        buffers.held.add(row);
+        buffers.due.add(row);
+    }
+    /** Sort every row due for `camera`, in one compute call: before a level mesh draws for it. */
+    run(camera) {
+        this.layOut();
+        const buffers = this.cameras.get(camera);
+        if (!buffers || buffers.due.size === 0)
+            return;
+        const sort = this.sortBuffers(buffers);
+        const { scaled } = this;
+        const passes = (this.passes ??= sortPasses(sort, this.pool.pages));
+        passes.point(sort, this.layout.length);
+        this.renderer.compute([passes.update, passes.indirect]);
+        buffers.whole = false;
+        // Sorted: the rows wait as they are until written again, their sorting bits cleared with the next upload.
+        for (const row of buffers.due)
+            setSorting(buffers, row, 0);
+        buffers.due.clear();
+        // The pass made the scaled matrices' buffer: only the GPU writes them.
+        if (scaled && scaled.array.length > 0)
+            releaseArrays([scaled]);
+    }
+    /** Whether it was disposed: then it takes no InstancedLod and no camera. */
+    get disposed() {
+        return this.isDisposed;
+    }
+    dispose() {
+        this.isDisposed = true;
+        for (const buffers of this.cameras.values())
+            disposeBuffers(buffers);
+        this.cameras.clear();
+        this.layout.dispose();
+        this.scaled?.dispose();
+        this.unscaled.dispose();
+        this.passes?.dispose();
+        this.passes = null;
+    }
+    check() {
+        if (this.isDisposed)
+            throw new Error("LodGpu: disposed");
+    }
+    layOut() {
+        this.layout.layOut(this.cameras.values());
+    }
+    buffersOf(camera) {
+        const buffers = this.cameras.get(camera);
+        if (!buffers)
+            throw new Error("LodGpu: no buffers for the camera");
+        return buffers;
+    }
+    sortBuffers({ words, floats, indices, fades, args }) {
+        return {
+            words,
+            floats,
+            indices,
+            fades,
+            args,
+            matrices: this.pool.matrices,
+            scaled: this.scaled ?? this.unscaled,
+            counts: this.layout.counts,
+            occupied: this.pool.occupied,
+            draws: this.layout.draws,
+        };
+    }
+}
+/** `buffers` no longer sort `row`: its InstancedLod lets go of the camera, or is disposed. */
+function idle(buffers, row) {
+    if (!buffers.held.delete(row))
+        return;
+    buffers.due.delete(row);
+    setSorting(buffers, row, 0);
+}
+//# sourceMappingURL=sort.js.map

package/dist/instanced/sort.js.map

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

package/dist/instanced/update.d.ts

@@ -0,0 +1,30 @@
+import type { IndirectStorageBufferAttribute, StorageBufferAttribute, StorageInstancedBufferAttribute } from "three/webgpu";
+/** The buffers the sort passes read and write: pointed at a camera's (rows, lists, args) as it sorts. */
+export interface SortBuffers {
+    /** Every row, for the camera: its u32s and its f32s (see rows.ts). */
+    words: StorageBufferAttribute;
+    floats: StorageBufferAttribute;
+    /** The pool's matrices, and survivors' scaled ones, which the level meshes draw while survivors scale. */
+    matrices: StorageInstancedBufferAttribute;
+    scaled: StorageInstancedBufferAttribute;
+    /** The camera's slots: per slot, the pool index it draws and its signed fade. */
+    indices: StorageBufferAttribute;
+    fades: StorageBufferAttribute;
+    /** Per row and level, how many instances it holds for the camera: counted by updateInstance, cleared by the indirect pass. */
+    counts: StorageBufferAttribute;
+    /** How many pages chunks hold, then each with its row (see pages/buffers.ts). */
+    occupied: StorageBufferAttribute;
+    /** Every row's draws, from its first (see `drawWords` in rows.ts). */
+    draws: StorageBufferAttribute;
+    /** The camera's indirect draws, five words each, in the order of `draws`. */
+    args: IndirectStorageBufferAttribute;
+}
+/** The sort passes over `buffers`, their nodes pointed at other buffers by `point`, for a pool of `pages` pages. */
+export declare function sortPasses(buffers: SortBuffers, pages: number): {
+    update: import("three/webgpu").ComputeNode;
+    indirect: import("three/webgpu").ComputeNode;
+    /** Point the passes at `buffers`, and dispatch the indirect pass over `rows` rows: before they run. */
+    point(next: SortBuffers, rows: number): void;
+    dispose(): void;
+};
+export type SortPasses = ReturnType<typeof sortPasses>;

package/dist/instanced/update.js

@@ -0,0 +1,207 @@
+import { Fn, If, Loop, Return, atomicAdd, atomicLoad, atomicStore, computeKernel, distance, dot, float, globalId, int, localId, mat4, storage, uint, uniform, vec4, workgroupId, } from "three/tsl";
+import { levelsToDrawNode } from "../levels/draw.js";
+import { column, maxScale, stretch } from "../tsl.js";
+import { toTsl } from "../typegpu.js";
+import { PAGE_BITS } from "./pages/buffers.js";
+import { cullScale, instanceOnScreen } from "./measure.js";
+import { PAGE } from "./pages/workgroup.js";
+import { COUNTS_PER_ROW, DRAW_BYTES, FLOATS_AT, FLOAT_ROW, INTS_AT, INT_ROW, UNLISTED } from "./rows.js";
+// Sorting every InstancedLod's instances into its levels' instance lists for one camera, on the GPU, in two passes a
+// LodGpu builds once (see sort.ts).
+//
+// One workgroup per page of the pool (see pages/index.ts), one lane per pool index of the pages in use: updateInstance
+// reads the row of the page's InstancedLod, which holds all it sorts by for the camera, and skips the page unless the
+// row is sorting. It skips an index at scale 0, thins the instance out by `cullDistance`, skips it outside the camera's
+// frustum, measures its height on screen from its matrix with instanceOnScreen, picks what it draws with levelsToDraw,
+// the function a Lod runs on the CPU, and appends itself to each level it draws: its pool index and signed fade go to
+// that level's next free slot. Each level of an InstancedLod that draws something has a list of its `listSize` slots,
+// from the start its row gives; the level's draws start there (their first instance). The indirect pass, one lane per row, hands each level's
+// count to the indirect draws of the row's meshes and clears its counts for the next camera. Both stay within WebGPU's
+// default limit of 8 storage buffers per stage.
+const cullScaleNode = toTsl("lodCullScale", ["origin", "distance", "near", "far", "survivors"], cullScale);
+const instanceOnScreenNode = toTsl("lodInstanceOnScreen", ["matrix", "source", "grow", "eye", "scale", "ortho"], instanceOnScreen);
+/** The sort passes over `buffers`, their nodes pointed at other buffers by `point`, for a pool of `pages` pages. */
+export function sortPasses(buffers, pages) {
+    if (pages > MAX_WORKGROUPS)
+        throw new RangeError(`LodGpu: a pool of ${pages} pages outgrows one dispatch of ${MAX_WORKGROUPS} workgroups: lower maxInstanceCount or maxChunkCount`);
+    const nodes = nodesOf(buffers);
+    const rowCount = uniform(0, "uint");
+    const update = computeKernel(Fn(() => {
+        If(workgroupId.x.greaterThanEqual(nodes.occupied.element(0)), () => void Return());
+        const entry = nodes.occupied.element(workgroupId.x.add(1)).toVar();
+        const row = entry.shiftRight(PAGE_BITS).toVar();
+        const page = entry.bitAnd(2 ** PAGE_BITS - 1);
+        updateInstance(nodes, row, page.mul(PAGE).add(localId.x).toVar());
+    })(), [PAGE]);
+    update.dispatchSize = [pages, 1, 1];
+    const indirect = computeKernel(Fn(() => {
+        const row = globalId.x.toVar();
+        If(row.greaterThanEqual(rowCount), () => void Return());
+        writeDraws(nodes, row);
+    })(), [LANES]);
+    return {
+        update,
+        indirect,
+        /** Point the passes at `buffers`, and dispatch the indirect pass over `rows` rows: before they run. */
+        point(next, rows) {
+            nodes.words.value = next.words;
+            nodes.floats.value = next.floats;
+            nodes.matrices.value = next.matrices;
+            nodes.scaled.value = next.scaled;
+            nodes.indices.value = next.indices;
+            nodes.fades.value = next.fades;
+            nodes.counts.value = next.counts;
+            nodes.occupied.value = next.occupied;
+            nodes.draws.value = next.draws;
+            nodes.args.value = next.args;
+            rowCount.value = rows;
+            indirect.dispatchSize = [Math.max(Math.ceil(rows / LANES), 1), 1, 1];
+        },
+        dispose() {
+            update.dispose();
+            indirect.dispose();
+        },
+    };
+}
+/** The storage nodes of `buffers`, as the passes read and write them. */
+function nodesOf(buffers) {
+    return {
+        words: storage(buffers.words, "uint", 0).setName("lodRowWords").toReadOnly(),
+        floats: storage(buffers.floats, "float", 0).setName("lodRowFloats").toReadOnly(),
+        matrices: storage(buffers.matrices, "mat4", 0).setName("lodPoolMatrices").toReadOnly(),
+        scaled: storage(buffers.scaled, "mat4", 0).setName("lodScaledMatrices"),
+        indices: storage(buffers.indices, "uint", 0).setName("lodSlotIndices"),
+        fades: storage(buffers.fades, "float", 0).setName("lodSlotFades"),
+        counts: storage(buffers.counts, "uint", 0).setName("lodCounts").toAtomic(),
+        occupied: storage(buffers.occupied, "uint", 0).setName("lodOccupied").toReadOnly(),
+        draws: storage(buffers.draws, "uvec4", 0).setName("lodDraws").toReadOnly(),
+        args: storage(buffers.args, "uint", 0).setName("lodDrawArgs"),
+    };
+}
+/** Lanes per workgroup of the indirect pass, one per row. */
+const LANES = 64;
+/** WebGPU's guaranteed maxComputeWorkgroupsPerDimension. */
+const MAX_WORKGROUPS = 65535;
+/** Row `row`'s values, by name, read from the camera's rows of u32s and of f32s. */
+function rowOf(nodes, row) {
+    const base = row.mul(INT_ROW * 4).toVar();
+    const floats = row.mul(FLOAT_ROW * 4).toVar();
+    const u = (k, c) => nodes.words.element(base.add(k * 4 + c)).toVar();
+    const f = (k, c) => nodes.floats.element(floats.add(k * 4 + c));
+    const f4 = (k) => vec4(f(k, 0), f(k, 1), f(k, 2), f(k, 3)).toVar();
+    const eye = f4(FLOATS_AT.eye);
+    const values = f4(FLOATS_AT.values);
+    return {
+        count: int(u(INTS_AT.levels, 0)),
+        coarsest: int(u(INTS_AT.levels, 1)),
+        forced: int(u(INTS_AT.levels, 2)).sub(1), // see forcedWord
+        sorting: u(INTS_AT.levels, 3),
+        empty: u(INTS_AT.masks, 0),
+        fades: u(INTS_AT.masks, 1),
+        loaded: u(INTS_AT.masks, 2),
+        before: u(INTS_AT.masks, 3),
+        ortho: u(INTS_AT.flags, 0),
+        culled: u(INTS_AT.flags, 1),
+        survivors: u(INTS_AT.flags, 2),
+        drawCount: u(INTS_AT.flags, 3),
+        listSize: u(INTS_AT.layout, 0),
+        drawBase: u(INTS_AT.layout, 1),
+        /** The first slot of level `level`'s list, `UNLISTED` for none. */
+        start: (level) => nodes.words.element(base.add(INTS_AT.starts * 4).add(level)),
+        low: f4(FLOATS_AT.low),
+        high: f4(FLOATS_AT.high),
+        eye: eye.xyz,
+        scale: eye.w,
+        source: f4(FLOATS_AT.source),
+        progress: values.x,
+        reach: values.y,
+        near: values.z,
+        far: values.w,
+        cullEye: f4(FLOATS_AT.cullEye).xyz,
+        planes: Array.from({ length: 6 }, (_, i) => f4(FLOATS_AT.planes + i)),
+    };
+}
+/**
+ * The instance at `poolIndex`, of row `row`'s InstancedLod, sorted into the lists of the levels it draws for the camera
+ * whose rows `nodes` read, if the row is sorting. Stateless: everything it reads and writes is in `nodes`.
+ */
+function updateInstance(nodes, row, poolIndex) {
+    const r = rowOf(nodes, row);
+    If(r.sorting.equal(0), () => void Return());
+    const { count, coarsest, forced, empty, fades, loaded, before, eye, scale, progress, reach, near, far, ortho, culled, survivors, low, high } = r;
+    const m = nodes.matrices.element(poolIndex).toVar();
+    const hide = () => void Return();
+    If(maxScale(m).equal(0), hide);
+    const grow = float(1).toVar();
+    If(culled.equal(uint(1)), () => {
+        const origin = column(m, 3).xyz.toVar();
+        grow.assign(cullScaleNode({ origin, distance: distance(origin, r.cullEye), near, far, survivors }));
+        If(grow.equal(0), hide);
+        If(survivors.equal(uint(1)), () => {
+            const scaled = mat4(column(m, 0).mul(grow), column(m, 1).mul(grow), column(m, 2).mul(grow), column(m, 3));
+            nodes.scaled.element(poolIndex).assign(scaled);
+        });
+    });
+    const onScreen = instanceOnScreenNode({ matrix: m, source: r.source, grow, eye, scale, ortho }).toVar();
+    const centre = onScreen.xyz;
+    // Outside the camera's frustum: wholly behind one of its planes, with every level and its sway.
+    const extent = reach
+        .mul(stretch(m))
+        .mul(grow)
+        .mul(1 + 1e-4)
+        .negate();
+    for (const plane of r.planes)
+        If(dot(plane.xyz, centre).add(plane.w).lessThan(extent), hide);
+    const height = onScreen.w;
+    const drawn = levelsToDrawNode({ height, count, low, high, empty, coarsest, forced, fades, loaded, before, progress }).toVar();
+    const level = int(drawn.x).toVar();
+    const finer = int(drawn.y).toVar();
+    const fade = drawn.z.toVar();
+    const { listSize } = r;
+    /** Append the instance to level `index`'s list with `signed`, if the level has one and its list has room. */
+    const append = (index, signed) => {
+        const at = uint(index).toVar();
+        const start = r.start(at).toVar();
+        If(start.notEqual(UNLISTED), () => {
+            const k = atomicAdd(nodes.counts.element(row.mul(COUNTS_PER_ROW).add(at)), uint(1)).toVar();
+            If(k.lessThan(listSize), () => {
+                const slot = start.add(k).toVar();
+                nodes.indices.element(slot).assign(poolIndex);
+                nodes.fades.element(slot).assign(signed);
+            });
+        });
+    };
+    If(level.greaterThanEqual(0), () => append(level, fade));
+    // The finer neighbour fading out with it.
+    If(finer.greaterThanEqual(0).and(fade.greaterThan(0)), () => append(finer, fade.negate()));
+}
+/**
+ * Hands each level's count of row `row`, if sorting, to the indirect draws of its meshes (at most its list's slots),
+ * and clears its counts for the next camera.
+ */
+function writeDraws(nodes, row) {
+    const r = rowOf(nodes, row);
+    If(r.sorting.equal(0), () => void Return());
+    const { listSize, drawBase } = r;
+    Loop({ start: uint(0), end: r.drawCount, type: "uint", condition: "<" }, ({ i }) => {
+        const draw = nodes.draws.element(drawBase.add(i)).toVar();
+        const first = r.start(draw.x).toVar();
+        const base = drawBase
+            .add(i)
+            .mul(DRAW_BYTES / 4)
+            .toVar();
+        const words = nodes.args;
+        // Indexed: count, instances, first index, base vertex, first instance; else count, instances, first vertex, first
+        // instance and an unused word.
+        words.element(base).assign(draw.y);
+        const held = atomicLoad(nodes.counts.element(row.mul(COUNTS_PER_ROW).add(draw.x))).toVar();
+        words.element(base.add(1)).assign(held.lessThan(listSize).select(held, listSize));
+        words.element(base.add(2)).assign(draw.z);
+        words.element(base.add(3)).assign(draw.w.equal(1).select(uint(0), first));
+        words.element(base.add(4)).assign(draw.w.equal(1).select(first, uint(0)));
+    });
+    Loop({ start: uint(0), end: uint(COUNTS_PER_ROW), type: "uint", condition: "<" }, ({ i }) => {
+        atomicStore(nodes.counts.element(row.mul(COUNTS_PER_ROW).add(i)), uint(0));
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/instanced/update.js.map

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

package/dist/levels/bounds.d.ts

@@ -0,0 +1,21 @@
+import { Box3, Sphere, type Object3D } from "three/webgpu";
+/**
+ * The sphere fades measure for a Lod's levels: level 0's, or the first level's that draws
+ * anything when level 0 draws nothing; `own` in that level's own space, `placed` in its
+ * parent's (the Lod's). It is the centre and half diagonal of the level's `boundingBox`,
+ * which an impostor baked from it shares. `who` names the caller in the error.
+ */
+export declare function measureLevels(levels: readonly {
+    object?: Object3D;
+    box?: Box3;
+}[], who: string): {
+    own: Sphere;
+    placed: Sphere;
+};
+/** A level's bounds in the space of the Lod that holds it, including an eager object's transform. */
+export declare function levelBox(level: {
+    object?: Object3D;
+    box?: Box3;
+}): Box3;
+/** Fill absent mesh bounds conservatively from a deferred level's declared box, without reading vertices. */
+export declare function prepareBounds(root: Object3D, box: Box3): void;

package/dist/levels/bounds.js

@@ -0,0 +1,42 @@
+import { Box3, Sphere, Vector3 } from "three/webgpu";
+import { boundingBox, local } from "../source/detail.js";
+import { isMesh } from "../three.js";
+// Where a Lod's levels are: the bounds each declares or draws, measured from their full detail.
+const sphereOf = (box) => (box.isEmpty() ? null : new Sphere(box.getCenter(new Vector3()), box.getSize(new Vector3()).length() / 2));
+/**
+ * The sphere fades measure for a Lod's levels: level 0's, or the first level's that draws
+ * anything when level 0 draws nothing; `own` in that level's own space, `placed` in its
+ * parent's (the Lod's). It is the centre and half diagonal of the level's `boundingBox`,
+ * which an impostor baked from it shares. `who` names the caller in the error.
+ */
+export function measureLevels(levels, who) {
+    for (const { object, box } of levels) {
+        const own = sphereOf(object ? boundingBox(object) : (box ?? new Box3()));
+        if (!own)
+            continue;
+        return { own, placed: object ? own.clone().applyMatrix4(local(object)) : own.clone() };
+    }
+    throw new Error(`${who}: no level has visible geometry to measure`);
+}
+/** A level's bounds in the space of the Lod that holds it, including an eager object's transform. */
+export function levelBox(level) {
+    if (level.box)
+        return level.box.clone();
+    return level.object ? boundingBox(level.object).applyMatrix4(local(level.object)) : new Box3();
+}
+/** Fill absent mesh bounds conservatively from a deferred level's declared box, without reading vertices. */
+export function prepareBounds(root, box) {
+    const visit = (node, placement) => {
+        if (isMesh(node)) {
+            if (placement.determinant() === 0)
+                throw new Error("Lod: mesh placement must be invertible");
+            const geometry = node.geometry;
+            geometry.boundingBox ??= box.clone().applyMatrix4(placement.clone().invert());
+            geometry.boundingSphere ??= geometry.boundingBox.getBoundingSphere(new Sphere());
+        }
+        for (const child of node.children)
+            visit(child, local(child).premultiply(placement));
+    };
+    visit(root, local(root));
+}
+//# sourceMappingURL=bounds.js.map

package/dist/levels/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../../src/levels/bounds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,gGAAgG;AAEhG,MAAM,QAAQ,GAAG,CAAC,GAAS,EAAiB,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1J;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoD,EAAE,GAAW;IAC7F,KAAK,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;IACzF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,4CAA4C,CAAC,CAAC;AACtE,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,QAAQ,CAAC,KAAwC;IAC/D,IAAI,KAAK,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACjG,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,GAAS;IACrD,MAAM,KAAK,GAAG,CAAC,IAAc,EAAE,SAAkB,EAAQ,EAAE;QACzD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,QAAQ,CAAC,WAAW,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,QAAQ,CAAC,cAAc,KAAK,QAAQ,CAAC,WAAW,CAAC,iBAAiB,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/levels/cameras.d.ts

@@ -0,0 +1,48 @@
+import { type Camera, type Renderer, type Scene } from "three/webgpu";
+import { type RenderContext, type ShadowMap } from "./compile/contexts.js";
+/**
+ * The height `renderer` draws at now, which levels are chosen at: CSS pixels on the canvas, so that a high-density
+ * screen picks the levels a standard one does and pays for its extra pixels only in fill; pixels in a render target,
+ * except one the canvas's size, which stands in for it (a post-processing target); in a shadow pass, the map's texels.
+ */
+export declare function drawingHeight(renderer: Renderer, shadow: boolean): number | null;
+/**
+ * What a Lod's renders told of each camera that drew it: the height it draws at, where it rendered, and the shadow
+ * maps it drew. A context or shadow map whose target is disposed is passed over, so that no compile revives the target.
+ */
+export declare class CameraRenders {
+    /** Per camera: a side table, as three's Camera has no place for a package's state; a camera let go is let go here. */
+    private readonly cameras;
+    /** The targets disposed since they were last drawn into. */
+    private readonly disposed;
+    /** One listener on each target drawn into, until it is disposed or `dispose` is called. */
+    private readonly listeners;
+    /**
+     * The height `camera` draws at, measured from `renderer` while it renders (see `drawingHeight`), else the last it
+     * drew at; before it drew, the canvas's.
+     */
+    heightOf(camera: Camera, renderer: Renderer, shadow: boolean): number;
+    /** Where `camera` last rendered a scene holding the Lod, into a target not disposed. */
+    contextOf(camera: Camera): RenderContext | undefined;
+    /**
+     * Whether `context` is still one its camera renders in: not one whose target was disposed, nor one evicted by the
+     * cap on contexts per camera.
+     */
+    holds(context: RenderContext): boolean;
+    /** The shadow maps `cameras` drew, into targets not disposed. */
+    shadowsOf(cameras: Iterable<Camera>): ShadowMap[];
+    /** Whether `camera`, a light's shadow camera, drew a shadow map whose target is not disposed. */
+    drawsShadowMap(camera: Camera): boolean;
+    /**
+     * Whether `target` was disposed since it was last drawn into: what draws into it compiles nothing. The output never
+     * is.
+     */
+    isDisposed(target: RenderContext["target"]): boolean;
+    /** Note what `renderer` rendering `scene` with `camera` tells: the camera's render context, or a shadow map. */
+    note(renderer: Renderer, scene: Scene, camera: Camera): void;
+    /** Stop listening to the targets drawn into. */
+    dispose(): void;
+    /** `target` is drawn into now: live again if it was disposed, and listened to for its disposal. */
+    private drawnInto;
+    private stateOf;
+}