@meimu/mutracer 0.1.4 → 0.2.0

package/lib/renderer/WGPURenderingPipeline.js

@@ -1,9 +1,16 @@
+import { hdrResolveWGSL } from './wgsl/compose.frag.wgsl.js';
+import { oidnAuxiliaryDefine } from './wgsl/oidnAuxiliary.wgsl.js';
+import { displayAovKind, DEFAULT_AOV_DISPLAY } from './aovDisplay.js';
+import { WGPUAov } from './WGPUAov.js';
+import { aovMask } from './aov.js';
+import { scheduleFrame } from '../util/frame.js';
 import { DisplayPostProcess } from './DisplayPostProcess.js';
 import { customDenoiseLayersMain, customDenoiseCoverageMain } from './wgsl/customDenoise.wgsl.js';
 import { WGPUCanvasSurface } from './WGPUCanvasSurface.js';
 import { WGPUScratchBuffer } from './WGPUScratchBuffer.js';
 import { WGPUScratchTexture } from './WGPUScratchTexture.js';
 import { ScratchPool } from './ScratchPool.js';
+import { GPUTraceQueue } from './GPUTraceQueue.js';
 import { makeRenderPipeline } from './renderPipeline.js';
 import { textureBytes } from './gpuMemory.js';
 import { WGPUFullQuadPass } from './WGPUFullQuadPass.js';
@@ -21,54 +28,44 @@ export const oidnAlbedoSrgbEncodeMain = /* wgsl */ `
 if (globalId.x >= u32(imageSize.x) || globalId.y >= u32(imageSize.y)) { return; }
 let index = globalId.x + globalId.y * u32(imageSize.x);
 let raw = textureLoad(in_albedo, vec2u(globalId.xy), 0);
-let linear = clamp(raw.rgb, vec3f(0.0), vec3f(1.0));
-let encoded = select(
-1.055 * pow(linear, vec3f(1.0 / 2.4)) - 0.055,
-12.92 * linear,
-linear <= vec3f(0.0031308)
-);
+let encoded = sT(raw.rgb);
 out_albedo[index] = vec4f(encoded, raw.a);
 `;
 export const oidnAlbedoSrgbDecodeMain = /* wgsl */ `
 if (globalId.x >= u32(imageSize.x) || globalId.y >= u32(imageSize.y)) { return; }
 let index = globalId.x + globalId.y * u32(imageSize.x);
 let filtered = in_albedo[index];
-let encoded = clamp(filtered.rgb, vec3f(0.0), vec3f(1.0));
-let linear = select(
-pow((encoded + 0.055) / 1.055, vec3f(2.4)),
-encoded / 12.92,
-encoded <= vec3f(0.04045)
-);
+let linear = sS(filtered.rgb);
 var result = linear;
-let jg = textureLoad(in_rawAlbedo, vec2i(globalId.xy), 0).a;
+let jD = textureLoad(in_rawAlbedo, vec2i(globalId.xy), 0).a;
 if (preserveSurfaceTexture != 0u) {
 
 
 
-let fP = vec2i(globalId.xy);
-let center = textureLoad(in_rawNormal, fP, 0);
+let pixel = vec2i(globalId.xy);
+let center = textureLoad(in_rawNormal, pixel, 0);
 let n = normalize(center.rgb * 2.0 - 1.0 + vec3f(1e-8));
-var ng = 0.0;
+var oc = 0.0;
 for (var y = -1; y <= 1; y++) {
 for (var x = -1; x <= 1; x++) {
-let tV = textureLoad(in_rawNormal,
-clamp(fP + vec2i(x, y), vec2i(0), imageSize - 1), 0);
-let nn = normalize(tV.rgb * 2.0 - 1.0 + vec3f(1e-8));
-ng = max(ng,
-max(1.0 - dot(n, nn), abs(center.a - tV.a)));
+let vw = textureLoad(in_rawNormal,
+clamp(pixel + vec2i(x, y), vec2i(0), imageSize - 1), 0);
+let nn = normalize(vw.rgb * 2.0 - 1.0 + vec3f(1e-8));
+oc = max(oc,
+max(1.0 - dot(n, nn), abs(center.a - vw.a)));
 }
 }
-let un = smoothstep(0.02, 0.1, ng);
-let raw = clamp(textureLoad(in_rawAlbedo, fP, 0).rgb,
+let vO = smoothstep(0.02, 0.1, oc);
+let raw = clamp(textureLoad(in_rawAlbedo, pixel, 0).rgb,
 vec3f(0.0), vec3f(1.0));
-result = mix(raw, linear, un);
+result = mix(raw, linear, vO);
 }
-out_albedo[index] = vec4f(result, jg);
+out_albedo[index] = vec4f(result, jD);
 `;
 export const oidnNormalSanitizeMain = /* wgsl */ `
 if (globalId.x >= u32(imageSize.x) || globalId.y >= u32(imageSize.y)) { return; }
 let index = globalId.x + globalId.y * u32(imageSize.x);
-out_normal[index] = vec4f(clamp(in_normal[index].rgb, vec3f(0.0), vec3f(1.0)), 1.0);
+out_normal[index] = vec4f(rL(in_normal[index].rgb), 1.0);
 `;
 function createTimeQuery(device) {
     try {
@@ -95,17 +92,25 @@ function createTimeQuery(device) {
         return undefined;
     }
 }
-function makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scratch, customJobs) {
+function makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scratch, customJobs, traceQueue) {
     let sampleRenderedCallback = () => { };
-    let allowMultipleSamplesPerFrame = false;
+    let batchSamples = false;
+    let realtimeBatchBudgetMs = Infinity;
+    // Samples traced between display frames skip the resolve and composition;
+    // the next presentation or read resolves them once.
+    let realtimeDeferPostProcess = false;
+    let postProcessPending = false;
     let offlineSamplesPerBatch = 0;
     let deferPostProcess = false;
     let sampleSequenceOffset = 0;
+    const aov = new WGPUAov(device);
+    let aovCamera;
     let sampleCount = 0;
     let elapsedFrameTime = 32;
     let elapsedTileTime;
     let tileTimingGeneration = 0;
     let lastGpuTraceTiming;
+    let displayTrace;
     let diagnosticsReadbackPromise = Promise.resolve();
     let isFirstFrame = true;
     let disposed = false;
@@ -127,6 +132,8 @@ function makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scrat
     let denoiseValid = false;
     let maxTimePerTile = 21;
     let bloomIntensity = 0;
+    // Sample count of this accumulation's last bloom refresh.
+    let bloomSamples = 0;
     let bloomThreshold = 1;
     let bloomRadius = 0.6;
     let exposure = 1;
@@ -139,6 +146,7 @@ function makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scrat
     let hdrOutputRequested = false;
     let hdrOutputActive = false;
     let output = 'final';
+    let aovDisplayOptions = DEFAULT_AOV_DISPLAY;
     let shadowCatcherColor = vec3.create();
     let shadowCatcherAlpha = 1;
     let pageLeaveTime = performance.now();
@@ -248,12 +256,14 @@ function makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scrat
         inputs: ['colorTex', 'coverageTex'],
         outputs: ['color'],
         uniforms: [{ label: 'flatBackgroundColor', type: 'vec4f', data: [0, 0, 0, 0] }],
+        fsDefine: hdrResolveWGSL,
         fsMain: /* wgsl */ `
 var color = load_colorTex(uv, 0);
 let coverage = clamp(load_coverageTex(uv, 0).a, 0.0, 1.0);
-if (flatBackgroundColor.a > 0.5 && coverage > 0.0) {
-color = vec4f(color.rgb * coverage, color.a);
-}
+color = vec4f(
+jQ(color.r, coverage, flatBackgroundColor.a > 0.5, true),
+jQ(color.g, coverage, flatBackgroundColor.a > 0.5, true),
+jQ(color.b, coverage, flatBackgroundColor.a > 0.5, true), color.a);
 output.color = color;
 `
     }));
