@tinypoly/gpu-renderer 0.0.0-stage → 0.0.1

package/dist/device.js

@@ -0,0 +1,52 @@
+/** Acquiring a device, and the questions a host asks before choosing this renderer at all. */
+/**
+ * Whether this context exposes WebGPU at all. It is a cheap, synchronous check for a fallback decision;
+ * it does not prove that an adapter exists, which only `requestWebGpuSupport` can tell.
+ */
+export function isWebGpuAvailable() {
+    return typeof navigator !== "undefined" && "gpu" in navigator && navigator.gpu != null;
+}
+/**
+ * Asks the platform for an adapter, which is the only honest answer to "can this machine render?".
+ * A browser can expose `navigator.gpu` and still hand back no adapter (a blocklisted driver, a headless session
+ * without a software fallback), so hosts deciding between renderers should await this one.
+ */
+export async function requestWebGpuSupport() {
+    if (!isWebGpuAvailable())
+        return { supported: false, reason: "This browser does not expose WebGPU." };
+    try {
+        const adapter = await navigator.gpu.requestAdapter();
+        if (!adapter)
+            return { supported: false, reason: "WebGPU is exposed, but no adapter was available." };
+        return { supported: true, reason: "" };
+    }
+    catch (error) {
+        return { supported: false, reason: `Requesting a WebGPU adapter failed: ${error.message}` };
+    }
+}
+/**
+ * The device the renderer runs on, asking for everything the adapter offers. Scene geometry, the hierarchy and the
+ * accumulation buffer all live in storage buffers, so the default 128 MiB binding size is the first ceiling a real
+ * scene meets, and adapters routinely allow far more.
+ */
+export async function requestRenderDevice(options = {}) {
+    if (!isWebGpuAvailable())
+        throw new Error("GPU renderer: this browser does not expose WebGPU.");
+    const adapter = await navigator.gpu.requestAdapter({ powerPreference: "high-performance" });
+    if (!adapter)
+        throw new Error("GPU renderer: no WebGPU adapter was available.");
+    const device = await adapter.requestDevice({
+        requiredLimits: {
+            maxStorageBufferBindingSize: adapter.limits.maxStorageBufferBindingSize,
+            maxBufferSize: adapter.limits.maxBufferSize,
+        },
+    });
+    void device.lost.then(info => options.onLost?.(info.message || String(info.reason)));
+    return {
+        adapter,
+        device,
+        maxStorageBufferBindingSize: device.limits.maxStorageBufferBindingSize,
+        maxBufferSize: device.limits.maxBufferSize,
+    };
+}
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAuB9F;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,KAAK,IAAI,SAAS,IAAI,SAAS,CAAC,GAAG,IAAI,IAAI,CAAC;AACzF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC,iBAAiB,EAAE;QACtB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;IAE9E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAErD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,kDAAkD,EAAE,CAAC;QAEtG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;IAAC,OAAM,KAAK,EAAE,CAAC;QACd,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,uCAAwC,KAAe,CAAC,OAAO,EAAE,EAAE,CAAC;IACzG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAA+B,EAAE;IACzE,IAAI,CAAC,iBAAiB,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAExE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAE5F,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC;QACzC,cAAc,EAAE;YACd,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,2BAA2B;YACvE,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa;SAC5C;KACF,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAErF,OAAO;QACL,OAAO;QACP,MAAM;QACN,2BAA2B,EAAE,MAAM,CAAC,MAAM,CAAC,2BAA2B;QACtE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa;KAC3C,CAAC;AACJ,CAAC"}

