@drawcall/lod 0.2.0 → 0.4.0

package/dist/loader/index.js

@@ -0,0 +1,272 @@
+import { Box3, Group, Loader, LoadingManager, Vector3 } from "three/webgpu";
+import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import { at } from "../at.js";
+import { createBakeRenderer } from "../bake.js";
+import { disposeRecursive } from "../dispose.js";
+import { framePixels } from "../impostor/impostor.js";
+import { resolveThresholds } from "../levels/index.js";
+import { meshoptDecoder } from "../meshopt.js";
+import { isMesh, isObject3D, rejectSkinned } from "../three.js";
+import { LodLoadContext } from "./context.js";
+import { entryOf } from "./entry.js";
+import { decodeLevel, encodeLevel, encodeShape, placedBox, readLevel, readShape, shapeOf } from "./level.js";
+import { derived, normalize } from "./request.js";
+import { assetPath, publicPath, sourceRelativeURL } from "./url.js";
+/**
+ * Loads levels of detail from asset URLs, storing each derived level, and the source's shape, in vitecache, keyed by
+ * the request alone. Load it as a vitecache cached loader, with literal requests, so that the vitecache plugin finds
+ * every load and builds its levels in Node, saving them with the files they were built from; browsers read them, and
+ * one that misses builds the level itself.
+ *
+ * Loads asset URLs through manager handlers, else with a GLTFLoader of its own, which decodes meshopt only: register
+ * a GLTFLoader configured with Draco or KTX2 decoders for models compressed with them, and a GLTSLoader for .glts
+ * sources. Impostor and interior bakes draw with a renderer of the loader's own, made at its first bake and freed with
+ * what the last of the ladders it describes loaded (see `loadAsync`), or by `dispose`.
+ */
+export class CachedLodLoader extends Loader {
+    options;
+    gltf;
+    /**
+     * The renderer this loader bakes with, made at its first bake. Its own, not the app's: a canvas the size of a bake
+     * frame would draw that frame over the whole target (see `bakeImpostor`).
+     */
+    renderer;
+    /** How many ladders it described whose loads are not yet freed. */
+    ladders = 0;
+    /** Whether `loadAsync` builds every level with the ladder rather than when a camera first needs it. */
+    buildsAll = false;
+    constructor(manager, options = {}) {
+        super(manager);
+        this.options = options;
+    }
+    load(request, onLoad, _onProgress, onError) {
+        this.loadAsync(request).then(onLoad, onError ?? ((error) => console.error(error)));
+    }
+    /**
+     * Describes the ladder from its source, which the first level loaded then takes. Empty levels load with it, as does
+     * the source when it is the only drawable; other levels load when a camera needs them, including a coarse stand-in
+     * while its first detail arrives, and each derived level is built when first loaded. A level whose default threshold
+     * is measured from it is built with the ladder, and in Node every level is.
+     *
+     * What the levels load is freed when the last Lod holding them is disposed (see `LodLevel.hold`), which spends them:
+     * a Lod made from them later throws, so call loadAsync again. Levels no Lod ever holds are never freed: they are
+     * yours until a Lod holds them. Once every ladder it described is freed, so is its bake renderer.
+     */
+    async loadAsync(request) {
+        const ladder = normalize(request, this.path, (url) => this.publicPath(this.manager.resolveURL(url)));
+        const { url, levels: requests } = ladder;
+        this.ladders++;
+        const context = new LodLoadContext(() => this.loadAsset(url), this.options.onLevel, () => {
+            if (--this.ladders === 0)
+                void this.freeRenderer();
+        });
+        this.manager.itemStart(url);
+        try {
+            // Built with the ladder: every level in Node; elsewhere a simplified or baked level without maxPixels, whose
+            // default threshold is measured from its deviation.
+            const eager = requests.flatMap((level, index) => level.type !== "empty" && (this.buildsAll || (level.type !== "impostor" && level.maxPixels === undefined)) ? [index + 1] : []);
+            // Only what measures a default threshold: bytes no camera asked for are not held.
+            const measured = new Map();
+            for (const index of eager) {
+                let built = false;
+                const level = await this.cached(ladder, index, async () => {
+                    built = true;
+                    return this.build(ladder, index, await context.source());
+                });
+                // A level built here is handed to its first load; a stored one is read again then.
+                if (built)
+                    context.setBuilt(index, level);
+                measured.set(index, readLevel(level).level);
+            }
+            const shape = readShape(await this.cached(ladder, "shape", async () => encodeShape(shapeOf(await context.source()))));
+            const box = placedBox(shape);
+            if (box.isEmpty())
+                throw new Error("CachedLodLoader: the source has no visible geometry to measure");
+            // Building every level, the loader frees what it loaded with as loadAsync resolves (see the Node loader): no
+            // level keeps the spare source, and the source loads again only when a level asks for it.
+            if (this.buildsAll) {
+                const spare = context.take();
+                if (spare)
+                    disposeRecursive(spare);
+            }
+            const thresholds = resolveThresholds([
+                {},
+                ...requests.map((level, position) => ({
+                    // An impostor's default is its frame's, whether or not it is built with the ladder.
+                    maxPixels: level.maxPixels ?? (level.type === "impostor" ? framePixels(level.resolution) : undefined),
+                    measured: level.type === "impostor" ? undefined : measured.get(position + 1),
+                })),
+            ], shape.box.getSize(new Vector3()).length(), "CachedLodLoader");
+            const { hold } = context;
+            // Every load runs once however often it is asked for: every Lod made from the levels and the levels reading the
+            // source's materials share one object. The source's starts synchronously, so it takes the spare before a coarser
+            // level demanded in the same tick.
+            const loadSource = once(async () => context.arrive(context.take() ?? (await this.loadAsset(url)), 0, { materials: true }));
+            const materials = async () => {
+                const { object } = at(levels, 0);
+                return materialsOf(object ?? (await loadSource()));
+            };
+            const deferred = [
+                { load: loadSource, maxPixels: Infinity, box, hold },
+                ...requests.map((level, position) => {
+                    const index = position + 1;
+                    const maxPixels = at(thresholds, index);
+                    if (level.type === "empty")
+                        return { load: once(async () => context.arrive(new Group(), index, { materials: true })), maxPixels, box: new Box3(), hold };
+                    const load = once(async () => {
+                        const bytes = context.takeBuilt(index) ?? (await this.levelBytes(ladder, index, context.take()));
+                        const object = await decodeLevel(level.type, readLevel(bytes), materials, level.type === "impostor" ? level.draw : undefined);
+                        // A simplified level draws with the source level's materials, which that level frees.
+                        return context.arrive(object, index, { materials: level.type !== "simplify" });
+                    });
+                    return { load, maxPixels, box: box.clone(), hold };
+                }),
+            ];
+            const levels = await preload(deferred, !this.buildsAll);
+            return levels;
+        }
+        catch (error) {
+            context.fail();
+            this.manager.itemError(url);
+            throw error;
+        }
+        finally {
+            this.manager.itemEnd(url);
+        }
+    }
+    /** The stored bytes of derived level `of`, or of the source's shape, else what `build` makes, saved. */
+    async cached(ladder, of, build) {
+        const entry = entryOf(ladder, of, this.options);
+        const stored = await entry.load();
+        if (stored)
+            return stored;
+        const bytes = await build();
+        await entry.save(bytes, { dependencies: this.inputs() });
+        return bytes;
+    }
+    /**
+     * The path below the app's base that `url`, as the manager resolved it, loads, such as `/tree/model.glts`: what its
+     * levels are stored under, alike wherever the app is served. The manager of a .glts script resolves URLs against the
+     * script.
+     */
+    publicPath(url) {
+        return publicPath(url, this.options.basePath ?? "/_vitecache/");
+    }
+    /** The files and packages what this loader built so far was built from: none in browsers, which do not save. */
+    inputs() {
+        return [];
+    }
+    /** A deferred level's bytes, built from `spare`, the ladder's source, or from a source of its own. Disposes `spare` either way. */
+    async levelBytes(ladder, index, spare) {
+        let used = false;
+        const bytes = await this.cached(ladder, index, async () => {
+            used = true;
+            const source = spare ?? (await this.loadAsset(ladder.url));
+            try {
+                return await this.build(ladder, index, source);
+            }
+            finally {
+                disposeRecursive(source);
+            }
+        });
+        if (spare && !used)
+            disposeRecursive(spare);
+        return bytes;
+    }
+    /** Build level `index` from `source`, encoded. */
+    async build(ladder, index, source) {
+        const request = derived(ladder.levels, index);
+        const load = (name) => {
+            const asset = request.type === "baked" ? request[name] : undefined;
+            return asset === undefined ? undefined : this.loadAsset(sourceRelativeURL(asset, ladder.url));
+        };
+        let low, interior, built;
+        try {
+            rejectSkinned(source, "CachedLodLoader");
+            low = await load("low");
+            interior = await load("interior");
+            // Only a miss builds: simplify, the bakes and their WASM stay out of pages whose levels are all stored.
+            const { buildLevel } = await import("./build.js");
+            built = await buildLevel(source, request, { low, interior }, () => this.bakeRenderer());
+            return await encodeLevel(built, request.type, shapeOf(source), materialsOf(source));
+        }
+        finally {
+            for (const object of [interior, low])
+                if (object)
+                    disposeRecursive(object);
+            // A simplified level draws with the source's materials, which are freed with the source.
+            if (built)
+                disposeRecursive(built, { materials: request.type !== "simplify" });
+        }
+    }
+    /** The renderer this loader bakes with, made at its first bake. */
+    bakeRenderer() {
+        this.renderer ??= this.newBakeRenderer();
+        return this.renderer;
+    }
+    newBakeRenderer() {
+        return createBakeRenderer();
+    }
+    /**
+     * Free the renderer this loader made for its bakes, resolving once freed; a bake under way fails. Levels it loaded
+     * stay as they are, and a later bake makes a new renderer. In Node each `loadAsync` frees what it made to load and
+     * bake with, the scenes of its GLTSLoader included, before it resolves, so there this frees nothing.
+     */
+    async dispose() {
+        await this.freeRenderer();
+    }
+    /** Free the bake renderer, once made. */
+    async freeRenderer() {
+        const renderer = this.renderer;
+        this.renderer = undefined;
+        // A renderer that failed to initialise failed the bake that made it.
+        const made = await renderer?.catch(() => undefined);
+        made?.dispose();
+    }
+    async loadAsset(url) {
+        const { path, extension } = assetPath(url);
+        const handler = this.manager.getHandler(path);
+        if (!handler && extension === "glts")
+            throw new Error(`CachedLodLoader: cannot load "${url}": register a GLTSLoader for .glts on the loading manager`);
+        let result;
+        if (handler)
+            result = await handler.loadAsync(url);
+        else {
+            this.gltf ??= new GLTFLoader(this.manager).setMeshoptDecoder(meshoptDecoder());
+            const decoder = this.gltf.setCrossOrigin(this.crossOrigin).setWithCredentials(this.withCredentials).setRequestHeader(this.requestHeader);
+            result = await decoder.loadAsync(url);
+        }
+        return objectOf(result, url);
+    }
+}
+/** `load`, run once however often it is called: every call shares its promise. */
+function once(load) {
+    let started;
+    return () => (started ??= load());
+}
+function materialsOf(object) {
+    const materials = [];
+    object.traverse((node) => {
+        if (isMesh(node))
+            for (const material of [node.material].flat())
+                materials.push(material);
+    });
+    return materials;
+}
+/**
+ * Loads what every camera draws before it picks a level: the empty levels, and, given `preloadSource`, the source if it
+ * is the only drawable.
+ */
+async function preload(levels, preloadSource) {
+    const drawable = levels.filter((level) => !level.box.isEmpty());
+    return Promise.all(levels.map(async (level) => level.box.isEmpty() || (preloadSource && drawable.length === 1) ? { object: await level.load(), maxPixels: level.maxPixels, hold: level.hold } : level));
+}
+function objectOf(result, url) {
+    if (isObject3D(result))
+        return result;
+    const scene = typeof result === "object" && result !== null ? Reflect.get(result, "scene") : undefined;
+    if (isObject3D(scene))
+        return scene;
+    throw new Error(`CachedLodLoader: the handler for "${url}" did not load an Object3D or a glTF`);
+}
+//# sourceMappingURL=index.js.map