@@ -337,7 +347,6 @@ output.color = color;
         fsMain: compositeDenoiseDisplayMain,
         fsDefine: linearToSrgbDefine,
         uniforms: [
-            { label: 'hdrOutputEnabled', type: 'f32', data: 0 },
             { label: 'denoisedAlpha', type: 'f32', data: 0 }
         ],
         outputs: ['color'], inputs: ['colorTex', 'composedTex']
@@ -354,6 +363,7 @@ output.color = color;
         inputs: ['albedo'],
         outputs: ['albedo'],
         uniforms: auxiliaryPassUniforms,
+        csDefine: oidnAuxiliaryDefine,
         csMain: oidnAlbedoSrgbEncodeMain
     }));
     const oidnAlbedoDecodePass = scratch.get('oidnAlbedoDecodePass', () => new WGPUComputePass('OIDN albedo sRGB decode', device, {
@@ -362,12 +372,14 @@ output.color = color;
         uniforms: [...auxiliaryPassUniforms, {
                 label: 'preserveSurfaceTexture', type: 'u32', data: 0
             }],
+        csDefine: oidnAuxiliaryDefine,
         csMain: oidnAlbedoSrgbDecodeMain
     }));
     const oidnNormalSanitizePass = scratch.get('oidnNormalSanitizePass', () => new WGPUComputePass('OIDN normal sanitize', device, {
         inputs: ['normal'],
         outputs: ['normal'],
         uniforms: auxiliaryPassUniforms,
+        csDefine: oidnAuxiliaryDefine,
         csMain: oidnNormalSanitizeMain
     }));
     oidnAlbedoEncodePass.setOutputParams({ albedo: { channels: 4 } });