package/dist/dispatchScheduler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * How many rows of pixels one submit covers. The system watchdog kills a command that runs too long (around two
+ * seconds on Windows), and a tab that submits the whole image at once stops answering, so the work is cut into bands
+ * and the band grows or shrinks towards a target time per submit.
+ *
+ * The first band of a new scene is deliberately small: nothing is known about the machine yet, and a slow integrated
+ * GPU should discover that on a band it survives.
+ */
+export interface DispatchSchedulerOptions {
+    /** Milliseconds one submit should take. */
+    targetMs?: number;
+    /** Rows the first submit covers, before anything has been measured. */
+    initialRows?: number;
+    /** Rows in the whole image. */
+    maxRows: number;
+}
+export declare class DispatchScheduler {
+    private readonly targetMs;
+    private readonly initialRows;
+    private readonly maxRows;
+    private rows;
+    /** Rows a millisecond, as far as anything has shown. Zero until the first submit says something. */
+    private throughput;
+    constructor(options: DispatchSchedulerOptions);
+    /** Rows the next submit should cover, never more than what is left. */
+    next(remaining: number): number;
+    /**
+     * Feeds back how long the last submit took, which moves the band towards the target time.
+     *
+     * What it estimates is a rate, not a direction. Every submit also costs a fixed round trip to the device, and on a
+     * small or simple image that round trip is most of what the clock sees. A rule that only asked whether the submit
+     * came back late would then read every band as too slow and shrink until each one covered a single row, which is the
+     * worst possible way to spend that round trip and is a hole it could never climb out of. A rate notices instead that
+     * a wider band cost no more, and widens.
+     *
+     * The rate is measured from the rows actually submitted rather than from the current guess, so one band clamped by
+     * what was left of the image does not stop the next one from growing.
+     */
+    record(durationMs: number, rows: number): void;
+    /** Back to the unmeasured band, for a new scene or a new size. */
+    reset(): void;
+}
+//# sourceMappingURL=dispatchScheduler.d.ts.map

package/dist/dispatchScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchScheduler.d.ts","sourceRoot":"","sources":["../src/dispatchScheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,oGAAoG;IACpG,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE,wBAAwB;IAO7C,uEAAuE;IACvE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI/B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAWvC,kEAAkE;IAClE,KAAK;CAIN"}

package/dist/dispatchScheduler.js

@@ -0,0 +1,49 @@
+/** The most one measurement may widen the band, so an unmeasured machine meets the watchdog gradually. */
+const GROW = 4;
+/** How quickly the estimate gives ground when submits come back slower than they used to. */
+const DECAY = 0.8;
+export class DispatchScheduler {
+    targetMs;
+    initialRows;
+    maxRows;
+    rows;
+    /** Rows a millisecond, as far as anything has shown. Zero until the first submit says something. */
+    throughput = 0;
+    constructor(options) {
+        this.targetMs = options.targetMs ?? 12;
+        this.maxRows = Math.max(1, Math.floor(options.maxRows));
+        this.initialRows = Math.max(1, Math.min(this.maxRows, Math.floor(options.initialRows ?? 16)));
+        this.rows = this.initialRows;
+    }
+    /** Rows the next submit should cover, never more than what is left. */
+    next(remaining) {
+        return Math.max(1, Math.min(Math.floor(this.rows), Math.floor(remaining)));
+    }
+    /**
+     * Feeds back how long the last submit took, which moves the band towards the target time.
+     *
+     * What it estimates is a rate, not a direction. Every submit also costs a fixed round trip to the device, and on a
+     * small or simple image that round trip is most of what the clock sees. A rule that only asked whether the submit
+     * came back late would then read every band as too slow and shrink until each one covered a single row, which is the
+     * worst possible way to spend that round trip and is a hole it could never climb out of. A rate notices instead that
+     * a wider band cost no more, and widens.
+     *
+     * The rate is measured from the rows actually submitted rather than from the current guess, so one band clamped by
+     * what was left of the image does not stop the next one from growing.
+     */
+    record(durationMs, rows) {
+        if (!Number.isFinite(durationMs) || durationMs <= 0 || rows <= 0)
+            return;
+        const observed = rows / durationMs;
+        // Good news is believed at once, since it can only mean the band was cheaper than the clock suggested. Bad news
+        // is taken gradually, so one submit that happened to land behind something else does not collapse the band.
+        this.throughput = observed > this.throughput ? observed : this.throughput * DECAY + observed * (1 - DECAY);
+        this.rows = Math.max(1, Math.min(this.maxRows, rows * GROW, this.targetMs * this.throughput));
+    }
+    /** Back to the unmeasured band, for a new scene or a new size. */
+    reset() {
+        this.rows = this.initialRows;
+        this.throughput = 0;
+    }
+}
+//# sourceMappingURL=dispatchScheduler.js.map