package/dist/loader/index.js.map

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

package/dist/loader/level.d.ts

@@ -0,0 +1,41 @@
+import { Box3, Matrix4, type Material, type Object3D } from "three/webgpu";
+import { type ImpostorMeshOptions } from "../impostor/mesh/index.js";
+import type { LodLevelRequest } from "./request.js";
+/** A level the loader builds from the source and caches. */
+export type Derived = Exclude<LodLevelRequest, {
+    type: "empty";
+}>;
+type Kind = Derived["type"];
+/**
+ * The source's full-detail bounds in its own space and its placement. Every drawable level declares these bounds,
+ * so a ladder is described before its finer levels are built; each derived level must fit inside them.
+ */
+export interface Shape {
+    box: Box3;
+    matrix: Matrix4;
+}
+export declare function shapeOf(source: Object3D): Shape;
+/** `shape` on its own, as its cache entry holds it. */
+export declare const encodeShape: (shape: Shape) => Uint8Array;
+export declare const readShape: (bytes: Uint8Array) => Shape;
+/** The bounds every drawable level declares, in the space of the Lod that holds it. */
+export declare const placedBox: ({ box, matrix }: Shape) => Box3;
+interface Metadata {
+    name: string;
+    deviation?: number;
+    texels?: number;
+    matrix: Matrix4;
+    matrixAutoUpdate: boolean;
+    castShadow: boolean;
+    receiveShadow: boolean;
+}
+export interface Entry {
+    shape: Shape;
+    level: Metadata;
+    payload: Uint8Array;
+}
+export declare function encodeLevel(object: Object3D, kind: Kind, shape: Shape, materials: readonly Material[]): Promise<Uint8Array>;
+/** Decode a level placed as it was built; `materials` are the source's, which a simplified level draws with. */
+export declare function decodeLevel(kind: Kind, { level, payload }: Entry, materials: () => Promise<Material[]>, draw: ImpostorMeshOptions | undefined): Promise<Object3D>;
+export declare function readLevel(bytes: Uint8Array): Entry;
+export {};