@@ -375,11 +387,11 @@ output.color = color;
     oidnNormalSanitizePass.setOutputParams({ normal: { channels: 4 } });
     const outputPass = scratch.get('outputPass', () => new WGPUFullQuadPass('output', device, {
         fsMain: /* wgsl */ `
-let vM = min(
+let xs = min(
 vec2i(uv2 * vec2f(colorTexRegion())),
 vec2i(colorTexRegion()) - vec2i(1)
 );
-var color = load_colorTex(vM, 0);
+var color = load_colorTex(xs, 0);
 color = vec4(color.rgb * color.a, color.a);
 output.color = color;
 `,
@@ -498,7 +510,6 @@ output.color = color;
         composePass.setUniform('shadowCatcherAlpha', shadowCatcherAlpha);
         compositeDenoiseDisplayPass.setSize(renderWidth, renderHeight);
         compositeDenoiseDisplayPass.setOutputParams({ color: { format: composeColorFormat } });
-        compositeDenoiseDisplayPass.setUniform('hdrOutputEnabled', +hdrOutputActive);
         compositeDenoiseDisplayPass.setUniform('denoisedAlpha', denoiseValid && denoisedDisplayLinear ? +rayTracePass.needsDenoiseAlpha() : 0);
     }
     function snapshotInput(encoder, key, texture, exact = false) {
@@ -529,6 +540,15 @@ output.color = color;
         }
         composePass.setUniform('flatBackgroundColor', resolvedFlatBackground);
         rawOutputPass.setUniform('flatBackgroundColor', resolvedFlatBackground);
+        const aovKind = displayAovKind(output);
+        if (aovKind && sampleCount === 0) {
+            if (!execution?.aovs?.includes(aovKind))
+                throw new Error(`AOV ${aovKind} is not enabled`);
+            if (!aov.samples)
+                return;
+            finishPresentation(encoder, aov.visualize(aovKind, aovDisplayOptions, hdrOutputActive));
+            return;
+        }
         if (resolvedSamples < 1)
             return;
         prepareComposition();
@@ -550,17 +570,18 @@ output.color = color;
             }));
             layers.setOutputParams({ foreground: { format: 'rgba32float' }, background: { format: 'rgba32float' } });
             layers.setSize(renderWidth, renderHeight);
+            displayTrace?.push('CorrectLayers:SceneLinear');
             layers.createPass(encoder, { originalTex: getFrameInput('color'), filteredTex: denoisedTexture,
                 foregroundTex: foregroundTexture, backgroundTex: catcherBackgroundTexture });
             foregroundTexture = layers.getOutput('foreground');
             catcherBackgroundTexture = layers.getOutput('background');
         }
         const bloomEnabled = bloomIntensity > 0.0;
-        // Progressive accumulation refreshes bloom every ten samples.
-        const samplesSkipped = sampleCount < 10 || sampleCount % 10 > 0;
+        // Progressive accumulation refreshes bloom after every ten new samples,
+        // including when several samples are resolved at once.
         const bloomState = scratch.get('bloom state', () => ({ owner: undefined, settings: '', dispose() { } }));
         const bloomSettings = `${bloomThreshold}/${bloomRadius}/${+(denoiseValid && denoisedHDR)}`;