package/dist/dispatchScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchScheduler.js","sourceRoot":"","sources":["../src/dispatchScheduler.ts"],"names":[],"mappings":"AAiBA,0GAA0G;AAC1G,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,6FAA6F;AAC7F,MAAM,KAAK,GAAG,GAAG,CAAC;AAElB,MAAM,OAAO,iBAAiB;IACX,QAAQ,CAAS;IACjB,WAAW,CAAS;IACpB,OAAO,CAAS;IACzB,IAAI,CAAS;IACrB,oGAAoG;IAC5F,UAAU,GAAG,CAAC,CAAC;IAEvB,YAAY,OAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9F,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,CAAC;IAED,uEAAuE;IACvE,IAAI,CAAC,SAAiB;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAkB,EAAE,IAAY;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;YAAE,OAAO;QAEzE,MAAM,QAAQ,GAAG,IAAI,GAAG,UAAU,CAAC;QAEnC,gHAAgH;QAChH,4GAA4G;QAC5G,IAAI,CAAC,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC3G,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAChG,CAAC;IAED,kEAAkE;IAClE,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/environment.d.ts

@@ -0,0 +1,39 @@
+import type { RenderEnvironment, SerializedTexture } from "./upstream.js";
+/**
+ * The light that surrounds the scene. A gradient is three numbers the shader evaluates directly; an equirectangular
+ * image is a texture plus the tables that let a shadow ray aim at its bright parts.
+ *
+ * Without those tables a sun in an image is exactly the problem direct light sampling exists to solve: a tiny, very
+ * bright region that a cosine weighted bounce almost never finds. The construction is the one in `environment.js` of
+ * the CPU renderer: a cumulative distribution over rows weighted by luminance and the sine of the colatitude, then one
+ * over the columns of each row.
+ */
+export interface PackedEnvironment {
+    /** The image itself, ready to join the scene's own textures. */
+    texture: SerializedTexture;
+    /** Rows, then each row's columns, then the luminance of every texel: `2 * width * height + height` floats. */
+    distribution: Float32Array;
+    width: number;
+    height: number;
+    /** The sum of luminance times the sine of the colatitude, which turns a texel's share into a density. */
+    total: number;
+}
+/**
+ * Cumulative distributions over the reduced image. A row is weighted by the sine of its colatitude, because a row near
+ * a pole covers far less of the sphere than one at the equator.
+ */
+export declare function environmentDistribution(grid: Float32Array, width: number, height: number): {
+    distribution: Float32Array<ArrayBuffer>;
+    total: number;
+} | null;
+/**
+ * Loads an equirectangular image and builds everything the shader needs from it. Returns null for an environment that
+ * is not an image, or one whose file could not be read, which leaves the renderer on its gradient.
+ */
+export declare function loadEnvironment(environment: RenderEnvironment): Promise<PackedEnvironment | null>;
+/**
+ * An equirectangular image already in memory, linear RGBA floats with the zenith in the first row, made into an
+ * environment: a procedural sky baked by the CPU renderer's interpreter arrives this way.
+ */
+export declare function environmentFromImage(data: Float32Array, sourceWidth: number, sourceHeight: number, id?: string): PackedEnvironment | null;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,8GAA8G;IAC9G,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAC;CACf;AAsFD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;SAuCxF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAqBvG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,SAAgB,GAAG,iBAAiB,GAAG,IAAI,CAgD7G"}

package/dist/environment.js