package/dist/loader/level.js

@@ -0,0 +1,140 @@
+import { Box3, Matrix4 } from "three/webgpu";
+import { decodeBakedMeshAsync, encodeBakedMeshAsync } from "../baked/codec.js";
+import { boundingBox } from "../source/detail.js";
+import { decodeImpostorAsync, encodeImpostorAsync } from "../impostor/codec.js";
+import { ImpostorMesh } from "../impostor/mesh/index.js";
+import { measure, recordDeviation } from "../levels/index.js";
+import { isImpostorMesh, isMesh } from "../three.js";
+import { decodeMeshAsync, encodeMeshAsync } from "../codec/mesh.js";
+export function shapeOf(source) {
+    if (source.matrixAutoUpdate)
+        source.updateMatrix();
+    return { box: boundingBox(source), matrix: source.matrix.clone() };
+}
+/** `shape` on its own, as its cache entry holds it. */
+export const encodeShape = (shape) => new TextEncoder().encode(JSON.stringify(shapeFields(shape)));
+export const readShape = (bytes) => parseShape(object(JSON.parse(new TextDecoder().decode(bytes))));
+const shapeFields = ({ box, matrix }) => ({ box: [...box.min.toArray(), ...box.max.toArray()], placement: matrix.toArray() });
+function parseShape(meta) {
+    const box = new Box3().setFromArray(numbers(meta.box, 6));
+    if (box.isEmpty())
+        fail("empty source box");
+    return { box, matrix: new Matrix4().fromArray(numbers(meta.placement, 16)) };
+}
+/** The bounds every drawable level declares, in the space of the Lod that holds it. */
+export const placedBox = ({ box, matrix }) => box.clone().applyMatrix4(matrix);
+const MAGIC = 0x33444f4c;
+export async function encodeLevel(object, kind, shape, materials) {
+    if (object.matrixAutoUpdate)
+        object.updateMatrix();
+    const box = boundingBox(object).applyMatrix4(object.matrix);
+    if (box.isEmpty())
+        throw new Error(`CachedLodLoader: the ${kind} level draws nothing`);
+    const bounds = placedBox(shape);
+    // Rounding in welds and bakes may move a vertex by a hair.
+    if (!bounds
+        .clone()
+        .expandByScalar(bounds.getSize(box.min.clone()).length() * 1e-4)
+        .containsBox(box))
+        throw new Error(`CachedLodLoader: the ${kind} level extends beyond the source's bounds; derived shapes, such as a low shell, must stay inside the source`);
+    const payload = await encodePayload(object, kind, materials);
+    const header = new TextEncoder().encode(JSON.stringify({
+        ...shapeFields(shape),
+        name: object.name,
+        ...measure(object),
+        matrix: object.matrix.toArray(),
+        matrixAutoUpdate: object.matrixAutoUpdate,
+        castShadow: object.castShadow,
+        receiveShadow: object.receiveShadow,
+    }));
+    const bytes = new Uint8Array(8 + header.length + payload.length);
+    const data = new DataView(bytes.buffer);
+    data.setUint32(0, MAGIC, true);
+    data.setUint32(4, header.length, true);
+    bytes.set(header, 8);
+    bytes.set(payload, 8 + header.length);
+    return bytes;
+}
+async function encodePayload(object, kind, materials) {
+    switch (kind) {
+        case "simplify":
+            return encodeMeshAsync(object, materials);
+        case "baked":
+            if (!isMesh(object))
+                throw new Error("CachedLodLoader: baked level is not a mesh");
+            return encodeBakedMeshAsync(object);
+        case "impostor":
+            if (!isImpostorMesh(object))
+                throw new Error("CachedLodLoader: impostor level is not an ImpostorMesh");
+            return encodeImpostorAsync(object.impostor);
+    }
+}
+/** Decode a level placed as it was built; `materials` are the source's, which a simplified level draws with. */
+export async function decodeLevel(kind, { level, payload }, materials, draw) {
+    const object = kind === "simplify"
+        ? await decodeMeshAsync(payload, await materials())
+        : kind === "baked"
+            ? await decodeBakedMeshAsync(payload)
+            : new ImpostorMesh(await decodeImpostorAsync(payload), 1, draw);
+    object.name = level.name;
+    level.matrix.decompose(object.position, object.quaternion, object.scale);
+    object.matrix.copy(level.matrix);
+    object.matrixAutoUpdate = level.matrixAutoUpdate;
+    object.castShadow = level.castShadow;
+    object.receiveShadow = level.receiveShadow;
+    if (level.deviation !== undefined)
+        recordDeviation(object, level.deviation);
+    return object;
+}
+export function readLevel(bytes) {
+    if (bytes.length < 8)
+        fail("missing header");
+    const data = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const length = data.getUint32(4, true);
+    if (data.getUint32(0, true) !== MAGIC || length > bytes.length - 8)
+        fail("invalid header");
+    const meta = object(JSON.parse(new TextDecoder().decode(bytes.subarray(8, 8 + length))));
+    if (typeof meta.name !== "string" ||
+        typeof meta.castShadow !== "boolean" ||
+        typeof meta.receiveShadow !== "boolean" ||
+        typeof meta.matrixAutoUpdate !== "boolean")
+        fail("invalid level settings");
+    const deviation = meta.deviation === undefined ? undefined : finite(meta.deviation);
+    if (deviation !== undefined && deviation < 0)
+        fail("negative deviation");
+    const texels = meta.texels === undefined ? undefined : finite(meta.texels);
+    if (texels !== undefined && texels <= 0)
+        fail("invalid texels");
+    return {
+        shape: parseShape(meta),
+        level: {
+            name: meta.name,
+            deviation,
+            texels,
+            matrix: new Matrix4().fromArray(numbers(meta.matrix, 16)),
+            matrixAutoUpdate: meta.matrixAutoUpdate,
+            castShadow: meta.castShadow,
+            receiveShadow: meta.receiveShadow,
+        },
+        payload: bytes.subarray(8 + length),
+    };
+}
+function object(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        fail("expected metadata object");
+    return Object.fromEntries(Object.entries(value));
+}
+function finite(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        fail("expected finite number");
+    return value;
+}
+function numbers(value, count) {
+    if (!Array.isArray(value) || value.length !== count)
+        fail(`expected ${count} numbers`);
+    return value.map(finite);
+}
+function fail(reason) {
+    throw new Error(`CachedLodLoader: invalid cache (${reason})`);
+}
+//# sourceMappingURL=level.js.map

