@meimu/mutracer 0.2.0 → 0.3.1

package/lib/renderer/DisplayPostProcess.js

@@ -1,41 +1,74 @@
 import { textureBytes } from './gpuMemory.js';
-/** Target-owned ping-pong images. A failed chain never replaces the composed image. */
+/** Target-owned images. A failed chain never replaces the composed image. */
 export class DisplayPostProcess {
     device;
-    textures = [];
+    textures = new Map();
     image;
     constructor(device) {
         this.device = device;
     }
     get output() { return this.image; }
     reset() { this.image = undefined; }
-    getMemoryBytes() { return this.textures.reduce((sum, texture) => sum + textureBytes(texture), 0); }
+    getMemoryBytes() { return [...this.textures.values()].flat().reduce((sum, texture) => sum + textureBytes(texture), 0); }
     retire(textures) {
         if (!textures.length)
             return;
         void this.device.queue.onSubmittedWorkDone().catch(() => { }).then(() => textures.forEach(texture => texture.destroy()));
     }
-    dispose() { this.reset(); this.retire(this.textures); this.textures = []; }
-    run(input, passes, render) {
+    dispose() { this.reset(); this.retire([...this.textures.values()].flat()); this.textures.clear(); }
+    run(input, passes, render, display = input, options = [], crop) {
         this.reset();
-        if (!passes.length)
+        const cropped = crop && (crop.width !== input.width || crop.height !== input.height);
+        if (!passes.length && !cropped)
             return;
-        if (this.textures.length === 0 || this.textures[0].width !== input.width || this.textures[0].height !== input.height || this.textures[0].format !== input.format) {
-            this.retire(this.textures);
-            this.textures = Array.from({ length: 2 }, (_, index) => this.device.createTexture({
-                label: `Display post-process ${index}`, size: { width: input.width, height: input.height }, format: input.format,
+        const validate = (size) => {
+            const limit = this.device.limits.maxTextureDimension2D;
+            if (!size || !Number.isInteger(size.width) || !Number.isInteger(size.height) || size.width < 1 || size.height < 1 || size.width > limit || size.height > limit) {
+                throw new RangeError('Post-process output dimensions must be positive integers within maxTextureDimension2D.');
+            }
+            return { width: size.width, height: size.height };
+        };
+        // Evaluate the entire size chain before recording user commands.
+        let size = cropped ? validate(crop) : { width: input.width, height: input.height };
+        const sizes = passes.map((_, index) => size = validate(options[index]?.outputSize ? options[index].outputSize({ ...size }, { width: display.width, height: display.height }) : size));
+        const active = new Set();
+        const acquire = (size, previous) => {
+            const key = `${size.width}:${size.height}:${input.format}`;
+            active.add(key);
+            // Allocate the second image of a size only when consecutive passes need to ping-pong.
+            const pair = this.textures.get(key) ?? [];
+            this.textures.set(key, pair);
+            const index = pair[0] === previous ? 1 : 0;
+            pair[index] ??= this.device.createTexture({
+                label: `Display post-process ${index}`, size, format: input.format,
                 usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.COPY_SRC | GPUTextureUsage.COPY_DST
-            }));
-        }
+            });
+            return pair[index];
+        };
+        const actual = render._output?.getMemory() ?? input;
         const encoder = this.device.createCommandEncoder();
         let previous = input;
-        for (let index = 0; index < passes.length; index++) {
-            const output = this.textures[index % 2];
-            passes[index]({ device: this.device, encoder, input: previous, output, width: input.width, height: input.height, render });
-            previous = output;
+        try {
+            if (cropped) {
+                const output = acquire(crop, previous);
+                encoder.copyTextureToTexture({ texture: input, origin: { x: Math.floor((input.width - crop.width) / 2), y: Math.floor((input.height - crop.height) / 2) } }, { texture: output }, crop);
+                previous = output;
+            }
+            for (let index = 0; index < passes.length; index++) {
+                const output = acquire(sizes[index], previous);
+                passes[index]({ device: this.device, encoder, input: previous, output, width: actual.width, height: actual.height, render });
+                previous = output;
+            }
+            this.device.queue.submit([encoder.finish()]);
+            this.image = previous;
+        }
+        finally {
+            for (const [key, pair] of this.textures)
+                if (!active.has(key)) {
+                    this.textures.delete(key);
+                    this.retire(pair);
+                }
         }
-        this.device.queue.submit([encoder.finish()]);
-        this.image = previous;
     }
 }
 //# sourceMappingURL=DisplayPostProcess.js.map

package/lib/renderer/DisplayPostProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayPostProcess.js","sourceRoot":"","sources":["../../src/renderer/DisplayPostProcess.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PostProcess, PostProcessContext } from '../Display.js';\nimport {textureBytes} from './gpuMemory.js';\n\n/** Target-owned ping-pong images. A failed chain never replaces the composed image. */\nexport class DisplayPostProcess {\n  private textures: GPUTexture[] = [];\n  private image?: GPUTexture;\n  constructor(private readonly device: GPUDevice) {}\n  get output() { return this.image; }\n  reset() { this.image = undefined; }\n  getMemoryBytes() { return this.textures.reduce((sum, texture) => sum + textureBytes(texture), 0); }\n  private retire(textures: GPUTexture[]) {\n    if (!textures.length) return;\n    void this.device.queue.onSubmittedWorkDone().catch(() => {}).then(() => textures.forEach(texture => texture.destroy()));\n  }\n  dispose() { this.reset(); this.retire(this.textures); this.textures = []; }\n  run(input: GPUTexture, passes: readonly PostProcess[], render: PostProcessContext['render']) {\n    this.reset();\n    if (!passes.length) return;\n    if (this.textures.length === 0 || this.textures[0].width !== input.width || this.textures[0].height !== input.height || this.textures[0].format !== input.format) {\n      this.retire(this.textures);\n      this.textures = Array.from({length: 2}, (_, index) => this.device.createTexture({\n        label: `Display post-process ${index}`, size: {width: input.width, height: input.height}, format: input.format,\n        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.COPY_SRC | GPUTextureUsage.COPY_DST\n      }));\n    }\n    const encoder = this.device.createCommandEncoder();\n    let previous = input;\n    for (let index = 0; index < passes.length; index++) {\n      const output = this.textures[index % 2];\n      passes[index]({device: this.device, encoder, input: previous, output, width: input.width, height: input.height, render});\n      previous = output;\n    }\n    this.device.queue.submit([encoder.finish()]);\n    this.image = previous;\n  }\n}\n"]}
+{"version":3,"file":"DisplayPostProcess.js","sourceRoot":"","sources":["../../src/renderer/DisplayPostProcess.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PostProcess, PostProcessContext, PostProcessOptions } from '../Display.js';\nimport {textureBytes} from './gpuMemory.js';\n\ntype Size = {width: number; height: number};\n/** Target-owned images. A failed chain never replaces the composed image. */\nexport class DisplayPostProcess {\n  private textures = new Map<string, GPUTexture[]>();\n  private image?: GPUTexture;\n  constructor(private readonly device: GPUDevice) {}\n  get output() { return this.image; }\n  reset() { this.image = undefined; }\n  getMemoryBytes() { return [...this.textures.values()].flat().reduce((sum, texture) => sum + textureBytes(texture), 0); }\n  private retire(textures: GPUTexture[]) {\n    if (!textures.length) return;\n    void this.device.queue.onSubmittedWorkDone().catch(() => {}).then(() => textures.forEach(texture => texture.destroy()));\n  }\n  dispose() { this.reset(); this.retire([...this.textures.values()].flat()); this.textures.clear(); }\n  run(input: GPUTexture, passes: readonly PostProcess[], render: PostProcessContext['render'], display: Size = input,\n    options: readonly PostProcessOptions[] = [], crop?: Size) {\n    this.reset();\n    const cropped = crop && (crop.width !== input.width || crop.height !== input.height);\n    if (!passes.length && !cropped) return;\n    const validate = (size: Size) => {\n      const limit = this.device.limits.maxTextureDimension2D;\n      if (!size || !Number.isInteger(size.width) || !Number.isInteger(size.height) || size.width < 1 || size.height < 1 || size.width > limit || size.height > limit) {\n        throw new RangeError('Post-process output dimensions must be positive integers within maxTextureDimension2D.');\n      }\n      return {width: size.width, height: size.height};\n    };\n    // Evaluate the entire size chain before recording user commands.\n    let size: Size = cropped ? validate(crop) : {width: input.width, height: input.height};\n    const sizes = passes.map((_, index) => size = validate(options[index]?.outputSize ? options[index].outputSize!({...size}, {width: display.width, height: display.height}) : size));\n    const active = new Set<string>();\n    const acquire = (size: Size, previous: GPUTexture) => {\n      const key = `${size.width}:${size.height}:${input.format}`;\n      active.add(key);\n      // Allocate the second image of a size only when consecutive passes need to ping-pong.\n      const pair = this.textures.get(key) ?? [];\n      this.textures.set(key, pair);\n      const index = pair[0] === previous ? 1 : 0;\n      pair[index] ??= this.device.createTexture({\n        label: `Display post-process ${index}`, size, format: input.format,\n        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.COPY_SRC | GPUTextureUsage.COPY_DST\n      });\n      return pair[index];\n    };\n    const actual = render._output?.getMemory() ?? input;\n    const encoder = this.device.createCommandEncoder();\n    let previous = input;\n    try {\n      if (cropped) {\n        const output = acquire(crop, previous);\n        encoder.copyTextureToTexture({texture: input, origin: {x: Math.floor((input.width-crop.width)/2), y: Math.floor((input.height-crop.height)/2)}}, {texture: output}, crop);\n        previous = output;\n      }\n      for (let index = 0; index < passes.length; index++) {\n        const output = acquire(sizes[index], previous);\n        passes[index]({device: this.device, encoder, input: previous, output, width: actual.width, height: actual.height, render});\n        previous = output;\n      }\n      this.device.queue.submit([encoder.finish()]);\n      this.image = previous;\n    } finally {\n      for (const [key, pair] of this.textures) if (!active.has(key)) { this.textures.delete(key); this.retire(pair); }\n    }\n  }\n}\n"]}

package/lib/renderer/GPUTraceQueue.d.ts

@@ -4,7 +4,8 @@ export declare class GPUTraceQueue {
     private pendingMs;
     private pending;
     constructor(queue: GPUQueue);
+    get hasPending(): boolean;
     available(budgetMs: number): number;
-    whenAvailable(): Promise<void>;
+    whenAvailable(): Promise<boolean>;
     track(estimatedMs: number): void;
 }

package/lib/renderer/GPUTraceQueue.js

@@ -6,11 +6,13 @@ export class GPUTraceQueue {
     constructor(queue) {
         this.queue = queue;
     }
+    get hasPending() { return this.pending.size > 0; }
     available(budgetMs) {
         return Math.max(0, budgetMs - this.pendingMs);
     }
     whenAvailable() {
-        return this.pending.values().next().value ?? Promise.resolve();
+        const pending = this.pending.values().next().value;
+        return pending ? pending.then(() => true) : Promise.resolve(false);
     }
     track(estimatedMs) {
         this.pendingMs += estimatedMs;

package/lib/renderer/GPUTraceQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"GPUTraceQueue.js","sourceRoot":"","sources":["../../src/renderer/GPUTraceQueue.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,OAAO,aAAa;IAIJ;IAHZ,SAAS,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE3C,YAAoB,KAAe;QAAf,UAAK,GAAL,KAAK,CAAU;IAAG,CAAC;IAEvC,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,WAAmB;QACvB,IAAI,CAAC,SAAS,IAAI,WAAW,CAAC;QAC9B,4EAA4E;QAC5E,6EAA6E;QAC7E,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,qEAAqE;YACrE,wEAAwE;YACxE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;CACF","sourcesContent":["/** Shared by resident targets so switching images cannot reset queued work. */\nexport class GPUTraceQueue {\n  private pendingMs = 0;\n  private pending = new Set<Promise<void>>();\n\n  constructor(private queue: GPUQueue) {}\n\n  available(budgetMs: number): number {\n    return Math.max(0, budgetMs - this.pendingMs);\n  }\n\n  whenAvailable(): Promise<void> {\n    return this.pending.values().next().value ?? Promise.resolve();\n  }\n\n  track(estimatedMs: number): void {\n    this.pendingMs += estimatedMs;\n    // Fence each sample, rather than the entire batch: a later display tick can\n    // replace completed samples while the tail of the previous batch still runs.\n    const retire = () => {\n      this.pendingMs = Math.max(0, this.pendingMs - estimatedMs);\n      this.pending.delete(completion);\n      // Subtracting estimates leaves rounding residue. An empty queue must\n      // admit a sample as long as the budget, or nothing would wake it again.\n      if (!this.pending.size) this.pendingMs = 0;\n    };\n    const completion = this.queue.onSubmittedWorkDone().then(retire, retire);\n    this.pending.add(completion);\n  }\n}\n"]}
+{"version":3,"file":"GPUTraceQueue.js","sourceRoot":"","sources":["../../src/renderer/GPUTraceQueue.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,OAAO,aAAa;IAIJ;IAHZ,SAAS,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE3C,YAAoB,KAAe;QAAf,UAAK,GAAL,KAAK,CAAU;IAAG,CAAC;IAEvC,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IAE3D,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,aAAa;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACnD,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,WAAmB;QACvB,IAAI,CAAC,SAAS,IAAI,WAAW,CAAC;QAC9B,4EAA4E;QAC5E,6EAA6E;QAC7E,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,qEAAqE;YACrE,wEAAwE;YACxE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAC7C,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;CACF","sourcesContent":["/** Shared by resident targets so switching images cannot reset queued work. */\nexport class GPUTraceQueue {\n  private pendingMs = 0;\n  private pending = new Set<Promise<void>>();\n\n  constructor(private queue: GPUQueue) {}\n\n  get hasPending(): boolean { return this.pending.size > 0; }\n\n  available(budgetMs: number): number {\n    return Math.max(0, budgetMs - this.pendingMs);\n  }\n\n  whenAvailable(): Promise<boolean> {\n    const pending = this.pending.values().next().value;\n    return pending ? pending.then(() => true) : Promise.resolve(false);\n  }\n\n  track(estimatedMs: number): void {\n    this.pendingMs += estimatedMs;\n    // Fence each sample, rather than the entire batch: a later display tick can\n    // replace completed samples while the tail of the previous batch still runs.\n    const retire = () => {\n      this.pendingMs = Math.max(0, this.pendingMs - estimatedMs);\n      this.pending.delete(completion);\n      // Subtracting estimates leaves rounding residue. An empty queue must\n      // admit a sample as long as the budget, or nothing would wake it again.\n      if (!this.pending.size) this.pendingMs = 0;\n    };\n    const completion = this.queue.onSubmittedWorkDone().then(retire, retire);\n    this.pending.add(completion);\n  }\n}\n"]}

package/lib/renderer/MaterialData.js

@@ -18,8 +18,13 @@ export default class MaterialData {
         this.textures = maps.textures.slice();
         for (const texture of lightTextures) {
             if (texture) {
-                this.lightTexturesIndices.push(this.textures.length);
-                this.textures.push(texture);
+                const existing = options.independentTextures ? this.textures.indexOf(texture) : -1;
+                if (existing >= 0)
+                    this.lightTexturesIndices.push(existing);
+                else {
+                    this.lightTexturesIndices.push(this.textures.length);
+                    this.textures.push(texture);
+                }
             }
             else
                 this.lightTexturesIndices.push(-1);

package/lib/renderer/MaterialData.js.map

@@ -1 +1 @@
-{"version":3,"file":"MaterialData.js","sourceRoot":"","sources":["../../src/renderer/MaterialData.ts"],"names":[],"mappings":"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","sourcesContent":["import type MaterialState from '../scene/MaterialState.js';\nimport type TextureState from '../scene/TextureState.js';\nimport { MATERIAL_TEXTURE_NAMES, MATERIAL_TEXTURE_SLOTS } from './materialTextureSlots.js';\nimport { mergeTexturesFromMaterials } from './materialTextures.js';\nimport { createMaterialBufferData, repackMaterialParams } from './materialParams.js';\nimport { packMaterialBuffer } from './materialLayout.js';\nimport { planTextureAtlas, type MaterialTableOptions, type TextureAtlasPlan } from './textureAtlas.js';\nimport type { BufferData } from './materialBufferData.js';\n\n// CPU material preparation shared by browser uploads and native command generation.\n// The adapter describes source encoding; the core never decodes DOM/GPU resources.\nexport default class MaterialData {\n  bufferData: BufferData;\n  textures: TextureState[];\n  displacementMaps: TextureState[];\n  lightTexturesIndices: number[] = [];\n  defines: Record<string, number> = {};\n  atlas: TextureAtlasPlan;\n  constructor(materials: MaterialState[], lightTextures: (TextureState | undefined)[],\n    colorLinear: (texture: TextureState) => number, options: MaterialTableOptions = {},\n    floatStorage?: (texture: TextureState) => boolean) {\n    const maps = mergeTexturesFromMaterials(materials, MATERIAL_TEXTURE_NAMES);\n    this.displacementMaps = maps.indices.displacementMap.map(index => maps.textures[index]).filter(texture => !!texture);\n    this.textures = maps.textures.slice();\n    for (const texture of lightTextures) {\n      if (texture) { this.lightTexturesIndices.push(this.textures.length); this.textures.push(texture); }\n      else this.lightTexturesIndices.push(-1);\n    }\n    this.bufferData = createMaterialBufferData(materials);\n    this.bufferData.diffuseMapIndex = maps.indices.map;\n    this.bufferData.alphaMapIndex = maps.indices.alphaMap;\n    this.bufferData.normalMapIndex = maps.indices.normalMap;\n    this.bufferData.emissiveMapIndex = maps.indices.emissiveMap;\n    this.bufferData.metallicRoughnessMapIndex = maps.indices.metallicRoughnessMap;\n    this.bufferData.roughnessMapIndex = maps.indices.roughnessMap;\n    this.bufferData.metalnessMapIndex = maps.indices.metalnessMap;\n    this.bufferData.transmissionMapIndex = maps.indices.transmissionMap;\n    this.bufferData.thinFilmMapIndex = maps.indices.thinFilmMap;\n    this.bufferData.displacementMapIndex = maps.indices.displacementMap;\n    this.bufferData.coatWeightMapIndex = maps.indices.coatWeightMap;\n    this.bufferData.coatRoughnessMapIndex = maps.indices.coatRoughnessMap;\n    this.bufferData.fuzzColorMapIndex = maps.indices.fuzzColorMap;\n    this.bufferData.fuzzRoughnessMapIndex = maps.indices.fuzzRoughnessMap;\n    this.bufferData.specularWeightMapIndex = maps.indices.specularWeightMap;\n    this.bufferData.specularColorMapIndex = maps.indices.specularColorMap;\n    this.bufferData.anisotropyMapIndex = maps.indices.anisotropyMap;\n    this.bufferData.coatNormalMapIndex = maps.indices.coatNormalMap;\n    this.atlas = planTextureAtlas(this.textures, this.textures.map(colorLinear), options,\n      floatStorage ? this.textures.some(floatStorage) : undefined);\n    this.bufferData.mapInfo = this.atlas.mapInfo; this.bufferData.mapTransform = this.atlas.mapTransform;\n    this.bufferData.mapWrap = this.atlas.mapWrap;\n    this.bufferData.mapUvChannel = this.atlas.mapUvChannel; this.bufferData.mapColorLinear = this.atlas.mapColorLinear;\n    this.defines = {NUM_MAPS: this.textures.length};\n    for (const slot of MATERIAL_TEXTURE_SLOTS) {\n      if (slot.define) this.defines[slot.define] = maps.indices[slot.property].filter(index => index >= 0).length;\n    }\n  }\n  repackParams(materials: MaterialState[]) { repackMaterialParams(this.bufferData, materials); }\n  getBufferArray() { return packMaterialBuffer(this.bufferData); }\n}\n"]}
+{"version":3,"file":"MaterialData.js","sourceRoot":"","sources":["../../src/renderer/MaterialData.ts"],"names":[],"mappings":"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","sourcesContent":["import type MaterialState from '../scene/MaterialState.js';\nimport type TextureState from '../scene/TextureState.js';\nimport { MATERIAL_TEXTURE_NAMES, MATERIAL_TEXTURE_SLOTS } from './materialTextureSlots.js';\nimport { mergeTexturesFromMaterials } from './materialTextures.js';\nimport { createMaterialBufferData, repackMaterialParams } from './materialParams.js';\nimport { packMaterialBuffer } from './materialLayout.js';\nimport { planTextureAtlas, type MaterialTableOptions, type TextureAtlasPlan } from './textureAtlas.js';\nimport type { BufferData } from './materialBufferData.js';\n\n// CPU material preparation shared by browser uploads and native command generation.\n// The adapter describes source encoding; the core never decodes DOM/GPU resources.\nexport default class MaterialData {\n  bufferData: BufferData;\n  textures: TextureState[];\n  displacementMaps: TextureState[];\n  lightTexturesIndices: number[] = [];\n  defines: Record<string, number> = {};\n  atlas: TextureAtlasPlan;\n  constructor(materials: MaterialState[], lightTextures: (TextureState | undefined)[],\n    colorLinear: (texture: TextureState) => number, options: MaterialTableOptions = {},\n    floatStorage?: (texture: TextureState) => boolean) {\n    const maps = mergeTexturesFromMaterials(materials, MATERIAL_TEXTURE_NAMES);\n    this.displacementMaps = maps.indices.displacementMap.map(index => maps.textures[index]).filter(texture => !!texture);\n    this.textures = maps.textures.slice();\n    for (const texture of lightTextures) {\n      if (texture) {\n        const existing = options.independentTextures ? this.textures.indexOf(texture) : -1;\n        if (existing >= 0) this.lightTexturesIndices.push(existing);\n        else { this.lightTexturesIndices.push(this.textures.length); this.textures.push(texture); }\n      }\n      else this.lightTexturesIndices.push(-1);\n    }\n    this.bufferData = createMaterialBufferData(materials);\n    this.bufferData.diffuseMapIndex = maps.indices.map;\n    this.bufferData.alphaMapIndex = maps.indices.alphaMap;\n    this.bufferData.normalMapIndex = maps.indices.normalMap;\n    this.bufferData.emissiveMapIndex = maps.indices.emissiveMap;\n    this.bufferData.metallicRoughnessMapIndex = maps.indices.metallicRoughnessMap;\n    this.bufferData.roughnessMapIndex = maps.indices.roughnessMap;\n    this.bufferData.metalnessMapIndex = maps.indices.metalnessMap;\n    this.bufferData.transmissionMapIndex = maps.indices.transmissionMap;\n    this.bufferData.thinFilmMapIndex = maps.indices.thinFilmMap;\n    this.bufferData.displacementMapIndex = maps.indices.displacementMap;\n    this.bufferData.coatWeightMapIndex = maps.indices.coatWeightMap;\n    this.bufferData.coatRoughnessMapIndex = maps.indices.coatRoughnessMap;\n    this.bufferData.fuzzColorMapIndex = maps.indices.fuzzColorMap;\n    this.bufferData.fuzzRoughnessMapIndex = maps.indices.fuzzRoughnessMap;\n    this.bufferData.specularWeightMapIndex = maps.indices.specularWeightMap;\n    this.bufferData.specularColorMapIndex = maps.indices.specularColorMap;\n    this.bufferData.anisotropyMapIndex = maps.indices.anisotropyMap;\n    this.bufferData.coatNormalMapIndex = maps.indices.coatNormalMap;\n    this.atlas = planTextureAtlas(this.textures, this.textures.map(colorLinear), options,\n      floatStorage ? this.textures.some(floatStorage) : undefined);\n    this.bufferData.mapInfo = this.atlas.mapInfo; this.bufferData.mapTransform = this.atlas.mapTransform;\n    this.bufferData.mapWrap = this.atlas.mapWrap;\n    this.bufferData.mapUvChannel = this.atlas.mapUvChannel; this.bufferData.mapColorLinear = this.atlas.mapColorLinear;\n    this.defines = {NUM_MAPS: this.textures.length};\n    for (const slot of MATERIAL_TEXTURE_SLOTS) {\n      if (slot.define) this.defines[slot.define] = maps.indices[slot.property].filter(index => index >= 0).length;\n    }\n  }\n  repackParams(materials: MaterialState[]) { repackMaterialParams(this.bufferData, materials); }\n  getBufferArray() { return packMaterialBuffer(this.bufferData); }\n}\n"]}

package/lib/renderer/RenderingPipeline.d.ts

@@ -1,3 +1,4 @@
+import type { SurfaceHit } from './surfaceHit.js';
 import type { PostProcess } from '../Display.js';
 import type Render from '../Render.js';
 import type { DenoiserHandle, OIDNWeb } from './denoiser.js';
@@ -157,6 +158,10 @@ export interface RenderingDiagnostics {
         };
     };
     gpuTraceTiming?: {
+        /** Last light-tracing batch time in milliseconds. Default undefined until measured. */ causticTimeMs?: number;
+        /** Last photon-map batch time in milliseconds. Default undefined until measured. */ photonMappingTimeMs?: number;
+        /** Photon emission, count, block scan, sum scan and scatter times in milliseconds. Default undefined until measured. */ photonStagesMs?: number[];
+        /** Camera path kernel time in milliseconds. Default undefined until measured. */ pathTracingTimeMs?: number;
         tileTimeMs: number;
         tileTimePerSampleMs?: number;
         estimatedFullFrameTimeMs: number;
@@ -180,6 +185,7 @@ export interface SceneResources {
     getDiagnostics(): RenderingDiagnostics;
     dispose(): void;
     readDepthSamples(area: DepthSampleArea): Promise<Float32Array | undefined>;
+    pickSurface?(x: number, y: number, aspect?: number): Promise<SurfaceHit | null | undefined>;
 }
 /** Explicit execution and composition for one accumulation. */
 export interface RenderPasses {
@@ -189,7 +195,11 @@ export interface RenderPasses {
     trace(camera: Camera, maxSamples: number): boolean;
     drawPostProcess(): void;
     /** Apply display-only passes to the last composed image; absent on WebGL. */
-    applyPostProcesses?(passes: readonly PostProcess[], render: Render): void;
+    applyPostProcesses?(passes: readonly PostProcess[], render: Render, options?: readonly import('../Display.js').PostProcessOptions[], crop?: {
+        width: number;
+        height: number;
+    }): void;
+    getAovTexture?(kind: 'diffuseColor' | 'specularColor' | 'depth'): GPUTexture | undefined;
     getOutputTexture?(kind: 'hdr' | 'display'): GPUTexture | undefined;
     /** Configure deterministic headless batches used by offline frame export. */
     setOfflineRenderOptions(options: {

package/lib/renderer/RenderingPipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderingPipeline.js","sourceRoot":"","sources":["../../src/renderer/RenderingPipeline.ts"],"names":[],"mappings":"AAqLA,OAAO,EAAC,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC","sourcesContent":["import type {PostProcess} from '../Display.js';\nimport type Render from '../Render.js';\nimport type {DenoiserHandle, OIDNWeb} from './denoiser.js';\nimport type {DenoiseSchedule} from '../Render.js';\nimport type { DepthSampleArea } from './depthQuery.js';\nimport Camera from '../scene/Camera.js';\nimport Mesh from '../scene/Mesh.js';\nimport Geometry from '../scene/Geometry.js';\nimport OpenPBRMaterial from '../scene/OpenPBRMaterial.js';\nimport type { SceneBackground, SceneLight } from '../scene/Scene.js';\nimport type { ColorRGB } from '../types.js';\nimport type { TextureAtlasStats } from './MaterialTable.js';\nimport type {\n  OfflineAdaptiveSamplingOptions,\n  OfflineAdaptiveSamplingResult\n} from './OfflineAdaptiveSampling.js';\n\nexport type ToneMapping =\n  | 'agx'\n  | 'aces'\n  | 'cineon'\n  | 'reinhard'\n  | 'linear';\n\nexport interface ToneMappingParams {\n  /** Linear exposure multiplier. Default `1`. */\n  exposure?: number;\n  /** Display tone mapper. Default `agx`. */\n  toneMapping?: ToneMapping;\n  /** Contrast multiplier. Default `1`. */\n  contrast?: number;\n  /** Saturation multiplier. Default `1`. */\n  saturation?: number;\n  /** Color temperature adjustment in [-1, 1]. Default `0`. */\n  temperature?: number;\n  /** Green/magenta adjustment in [-1, 1]. Default `0`. */\n  tint?: number;\n  /** Vignette strength in [0, 1]. Default `0`. */\n  vignette?: number;\n}\n\nexport type DisplayChannel =\n  | 'final'\n  | 'shadow'\n  | 'albedo'\n  | 'normal'\n  | 'shadowCatcher'\n  | import('./aov.js').AovKind;\n\n/** Primary-ray policy for glTF BLEND materials. */\nexport type AlphaBlendStrategy =\n  | 'stochastic'\n  | 'deterministic-source-over';\n\n/** Generated source measurements for one shader module. */\nexport interface ShaderModuleCompilationDiagnostics {\n  /** Module or pipeline diagnostic label. */\n  label: string;\n  /** Generated shader source size in bytes. */\n  sourceBytes: number;\n  /** Generated shader source line count. */\n  sourceLines: number;\n  /** Stable source-level fingerprint for diagnosing cache-key churn. */\n  sourceFingerprint: string;\n}\n\n/** Compilation measurements for one shader pipeline/program. */\nexport interface ShaderPipelineCompilationDiagnostics {\n  /** Module or pipeline diagnostic label. */\n  label: string;\n  /** Compute entry-point name. */\n  entryPoint: string;\n  /**\n   * Whether this pipeline belongs to the minimum set needed to present a\n   * usable first image. Optional reuse and quality stages are false even\n   * while the current eager compiler still waits for them.\n   */\n  firstFrameRequired: boolean;\n  /** Current compilation state. */\n  status: 'queued' | 'compiling' | 'ready' | 'failed';\n  /** Milliseconds from the start of this pipeline compilation batch. */\n  startedAtMs?: number;\n  /** Milliseconds from the start of this pipeline compilation batch. */\n  endedAtMs?: number;\n  /** Pipeline compilation duration in milliseconds; undefined until completed. */\n  durationMs?: number;\n  /** Number of pipelines compiling when this one started; undefined before start. */\n  concurrentCompilationCount?: number;\n  /** Failure message; undefined without a compilation error. */\n  error?: string;\n}\n\n/** Source generation and asynchronous pipeline compilation measurements. */\nexport interface ShaderCompilationDiagnostics {\n  /** Current compilation state. */\n  status: 'compiling' | 'ready' | 'failed';\n  /** Generated shader source size in bytes. */\n  sourceBytes: number;\n  /** Generated shader source line count. */\n  sourceLines: number;\n  /** Total pipelines in the batch. */\n  pipelineCount: number;\n  /** Number of pipelines successfully completed. */\n  completedPipelineCount: number;\n  /** CPU shader source generation time in milliseconds. */\n  sourceGenerationTimeMs: number;\n  /** Shader module creation time in milliseconds. */\n  moduleCreationTimeMs: number;\n  /** Per-module source measurements. */\n  modules: ShaderModuleCompilationDiagnostics[];\n  /** Per-pipeline timing and status measurements. */\n  pipelines: ShaderPipelineCompilationDiagnostics[];\n  /** Configured pool size, capped to the number of pipelines in this batch. */\n  maximumConcurrentPipelineCount: number;\n  /** Largest number of createComputePipelineAsync calls active at once. */\n  peakConcurrentPipelineCount: number;\n  /** Batch pipeline compilation time in milliseconds; undefined until completed. */\n  pipelineCompilationTimeMs?: number;\n  /** Total batch preparation time in milliseconds; undefined until completed. */\n  totalTimeMs?: number;\n  /** Failure message; undefined without a compilation error. */\n  error?: string;\n}\n\nexport interface RenderingDiagnostics {\n  /** Label of the last complete target presented; undefined before the first image. */\n  presentedTarget?: string;\n  /** Whether the displayed target contains a complete image. Default false. */\n  presentedComplete?: boolean;\n  /** Resident target dimensions and allocated GPU bytes, including denoise resources. */\n  targets?: { label: string; width: number; height: number; bytes: number }[];\n  hdrPresentation?: {\n    requested: boolean;\n    active: boolean;\n    /** Largest encoded RGB component sent to the HDR presentation pass. */\n    peakDisplayValue?: number;\n  };\n  textureAtlas?: TextureAtlasStats;\n  /** Material texture storage selection and estimated payload; driver allocation overhead is excluded. */\n  materialTextures?: {\n    requested: 'atlas' | 'auto';\n    active: 'atlas' | 'bindless';\n    /** Reason auto selected atlas; undefined when no fallback occurred. */\n    fallbackReason?: string;\n    textureCount: number;\n    estimatedBytes: number;\n    scale: number;\n    /** Metadata buffer bytes; zero for atlas. */\n    metadataBytes: number;\n    /** Resource-table slots; zero for atlas. */\n    resourceTableCapacity: number;\n    /** Payload and metadata waiting for previous GPU submissions; zero when none. */\n    retiredBytes: number;\n  };\n  /** Shader compilation measurements: current WebGPU batch or cumulative WebGL programs. */\n  shaderCompilation?: ShaderCompilationDiagnostics;\n  /** Light-selection table summary (WebGPU). */\n  lightSampling?: {\n    emissiveTriangles: number;\n    activeChoices: number;\n    totalWeight: number;\n    domains: Record<\n      'environment' | 'infinite' | 'localAndEmissive',\n      { count: number; weight: number; pmf: number }\n    >;\n  };\n  /** Traversal stack capacities compiled into the current WebGPU shader. */\n  bvh?: {\n    tlasTraversalStackSize?: number;\n    blasTraversalStackSize?: number;\n    /** Last static preparation statistics, excluding queue and WASM loading time. */\n    lastBuild?: { geometryCount: number; bvhTimeMs: number };\n  };\n  gpuTraceTiming?: {\n    tileTimeMs: number;\n    tileTimePerSampleMs?: number;\n    estimatedFullFrameTimeMs: number;\n    tileCount: number;\n  };\n}\n\nexport {DEFAULT_BEVEL_SAMPLES, MIN_BEVEL_SAMPLES, MAX_BEVEL_SAMPLES, DEFAULT_DIRECT_LIGHT_CANDIDATES, MIN_DIRECT_LIGHT_CANDIDATES, MAX_DIRECT_LIGHT_CANDIDATES, normalizeDirectLightCandidates, normalizeBevelSamples} from './renderingLimits.js';\n\n/** Shared scene resources; uploaded once per committed revision. */\nexport interface SceneResources {\n  /** Returns true when scene geometry, materials, or instance transforms changed. */\n  setMeshes(meshes: Mesh[], update?: {\n    transforms?: readonly Mesh[];\n    colors?: readonly Mesh[];\n    geometries?: readonly Geometry[];\n    materials?: readonly OpenPBRMaterial[];\n  }): boolean;\n  /** Changes the software memory guard used when packing material textures. */\n  setTextureAtlasBudget(maxBytes: number): boolean;\n  setLights(lights: SceneLight[]): void;\n  setBackground(background?: SceneBackground): void;\n  getDiagnostics(): RenderingDiagnostics;\n  dispose(): void;\n  readDepthSamples(area: DepthSampleArea): Promise<Float32Array | undefined>;\n}\n/** Explicit execution and composition for one accumulation. */\nexport interface RenderPasses {\n  isFirstFrame(): boolean;\n  /** Discard accumulated samples and any asynchronous denoise output. */\n  restartSamples(): void;\n  trace(camera: Camera, maxSamples: number): boolean;\n  drawPostProcess(): void;\n  /** Apply display-only passes to the last composed image; absent on WebGL. */\n  applyPostProcesses?(passes: readonly PostProcess[], render: Render): void;\n  getOutputTexture?(kind: 'hdr' | 'display'): GPUTexture | undefined;\n  /** Configure deterministic headless batches used by offline frame export. */\n  setOfflineRenderOptions(options: {\n    samplesPerBatch: number;\n    deferPostProcess: boolean;\n    sampleSequenceOffset: number;\n  }): void;\n  /** Store luminance second moments in the normal output during a pilot pass. */\n  setVarianceMoments(enabled: boolean): void;\n  /** Skip pixels once their independent final-pass target has been reached. */\n  setAdaptiveSamplingTargets(targets?: {\n    width: number;\n    height: number;\n    data: Float32Array;\n  }): void;\n  /** Generate final sample targets on GPU; WebGL returns undefined. */\n  prepareOfflineAdaptiveSampling(\n    options: OfflineAdaptiveSamplingOptions\n  ): Promise<OfflineAdaptiveSamplingResult | undefined>;\n  /** Enables extended-range float canvas presentation when the host supports it. */\n  setHDROutputEnabled?(enabled: boolean): boolean;\n  setToneMappingParams(params: ToneMappingParams): boolean;\n  setSize(width: number, height: number): void;\n  /**\n   * Denoises the current image with an explicitly selected built-in or custom filter. Resolves whether the result is now displayed.\n   */\n  performDenoise?(\n    denoiser: DenoiserHandle,\n    alphaDenoiser?: OIDNWeb,\n    schedule?: DenoiseSchedule,\n    signal?: AbortSignal\n  ): Promise<boolean>;\n  /** Drops a denoise in flight; the next draw invalidates its output. */\n  cancelDenoise?(): void;\n  /** Keep the last completed OIDN image visible while static while-converging batches accumulate. */\n  setPreserveDenoisedOutput?(preserve: boolean): void;\n  getTotalSamplesRendered(): number;\n  getDiagnostics(): RenderingDiagnostics;\n  /** Waits for asynchronous timestamp diagnostics without changing samples. */\n  flushDiagnostics(): Promise<void>;\n  setShadowCatcherParams(color: ColorRGB, alpha: number): boolean;\n  setBloomParams(opts: {\n    intensity: number;\n    threshold: number;\n    radius: number;\n  }): boolean;\n  setOnSampleRendered(\n    cb: (sampleCount: number, isFirstFrame: boolean, frameTime: number) => void\n  ): void;\n  setOutput(output: DisplayChannel): boolean;\n  setAovDisplayOptions?(options: import('./aovDisplay.js').AovDisplayOptions): void;\n  dispose(): void;\n  aovReady?(kind: import('./aov.js').AovKind): boolean;\n  /** Updates optional surface outputs without tracing beauty; false while compiling. */\n  refineAovs?(camera: Camera, samples?: number): boolean;\n  restartAovs?(): void;\n  getAovSamples?(): number;\n  readAov?(kind: import('./aov.js').AovKind): Promise<{width: number; height: number; data: Float32Array | Uint32Array}>;\n  readOutput(kind: 'hdr' | 'denoised' | 'albedo' | 'normal'): Promise<{\n    data: Float32Array;\n    width: number;\n    height: number;\n  }>;\n}\n"]}
+{"version":3,"file":"RenderingPipeline.js","sourceRoot":"","sources":["../../src/renderer/RenderingPipeline.ts"],"names":[],"mappings":"AA0LA,OAAO,EAAC,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC","sourcesContent":["import type {SurfaceHit} from './surfaceHit.js';\nimport type {PostProcess} from '../Display.js';\nimport type Render from '../Render.js';\nimport type {DenoiserHandle, OIDNWeb} from './denoiser.js';\nimport type {DenoiseSchedule} from '../Render.js';\nimport type { DepthSampleArea } from './depthQuery.js';\nimport Camera from '../scene/Camera.js';\nimport Mesh from '../scene/Mesh.js';\nimport Geometry from '../scene/Geometry.js';\nimport OpenPBRMaterial from '../scene/OpenPBRMaterial.js';\nimport type { SceneBackground, SceneLight } from '../scene/Scene.js';\nimport type { ColorRGB } from '../types.js';\nimport type { TextureAtlasStats } from './MaterialTable.js';\nimport type {\n  OfflineAdaptiveSamplingOptions,\n  OfflineAdaptiveSamplingResult\n} from './OfflineAdaptiveSampling.js';\n\nexport type ToneMapping =\n  | 'agx'\n  | 'aces'\n  | 'cineon'\n  | 'reinhard'\n  | 'linear';\n\nexport interface ToneMappingParams {\n  /** Linear exposure multiplier. Default `1`. */\n  exposure?: number;\n  /** Display tone mapper. Default `agx`. */\n  toneMapping?: ToneMapping;\n  /** Contrast multiplier. Default `1`. */\n  contrast?: number;\n  /** Saturation multiplier. Default `1`. */\n  saturation?: number;\n  /** Color temperature adjustment in [-1, 1]. Default `0`. */\n  temperature?: number;\n  /** Green/magenta adjustment in [-1, 1]. Default `0`. */\n  tint?: number;\n  /** Vignette strength in [0, 1]. Default `0`. */\n  vignette?: number;\n}\n\nexport type DisplayChannel =\n  | 'final'\n  | 'shadow'\n  | 'albedo'\n  | 'normal'\n  | 'shadowCatcher'\n  | import('./aov.js').AovKind;\n\n/** Primary-ray policy for glTF BLEND materials. */\nexport type AlphaBlendStrategy =\n  | 'stochastic'\n  | 'deterministic-source-over';\n\n/** Generated source measurements for one shader module. */\nexport interface ShaderModuleCompilationDiagnostics {\n  /** Module or pipeline diagnostic label. */\n  label: string;\n  /** Generated shader source size in bytes. */\n  sourceBytes: number;\n  /** Generated shader source line count. */\n  sourceLines: number;\n  /** Stable source-level fingerprint for diagnosing cache-key churn. */\n  sourceFingerprint: string;\n}\n\n/** Compilation measurements for one shader pipeline/program. */\nexport interface ShaderPipelineCompilationDiagnostics {\n  /** Module or pipeline diagnostic label. */\n  label: string;\n  /** Compute entry-point name. */\n  entryPoint: string;\n  /**\n   * Whether this pipeline belongs to the minimum set needed to present a\n   * usable first image. Optional reuse and quality stages are false even\n   * while the current eager compiler still waits for them.\n   */\n  firstFrameRequired: boolean;\n  /** Current compilation state. */\n  status: 'queued' | 'compiling' | 'ready' | 'failed';\n  /** Milliseconds from the start of this pipeline compilation batch. */\n  startedAtMs?: number;\n  /** Milliseconds from the start of this pipeline compilation batch. */\n  endedAtMs?: number;\n  /** Pipeline compilation duration in milliseconds; undefined until completed. */\n  durationMs?: number;\n  /** Number of pipelines compiling when this one started; undefined before start. */\n  concurrentCompilationCount?: number;\n  /** Failure message; undefined without a compilation error. */\n  error?: string;\n}\n\n/** Source generation and asynchronous pipeline compilation measurements. */\nexport interface ShaderCompilationDiagnostics {\n  /** Current compilation state. */\n  status: 'compiling' | 'ready' | 'failed';\n  /** Generated shader source size in bytes. */\n  sourceBytes: number;\n  /** Generated shader source line count. */\n  sourceLines: number;\n  /** Total pipelines in the batch. */\n  pipelineCount: number;\n  /** Number of pipelines successfully completed. */\n  completedPipelineCount: number;\n  /** CPU shader source generation time in milliseconds. */\n  sourceGenerationTimeMs: number;\n  /** Shader module creation time in milliseconds. */\n  moduleCreationTimeMs: number;\n  /** Per-module source measurements. */\n  modules: ShaderModuleCompilationDiagnostics[];\n  /** Per-pipeline timing and status measurements. */\n  pipelines: ShaderPipelineCompilationDiagnostics[];\n  /** Configured pool size, capped to the number of pipelines in this batch. */\n  maximumConcurrentPipelineCount: number;\n  /** Largest number of createComputePipelineAsync calls active at once. */\n  peakConcurrentPipelineCount: number;\n  /** Batch pipeline compilation time in milliseconds; undefined until completed. */\n  pipelineCompilationTimeMs?: number;\n  /** Total batch preparation time in milliseconds; undefined until completed. */\n  totalTimeMs?: number;\n  /** Failure message; undefined without a compilation error. */\n  error?: string;\n}\n\nexport interface RenderingDiagnostics {\n  /** Label of the last complete target presented; undefined before the first image. */\n  presentedTarget?: string;\n  /** Whether the displayed target contains a complete image. Default false. */\n  presentedComplete?: boolean;\n  /** Resident target dimensions and allocated GPU bytes, including denoise resources. */\n  targets?: { label: string; width: number; height: number; bytes: number }[];\n  hdrPresentation?: {\n    requested: boolean;\n    active: boolean;\n    /** Largest encoded RGB component sent to the HDR presentation pass. */\n    peakDisplayValue?: number;\n  };\n  textureAtlas?: TextureAtlasStats;\n  /** Material texture storage selection and estimated payload; driver allocation overhead is excluded. */\n  materialTextures?: {\n    requested: 'atlas' | 'auto';\n    active: 'atlas' | 'bindless';\n    /** Reason auto selected atlas; undefined when no fallback occurred. */\n    fallbackReason?: string;\n    textureCount: number;\n    estimatedBytes: number;\n    scale: number;\n    /** Metadata buffer bytes; zero for atlas. */\n    metadataBytes: number;\n    /** Resource-table slots; zero for atlas. */\n    resourceTableCapacity: number;\n    /** Payload and metadata waiting for previous GPU submissions; zero when none. */\n    retiredBytes: number;\n  };\n  /** Shader compilation measurements: current WebGPU batch or cumulative WebGL programs. */\n  shaderCompilation?: ShaderCompilationDiagnostics;\n  /** Light-selection table summary (WebGPU). */\n  lightSampling?: {\n    emissiveTriangles: number;\n    activeChoices: number;\n    totalWeight: number;\n    domains: Record<\n      'environment' | 'infinite' | 'localAndEmissive',\n      { count: number; weight: number; pmf: number }\n    >;\n  };\n  /** Traversal stack capacities compiled into the current WebGPU shader. */\n  bvh?: {\n    tlasTraversalStackSize?: number;\n    blasTraversalStackSize?: number;\n    /** Last static preparation statistics, excluding queue and WASM loading time. */\n    lastBuild?: { geometryCount: number; bvhTimeMs: number };\n  };\n  gpuTraceTiming?: {\n    /** Last light-tracing batch time in milliseconds. Default undefined until measured. */ causticTimeMs?:number;\n    /** Last photon-map batch time in milliseconds. Default undefined until measured. */ photonMappingTimeMs?:number;\n    /** Photon emission, count, block scan, sum scan and scatter times in milliseconds. Default undefined until measured. */ photonStagesMs?:number[];\n    /** Camera path kernel time in milliseconds. Default undefined until measured. */ pathTracingTimeMs?:number;\n    tileTimeMs: number;\n    tileTimePerSampleMs?: number;\n    estimatedFullFrameTimeMs: number;\n    tileCount: number;\n  };\n}\n\nexport {DEFAULT_BEVEL_SAMPLES, MIN_BEVEL_SAMPLES, MAX_BEVEL_SAMPLES, DEFAULT_DIRECT_LIGHT_CANDIDATES, MIN_DIRECT_LIGHT_CANDIDATES, MAX_DIRECT_LIGHT_CANDIDATES, normalizeDirectLightCandidates, normalizeBevelSamples} from './renderingLimits.js';\n\n/** Shared scene resources; uploaded once per committed revision. */\nexport interface SceneResources {\n  /** Returns true when scene geometry, materials, or instance transforms changed. */\n  setMeshes(meshes: Mesh[], update?: {\n    transforms?: readonly Mesh[];\n    colors?: readonly Mesh[];\n    geometries?: readonly Geometry[];\n    materials?: readonly OpenPBRMaterial[];\n  }): boolean;\n  /** Changes the software memory guard used when packing material textures. */\n  setTextureAtlasBudget(maxBytes: number): boolean;\n  setLights(lights: SceneLight[]): void;\n  setBackground(background?: SceneBackground): void;\n  getDiagnostics(): RenderingDiagnostics;\n  dispose(): void;\n  readDepthSamples(area: DepthSampleArea): Promise<Float32Array | undefined>;\n  pickSurface?(x: number, y: number, aspect?: number): Promise<SurfaceHit | null | undefined>;\n}\n/** Explicit execution and composition for one accumulation. */\nexport interface RenderPasses {\n  isFirstFrame(): boolean;\n  /** Discard accumulated samples and any asynchronous denoise output. */\n  restartSamples(): void;\n  trace(camera: Camera, maxSamples: number): boolean;\n  drawPostProcess(): void;\n  /** Apply display-only passes to the last composed image; absent on WebGL. */\n  applyPostProcesses?(passes: readonly PostProcess[], render: Render, options?: readonly import('../Display.js').PostProcessOptions[], crop?: {width: number; height: number}): void;\n  getAovTexture?(kind: 'diffuseColor' | 'specularColor' | 'depth'): GPUTexture | undefined;\n  getOutputTexture?(kind: 'hdr' | 'display'): GPUTexture | undefined;\n  /** Configure deterministic headless batches used by offline frame export. */\n  setOfflineRenderOptions(options: {\n    samplesPerBatch: number;\n    deferPostProcess: boolean;\n    sampleSequenceOffset: number;\n  }): void;\n  /** Store luminance second moments in the normal output during a pilot pass. */\n  setVarianceMoments(enabled: boolean): void;\n  /** Skip pixels once their independent final-pass target has been reached. */\n  setAdaptiveSamplingTargets(targets?: {\n    width: number;\n    height: number;\n    data: Float32Array;\n  }): void;\n  /** Generate final sample targets on GPU; WebGL returns undefined. */\n  prepareOfflineAdaptiveSampling(\n    options: OfflineAdaptiveSamplingOptions\n  ): Promise<OfflineAdaptiveSamplingResult | undefined>;\n  /** Enables extended-range float canvas presentation when the host supports it. */\n  setHDROutputEnabled?(enabled: boolean): boolean;\n  setToneMappingParams(params: ToneMappingParams): boolean;\n  setSize(width: number, height: number): void;\n  /**\n   * Denoises the current image with an explicitly selected built-in or custom filter. Resolves whether the result is now displayed.\n   */\n  performDenoise?(\n    denoiser: DenoiserHandle,\n    alphaDenoiser?: OIDNWeb,\n    schedule?: DenoiseSchedule,\n    signal?: AbortSignal\n  ): Promise<boolean>;\n  /** Drops a denoise in flight; the next draw invalidates its output. */\n  cancelDenoise?(): void;\n  /** Keep the last completed OIDN image visible while static while-converging batches accumulate. */\n  setPreserveDenoisedOutput?(preserve: boolean): void;\n  getTotalSamplesRendered(): number;\n  getDiagnostics(): RenderingDiagnostics;\n  /** Waits for asynchronous timestamp diagnostics without changing samples. */\n  flushDiagnostics(): Promise<void>;\n  setShadowCatcherParams(color: ColorRGB, alpha: number): boolean;\n  setBloomParams(opts: {\n    intensity: number;\n    threshold: number;\n    radius: number;\n  }): boolean;\n  setOnSampleRendered(\n    cb: (sampleCount: number, isFirstFrame: boolean, frameTime: number) => void\n  ): void;\n  setOutput(output: DisplayChannel): boolean;\n  setAovDisplayOptions?(options: import('./aovDisplay.js').AovDisplayOptions): void;\n  dispose(): void;\n  aovReady?(kind: import('./aov.js').AovKind): boolean;\n  /** Updates optional surface outputs without tracing beauty; false while compiling. */\n  refineAovs?(camera: Camera, samples?: number): boolean;\n  restartAovs?(): void;\n  getAovSamples?(): number;\n  readAov?(kind: import('./aov.js').AovKind): Promise<{width: number; height: number; data: Float32Array | Uint32Array}>;\n  readOutput(kind: 'hdr' | 'denoised' | 'albedo' | 'normal'): Promise<{\n    data: Float32Array;\n    width: number;\n    height: number;\n  }>;\n}\n"]}

package/lib/renderer/TileRender.d.ts

@@ -18,7 +18,7 @@ export declare function makeTileRender(gl?: WebGL2RenderingContext): {
     setDesiredMsPerTile(time: number): void;
     getDesiredMsPerTile(): number;
 };
-export declare function makeTileRenderWithPredict(): {
+export declare function makeTileRenderWithPredict(minimumTileSize?: number): {
     nextTile: () => {
         xIndex: number;
         yIndex: number;
@@ -37,7 +37,7 @@ export declare function makeTileRenderWithPredict(): {
     setMaxTiles(maxTiles: number): void;
     setDesiredMsPerTile(time: number): void;
     needsUpdatePredicting(): void;
-    setLastTraceTime(time: number): void;
+    setLastTraceTime(time: number, timedColumns?: number, timedRows?: number): void;
     getLastTraceTime(): number;
     getDesiredMsPerTile(): number;
 };

package/lib/renderer/TileRender.js

@@ -127,7 +127,7 @@ export function makeTileRender(gl) {
         }
     };
 }
-function getPredictResult(width, height, lastTraceTime, expectFrameTime, tilePixels, maxNumTiles) {
+function getPredictResult(width, height, lastTraceTime, expectFrameTime, tilePixels, maxNumTiles, minimumTileSize, minimumPredictionSize) {
     const maxTileSize = [width, height];
     const rawCount = lastTraceTime > 0 ? expectFrameTime / lastTraceTime : 1;
     // GPU cost is not perfectly linear with tile area: tiny probes include fixed
@@ -148,6 +148,11 @@ function getPredictResult(width, height, lastTraceTime, expectFrameTime, tilePix
         samplesPerFrame *= Math.floor(newTileHeight / maxTileSize[1]);
     }
     newTileHeight = Math.min(newTileHeight, maxTileSize[1]);
+    // A compute dispatch still occupies a whole workgroup when fewer lanes
+    // are active. Splitting below that footprint repeats the fixed kernel cost
+    // and can make timestamp feedback progressively slow down a tiny render.
+    newTileWidth = Math.max(newTileWidth, Math.min(width, Math.max(minimumTileSize, minimumPredictionSize[0])));
+    newTileHeight = Math.max(newTileHeight, Math.min(height, Math.max(minimumTileSize, minimumPredictionSize[1])));
     let newColumns = Math.round(width / newTileWidth);
     let newRows = Math.round(height / newTileHeight);
     newTileWidth = Math.ceil(width / newColumns);
@@ -181,7 +186,56 @@ function getInitialProbeSize(width, height) {
         Math.min(height, Math.max(1, Math.round(Math.sqrt(initialProbePixels / aspectRatio))))
     ];
 }
-export function makeTileRenderWithPredict() {
+// Keep repeated kernel/longest-path cost below one fifth of the sample where
+// possible. If that conflicts with responsiveness, prioritize the tile ceiling.
+const maximumFixedCostShare = 0.2;
+// A throughput-oriented ceiling still leaves over 5x margin below a 2s TDR.
+// This is a prediction, not a guarantee for unusually expensive sample paths.
+const maximumUnattainableTileMs = 350;
+const unattainableBudgetTolerance = 1.1;
+// Nearby grids amplify timestamp noise when extrapolating to zero pixels.
+const minimumAffineAreaChange = 0.2;
+function getUnattainableBudgetGrid(width, height, fixedMs, msPerPixel, minimumTileSize, maxNumTiles, samplesPerFrame) {
+    const areaCost = msPerPixel * width * height;
+    const maxColumns = Math.max(1, Math.floor(width / minimumTileSize));
+    const maxRows = Math.max(1, Math.floor(height / minimumTileSize));
+    // If the fixed cost alone exceeds the ceiling, no subdivision can meet it.
+    // Avoid multiplying an unavoidable stall by an ever-growing tile count.
+    const required = fixedMs < maximumUnattainableTileMs
+        ? Math.ceil(areaCost / (maximumUnattainableTileMs - fixedMs)) : 1;
+    const minimumTiles = clamp(required, 1, maxColumns * maxRows);
+    let fewest;
+    let withinBoth;
+    const better = (candidate, best) => !best || candidate.count < best.count ||
+        (candidate.count === best.count &&
+            Math.abs(candidate.columns - candidate.rows) < Math.abs(best.columns - best.rows));
+    for (let columns = 1; columns <= Math.min(maxColumns, minimumTiles); columns++) {
+        const rows = Math.ceil(minimumTiles / columns);
+        if (rows > maxRows)
+            continue;
+        const count = columns * rows, candidate = { columns, rows, count };
+        if (better(candidate, fewest))
+            fewest = candidate;
+        const tileMs = fixedMs + areaCost / count;
+        const fixedShare = count * fixedMs / (count * fixedMs + areaCost);
+        if (tileMs <= maximumUnattainableTileMs && fixedShare <= maximumFixedCostShare &&
+            better(candidate, withinBoth))
+            withinBoth = candidate;
+    }
+    // Fewer tiles also minimize fixed cost. If even the fewest grid that meets
+    // the ceiling exceeds the share limit, no grid can satisfy both constraints.
+    let { columns, rows, count: numTiles } = (withinBoth ?? fewest);
+    if (numTiles > maxNumTiles) {
+        // Preserve the existing rectangular rounding of the public maxTiles cap.
+        numTiles = maxNumTiles;
+        columns = Math.ceil(Math.sqrt(numTiles));
+        rows = Math.ceil(numTiles / columns);
+        numTiles = columns * rows;
+    }
+    return { columns, rows, numTiles, tileWidth: Math.ceil(width / columns),
+        tileHeight: Math.ceil(height / rows), samplesPerFrame };
+}
+export function makeTileRenderWithPredict(minimumTileSize = 1) {
     let numTiles = 1;
     let currentTile = -1;
     let lastTraceTime = -1;
@@ -202,6 +256,18 @@ export function makeTileRenderWithPredict() {
     let columns = 0;
     let rows = 0;
     let maxNumTiles = Infinity;
+    // Validate a refinement against the grid that motivated it. A smaller
+    // dispatch can retain most of the longest path / fixed kernel cost.
+    let refinement;
+    let minimumPredictionSize = [0, 0];
+    let lastMeasurement;
+    let unattainableGrid;
+    function clearPredictionEvidence() {
+        refinement = undefined;
+        minimumPredictionSize = [0, 0];
+        lastMeasurement = undefined;
+        unattainableGrid = undefined;
+    }
     function nextTile() {
         currentTile++;
         const avgTileTime = lastFrameTraceTimeValidCount > 0
@@ -212,7 +278,48 @@ export function makeTileRenderWithPredict() {
         }
         if (currentTile === 0 && timingRevision !== appliedTimingRevision) {
             appliedTimingRevision = timingRevision;
-            const result = getPredictResult(width, height, avgTileTime, expectFrameTime, lastTraceTime >= 0 ? tilePixels : getInitialProbeSize(width, height), maxNumTiles);
+            const measured = lastFrameTraceTimeValidCount > 0;
+            let rollback;
+            if (measured && refinement) {
+                const areaRatio = refinement.grid.numTiles / numTiles;
+                // Require at least half of the area-proportional improvement, unless
+                // the new tile already fits the budget (with 10% timing tolerance).
+                if (avgTileTime > expectFrameTime * 1.1 &&
+                    avgTileTime > refinement.time * (1 - (1 - areaRatio) * 0.5)) {
+                    rollback = refinement;
+                    minimumPredictionSize = [rollback.grid.tileWidth, rollback.grid.tileHeight];
+                }
+                refinement = undefined;
+            }
+            let result = rollback?.grid ?? getPredictResult(width, height, avgTileTime, expectFrameTime, lastTraceTime >= 0 ? tilePixels : getInitialProbeSize(width, height), maxNumTiles, minimumTileSize, minimumPredictionSize);
+            if (measured && columns > 0 && rows > 0 && !unattainableGrid) {
+                // Use nominal covered area, rather than ceil-rounded dispatch bounds:
+                // the interleaved grid covers every pixel exactly once per sample.
+                const point = { area: width * height / numTiles, time: avgTileTime };
+                if (lastMeasurement && Math.abs(point.area - lastMeasurement.area) >=
+                    minimumAffineAreaChange * Math.max(point.area, lastMeasurement.area)) {
+                    const slope = (point.time - lastMeasurement.time) / (point.area - lastMeasurement.area);
+                    const fixed = point.time - slope * point.area;
+                    if (Number.isFinite(slope) && slope > 0 && Number.isFinite(fixed) &&
+                        fixed >= expectFrameTime * unattainableBudgetTolerance) {
+                        unattainableGrid = getUnattainableBudgetGrid(width, height, fixed, slope, minimumTileSize, maxNumTiles, result.samplesPerFrame);
+                    }
+                }
+                lastMeasurement = point;
+            }
+            if (unattainableGrid) {
+                // Retain the decision until explicit invalidation. Re-fitting on its
+                // own probe/target grids can alternate counts as path costs fluctuate.
+                // Keep the original samplesPerFrame calculation independent of this policy.
+                result = { ...unattainableGrid, samplesPerFrame: result.samplesPerFrame };
+                refinement = undefined;
+            }
+            if (!unattainableGrid && !rollback && measured && result.numTiles > numTiles) {
+                refinement = {
+                    grid: { tileWidth, tileHeight, columns, rows, numTiles, samplesPerFrame },
+                    time: avgTileTime
+                };
+            }
             lastFrameTotalTraceTime = 0;
             lastFrameTraceTimeValidCount = 0;
             tileWidth = result.tileWidth;
@@ -246,28 +353,42 @@ export function makeTileRenderWithPredict() {
             currentTile = -1;
         },
         setSize(w, h) {
-            if (width !== w || height !== h)
+            if (width !== w || height !== h) {
                 timingRevision++;
+                clearPredictionEvidence();
+                lastTraceTime = -1;
+                lastFrameTotalTraceTime = 0;
+                lastFrameTraceTimeValidCount = 0;
+            }
             width = w;
             height = h;
         },
         setMaxTiles(maxTiles) {
-            if (maxNumTiles !== maxTiles)
+            if (maxNumTiles !== maxTiles) {
                 timingRevision++;
+                clearPredictionEvidence();
+            }
             maxNumTiles = maxTiles;
         },
         setDesiredMsPerTile(time) {
-            if (expectFrameTime !== time)
+            if (expectFrameTime !== time) {
                 timingRevision++;
+                clearPredictionEvidence();
+            }
             expectFrameTime = time;
         },
         needsUpdatePredicting() {
+            clearPredictionEvidence();
             timingRevision++;
             lastTraceTime = -1;
             lastFrameTotalTraceTime = 0;
             lastFrameTraceTimeValidCount = 0;
         },
-        setLastTraceTime(time) {
+        setLastTraceTime(time, timedColumns = columns, timedRows = rows) {
+            // A timestamp can arrive after the next sample changed the grid. Only
+            // compare measurements of the grid currently being evaluated.
+            if (timedColumns !== columns || timedRows !== rows || !Number.isFinite(time) || time <= 0)
+                return;
             timingRevision++;
             lastTraceTime = time;
             lastFrameTraceTimeValidCount++;