@@ -0,0 +1,168 @@
+import { HDRLoader } from "three/examples/jsm/loaders/HDRLoader.js";
+/** The grid the distribution is built on, as in the CPU renderer. Finer than this buys nothing but memory. */
+const GRID_WIDTH = 256;
+const GRID_HEIGHT = 128;
+/** How large an image is kept for the sharp lookup. A full resolution sky costs more memory than it adds detail here. */
+const MAX_WIDTH = 1024;
+const luminance = (r, g, b) => 0.2126 * r + 0.7152 * g + 0.0722 * b;
+/** An area averaged reduction to `width` by `height`, which is what the distribution is built from. */
+function reduce(source, sourceWidth, sourceHeight, width, height) {
+    const target = new Float32Array(width * height * 3);
+    const scaleX = sourceWidth / width, scaleY = sourceHeight / height;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const x0 = Math.floor(x * scaleX), x1 = Math.max(x0 + 1, Math.ceil((x + 1) * scaleX));
+            const y0 = Math.floor(y * scaleY), y1 = Math.max(y0 + 1, Math.ceil((y + 1) * scaleY));
+            let r = 0, g = 0, b = 0, n = 0;
+            for (let sy = y0; sy < Math.min(sourceHeight, y1); sy++) {
+                for (let sx = x0; sx < Math.min(sourceWidth, x1); sx++) {
+                    const at = (sy * sourceWidth + sx) * 4;
+                    r += source[at];
+                    g += source[at + 1];
+                    b += source[at + 2];
+                    n++;
+                }
+            }
+            const at = (y * width + x) * 3;
+            const weight = n || 1;
+            target[at] = r / weight;
+            target[at + 1] = g / weight;
+            target[at + 2] = b / weight;
+        }
+    }
+    return target;
+}
+/** Never picked less often than this share of the average, so no direction is left without a density. */
+const FLOOR = 0.02;
+/**
+ * The luminance a direction is picked by. It is the neighbourhood's brightest rather than the texel's own, because the
+ * image is read back with a bilinear filter: that filter spreads a sun into the texels around it, and a direction the
+ * distribution gave no chance of being picked would arrive through the bounce alone, as a firefly. Taking the maximum
+ * over the neighbours keeps the density above what the filter can produce there.
+ */
+function weights(grid, width, height) {
+    const raw = new Float32Array(width * height);
+    const spread = new Float32Array(width * height);
+    let sum = 0;
+    for (let index = 0; index < width * height; index++) {
+        raw[index] = luminance(grid[index * 3], grid[index * 3 + 1], grid[index * 3 + 2]);
+        sum += raw[index];
+    }
+    const floor = sum / (width * height) * FLOOR;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            let peak = 0;
+            for (let dy = -1; dy <= 1; dy++) {
+                const row = Math.min(Math.max(y + dy, 0), height - 1);
+                for (let dx = -1; dx <= 1; dx++) {
+                    // Longitude wraps around, so the texel left of the first column is the last one.
+                    peak = Math.max(peak, raw[row * width + (x + dx + width) % width]);
+                }
+            }
+            spread[y * width + x] = peak + floor;
+        }
+    }
+    return spread;
+}
+/**
+ * Cumulative distributions over the reduced image. A row is weighted by the sine of its colatitude, because a row near
+ * a pole covers far less of the sphere than one at the equator.
+ */
+export function environmentDistribution(grid, width, height) {
+    const rows = new Float32Array(height);
+    const columns = new Float32Array(width * height);
+    const values = weights(grid, width, height);
+    let total = 0;
+    for (let y = 0; y < height; y++) {
+        const sine = Math.sin((y + 0.5) / height * Math.PI);
+        let row = 0;
+        for (let x = 0; x < width; x++) {
+            const index = y * width + x;
+            row += values[index] * sine;
+            columns[index] = row;
+        }
+        for (let x = 0; x < width; x++) {
+            const index = y * width + x;
+            // A row with nothing in it is still chosen uniformly, so a search over it always terminates somewhere.
+            columns[index] = row > 0 ? columns[index] / row : (x + 1) / width;
+        }
+        total += row;
+        rows[y] = total;
+    }
+    if (!(total > 0))
+        return null;
+    for (let y = 0; y < height; y++)
+        rows[y] /= total;
+    const distribution = new Float32Array(height + width * height * 2);
+    distribution.set(rows, 0);
+    distribution.set(columns, height);
+    distribution.set(values, height + width * height);
+    return { distribution, total };
+}
+/**
+ * Loads an equirectangular image and builds everything the shader needs from it. Returns null for an environment that
+ * is not an image, or one whose file could not be read, which leaves the renderer on its gradient.
+ */
+export async function loadEnvironment(environment) {
+    if (environment.kind !== "hdri" || !environment.url)
+        return null;
+    const loaded = await new Promise(resolve => {
+        new HDRLoader()
+            .setDataType(1015)
+            .load(environment.url, texture => {
+            const image = texture.image;
+            resolve(image?.data instanceof Float32Array ? image : null);
+            texture.dispose();
+        }, undefined, () => resolve(null));
+    });
+    if (!loaded || loaded.width < 1 || loaded.height < 1)
+        return null;
+    return environmentFromImage(loaded.data, loaded.width, loaded.height);
+}
+/**
+ * An equirectangular image already in memory, linear RGBA floats with the zenith in the first row, made into an
+ * environment: a procedural sky baked by the CPU renderer's interpreter arrives this way.
+ */
+export function environmentFromImage(data, sourceWidth, sourceHeight, id = "environment") {
+    const loaded = { data, width: sourceWidth, height: sourceHeight };
+    if (loaded.width < 1 || loaded.height < 1 || data.length < loaded.width * loaded.height * 4)
+        return null;
+    // The sharp lookup keeps at most MAX_WIDTH across; the distribution is built on a much coarser grid either way.
+    const width = Math.min(loaded.width, MAX_WIDTH);
+    const height = Math.max(1, Math.round(loaded.height * (width / loaded.width)));
+    const scaled = width === loaded.width
+        ? loaded.data
+        : (() => {
+            const reduced = reduce(loaded.data, loaded.width, loaded.height, width, height);
+            const rgba = new Float32Array(width * height * 4);
+            for (let texel = 0; texel < width * height; texel++) {
+                rgba[texel * 4] = reduced[texel * 3];
+                rgba[texel * 4 + 1] = reduced[texel * 3 + 1];
+                rgba[texel * 4 + 2] = reduced[texel * 3 + 2];
+                rgba[texel * 4 + 3] = 1;
+            }
+            return rgba;
+        })();
+    const gridWidth = Math.min(GRID_WIDTH, width);
+    const gridHeight = Math.min(GRID_HEIGHT, height);
+    const built = environmentDistribution(reduce(scaled, width, height, gridWidth, gridHeight), gridWidth, gridHeight);
+    if (!built)
+        return null;
+    const texture = {
+        id,
+        width,
+        height,
+        data: scaled,
+        // An HDR file is linear already, and the loader hands back floats.
+        colorSpace: "srgb-linear",
+        // Longitude wraps around; latitude stops at the poles.
+        wrapS: 1000,
+        wrapT: 1001,
+        matrix: [1, 0, 0, 0, 1, 0, 0, 0, 1],
+        flipY: false,
+        channel: 0,
+        nearest: false,
+    };
+    return { texture, distribution: built.distribution, width: gridWidth, height: gridHeight, total: built.total };
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

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

package/dist/frameLayout.d.ts

@@ -0,0 +1,4 @@
+/** The kernel's per dispatch uniform, as both sides of the device see it. */
+export declare const FRAME_LAYOUT: import("./structLayout.js").StructLayout;
+export declare const FRAME_WORDS: number;
+//# sourceMappingURL=frameLayout.d.ts.map

package/dist/frameLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameLayout.d.ts","sourceRoot":"","sources":["../src/frameLayout.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,YAAY,0CAqDvB,CAAC;AAEH,eAAO,MAAM,WAAW,QAAqB,CAAC"}

package/dist/frameLayout.js

@@ -0,0 +1,58 @@
+import { layoutStruct } from "./structLayout.js";
+/** The kernel's per dispatch uniform, as both sides of the device see it. */
+export const FRAME_LAYOUT = layoutStruct("Frame", [
+    { name: "cameraToWorld", type: "mat4f" },
+    { name: "worldToCamera", type: "mat4f" },
+    { name: "projection", type: "mat4f" },
+    { name: "inverseProjection", type: "mat4f", doc: "Clip space to view space: every camera ray goes through it." },
+    { name: "environmentTop", type: "vec4f", doc: "rgb is the colour at the top of the gradient, w its exponent." },
+    { name: "environmentBottom", type: "vec4f", doc: "rgb is the colour at the bottom, w the environment's strength." },
+    { name: "ambientSky", type: "vec4f", doc: "An ambient or hemisphere light, as radiance along the axis and against it." },
+    { name: "ambientGround", type: "vec4f" },
+    { name: "ambientAxis", type: "vec4f" },
+    ...Array.from({ length: 9 }, (_, k) => ({
+        name: `probe${k}`,
+        type: "vec4f",
+        doc: k === 0 ? "Light probes: Three's nine spherical harmonic coefficients of radiance, summed." : undefined,
+    })),
+    { name: "fogColor", type: "vec4f", doc: "rgb is the fog colour, w its kind: 0 none, 1 linear, 2 exponential squared." },
+    { name: "fogParams", type: "vec4f", doc: "near, far, density, and 1 when the fog covers every surface." },
+    { name: "background", type: "vec4f", doc: "rgb is the colour, w the mode: 0 environment, 1 colour, 2 transparent." },
+    { name: "lens", type: "vec4f", doc: "Lens radius, focus distance, blade count; a radius of zero is a pinhole." },
+    { name: "resolution", type: "vec2u" },
+    { name: "bandOrigin", type: "vec2u" },
+    { name: "bandSize", type: "vec2u" },
+    { name: "sampleIndex", type: "u32" },
+    { name: "sampleCount", type: "u32" },
+    { name: "cameraKind", type: "u32", doc: "0 perspective, 1 orthographic." },
+    { name: "bounces", type: "u32" },
+    { name: "triangleCount", type: "u32" },
+    { name: "lightCount", type: "u32" },
+    { name: "areaLightCount", type: "u32", doc: "How many leading lights are emissive triangles." },
+    { name: "clampIndirect", type: "f32", doc: "Maximum luminance one indirect contribution may add; zero leaves it." },
+    { name: "shadowSpread", type: "f32", doc: "Tangent of half the angular diameter shadow rays spread over." },
+    { name: "shadowsEnabled", type: "u32" },
+    { name: "uvOffset", type: "u32", doc: "Where the UV sets start inside the attribute buffer." },
+    { name: "orderOffset", type: "u32", doc: "Where the hierarchy's triangle order starts inside the index buffer." },
+    { name: "colorOffset", type: "u32", doc: "Where vertex colours start inside the attribute buffer." },
+    { name: "hasColors", type: "u32" },
+    { name: "varyingOffset", type: "u32", doc: "Where shader varyings start inside the attribute buffer." },
+    { name: "environmentTexture", type: "u32", doc: "The surrounding image, or NO_TEXTURE for the gradient." },
+    { name: "environmentCdf", type: "u32" },
+    { name: "environmentCdfSize", type: "vec2u" },
+    { name: "environmentTotal", type: "f32" },
+    { name: "environmentRotation", type: "f32" },
+    { name: "environmentPick", type: "f32", doc: "How often direct sampling picks the environment over a light." },
+    { name: "skyProgram", type: "u32", doc: "A procedural sky's foreground program, or NO_PROGRAM." },
+    { name: "skyData", type: "u32" },
+    { name: "skyBackground", type: "u32", doc: "Whether a procedural sky paints the background (1) or leaves it black (0)." },
+    { name: "skyIntensity", type: "f32", doc: "The strength a procedural sky lights with, which its background ignores." },
+    { name: "pixelCount", type: "u32", doc: "Where the alpha half of the accumulation buffer starts." },
+    { name: "volumetricCount", type: "u32", doc: "Lights that scatter in the air, and where their records start." },
+    { name: "volumetricData", type: "u32" },
+    { name: "adaptiveMin", type: "u32", doc: "Samples a pixel takes before it may stop as converged; 0 never stops." },
+    { name: "adaptiveThreshold", type: "f32", doc: "The error under which a pixel and its neighbours count as converged." },
+    { name: "clipPlane", type: "vec4f", doc: "A plane the camera ray drops surfaces behind, for planar captures; w = 0 and xyz = 0 is none." },
+]);
+export const FRAME_WORDS = FRAME_LAYOUT.words;
+//# sourceMappingURL=frameLayout.js.map

package/dist/frameLayout.js.map

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

package/dist/geometry.d.ts

@@ -0,0 +1,75 @@
+import { type CameraMatrices } from "./camera.js";
+import { NO_PROGRAM, type MaterialPlacement, type MaterialProperties } from "./materialLayout.js";
+import type { ShaderPrograms } from "./shaderProgram.js";
+import type { SerializedMesh, SerializedScene, SerializedTexture, UniformValue } from "./upstream.js";
+/** The flat, GPU ready form of a scene's triangles. Positions and normals are world space, three vertices per entry. */
+export interface PackedGeometry {
+    /** Nine coordinates per triangle. */
+    positions: Float32Array;
+    /** Nine normal components per triangle, one per vertex. */
+    normals: Float32Array;
+    /** Twelve per triangle: two UV sets for each of the three vertices, which is what Three's map channels need. */
+    uvs: Float32Array;
+    /** Twelve per triangle, RGBA per vertex, when any material reads vertex colours; empty otherwise. */
+    colors: Float32Array;
+    /** Shader varyings, three corners per triangle of a shader material, laid out as each program asks. */
+    varyings: Float32Array;
+    /** One material index per triangle. */
+    materials: Uint32Array;
+    triangleCount: number;
+    /** Four floats per material: linear rgb and opacity. */
+    materialColors: Float32Array;
+    /** Four floats per material: linear emissive rgb and its intensity. */
+    materialEmissive: Float32Array;
+    /** Every material of the scene, resolved, in the order the triangle indices refer to them. */
+    materialProperties: MaterialProperties[];
+    /** The mesh specific half of each material entry. */
+    materialPlacements: MaterialPlacement[];
+    materialCount: number;
+    /** Words the materials keep in the texture buffer: clipping planes and shader uniforms. */
+    extraWords: Uint32Array;
+    /**
+     * Whether the triangles depend on the camera: points, lines and sprites face it, and a vertex shader projects through
+     * it. Such a scene is packed again whenever the camera or the image size changes.
+     */
+    cameraDependent: boolean;
+}
+export interface PackOptions {
+    /** The index in the texture table of each texture, by id. */
+    textures?: ReadonlyMap<string, number>;
+    /** The textures themselves, for the work done here on the CPU: displacement maps and vertex shaders. */
+    textureData?: ReadonlyMap<string, SerializedTexture>;
+    /** The camera and image size points, lines, sprites and vertex shaders are built for. */
+    camera?: CameraMatrices;
+    width?: number;
+    height?: number;
+    /** Translated fragment shaders, for the materials that have one. */
+    programs?: ShaderPrograms;
+    /** Where the extra words will start in the texture buffer, so the materials can point at them absolutely. */
+    extraBase?: number;
+    /** Scene fog, which a shader's fog uniforms read. */
+    fog?: SerializedScene["fog"];
+}
+/** The uniforms Three sets on every shader for this camera and mesh. */
+export declare function builtinUniforms(camera: CameraMatrices | undefined, matrixWorld: readonly number[], fog?: SerializedScene["fog"]): Record<string, UniformValue>;
+/**
+ * Flattens the scene into triangles, materials resolved and transforms applied. Every triangle carries its own three
+ * vertices: the path tracer reads a hit through its triangle index, and sharing vertices would cost an indirection on
+ * the hottest path of the kernel for memory that low poly scenes do not miss.
+ *
+ * Points, lines and sprites become triangles that face the camera, sized the way Three draws them, so a path has a
+ * surface to find; vertex shaders run here, on the CPU renderer's interpreter, and their varyings ride along per corner.
+ */
+export declare function packGeometry(scene: SerializedScene, options?: PackOptions | ReadonlyMap<string, number>): PackedGeometry;
+/**
+ * The attributes of an instanced geometry, which the snapshot keeps as plain attributes with one element per instance
+ * rather than per vertex, and how many instances there are.
+ */
+export declare function instancedAttributes(mesh: SerializedMesh): {
+    names: Set<string>;
+    count: number;
+} | null;
+/** Flat shading for geometry that arrives without normals: the three vertices share the face normal. */
+export declare function faceNormal(a: readonly number[], b: readonly number[], c: readonly number[]): number[];
+export { NO_PROGRAM };
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAKL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAsB,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1H,wHAAwH;AACxH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,SAAS,EAAE,YAAY,CAAC;IACxB,2DAA2D;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,gHAAgH;IAChH,GAAG,EAAE,YAAY,CAAC;IAClB,qGAAqG;IACrG,MAAM,EAAE,YAAY,CAAC;IACrB,uGAAuG;IACvG,QAAQ,EAAE,YAAY,CAAC;IACvB,uCAAuC;IACvC,SAAS,EAAE,WAAW,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,cAAc,EAAE,YAAY,CAAC;IAC7B,uEAAuE;IACvE,gBAAgB,EAAE,YAAY,CAAC;IAC/B,8FAA8F;IAC9F,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IACzC,qDAAqD;IACrD,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,UAAU,EAAE,WAAW,CAAC;IACxB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,wGAAwG;IACxG,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACrD,yFAAyF;IACzF,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,6GAA6G;IAC7G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;CAC9B;AAiGD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,EAChG,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAmB5D;AAsBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,cAAc,CAoUjG;AAqfD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAetG;AAED,wGAAwG;AACxG,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAKrG;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}