package/dist/loader/level.js.map

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

package/dist/loader/node.d.ts

@@ -0,0 +1,26 @@
+import { LoadingManager } from "three/webgpu";
+import type { LodLevel } from "../levels/index.js";
+import { CachedLodLoader as BrowserCachedLodLoader, type CachedLodLoaderOptions } from "./index.js";
+import type { LodRequest } from "./request.js";
+/**
+ * CachedLodLoader in Node, as the vitecache plugin and the glts CLI run it: `loadAsync` builds and saves every level of
+ * the ladder, each with the public files the ladder's loads read and the installed versions of three and of the
+ * packages its .glts sources import. A load that reads anything else, such as a URL off the public directory or a module
+ * a .glts source imports from a CDN, fails, since no stored level could be checked against it. Served paths such as
+ * `/trees/oak.glts`, and `file:` URLs in the public directory, as a headless .glts script's manager resolves them to,
+ * load from vitecache's public directory (see `publicURL`), and `.glts` sources through a GLTSLoader of the load's own;
+ * bakes draw on a WebGPU device of @drawcall/webgpu. The manager only resolves the request's URL.
+ *
+ * Each `loadAsync` loads and bakes with what it makes for itself, which it frees before resolving, so loads may run
+ * concurrently. The levels it returns load their stored bytes as in browsers, and none holds the source: the source
+ * level, and a simplified level, which draws with the source's materials, load the source again when a camera needs
+ * them, as the glts CLI's renders of a .glts script that draws a Lod do.
+ */
+export declare class CachedLodLoader extends BrowserCachedLodLoader {
+    constructor(manager?: LoadingManager, options?: CachedLodLoaderOptions);
+    loadAsync(request: LodRequest): Promise<LodLevel[]>;
+    /** Nothing to free: each load frees what it made. */
+    dispose(): Promise<void>;
+    /** A `file:` URL in the public directory as its served path; others as in browsers. */
+    protected publicPath(url: string): string;
+}