-        const needsUpdateBloom = bloomEnabled && sampleCount >= 10 && (!samplesSkipped || bloomState.owner !== targetKey || bloomState.settings !== bloomSettings);
+        const needsUpdateBloom = bloomEnabled && sampleCount >= 10 && (sampleCount - bloomSamples >= 10 || bloomState.owner !== targetKey || bloomState.settings !== bloomSettings);
         let bloomIntensityToUpdate = bloomIntensity;
         if (needsUpdateBloom) {
             if (!bloomPass) {
@@ -570,14 +591,17 @@ output.color = color;
             bloomPass.setSize(renderWidth, renderHeight);
             bloomState.owner = targetKey;
             bloomState.settings = bloomSettings;
+            bloomSamples = sampleCount;
             bloomPass.setBrightThreshold(bloomThreshold);
             bloomPass.setRadius(bloomRadius);
+            displayTrace?.push('Bloom:SceneLinear');
             bloomPass.createPass(encoder, colorTexture);
         }
         else if (bloomEnabled && sampleCount < 10) {
             bloomIntensityToUpdate = 0;
         }
         composePass.setUniform('bloomIntensity', bloomIntensityToUpdate);
+        displayTrace?.push('Compose:DisplayLinear+DisplayEncoded');
         composePass.createPass(encoder, {
             colorTex: colorTexture,
             foregroundTex: foregroundTexture,
@@ -588,6 +612,7 @@ output.color = color;
             bloomTex: bloomEnabled && bloomPass ? bloomPass.getOutput() : colorTexture
         });
         if (denoiseValid && !denoisedHDR && denoisedDisplayLinear && denoisedTexture) {
+            displayTrace?.push('Encode:DisplayEncoded');
             compositeDenoiseDisplayPass.createPass(encoder, {
                 colorTex: denoisedTexture,
                 composedTex: composePass.getOutput('denoiseColor')
@@ -596,14 +621,24 @@ output.color = color;
         let displayTexture = (denoiseValid && denoisedBuffer ? (denoisedHDR ? composePass.getOutput('color') : denoisedDisplayLinear
             ? compositeDenoiseDisplayPass.getOutput('color') : denoisedTexture) : undefined) ||
             composePass.getOutput('color');
+        if (aovKind) {
+            if (!execution?.aovs?.includes(aovKind))
+                throw new Error(`AOV ${aovKind} is not enabled`);
+            displayTexture = aov.visualize(aovKind, aovDisplayOptions, hdrOutputActive);
+        }
+        finishPresentation(encoder, displayTexture);
+    }
+    function finishPresentation(encoder, displayTexture) {
         const activeHDRPeakMeter = hdrOutputActive
             ? (hdrPeakMeter ??= scratch.get('hdrPeak', () => new WGPUHDRPeakMeter(device)))
             : undefined;
         const hdrPeakReadbackSubmitted = activeHDRPeakMeter?.encode(encoder, displayTexture, renderWidth, renderHeight) ?? false;
         if (output === 'normal' || output === 'albedo') {
+            displayTrace?.push('AOV:Raw');
             displayTexture = getFrameInput(output);
         }
         else if (output === 'shadowCatcher') {
+            displayTrace?.push('AOV:Raw');
             displayTexture = getFrameInput('shadowCatcher');
         }
         if (displayTexture.width < renderWidth || displayTexture.height < renderHeight) {
@@ -632,6 +667,12 @@ output.color = color;
             void activeHDRPeakMeter?.resolve();
         }
     }
+    function flushPostProcess() {
+        if (!postProcessPending)
+            return;
+        postProcessPending = false;
+        drawPostProcess(device.createCommandEncoder(), false, true);
+    }
     function trace(camera, maxSamples) {
         // A call to draw means accumulation has been invalidated. Cancel OIDN
         // before checking shader compilation: pipeline-affecting parameter changes
@@ -645,8 +686,13 @@ output.color = color;
         }
         // Update the camera before compiling and sampling.
         rayTracePass.setCamera(camera);
+        aovCamera = camera;
         const resetAccumulation = isFirstFrame;
+        if (resetAccumulation)
+            aov.reset();
         if (resetAccumulation) {
+            postProcessPending = false;
+            bloomSamples = 0;
             denoiseValid = false;
             tileTimingGeneration++;
             elapsedTileTime = undefined;
@@ -662,6 +708,8 @@ output.color = color;
             sampleCount = 0;
             return true;
         }
+        if (execution?.aovs?.length && !rayTracePass.prepareAovs(execution.aovs))
+            return true;
         // Keep the last completed denoise visible while a static while-converging batch
         // accumulates, including the incomplete first sample after a scene edit.
         if (!preserveDenoisedOutput || isFirstFrame) {
@@ -687,16 +735,32 @@ output.color = color;
             needsUpdatePredicting = false;
         }
         const frameSampleCount = sampleCount;
+        const sampleTimeMs = lastGpuTraceTiming?.estimatedFullFrameTimeMs;
+        const realtime = offlineSamplesPerBatch === 0 && batchSamples;
+        const realtimeBudget = Math.min(maxTimePerTile, realtimeBatchBudgetMs);
+        if (realtime && !resetAccumulation && !isPredictingFrame && sampleTimeMs !== undefined &&
+            traceQueue.available(realtimeBudget) < Math.min(sampleTimeMs, realtimeBudget))
+            return false;
+        // Only batch a measured, unchanged full-frame workload. New cameras get
+        // their first sample immediately; expensive samples retain tiled execution.
+        const realtimeBatch = realtime && sampleCount > 0 &&
+            !resetAccumulation && !isPredictingFrame && lastGpuTraceTiming?.tileCount === 1 && sampleTimeMs !== undefined &&
+            sampleTimeMs <= realtimeBudget / 2;
+        const realtimeSamples = realtimeBatch
+            ? Math.min(64, Math.floor(traceQueue.available(realtimeBudget) / sampleTimeMs)) : 1;
+        if (realtimeBatch && realtimeSamples === 0)
+            return false;
+        const batchStarted = performance.now();
         _startRecordFrameTime(!resetAccumulation);
         const renderSampleTarget = maxSamples;
-        const batchTarget = Math.min(renderSampleTarget, sampleCount + Math.max(offlineSamplesPerBatch, 1));
+        const batchTarget = Math.min(renderSampleTarget, sampleCount + (offlineSamplesPerBatch > 0 ? offlineSamplesPerBatch : realtimeSamples));
         do {
             let { xIndex, yIndex, columns, rows, isFirstTile, isLastTile, samplesPerFrame } = (tileRenderWithPredict || tileRender).nextTile(elapsedTileTime);
             rayTraceOutputPass.setSampleTileGrid(columns, rows);
-            if (offlineSamplesPerBatch > 0 && columns * rows === 1) {
+            if ((offlineSamplesPerBatch > 0 || realtimeBatch) && columns * rows === 1) {
                 samplesPerFrame = batchTarget - sampleCount;
             }
-            else if (!allowMultipleSamplesPerFrame) {
+            else if (!batchSamples) {
                 samplesPerFrame = 1;
             }
             if (columns * rows === 1) {
@@ -708,11 +772,21 @@ output.color = color;
                     sample(sampleCount === 0, [1, 1]);
                     sampleCount++;
                     samplesSubmitted++;
+                    if (realtime && !isPredictingFrame && sampleTimeMs !== undefined)
+                        traceQueue.track(sampleTimeMs);
+                    if (realtimeBatch) {
+                        // Encoding many tiny samples must also leave the main thread free
+                        // to receive camera input. Yield before encoding another batch.
+                        if (performance.now() - batchStarted >= 4)
+                            break;
+                    }
                 }
             }
             else {
                 rayTracePass.setSampleTiles(columns, rows, xIndex, yIndex);
                 sample(sampleCount === 0 && isFirstTile, [columns, rows]);
+                if (realtime && !isPredictingFrame && sampleTimeMs !== undefined)
+                    traceQueue.track(sampleTimeMs / (columns * rows));
                 if (isLastTile)
                     sampleCount++;
             }
@@ -727,7 +801,14 @@ output.color = color;
             sampleCount = 0;
             return false;
         }
-        if (sampleCount !== frameSampleCount && (!deferPostProcess || sampleCount >= renderSampleTarget)) {
+        if (sampleCount !== frameSampleCount && execution?.aovs?.length) {
+            rayTracePass.renderAovs(aov, camera, sampleCount, execution.aovSamples ?? 16, execution.aovs);
+        }
+        if (sampleCount !== frameSampleCount && realtime && realtimeDeferPostProcess && sampleCount < renderSampleTarget) {
+            postProcessPending = true;
+        }
+        else if (sampleCount !== frameSampleCount && (!deferPostProcess || sampleCount >= renderSampleTarget)) {
+            postProcessPending = false;
             const encoder = device.createCommandEncoder();
             drawPostProcess(encoder, sampleCount >= renderSampleTarget, true);
         }
@@ -856,7 +937,6 @@ output.color = color;
             hdrPeakMeter?.reset();
         }
         compositeDenoiseDisplayPass.setOutputParams({ color: { format: composeColorFormat } });
-        compositeDenoiseDisplayPass.setUniform('hdrOutputEnabled', hdrOutputActive ? 1 : 0);
         composePass.setUniform('hdrOutputEnabled', hdrOutputActive ? 1 : 0);
         return wasActive !== hdrOutputActive;
     }
@@ -893,6 +973,7 @@ output.color = color;
         jnlmPass ??= scratch.get('jnlm', () => new WGPUJNLMDenoisePass(device));
         const rayBuffers = rayTracePass.getOutputBuffer();
         const encoder = device.createCommandEncoder({ label: 'JNLM denoise' });
+        displayTrace?.push('Denoise:DisplayLinear');
         const output = jnlmPass.encode(encoder, {
             width: renderWidth,
             height: renderHeight,
@@ -917,7 +998,7 @@ output.color = color;
             return completed;
         });
     }
-    function performCustomDenoise(denoiser, schedule, signal) {
+    function performCustomDenoise(denoiser, schedule, signal, requestedAovs = []) {
         const generation = denoiseGeneration;
         const controller = activeCustomController = new AbortController();
         const abort = () => controller.abort();
@@ -932,7 +1013,15 @@ output.color = color;
             const albedo = copyGuide('Custom albedo', getFrameInput('albedo'), true);
             const normal = copyGuide('Custom normal', getFrameInput('normal'), true);
             const output = scratch.get('Custom output', () => new WGPUScratchBuffer(device)).get(width * height * 16, true);
-            await denoiser.denoise({ device, width, height, color, albedo, normal, output }, { signal: controller.signal, schedule });
+            const aovs = requestedAovs.length ? aov.snapshot(requestedAovs) : undefined;
+            displayTrace?.push('Denoise:SceneLinear');
+            try {
+                await denoiser.denoise({ device, width, height, color, albedo, normal, output, aovs }, { signal: controller.signal, schedule });
+            }
+            finally {
+                if (aovs)
+                    void device.queue.onSubmittedWorkDone().catch(() => undefined).then(() => aov.releaseSnapshot(aovs));
+            }
             if (controller.signal.aborted || disposed || generation !== denoiseGeneration)
                 return false;
             const coverage = scratch.get('custom coverage', () => new WGPUComputePass('Custom coverage', device, {
@@ -965,8 +1054,11 @@ output.color = color;
         cancelDenoise();
         if (isFirstFrame || sampleCount < 1)
             return Promise.resolve(false);
+        if (output !== 'final' && output !== 'shadow')
+            return Promise.resolve(true);
+        flushPostProcess();
         if (attachedDenoiser.kind === 'custom')
-            return performCustomDenoise(attachedDenoiser.denoiser, denoiseSchedule, signal);
+            return performCustomDenoise(attachedDenoiser.denoiser, denoiseSchedule, signal, attachedDenoiser.aovs);
         denoisedHDR = false;
         if (attachedDenoiser.kind === 'jnlm')
             return performJNLMDenoise(attachedDenoiser.denoiser);
@@ -991,7 +1083,7 @@ output.color = color;
                 wholeImage: denoiseSchedule === 'every-sample'
             } : {}),
             // A preview frame is one whole-image pass. Settled images can take many
-            // tiles; oidn-web 0.5 runs those back to back by default, which starves
+            // tiles; oidn-webgpu runs those back to back by default, which starves
             // the page at 4K, so pace them to display frames instead.
             scheduling: denoiseSchedule === 'every-sample' ? 'event-loop' : 'animation-frame'
         };
@@ -1081,6 +1173,7 @@ output.color = color;
                 return Promise.resolve();
             // Snapshot the complete raw composition; never feed a previous denoise
             // back into the network during progressive updates.
+            displayTrace?.push('Denoise:DisplayLinear');
             return runOIDNPhase(generation, (finish, fail) => denoiser.tileExecute({
                 ...convergingTileOptions,
                 color: { data: colorInput, ...size },
@@ -1189,6 +1282,7 @@ output.color = color;
             diagnosticsReadbackPromise
         ]).then(() => {
             rayTracePass.releaseTarget(targetKey);
+            aov.dispose();
             denoisedBuffer?.destroy();
             presentationTexture?.destroy();
             displayPostProcess.dispose();
@@ -1215,9 +1309,26 @@ output.color = color;
             const timingKeys = ['bounces', 'bevel', 'bevelSamples', 'directLightCandidates', 'dispersionWavelengths', 'alphaBlendStrategy', 'samplingPattern', 'clamping', 'transmissiveOutputAlphaMin'];
             if (!execution || timingKeys.some(key => execution[key] !== settings[key]))
                 invalidateTilePrediction();
-            execution = { ...settings };
+            if (settings.aovs?.length && (!Number.isInteger(settings.aovSamples ?? 16) || (settings.aovSamples ?? 16) < 1))
+                throw new RangeError('aovSamples must be a positive integer');
+            const previousMask = aovMask(execution?.aovs ?? []), nextMask = aovMask(settings.aovs ?? []);
+            if (previousMask !== nextMask || execution?.aovSamples !== settings.aovSamples)
+                aov.samples = 0;
+            execution = { ...settings, aovs: [...(settings.aovs ?? [])] };
+            // Presentation may still name the previous preview's AOV. Drop that
+            // selection before tracing with a smaller set; Display validates and
+            // reapplies the current channel when the new image is presented.
+            const displayedAov = displayAovKind(output);
+            if (displayedAov && !settings.aovs?.includes(displayedAov))
+                output = 'final';
+            if (previousMask && !nextMask) {
+                aov.dispose();
+                aov.history.clear();
+                aov.width = aov.height = 0;
+                aov.reset();
+            }
             maxTimePerTile = Math.max(1, settings.timeBudgetMs);
-            allowMultipleSamplesPerFrame = settings.allowMultipleSamplesPerFrame;
+            batchSamples = settings.batchSamples;
             tileRender.setDesiredMsPerTile(maxTimePerTile);
             tileRender.setMaxTiles(settings.maxTiles);
             tileRenderWithPredict?.setDesiredMsPerTile(maxTimePerTile);
@@ -1228,6 +1339,10 @@ output.color = color;
         canCompleteSampleWithin(timeBudgetMs) {
             return (lastGpuTraceTiming?.estimatedFullFrameTimeMs ?? elapsedFrameTime) <= timeBudgetMs;
         },
+        setRealtimeBatchBudget(milliseconds) { realtimeBatchBudgetMs = milliseconds; },
+        setRealtimeDeferPostProcess(defer) { realtimeDeferPostProcess = defer; },
+        getRealtimeSampleTime() { return lastGpuTraceTiming?.tileCount === 1 ? lastGpuTraceTiming.estimatedFullFrameTimeMs : undefined; },
+        whenTraceAvailable() { return traceQueue.whenAvailable(); },
         get presentationComplete() { return !!presentationTexture; },
         get presentationDenoised() { return presentationDenoised; },
         present() {
@@ -1242,13 +1357,14 @@ output.color = color;
         getMemory() {
             return {
                 width: renderWidth, height: renderHeight,
-                bytes: rayTracePass.getTargetMemoryBytes(targetKey) + rayTraceOutputPass.getMemoryBytes() + textureBytes(presentationTexture) + displayPostProcess.getMemoryBytes() + (denoisedBuffer?.size ?? 0)
+                bytes: aov.bytes + rayTracePass.getTargetMemoryBytes(targetKey) + rayTraceOutputPass.getMemoryBytes() + textureBytes(presentationTexture) + displayPostProcess.getMemoryBytes() + (denoisedBuffer?.size ?? 0)
             };
         },
         isFirstFrame() {
             return isFirstFrame;
         },
         restartSamples() {
+            aov.reset();
             // Input edits reset accumulation, not learned throughput. Re-arming a
             // hidden probe here starves continuously changing scenes of visible samples.
             tileTimingGeneration++;
@@ -1257,16 +1373,17 @@ output.color = color;
             denoiseValid = false;
             presentationDenoised = false;
             resolvedSamples = 0;
+            postProcessPending = false;
+            bloomSamples = 0;
             (tileRenderWithPredict || tileRender).reset();
             isPredictingFrame = false;
             isFirstFrame = true;
             sampleCount = 0;
         },
         getOutputTexture(kind) {
-            if (resolvedSamples < 1)
-                return;
+            flushPostProcess();
             if (kind === 'hdr')
-                return getFrameInput('color');
+                return resolvedSamples > 0 ? getFrameInput('color') : undefined;
             return displayPostProcess.output ?? presentationTexture;
         },
         applyPostProcesses(passes, render) {
@@ -1275,8 +1392,9 @@ output.color = color;
         },
         trace,
         drawPostProcess() {
-            const encoder = device.createCommandEncoder();
-            drawPostProcess(encoder, true);
+            const resolve = postProcessPending;
+            postProcessPending = false;
+            drawPostProcess(device.createCommandEncoder(), true, resolve);
         },
         performDenoise,
         cancelDenoise,
@@ -1291,9 +1409,11 @@ output.color = color;
             const bytesPerRow = Math.ceil(width * 16 / 256) * 256;
             const buffer = device.createBuffer({ size: bytesPerRow * height, usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ });
             const encoder = device.createCommandEncoder();
-            readbackPass.setSize(width, height);
-            readbackPass.createPass(encoder, { inputTex: image });
-            encoder.copyTextureToBuffer({ texture: readbackPass.getOutput('color') }, { buffer, bytesPerRow }, { width, height });
+            const presentationReadback = hdrOutputActive && displayAovKind(output) ? scratch.get('AOV encoded readback', () => new WGPUFullQuadPass('AOV encoded readback', device, { textureWillBeRead: true, inputs: ['inputTex'], outputs: ['color'], fsMain: `let c=load_inputTex(uv,0);let rgb=select(1.055*pow(max(c.rgb,vec3f(0.0)),vec3f(1.0/2.4))-0.055,12.92*c.rgb,c.rgb<=vec3f(0.0031308));output.color=vec4f(rgb,c.a);` })) : readbackPass;
+            presentationReadback.setOutputParams({ color: { format: 'rgba32float' } });
+            presentationReadback.setSize(width, height);
+            presentationReadback.createPass(encoder, { inputTex: image });
+            encoder.copyTextureToBuffer({ texture: presentationReadback.getOutput('color') }, { buffer, bytesPerRow }, { width, height });
             device.queue.submit([encoder.finish()]);
             try {
                 await buffer.mapAsync(GPUMapMode.READ);
@@ -1308,7 +1428,32 @@ output.color = color;
                 buffer.destroy();
             }
         },
+        aovReady(kind) { return !!execution?.aovs?.includes(kind) && aov.samples > 0; },
+        getAovSamples() { return aov.samples; },
+        restartAovs() { aov.reset(); },
+        refineAovs(camera, samples = sampleCount) {
+            if (samples < 1 || !execution?.aovs?.length)
+                return true;
+            rayTracePass.setCamera(camera);
+            aovCamera = camera;
+            rayTracePass.updatePipeline();
+            if (rayTracePass.isCompilingShader() || !rayTracePass.isPipelineReady())
+                return false;
+            return rayTracePass.renderAovs(aov, camera, samples, execution.aovSamples ?? 16, execution.aovs);
+        },
+        async readAov(kind) {
+            if (!execution?.aovs?.includes(kind) || !aovCamera || (sampleCount < 1 && aov.samples < 1))
+                throw new Error('AOV output is not ready');
+            rayTracePass.setCamera(aovCamera);
+            while (!rayTracePass.renderAovs(aov, aovCamera, Math.max(sampleCount, aov.samples), execution.aovSamples ?? 16, execution.aovs)) {
+                if (disposed)
+                    throw new Error('AOV compilation was interrupted');
+                await new Promise(resolve => scheduleFrame(() => resolve()));
+            }
+            return aov.read(kind);
+        },
         async readOutput(kind) {
+            flushPostProcess();
             rawOutputPass.setUniform('flatBackgroundColor', resolvedFlatBackground);
             const width = renderWidth, height = renderHeight;
             const bytesPerRow = Math.ceil(width * 16 / 256) * 256;
@@ -1377,6 +1522,38 @@ output.color = color;
         getTotalSamplesRendered() {
             return sampleCount;
         },
+        /** @internal */
+        _displayParity() {
+            return {
+                record(trace) { displayTrace = trace; },
+                load(input) {
+                    cancelDenoise();
+                    clearDenoisedOutput();
+                    setSize(input.width, input.height);
+                    rayTracePass.useTarget(targetKey);
+                    rayTracePass.setSize(renderWidth, renderHeight, screenWidth / screenHeight);
+                    const buffers = rayTracePass.getOutputBuffer();
+                    const shadow = new Float32Array(input.width * input.height * 12);
+                    for (let i = 0; i < input.width * input.height; i++) {
+                        shadow.set(input.shadow.subarray(i * 8, i * 8 + 8), i * 12);
+                        shadow.set(input.moments.subarray(i * 4, i * 4 + 4), i * 12 + 8);
+                    }
+                    for (const [buffer, data] of [[buffers.color, input.color], [buffers.albedo, input.albedo],
+                        [buffers.normal, input.normal], [buffers.shadowCatcher, shadow]])
+                        device.queue.writeBuffer(buffer, 0, data);
+                    sampleCount = resolvedSamples = input.samples;
+                    resolvedHasShadowCatcher = input.catcher;
+                    isFirstFrame = false;
+                    postProcessPending = false;
+                    bloomSamples = 0;
+                    rayTraceOutputPass.setSampleCount(sampleCount);
+                    rayTraceOutputPass.setSampleTileGrid(1, 1);
+                    const encoder = device.createCommandEncoder();
+                    rayTraceOutputPass.createPass(encoder, buffers, resolvedHasShadowCatcher);
+                    device.queue.submit([encoder.finish()]);
+                }
+            };
+        },
         getDiagnostics() {
             return {
                 ...rayTracePass.getDiagnostics(),
@@ -1421,6 +1598,7 @@ output.color = color;
         setOnSampleRendered(cb) {
             sampleRenderedCallback = cb;
         },
+        setAovDisplayOptions(options) { aovDisplayOptions = { ...options, depthRange: [...options.depthRange] }; },
         setOutput(nextOutput) {
             if (output === nextOutput)
                 return false;
@@ -1432,7 +1610,8 @@ output.color = color;
 }
 /** Independent render targets, without preview or presentation policy. */
 export function makeWGPURenderTargets(canvas, device, options = {}) {
-    const rayTracePass = new WGPURayTracePass(device);
+    const rayTracePass = new WGPURayTracePass(device, options.materialTextures);
+    const traceQueue = new GPUTraceQueue(device.queue);
     const customJobs = new Set();
     const scratch = new ScratchPool(work => {
         // A cancelled custom filter can keep submitting GPU work until its promise settles.
@@ -1443,7 +1622,7 @@ export function makeWGPURenderTargets(canvas, device, options = {}) {
     });
     const surface = scratch.get('canvas', () => new WGPUCanvasSurface(canvas, device, options.presentationFormat ?? navigator.gpu.getPreferredCanvasFormat()));
     return makeRenderPipeline(rayTracePass, () => {
-        const target = makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scratch, customJobs);
+        const target = makeWGPUAccumulationTarget(canvas, device, rayTracePass, surface, scratch, customJobs, traceQueue);
         return target;
     }, false, scratch);
 }