@meimu/mutracer 0.1.5 → 0.3.0

package/lib/renderer/WGPUShaderCache.d.ts

@@ -3,6 +3,7 @@
 export declare class WGPUShaderCache {
     private device;
     private modules;
+    private moduleIds;
     private bindGroupLayouts;
     private layouts;
     private pipelines;
@@ -21,6 +22,5 @@ export declare class WGPUShaderCache {
     createComputePipeline(descriptor: GPUComputePipelineDescriptor): GPUComputePipeline;
     clear(): void;
 }
-/** Grow in coarse buckets; scene edits must not shrink a compiled stack. */
-export declare function retainedShaderCapacity(required: number, previous?: number, minimum?: number): number;
+export { retainedShaderCapacity } from './shaderCapacity.js';
 export declare function getTargetShaderCache(device: GPUDevice): WGPUShaderCache;

package/lib/renderer/WGPUShaderCache.js

@@ -3,6 +3,7 @@
 export class WGPUShaderCache {
     device;
     modules = new Map();
+    moduleIds = new Map();
     bindGroupLayouts = new Map();
     layouts = new Map();
     pipelines = new Map();
@@ -30,7 +31,13 @@ export class WGPUShaderCache {
     }
     createShaderModule(descriptor) {
         const key = descriptor.code;
-        return this.remember(this.modules, key, this.modules.get(key) ?? this.device.createShaderModule(descriptor), 8);
+        const module = this.remember(this.modules, key, this.modules.get(key) ?? this.device.createShaderModule(descriptor), 8);
+        // Pipeline retention is longer than module retention. Give exact source the
+        // same identity after module eviction, so a feature toggle can still find
+        // its compiled pipeline. Other GPU objects keep their object identities.
+        const id = this.remember(this.moduleIds, key, this.moduleIds.get(key) ?? this.id(module), 128);
+        this.ids.set(module, id);
+        return module;
     }
     createBindGroupLayout(descriptor) {
         const entries = Array.from(descriptor.entries);
@@ -81,6 +88,7 @@ export class WGPUShaderCache {
     }
     clear() {
         this.modules.clear();
+        this.moduleIds.clear();
         this.bindGroupLayouts.clear();
         this.layouts.clear();
         this.pipelines.clear();
@@ -88,10 +96,7 @@ export class WGPUShaderCache {
         this.computePipelines.clear();
     }
 }
-/** Grow in coarse buckets; scene edits must not shrink a compiled stack. */
-export function retainedShaderCapacity(required, previous = 0, minimum = 8) {
-    return Math.max(previous, minimum, 2 ** Math.ceil(Math.log2(Math.max(1, required))));
-}
+export { retainedShaderCapacity } from './shaderCapacity.js';
 /** Shared by target-local post-process passes; never contains GPU image resources. */
 const targetShaderCaches = new WeakMap();
 export function getTargetShaderCache(device) {

package/lib/renderer/WGPUShaderCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"WGPUShaderCache.js","sourceRoot":"","sources":["../../src/renderer/WGPUShaderCache.ts"],"names":[],"mappings":"AAAA;iEACiE;AACjE,MAAM,OAAO,eAAe;IAUN;IATZ,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7C,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IACzD,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC/C,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC3D,eAAe,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IACzD,GAAG,GAAG,IAAI,OAAO,EAAkB,CAAC;IACpC,MAAM,GAAG,CAAC,CAAC;IAEnB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEjC,EAAE,CAAC,KAAa;QACtB,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,QAAQ,CAAI,KAAqB,EAAE,GAAW,EAAE,KAAQ,EAAE,KAAa;QAC7E,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,KAAK,CAAC,IAAI,GAAG,KAAK;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB,CAAC,UAA6D;QAC9E,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,qBAAqB,CAAC,UAAwC;QAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAC7C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,oBAAoB,CAAC,UAAuC;QAC1D,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACjE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO;YACjC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,GAAG,UAAU,EAAE,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,0BAA0B,CAAC,UAAwC;QACjE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YACzB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;YACvB,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;YAC5C,OAAO,CAAC,UAAU;YAClB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAC/E,CAAC,CAAC;QACH,IAAI,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC;YACzB,yEAAyE;YACzE,+DAA+D;YAC/D,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;oBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,oBAAoB,CAAC,UAAuC;QAC1D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO;YACjC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAC7C,QAAQ,IAAI,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAC5C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,qBAAqB,CAAC,UAAwC;QAC5D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAC7C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1F,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,QAAQ,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,sFAAsF;AACtF,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAA8B,CAAC;AACrE,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,IAAI,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/** Small renderer-owned caches. Keys include exact source and GPU object identity;\n * resources/bind groups are deliberately never retained here. */\nexport class WGPUShaderCache {\n  private modules = new Map<string, GPUShaderModule>();\n  private bindGroupLayouts = new Map<string, GPUBindGroupLayout>();\n  private layouts = new Map<string, GPUPipelineLayout>();\n  private pipelines = new Map<string, Promise<GPUComputePipeline>>();\n  private renderPipelines = new Map<string, GPURenderPipeline>();\n  private computePipelines = new Map<string, GPUComputePipeline>();\n  private ids = new WeakMap<object, number>();\n  private nextId = 0;\n\n  constructor(private device: GPUDevice) {}\n\n  private id(value: object) {\n    let id = this.ids.get(value);\n    if (id === undefined) {\n      id = ++this.nextId;\n      this.ids.set(value, id);\n    }\n    return id;\n  }\n\n  private remember<T>(cache: Map<string, T>, key: string, value: T, limit: number) {\n    cache.delete(key);\n    cache.set(key, value);\n    if (cache.size > limit) cache.delete(cache.keys().next().value!);\n    return value;\n  }\n\n  createShaderModule(descriptor: Pick<GPUShaderModuleDescriptor, 'code' | 'label'>) {\n    const key = descriptor.code;\n    return this.remember(this.modules, key,\n      this.modules.get(key) ?? this.device.createShaderModule(descriptor), 8);\n  }\n\n  createBindGroupLayout(descriptor: GPUBindGroupLayoutDescriptor) {\n    const entries = Array.from(descriptor.entries);\n    const key = JSON.stringify(entries);\n    return this.remember(this.bindGroupLayouts, key,\n      this.bindGroupLayouts.get(key) ??\n        this.device.createBindGroupLayout({ ...descriptor, entries }), 32);\n  }\n\n  createPipelineLayout(descriptor: GPUPipelineLayoutDescriptor) {\n    const bindGroupLayouts = Array.from(descriptor.bindGroupLayouts);\n    const { bindGroupLayouts: _groups, label: _label, ...options } = descriptor;\n    const key = JSON.stringify([options,\n      bindGroupLayouts.map((layout) => layout == null ? null : this.id(layout))]);\n    return this.remember(this.layouts, key,\n      this.layouts.get(key) ??\n        this.device.createPipelineLayout({ ...descriptor, bindGroupLayouts }), 16);\n  }\n\n  createComputePipelineAsync(descriptor: GPUComputePipelineDescriptor) {\n    const { compute, layout } = descriptor;\n    const key = JSON.stringify([\n      this.id(compute.module),\n      layout === 'auto' ? 'auto' : this.id(layout),\n      compute.entryPoint,\n      Object.entries(compute.constants ?? {}).sort(([a], [b]) => a.localeCompare(b))\n    ]);\n    let pipeline = this.pipelines.get(key);\n    if (!pipeline) {\n      pipeline = this.device.createComputePipelineAsync(descriptor);\n      const pending = pipeline;\n      // A failed/in-flight request must not poison a later retry. The identity\n      // guard also avoids deleting a replacement after LRU eviction.\n      void pending.catch(() => {\n        if (this.pipelines.get(key) === pending) this.pipelines.delete(key);\n      });\n    }\n    return this.remember(this.pipelines, key, pipeline, 128);\n  }\n\n  createRenderPipeline(descriptor: GPURenderPipelineDescriptor) {\n    const { label: _label, vertex, fragment, ...options } = descriptor;\n    const key = JSON.stringify([options,\n      { ...vertex, module: this.id(vertex.module) },\n      fragment && { ...fragment, module: this.id(fragment.module) }]);\n    return this.remember(this.renderPipelines, key,\n      this.renderPipelines.get(key) ?? this.device.createRenderPipeline(descriptor), 128);\n  }\n\n  createComputePipeline(descriptor: GPUComputePipelineDescriptor) {\n    const { label: _label, compute, ...options } = descriptor;\n    const key = JSON.stringify([options, { ...compute, module: this.id(compute.module) }]);\n    return this.remember(this.computePipelines, key,\n      this.computePipelines.get(key) ?? this.device.createComputePipeline(descriptor), 128);\n  }\n\n  clear() {\n    this.modules.clear();\n    this.bindGroupLayouts.clear();\n    this.layouts.clear();\n    this.pipelines.clear();\n    this.renderPipelines.clear();\n    this.computePipelines.clear();\n  }\n}\n\n/** Grow in coarse buckets; scene edits must not shrink a compiled stack. */\nexport function retainedShaderCapacity(required: number, previous = 0, minimum = 8) {\n  return Math.max(previous, minimum, 2 ** Math.ceil(Math.log2(Math.max(1, required))));\n}\n\n/** Shared by target-local post-process passes; never contains GPU image resources. */\nconst targetShaderCaches = new WeakMap<GPUDevice, WGPUShaderCache>();\nexport function getTargetShaderCache(device: GPUDevice) {\n  let cache = targetShaderCaches.get(device);\n  if (!cache) targetShaderCaches.set(device, cache = new WGPUShaderCache(device));\n  return cache;\n}\n"]}
+{"version":3,"file":"WGPUShaderCache.js","sourceRoot":"","sources":["../../src/renderer/WGPUShaderCache.ts"],"names":[],"mappings":"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","sourcesContent":["/** Small renderer-owned caches. Keys include exact source and GPU object identity;\n * resources/bind groups are deliberately never retained here. */\nexport class WGPUShaderCache {\n  private modules = new Map<string, GPUShaderModule>();\n  private moduleIds = new Map<string, number>();\n  private bindGroupLayouts = new Map<string, GPUBindGroupLayout>();\n  private layouts = new Map<string, GPUPipelineLayout>();\n  private pipelines = new Map<string, Promise<GPUComputePipeline>>();\n  private renderPipelines = new Map<string, GPURenderPipeline>();\n  private computePipelines = new Map<string, GPUComputePipeline>();\n  private ids = new WeakMap<object, number>();\n  private nextId = 0;\n\n  constructor(private device: GPUDevice) {}\n\n  private id(value: object) {\n    let id = this.ids.get(value);\n    if (id === undefined) {\n      id = ++this.nextId;\n      this.ids.set(value, id);\n    }\n    return id;\n  }\n\n  private remember<T>(cache: Map<string, T>, key: string, value: T, limit: number) {\n    cache.delete(key);\n    cache.set(key, value);\n    if (cache.size > limit) cache.delete(cache.keys().next().value!);\n    return value;\n  }\n\n  createShaderModule(descriptor: Pick<GPUShaderModuleDescriptor, 'code' | 'label'>) {\n    const key = descriptor.code;\n    const module = this.remember(this.modules, key,\n      this.modules.get(key) ?? this.device.createShaderModule(descriptor), 8);\n    // Pipeline retention is longer than module retention. Give exact source the\n    // same identity after module eviction, so a feature toggle can still find\n    // its compiled pipeline. Other GPU objects keep their object identities.\n    const id = this.remember(this.moduleIds, key, this.moduleIds.get(key) ?? this.id(module), 128);\n    this.ids.set(module, id);\n    return module;\n  }\n\n  createBindGroupLayout(descriptor: GPUBindGroupLayoutDescriptor) {\n    const entries = Array.from(descriptor.entries);\n    const key = JSON.stringify(entries);\n    return this.remember(this.bindGroupLayouts, key,\n      this.bindGroupLayouts.get(key) ??\n        this.device.createBindGroupLayout({ ...descriptor, entries }), 32);\n  }\n\n  createPipelineLayout(descriptor: GPUPipelineLayoutDescriptor) {\n    const bindGroupLayouts = Array.from(descriptor.bindGroupLayouts);\n    const { bindGroupLayouts: _groups, label: _label, ...options } = descriptor;\n    const key = JSON.stringify([options,\n      bindGroupLayouts.map((layout) => layout == null ? null : this.id(layout))]);\n    return this.remember(this.layouts, key,\n      this.layouts.get(key) ??\n        this.device.createPipelineLayout({ ...descriptor, bindGroupLayouts }), 16);\n  }\n\n  createComputePipelineAsync(descriptor: GPUComputePipelineDescriptor) {\n    const { compute, layout } = descriptor;\n    const key = JSON.stringify([\n      this.id(compute.module),\n      layout === 'auto' ? 'auto' : this.id(layout),\n      compute.entryPoint,\n      Object.entries(compute.constants ?? {}).sort(([a], [b]) => a.localeCompare(b))\n    ]);\n    let pipeline = this.pipelines.get(key);\n    if (!pipeline) {\n      pipeline = this.device.createComputePipelineAsync(descriptor);\n      const pending = pipeline;\n      // A failed/in-flight request must not poison a later retry. The identity\n      // guard also avoids deleting a replacement after LRU eviction.\n      void pending.catch(() => {\n        if (this.pipelines.get(key) === pending) this.pipelines.delete(key);\n      });\n    }\n    return this.remember(this.pipelines, key, pipeline, 128);\n  }\n\n  createRenderPipeline(descriptor: GPURenderPipelineDescriptor) {\n    const { label: _label, vertex, fragment, ...options } = descriptor;\n    const key = JSON.stringify([options,\n      { ...vertex, module: this.id(vertex.module) },\n      fragment && { ...fragment, module: this.id(fragment.module) }]);\n    return this.remember(this.renderPipelines, key,\n      this.renderPipelines.get(key) ?? this.device.createRenderPipeline(descriptor), 128);\n  }\n\n  createComputePipeline(descriptor: GPUComputePipelineDescriptor) {\n    const { label: _label, compute, ...options } = descriptor;\n    const key = JSON.stringify([options, { ...compute, module: this.id(compute.module) }]);\n    return this.remember(this.computePipelines, key,\n      this.computePipelines.get(key) ?? this.device.createComputePipeline(descriptor), 128);\n  }\n\n  clear() {\n    this.modules.clear();\n    this.moduleIds.clear();\n    this.bindGroupLayouts.clear();\n    this.layouts.clear();\n    this.pipelines.clear();\n    this.renderPipelines.clear();\n    this.computePipelines.clear();\n  }\n}\n\nexport {retainedShaderCapacity} from './shaderCapacity.js';\n\n/** Shared by target-local post-process passes; never contains GPU image resources. */\nconst targetShaderCaches = new WeakMap<GPUDevice, WGPUShaderCache>();\nexport function getTargetShaderCache(device: GPUDevice) {\n  let cache = targetShaderCaches.get(device);\n  if (!cache) targetShaderCaches.set(device, cache = new WGPUShaderCache(device));\n  return cache;\n}\n"]}

package/lib/renderer/WGPUShaderCapabilities.d.ts

@@ -0,0 +1,10 @@
+import { type ShaderCapabilities } from './shaderCapabilities.js';
+/** Metadata for successful pipelines. Transport and resource layouts never mix. */
+export declare class WGPUShaderCapabilities {
+    private capacity;
+    private variants;
+    constructor(capacity?: number);
+    find(structure: string, required: ShaderCapabilities): ShaderCapabilities | undefined;
+    remember(structure: string, capabilities: ShaderCapabilities): void;
+    clear(): void;
+}

package/lib/renderer/WGPUShaderCapabilities.js

@@ -0,0 +1,54 @@
+import { shaderCapabilitiesInclude } from './shaderCapabilities.js';
+function capabilityKey(capabilities) {
+    return `${capabilities.SCENE_CAPABILITIES},${capabilities.MATERIAL_CAPABILITIES},${capabilities.LIGHT_CAPABILITIES}`;
+}
+function capabilityCount(capabilities) {
+    let count = 0;
+    for (let bits of [capabilities.SCENE_CAPABILITIES, capabilities.MATERIAL_CAPABILITIES, capabilities.LIGHT_CAPABILITIES]) {
+        while (bits) {
+            bits &= bits - 1;
+            count++;
+        }
+    }
+    return count;
+}
+/** Metadata for successful pipelines. Transport and resource layouts never mix. */
+export class WGPUShaderCapabilities {
+    capacity;
+    variants = new Map();
+    constructor(capacity = 128) {
+        this.capacity = capacity;
+    }
+    find(structure, required) {
+        const exactKey = structure + ':' + capabilityKey(required);
+        let key = exactKey;
+        let found = this.variants.get(key);
+        if (!found) {
+            let count = Infinity;
+            for (const [candidateKey, variant] of this.variants) {
+                if (variant.structure !== structure || !shaderCapabilitiesInclude(variant.capabilities, required))
+                    continue;
+                const candidateCount = capabilityCount(variant.capabilities);
+                if (candidateCount <= count) {
+                    key = candidateKey;
+                    found = variant;
+                    count = candidateCount;
+                }
+            }
+        }
+        if (!found)
+            return;
+        this.variants.delete(key);
+        this.variants.set(key, found);
+        return found.capabilities;
+    }
+    remember(structure, capabilities) {
+        const key = structure + ':' + capabilityKey(capabilities);
+        this.variants.delete(key);
+        this.variants.set(key, { structure, capabilities });
+        if (this.variants.size > this.capacity)
+            this.variants.delete(this.variants.keys().next().value);
+    }
+    clear() { this.variants.clear(); }
+}
+//# sourceMappingURL=WGPUShaderCapabilities.js.map

package/lib/renderer/WGPUShaderCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WGPUShaderCapabilities.js","sourceRoot":"","sources":["../../src/renderer/WGPUShaderCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,yBAAyB,EAA0B,MAAM,yBAAyB,CAAC;AAE3F,SAAS,aAAa,CAAC,YAAgC;IACrD,OAAO,GAAG,YAAY,CAAC,kBAAkB,IAAI,YAAY,CAAC,qBAAqB,IAAI,YAAY,CAAC,kBAAkB,EAAE,CAAC;AACvH,CAAC;AAED,SAAS,eAAe,CAAC,YAAgC;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,YAAY,CAAC,qBAAqB,EAAE,YAAY,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACxH,OAAO,IAAI,EAAE,CAAC;YAAC,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC;YAAC,KAAK,EAAE,CAAC;QAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,OAAO,sBAAsB;IAGb;IAFZ,QAAQ,GAAG,IAAI,GAAG,EAAiE,CAAC;IAE5F,YAAoB,WAAW,GAAG;QAAd,aAAQ,GAAR,QAAQ,CAAM;IAAG,CAAC;IAEtC,IAAI,CAAC,SAAiB,EAAE,QAA4B;QAClD,MAAM,QAAQ,GAAG,SAAS,GAAG,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,GAAG,GAAG,QAAQ,CAAC;QACnB,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,KAAK,GAAG,QAAQ,CAAC;YACrB,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC;oBAAE,SAAS;gBAC5G,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBAC7D,IAAI,cAAc,IAAI,KAAK,EAAE,CAAC;oBAC5B,GAAG,GAAG,YAAY,CAAC;oBAAC,KAAK,GAAG,OAAO,CAAC;oBAAC,KAAK,GAAG,cAAc,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,YAAgC;QAC1D,MAAM,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,YAAY,EAAC,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;IACnG,CAAC;IAED,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CACnC","sourcesContent":["import {shaderCapabilitiesInclude, type ShaderCapabilities} from './shaderCapabilities.js';\n\nfunction capabilityKey(capabilities: ShaderCapabilities) {\n  return `${capabilities.SCENE_CAPABILITIES},${capabilities.MATERIAL_CAPABILITIES},${capabilities.LIGHT_CAPABILITIES}`;\n}\n\nfunction capabilityCount(capabilities: ShaderCapabilities) {\n  let count = 0;\n  for (let bits of [capabilities.SCENE_CAPABILITIES, capabilities.MATERIAL_CAPABILITIES, capabilities.LIGHT_CAPABILITIES]) {\n    while (bits) { bits &= bits - 1; count++; }\n  }\n  return count;\n}\n\n/** Metadata for successful pipelines. Transport and resource layouts never mix. */\nexport class WGPUShaderCapabilities {\n  private variants = new Map<string, {structure: string; capabilities: ShaderCapabilities}>();\n\n  constructor(private capacity = 128) {}\n\n  find(structure: string, required: ShaderCapabilities) {\n    const exactKey = structure + ':' + capabilityKey(required);\n    let key = exactKey;\n    let found = this.variants.get(key);\n    if (!found) {\n      let count = Infinity;\n      for (const [candidateKey, variant] of this.variants) {\n        if (variant.structure !== structure || !shaderCapabilitiesInclude(variant.capabilities, required)) continue;\n        const candidateCount = capabilityCount(variant.capabilities);\n        if (candidateCount <= count) {\n          key = candidateKey; found = variant; count = candidateCount;\n        }\n      }\n    }\n    if (!found) return;\n    this.variants.delete(key);\n    this.variants.set(key, found);\n    return found.capabilities;\n  }\n\n  remember(structure: string, capabilities: ShaderCapabilities) {\n    const key = structure + ':' + capabilityKey(capabilities);\n    this.variants.delete(key);\n    this.variants.set(key, {structure, capabilities});\n    if (this.variants.size > this.capacity) this.variants.delete(this.variants.keys().next().value!);\n  }\n\n  clear() { this.variants.clear(); }\n}\n"]}

package/lib/renderer/WGPUSkyBaker.d.ts

@@ -0,0 +1,13 @@
+import type { ProceduralEnvironmentSource } from './envMapDistribution.js';
+/** Renders into the pipeline's own environment/background texture on its device. */
+export declare class WGPUSkyBaker {
+    private readonly device;
+    private readonly tables;
+    private readonly uniforms;
+    private readonly pipelines;
+    private readonly inputs;
+    private time?;
+    constructor(device: GPUDevice);
+    bake(source: ProceduralEnvironmentSource, output: GPUTexture): void;
+    dispose(): void;
+}

package/lib/renderer/WGPUSkyBaker.js

@@ -0,0 +1,85 @@
+import { sunPosition } from '../scene/skyParameters.js';
+import { SUN_RADIUS } from './skyModel.js';
+import { proceduralSkyWGSL } from './wgsl/proceduralSky.compute.js';
+/** Renders into the pipeline's own environment/background texture on its device. */
+export class WGPUSkyBaker {
+    device;
+    tables;
+    uniforms;
+    pipelines;
+    inputs = { transmittance: [], multiple: [1, 2], skyView: [1, 2, 4], irradiance: [1, 3], map: [3, 4] };
+    time;
+    constructor(device) {
+        this.device = device;
+        const texture = (label, width, height) => device.createTexture({
+            label, size: [width, height], format: 'rgba32float', usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.STORAGE_BINDING
+        });
+        this.tables = {
+            transmittance: texture('Sky transmittance', 256, 64), multiple: texture('Sky multiple scattering', 32, 1),
+            skyView: texture('Sky view', 96, 192), irradiance: texture('Sky irradiance', 2, 1)
+        };
+        this.uniforms = [0, 1].map(() => device.createBuffer({ label: 'Sky parameters', size: 80, usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST }));
+        const module = device.createShaderModule({ label: 'Procedural sky', code: proceduralSkyWGSL });
+        this.pipelines = {};
+        for (const pass of Object.keys(this.inputs)) {
+            const layout = device.createBindGroupLayout({ entries: [
+                    { binding: 0, visibility: GPUShaderStage.COMPUTE, buffer: { type: 'uniform' } },
+                    ...this.inputs[pass].map(binding => ({ binding, visibility: GPUShaderStage.COMPUTE, texture: { sampleType: 'unfilterable-float' } })),
+                    { binding: 5, visibility: GPUShaderStage.COMPUTE, storageTexture: { access: 'write-only', format: 'rgba32float' } }
+                ] });
+            this.pipelines[pass] = device.createComputePipeline({ label: `Sky ${pass}`, layout: device.createPipelineLayout({ bindGroupLayouts: [layout] }), compute: { module, entryPoint: pass } });
+        }
+    }
+    bake(source, output) {
+        const { width, height, sky, intensity, ambient } = source;
+        if (width > this.device.limits.maxTextureDimension2D || height > this.device.limits.maxTextureDimension2D) {
+            throw new RangeError('ProceduralSky resolution exceeds the device texture size limit.');
+        }
+        const { elevation, azimuth } = sunPosition(sky.time);
+        const e = elevation * Math.PI / 180, a = azimuth * Math.PI / 180;
+        const data = new Float32Array([
+            Math.cos(e), Math.sin(e), 0, a,
+            Math.cos(e) * Math.cos(a), Math.sin(e), Math.cos(e) * Math.sin(a), SUN_RADIUS * Math.PI / 180,
+            width, height, 0, 0,
+            intensity, intensity, intensity, 1,
+            ...ambient, 0
+        ]);
+        this.device.queue.writeBuffer(this.uniforms[0], 0, data);
+        data[11] = 1;
+        this.device.queue.writeBuffer(this.uniforms[1], 0, data);
+        const encoder = this.device.createCommandEncoder({ label: 'Procedural sky' });
+        const draw = (name, target, ground = false) => {
+            const pipeline = this.pipelines[name];
+            const inputs = {
+                1: this.tables.transmittance, 2: name === 'multiple' ? this.tables.transmittance : this.tables.multiple,
+                3: this.tables.skyView, 4: this.tables.irradiance
+            };
+            const group = this.device.createBindGroup({ layout: pipeline.getBindGroupLayout(0), entries: [
+                    { binding: 0, resource: { buffer: this.uniforms[ground ? 1 : 0] } },
+                    ...this.inputs[name].map(binding => ({ binding, resource: inputs[binding].createView() })),
+                    { binding: 5, resource: target.createView() }
+                ] });
+            const pass = encoder.beginComputePass({ label: `Sky ${name}` });
+            pass.setPipeline(pipeline);
+            pass.setBindGroup(0, group);
+            pass.dispatchWorkgroups(Math.ceil(target.width / 8), Math.ceil(target.height / 8));
+            pass.end();
+        };
+        if (this.time === undefined)
+            draw('transmittance', this.tables.transmittance);
+        if (this.time !== sky.time) {
+            draw('multiple', this.tables.multiple);
+            draw('skyView', this.tables.skyView);
+            draw('irradiance', this.tables.irradiance);
+            draw('skyView', this.tables.skyView, true);
+        }
+        draw('map', output, true);
+        this.device.queue.submit([encoder.finish()]);
+        this.time = sky.time;
+    }
+    dispose() {
+        Object.values(this.tables).forEach(texture => texture.destroy());
+        this.uniforms.forEach(buffer => buffer.destroy());
+    }
+}
+//# sourceMappingURL=WGPUSkyBaker.js.map

package/lib/renderer/WGPUSkyBaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WGPUSkyBaker.js","sourceRoot":"","sources":["../../src/renderer/WGPUSkyBaker.ts"],"names":[],"mappings":"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","sourcesContent":["import { sunPosition } from '../scene/skyParameters.js';\nimport type { ProceduralEnvironmentSource } from './envMapDistribution.js';\nimport { SUN_RADIUS } from './skyModel.js';\nimport { proceduralSkyWGSL } from './wgsl/proceduralSky.compute.js';\n\ntype Pass = 'transmittance' | 'multiple' | 'skyView' | 'irradiance' | 'map';\n\n/** Renders into the pipeline's own environment/background texture on its device. */\nexport class WGPUSkyBaker {\n  private readonly tables: Record<Exclude<Pass, 'map'>, GPUTexture>;\n  private readonly uniforms: GPUBuffer[];\n  private readonly pipelines: Record<Pass, GPUComputePipeline>;\n  private readonly inputs: Record<Pass, number[]> = { transmittance: [], multiple: [1, 2], skyView: [1, 2, 4], irradiance: [1, 3], map: [3, 4] };\n  private time?: number;\n\n  constructor(private readonly device: GPUDevice) {\n    const texture = (label: string, width: number, height: number) => device.createTexture({\n      label, size: [width, height], format: 'rgba32float', usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.STORAGE_BINDING\n    });\n    this.tables = {\n      transmittance: texture('Sky transmittance', 256, 64), multiple: texture('Sky multiple scattering', 32, 1),\n      skyView: texture('Sky view', 96, 192), irradiance: texture('Sky irradiance', 2, 1)\n    };\n    this.uniforms = [0, 1].map(() => device.createBuffer({ label: 'Sky parameters', size: 80, usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST }));\n    const module = device.createShaderModule({ label: 'Procedural sky', code: proceduralSkyWGSL });\n    this.pipelines = {} as Record<Pass, GPUComputePipeline>;\n    for (const pass of Object.keys(this.inputs) as Pass[]) {\n      const layout = device.createBindGroupLayout({ entries: [\n        { binding: 0, visibility: GPUShaderStage.COMPUTE, buffer: { type: 'uniform' } },\n        ...this.inputs[pass].map(binding => ({ binding, visibility: GPUShaderStage.COMPUTE, texture: { sampleType: 'unfilterable-float' as const } })),\n        { binding: 5, visibility: GPUShaderStage.COMPUTE, storageTexture: { access: 'write-only', format: 'rgba32float' } }\n      ] });\n      this.pipelines[pass] = device.createComputePipeline({ label: `Sky ${pass}`, layout: device.createPipelineLayout({ bindGroupLayouts: [layout] }), compute: { module, entryPoint: pass } });\n    }\n  }\n\n  bake(source: ProceduralEnvironmentSource, output: GPUTexture) {\n    const { width, height, sky, intensity, ambient } = source;\n    if (width > this.device.limits.maxTextureDimension2D || height > this.device.limits.maxTextureDimension2D) {\n      throw new RangeError('ProceduralSky resolution exceeds the device texture size limit.');\n    }\n    const { elevation, azimuth } = sunPosition(sky.time);\n    const e = elevation * Math.PI / 180, a = azimuth * Math.PI / 180;\n    const data = new Float32Array([\n      Math.cos(e), Math.sin(e), 0, a,\n      Math.cos(e) * Math.cos(a), Math.sin(e), Math.cos(e) * Math.sin(a), SUN_RADIUS * Math.PI / 180,\n      width, height, 0, 0,\n      intensity, intensity, intensity, 1,\n      ...ambient, 0\n    ]);\n    this.device.queue.writeBuffer(this.uniforms[0], 0, data);\n    data[11] = 1;\n    this.device.queue.writeBuffer(this.uniforms[1], 0, data);\n    const encoder = this.device.createCommandEncoder({ label: 'Procedural sky' });\n    const draw = (name: Pass, target: GPUTexture, ground = false) => {\n      const pipeline = this.pipelines[name];\n      const inputs: Record<number, GPUTexture> = {\n        1: this.tables.transmittance, 2: name === 'multiple' ? this.tables.transmittance : this.tables.multiple,\n        3: this.tables.skyView, 4: this.tables.irradiance\n      };\n      const group = this.device.createBindGroup({ layout: pipeline.getBindGroupLayout(0), entries: [\n        { binding: 0, resource: { buffer: this.uniforms[ground ? 1 : 0] } },\n        ...this.inputs[name].map(binding => ({ binding, resource: inputs[binding].createView() })),\n        { binding: 5, resource: target.createView() }\n      ] });\n      const pass = encoder.beginComputePass({ label: `Sky ${name}` });\n      pass.setPipeline(pipeline); pass.setBindGroup(0, group);\n      pass.dispatchWorkgroups(Math.ceil(target.width / 8), Math.ceil(target.height / 8)); pass.end();\n    };\n    if (this.time === undefined) draw('transmittance', this.tables.transmittance);\n    if (this.time !== sky.time) {\n      draw('multiple', this.tables.multiple);\n      draw('skyView', this.tables.skyView);\n      draw('irradiance', this.tables.irradiance);\n      draw('skyView', this.tables.skyView, true);\n    }\n    draw('map', output, true);\n    this.device.queue.submit([encoder.finish()]);\n    this.time = sky.time;\n  }\n\n  dispose() {\n    Object.values(this.tables).forEach(texture => texture.destroy());\n    this.uniforms.forEach(buffer => buffer.destroy());\n  }\n}\n"]}

package/lib/renderer/WebGLAov.d.ts

@@ -0,0 +1,41 @@
+import { type AovDisplayOptions } from './aovDisplay.js';
+import { AovHistory, type AovKind, type AovFrameSnapshot } from './aov.js';
+import { Texture2D, type WebGLDevice } from './webgl.js';
+declare const names: readonly ["geometry", "position", "diffuse", "specular"];
+export declare class WebGLAov {
+    readonly renderer: WebGLDevice;
+    private displayPass?;
+    readonly history: AovHistory;
+    width: number;
+    height: number;
+    samples: number;
+    centerReady: boolean;
+    frame?: AovFrameSnapshot;
+    readonly accumulation: Record<typeof names[number], Texture2D>[];
+    previousCenter: {
+        id: Texture2D;
+        motion: Texture2D;
+    } | undefined;
+    center: {
+        id: Texture2D;
+        motion: Texture2D;
+    } | undefined;
+    scene: Texture2D;
+    constructor(renderer: WebGLDevice);
+    reset(): void;
+    resize(width: number, height: number): void;
+    setScene(words: Uint32Array): void;
+    visualize(kind: AovKind, options: AovDisplayOptions): Texture2D;
+    read(kind: AovKind): Promise<{
+        width: number;
+        height: number;
+        data: Uint32Array<ArrayBuffer>;
+    } | {
+        width: number;
+        height: number;
+        data: Float32Array<ArrayBufferLike>;
+    }>;
+    get bytes(): number;
+    dispose(): void;
+}
+export {};

package/lib/renderer/WebGLAov.js

@@ -0,0 +1,106 @@
+import displayShader from './glsl/aovDisplay.frag.js';
+import { WebGLFullQuadPass } from './WebGLFullQuadPass.js';
+import { AOV_KINDS } from './aov.js';
+import { AOV_ID_COMPONENTS, validateAovDisplay } from './aovDisplay.js';
+import { AovHistory } from './aov.js';
+import { Texture2D, FrameBuffer } from './webgl.js';
+import { readRgbaPixels } from './WebGLReadback.js';
+const names = ['geometry', 'position', 'diffuse', 'specular'];
+export class WebGLAov {
+    renderer;
+    displayPass;
+    history = new AovHistory();
+    width = 0;
+    height = 0;
+    samples = 0;
+    centerReady = false;
+    frame;
+    accumulation = [];
+    previousCenter;
+    center;
+    scene = new Texture2D({ type: 5125, minFilter: 9728, magFilter: 9728 });
+    constructor(renderer) {
+        this.renderer = renderer;
+    }
+    reset() { if (this.centerReady) {
+        const swap = this.previousCenter;
+        this.previousCenter = this.center;
+        this.center = swap;
+    } this.samples = 0; this.centerReady = false; this.frame = undefined; }
+    resize(width, height) {
+        if (width === this.width && height === this.height)
+            return;
+        this.dispose();
+        this.history.clear();
+        this.reset();
+        this.width = width;
+        this.height = height;
+        const options = { width, height, type: 5126, minFilter: 9728, magFilter: 9728 };
+        for (let i = 0; i < 2; i++)
+            this.accumulation.push(Object.fromEntries(names.map(n => [n, new Texture2D(options)])));
+        this.previousCenter = { id: new Texture2D({ ...options, type: 5125 }), motion: new Texture2D(options) };
+        this.center = { id: new Texture2D({ ...options, type: 5125 }), motion: new Texture2D(options) };
+    }
+    setScene(words) {
+        const width = Math.min(1024, Math.max(1, Math.ceil(words.length / 4))), height = Math.ceil(words.length / (width * 4));
+        const data = new Uint32Array(width * height * 4);
+        data.set(words);
+        this.scene.source = { data, width, height };
+    }
+    visualize(kind, options) {
+        if (!this.samples || !this.center)
+            throw new Error('AOV output is not ready');
+        validateAovDisplay(options);
+        this.displayPass ??= new WebGLFullQuadPass('AOV display', this.renderer, { shader: displayShader, outputs: ['color'] });
+        const pass = this.displayPass;
+        pass.setSize(this.width, this.height);
+        pass.setUniforms({ kind: AOV_KINDS.indexOf(kind), samples: this.samples, mapping: [...options.depthRange, options.positionScale, options.motionScale], idComponent: AOV_ID_COMPONENTS.indexOf(options.idComponent) });
+        pass.createPass({ ...this.accumulation[(this.samples - 1) % 2], identity: this.center.id, motion: this.center.motion });
+        return pass.getOutput('color');
+    }
+    async read(kind) {
+        const gl = this.renderer.gl, framebuffer = new FrameBuffer(), width = this.width, height = this.height;
+        try {
+            const accumulated = this.accumulation[(this.samples - 1) % 2];
+            const name = kind === 'depth' || kind === 'roughness' ? 'geometry' : kind === 'diffuseAlbedo' ? 'diffuse' : kind === 'specularAlbedo' ? 'specular' : 'position';
+            framebuffer.bind(this.renderer, [kind === 'id' ? this.center.id : kind === 'motion' ? this.center.motion : accumulated[name]]);
+            if (kind === 'id') {
+                const source = new Uint32Array(width * height * 4), data = new Uint32Array(source.length);
+                gl.readPixels(0, 0, width, height, gl.RGBA_INTEGER, gl.UNSIGNED_INT, source);
+                for (let y = 0; y < height; y++)
+                    data.set(source.subarray((height - 1 - y) * width * 4, (height - y) * width * 4), y * width * 4);
+                return { width, height, data };
+            }
+            const data = readRgbaPixels(gl, width, height, false);
+            if (kind === 'motion') {
+                for (let o = 2; o < data.length; o += 4)
+                    data[o] = 0;
+                return { width, height, data };
+            }
+            framebuffer.bind(this.renderer, [accumulated.position]);
+            const coverage = readRgbaPixels(gl, width, height, false);
+            for (let p = 0; p < width * height; p++) {
+                const o = p * 4, hits = coverage[o + 3], inv = hits > 0 ? 1 / hits : 0, alpha = hits / Math.max(1, this.samples);
+                if (kind === 'depth')
+                    data.set([data[o] * inv, 0, 0, alpha], o);
+                else if (kind === 'roughness')
+                    data.set([data[o + 1] * inv, data[o + 2] * inv, data[o + 3] * inv, alpha], o);
+                else if (kind === 'position')
+                    data.set([data[o] * inv, data[o + 1] * inv, data[o + 2] * inv, alpha], o);
+                else {
+                    const count = data[o + 3], scale = count > 0 ? 1 / count : 0;
+                    data.set([data[o] * scale, data[o + 1] * scale, data[o + 2] * scale, count / Math.max(1, this.samples)], o);
+                }
+            }
+            return { width, height, data };
+        }
+        finally {
+            framebuffer.dispose(this.renderer);
+        }
+    }
+    get bytes() { return this.width * this.height * (2 * 64 + 64 + (this.displayPass ? 4 : 0)) + this.scene.width * this.scene.height * 16; }
+    dispose() { this.displayPass?.dispose(); this.displayPass = undefined; const gl = this.renderer.gl; for (const set of this.accumulation)
+        for (const texture of Object.values(set))
+            texture.dispose(gl); this.accumulation.length = 0; this.center?.id.dispose(gl); this.center?.motion.dispose(gl); this.center = undefined; this.previousCenter?.id.dispose(gl); this.previousCenter?.motion.dispose(gl); this.previousCenter = undefined; this.scene.dispose(gl); }
+}
+//# sourceMappingURL=WebGLAov.js.map

package/lib/renderer/WebGLAov.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLAov.js","sourceRoot":"","sources":["../../src/renderer/WebGLAov.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAC;AACnC,OAAO,EAAC,iBAAiB,EAAE,kBAAkB,EAAyB,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAC,UAAU,EAAsC,MAAM,UAAU,CAAC;AACzE,OAAO,EAAC,SAAS,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AACpE,OAAO,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAClD,MAAM,KAAK,GAAG,CAAC,UAAU,EAAC,UAAU,EAAC,SAAS,EAAC,UAAU,CAAU,CAAC;AACpE,MAAM,OAAO,QAAQ;IAQE;IAPb,WAAW,CAAqC;IAC/C,OAAO,GAAC,IAAI,UAAU,EAAE,CAAC;IAClC,KAAK,GAAC,CAAC,CAAC;IAAC,MAAM,GAAC,CAAC,CAAC;IAAC,OAAO,GAAC,CAAC,CAAC;IAAC,WAAW,GAAC,KAAK,CAAC;IAAC,KAAK,CAAoB;IACjE,YAAY,GAA2C,EAAE,CAAC;IACnE,cAAc,CAA+C;IAC7D,MAAM,CAA+C;IACrD,KAAK,GAAG,IAAI,SAAS,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAC,CAAC,CAAC;IACnE,YAAqB,QAAqB;QAArB,aAAQ,GAAR,QAAQ,CAAa;IAAG,CAAC;IAC9C,KAAK,KAAG,IAAG,IAAI,CAAC,WAAW,EAAC,CAAC;QAAA,MAAM,IAAI,GAAC,IAAI,CAAC,cAAc,CAAC;QAAA,IAAI,CAAC,cAAc,GAAC,IAAI,CAAC,MAAM,CAAC;QAAA,IAAI,CAAC,MAAM,GAAC,IAAI,CAAC;IAAA,CAAC,CAAA,IAAI,CAAC,OAAO,GAAC,CAAC,CAAC,CAAA,IAAI,CAAC,WAAW,GAAC,KAAK,CAAC,CAAA,IAAI,CAAC,KAAK,GAAC,SAAS,CAAC,CAAA,CAAC;IAC1K,MAAM,CAAC,KAAY,EAAC,MAAa;QAC/B,IAAG,KAAK,KAAG,IAAI,CAAC,KAAK,IAAI,MAAM,KAAG,IAAI,CAAC,MAAM;YAAC,OAAO;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QAAA,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAAA,IAAI,CAAC,KAAK,EAAE,CAAC;QAAA,IAAI,CAAC,KAAK,GAAC,KAAK,CAAC;QAAA,IAAI,CAAC,MAAM,GAAC,MAAM,CAAC;QACrF,MAAM,OAAO,GAAC,EAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAC,CAAC;QACrE,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,CAAC,EAAC,CAAC,EAAE;YAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAA2C,CAAC,CAAC;QACnJ,IAAI,CAAC,cAAc,GAAC,EAAC,EAAE,EAAC,IAAI,SAAS,CAAC,EAAC,GAAG,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,CAAC,EAAC,MAAM,EAAC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAC,CAAC;QAC7F,IAAI,CAAC,MAAM,GAAC,EAAC,EAAE,EAAC,IAAI,SAAS,CAAC,EAAC,GAAG,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,CAAC,EAAC,MAAM,EAAC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAC,CAAC;IACvF,CAAC;IACD,QAAQ,CAAC,KAAiB;QACxB,MAAM,KAAK,GAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAC,CAAC,CAAC,CAAC,CAAC,EAAC,MAAM,GAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAC,CAAC,KAAK,GAAC,CAAC,CAAC,CAAC,CAAC;QAC1G,MAAM,IAAI,GAAC,IAAI,WAAW,CAAC,KAAK,GAAC,MAAM,GAAC,CAAC,CAAC,CAAC;QAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,MAAM,GAAC,EAAC,IAAI,EAAC,KAAK,EAAC,MAAM,EAAC,CAAC;IACxC,CAAC;IACD,SAAS,CAAC,IAAY,EAAC,OAAyB;QAC9C,IAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM;YAAC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC5E,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,KAAG,IAAI,iBAAiB,CAAC,aAAa,EAAC,IAAI,CAAC,QAAQ,EAAC,EAAC,MAAM,EAAC,aAAa,EAAC,OAAO,EAAC,CAAC,OAAO,CAAC,EAAC,CAAC,CAAC;QAC/G,MAAM,IAAI,GAAC,IAAI,CAAC,WAAW,CAAC;QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAA,IAAI,CAAC,WAAW,CAAC,EAAC,IAAI,EAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAC,OAAO,EAAC,IAAI,CAAC,OAAO,EAAC,OAAO,EAAC,CAAC,GAAG,OAAO,CAAC,UAAU,EAAC,OAAO,CAAC,aAAa,EAAC,OAAO,CAAC,WAAW,CAAC,EAAC,WAAW,EAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAC,CAAC,CAAC;QAC5Q,IAAI,CAAC,UAAU,CAAC,EAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,GAAC,CAAC,CAAC,GAAC,CAAC,CAAC,EAAC,QAAQ,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAC,MAAM,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAC,CAAC,CAAC;QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/I,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,EAAE,GAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAC,IAAI,WAAW,EAAE,EAAE,KAAK,GAAC,IAAI,CAAC,KAAK,EAAC,MAAM,GAAC,IAAI,CAAC,MAAM,CAAC;QAC9F,IAAG,CAAC;YACF,MAAM,WAAW,GAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,GAAC,CAAC,CAAC,GAAC,CAAC,CAAC,CAAC;YACxD,MAAM,IAAI,GAAC,IAAI,KAAG,OAAO,IAAE,IAAI,KAAG,WAAW,CAAA,CAAC,CAAA,UAAU,CAAA,CAAC,CAAA,IAAI,KAAG,eAAe,CAAA,CAAC,CAAA,SAAS,CAAA,CAAC,CAAA,IAAI,KAAG,gBAAgB,CAAA,CAAC,CAAA,UAAU,CAAA,CAAC,CAAA,UAAU,CAAC;YACxI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAC,CAAC,IAAI,KAAG,IAAI,CAAA,CAAC,CAAA,IAAI,CAAC,MAAO,CAAC,EAAE,CAAA,CAAC,CAAA,IAAI,KAAG,QAAQ,CAAA,CAAC,CAAA,IAAI,CAAC,MAAO,CAAC,MAAM,CAAA,CAAC,CAAA,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpH,IAAG,IAAI,KAAG,IAAI,EAAC,CAAC;gBACd,MAAM,MAAM,GAAC,IAAI,WAAW,CAAC,KAAK,GAAC,MAAM,GAAC,CAAC,CAAC,EAAC,IAAI,GAAC,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACjF,EAAE,CAAC,UAAU,CAAC,CAAC,EAAC,CAAC,EAAC,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,YAAY,EAAC,EAAE,CAAC,YAAY,EAAC,MAAM,CAAC,CAAC;gBACvE,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,MAAM,EAAC,CAAC,EAAE;oBAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAC,CAAC,GAAC,CAAC,CAAC,GAAC,KAAK,GAAC,CAAC,EAAC,CAAC,MAAM,GAAC,CAAC,CAAC,GAAC,KAAK,GAAC,CAAC,CAAC,EAAC,CAAC,GAAC,KAAK,GAAC,CAAC,CAAC,CAAC;gBACtG,OAAO,EAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,CAAC;YAC7B,CAAC;YACD,MAAM,IAAI,GAAC,cAAc,CAAC,EAAE,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,CAAC,CAAC;YACjD,IAAG,IAAI,KAAG,QAAQ,EAAC,CAAC;gBAAA,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,IAAI,CAAC,MAAM,EAAC,CAAC,IAAE,CAAC;oBAAC,IAAI,CAAC,CAAC,CAAC,GAAC,CAAC,CAAC;gBAAA,OAAO,EAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,CAAC;YAAA,CAAC;YACzF,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAA,MAAM,QAAQ,GAAC,cAAc,CAAC,EAAE,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,CAAC,CAAC;YAC5G,KAAI,IAAI,CAAC,GAAC,CAAC,EAAC,CAAC,GAAC,KAAK,GAAC,MAAM,EAAC,CAAC,EAAE,EAAC,CAAC;gBAC9B,MAAM,CAAC,GAAC,CAAC,GAAC,CAAC,EAAC,IAAI,GAAC,QAAQ,CAAC,CAAC,GAAC,CAAC,CAAC,EAAC,GAAG,GAAC,IAAI,GAAC,CAAC,CAAA,CAAC,CAAA,CAAC,GAAC,IAAI,CAAA,CAAC,CAAA,CAAC,EAAC,KAAK,GAAC,IAAI,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvF,IAAG,IAAI,KAAG,OAAO;oBAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAC,GAAG,EAAC,CAAC,EAAC,CAAC,EAAC,KAAK,CAAC,EAAC,CAAC,CAAC,CAAC;qBACjD,IAAG,IAAI,KAAG,WAAW;oBAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,GAAG,EAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,GAAG,EAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,GAAG,EAAC,KAAK,CAAC,EAAC,CAAC,CAAC,CAAC;qBACpF,IAAG,IAAI,KAAG,UAAU;oBAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAC,GAAG,EAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,GAAG,EAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,GAAG,EAAC,KAAK,CAAC,EAAC,CAAC,CAAC,CAAC;qBAClF,CAAC;oBAAA,MAAM,KAAK,GAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,EAAC,KAAK,GAAC,KAAK,GAAC,CAAC,CAAA,CAAC,CAAA,CAAC,GAAC,KAAK,CAAA,CAAC,CAAA,CAAC,CAAC;oBAAA,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAC,KAAK,EAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,KAAK,EAAC,IAAI,CAAC,CAAC,GAAC,CAAC,CAAC,GAAC,KAAK,EAAC,KAAK,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC;gBAAA,CAAC;YACjJ,CAAC;YACD,OAAO,EAAC,KAAK,EAAC,MAAM,EAAC,IAAI,EAAC,CAAC;QAC7B,CAAC;gBAAO,CAAC;YAAA,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAAA,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,KAAG,OAAO,IAAI,CAAC,KAAK,GAAC,IAAI,CAAC,MAAM,GAAC,CAAC,CAAC,GAAC,EAAE,GAAC,EAAE,GAAC,CAAC,IAAI,CAAC,WAAW,CAAA,CAAC,CAAA,CAAC,CAAA,CAAC,CAAA,CAAC,CAAC,CAAC,GAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAC,EAAE,CAAC,CAAA,CAAC;IAClH,OAAO,KAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAA,IAAI,CAAC,WAAW,GAAC,SAAS,CAAC,CAAA,MAAM,EAAE,GAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA,KAAI,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY;QAAC,KAAI,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;YAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA,IAAI,CAAC,YAAY,CAAC,MAAM,GAAC,CAAC,CAAC,CAAA,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA,IAAI,CAAC,MAAM,GAAC,SAAS,CAAC,CAAA,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA,IAAI,CAAC,cAAc,GAAC,SAAS,CAAC,CAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA,CAAC;CAC1a","sourcesContent":["import displayShader from './glsl/aovDisplay.frag.js';\nimport {WebGLFullQuadPass} from './WebGLFullQuadPass.js';\nimport {AOV_KINDS} from './aov.js';\nimport {AOV_ID_COMPONENTS, validateAovDisplay, type AovDisplayOptions} from './aovDisplay.js';\nimport {AovHistory, type AovKind, type AovFrameSnapshot} from './aov.js';\nimport {Texture2D, FrameBuffer, type WebGLDevice} from './webgl.js';\nimport {readRgbaPixels} from './WebGLReadback.js';\nconst names = ['geometry','position','diffuse','specular'] as const;\nexport class WebGLAov {\n  private displayPass?: WebGLFullQuadPass<string,'color'>;\n  readonly history=new AovHistory();\n  width=0; height=0; samples=0; centerReady=false; frame?: AovFrameSnapshot;\n  readonly accumulation: Record<typeof names[number],Texture2D>[]=[];\n  previousCenter: {id:Texture2D; motion:Texture2D} | undefined;\n  center: {id:Texture2D; motion:Texture2D} | undefined;\n  scene = new Texture2D({type: 5125, minFilter:9728,magFilter:9728});\n  constructor(readonly renderer: WebGLDevice) {}\n  reset(){if(this.centerReady){const swap=this.previousCenter;this.previousCenter=this.center;this.center=swap;}this.samples=0;this.centerReady=false;this.frame=undefined;}\n  resize(width:number,height:number){\n    if(width===this.width && height===this.height)return;\n    this.dispose();this.history.clear();this.reset();this.width=width;this.height=height;\n    const options={width,height,type:5126,minFilter:9728,magFilter:9728};\n    for(let i=0;i<2;i++)this.accumulation.push(Object.fromEntries(names.map(n=>[n,new Texture2D(options)])) as Record<typeof names[number],Texture2D>);\n    this.previousCenter={id:new Texture2D({...options,type:5125}),motion:new Texture2D(options)};\n    this.center={id:new Texture2D({...options,type:5125}),motion:new Texture2D(options)};\n  }\n  setScene(words:Uint32Array){\n    const width=Math.min(1024,Math.max(1,Math.ceil(words.length/4))),height=Math.ceil(words.length/(width*4));\n    const data=new Uint32Array(width*height*4);data.set(words);\n    this.scene.source={data,width,height};\n  }\n  visualize(kind:AovKind,options:AovDisplayOptions):Texture2D {\n    if(!this.samples || !this.center)throw new Error('AOV output is not ready');\n    validateAovDisplay(options);\n    this.displayPass??=new WebGLFullQuadPass('AOV display',this.renderer,{shader:displayShader,outputs:['color']});\n    const pass=this.displayPass;pass.setSize(this.width,this.height);pass.setUniforms({kind:AOV_KINDS.indexOf(kind),samples:this.samples,mapping:[...options.depthRange,options.positionScale,options.motionScale],idComponent:AOV_ID_COMPONENTS.indexOf(options.idComponent)});\n    pass.createPass({...this.accumulation[(this.samples-1)%2],identity:this.center.id,motion:this.center.motion});return pass.getOutput('color');\n  }\n  async read(kind:AovKind){\n    const gl=this.renderer.gl, framebuffer=new FrameBuffer(), width=this.width,height=this.height;\n    try{\n      const accumulated=this.accumulation[(this.samples-1)%2];\n      const name=kind==='depth'||kind==='roughness'?'geometry':kind==='diffuseAlbedo'?'diffuse':kind==='specularAlbedo'?'specular':'position';\n      framebuffer.bind(this.renderer,[kind==='id'?this.center!.id:kind==='motion'?this.center!.motion:accumulated[name]]);\n      if(kind==='id'){\n        const source=new Uint32Array(width*height*4),data=new Uint32Array(source.length);\n        gl.readPixels(0,0,width,height,gl.RGBA_INTEGER,gl.UNSIGNED_INT,source);\n        for(let y=0;y<height;y++)data.set(source.subarray((height-1-y)*width*4,(height-y)*width*4),y*width*4);\n        return {width,height,data};\n      }\n      const data=readRgbaPixels(gl,width,height,false);\n      if(kind==='motion'){for(let o=2;o<data.length;o+=4)data[o]=0;return {width,height,data};}\n      framebuffer.bind(this.renderer,[accumulated.position]);const coverage=readRgbaPixels(gl,width,height,false);\n      for(let p=0;p<width*height;p++){\n        const o=p*4,hits=coverage[o+3],inv=hits>0?1/hits:0,alpha=hits/Math.max(1,this.samples);\n        if(kind==='depth')data.set([data[o]*inv,0,0,alpha],o);\n        else if(kind==='roughness')data.set([data[o+1]*inv,data[o+2]*inv,data[o+3]*inv,alpha],o);\n        else if(kind==='position')data.set([data[o]*inv,data[o+1]*inv,data[o+2]*inv,alpha],o);\n        else{const count=data[o+3],scale=count>0?1/count:0;data.set([data[o]*scale,data[o+1]*scale,data[o+2]*scale,count/Math.max(1,this.samples)],o);}\n      }\n      return {width,height,data};\n    }finally{framebuffer.dispose(this.renderer);}\n  }\n  get bytes(){return this.width*this.height*(2*64+64+(this.displayPass?4:0))+this.scene.width*this.scene.height*16;}\n  dispose(){this.displayPass?.dispose();this.displayPass=undefined;const gl=this.renderer.gl;for(const set of this.accumulation)for(const texture of Object.values(set))texture.dispose(gl);this.accumulation.length=0;this.center?.id.dispose(gl);this.center?.motion.dispose(gl);this.center=undefined;this.previousCenter?.id.dispose(gl);this.previousCenter?.motion.dispose(gl);this.previousCenter=undefined;this.scene.dispose(gl);}\n}\n"]}

package/lib/renderer/WebGLFullQuadPass.d.ts

@@ -1,5 +1,5 @@
-import { FragmentShader, ShaderDefineValue } from './shader.js';
-import { WebGLDevice, Texture2D, TextureOptions } from './webgl.js';
+import { FragmentShader, type ShaderDefineValue } from './shader.js';
+import { WebGLDevice, Texture2D, type TextureOptions } from './webgl.js';
 export interface WebGLFullQuadPassOutput extends TextureOptions {
 }
 export interface WebGLPassOptions {
@@ -25,7 +25,7 @@ export interface WebGLPassOptions {
 export declare class WebGLFullQuadPass<I extends string, O extends string> {
     private readonly _renderer;
     private _bindings;
-    private readonly _sourceShader;
+    private _sourceShader;
     private readonly _outputs;
     private readonly _frameBuffer;
     private _outputTextures;
@@ -43,6 +43,7 @@ export declare class WebGLFullQuadPass<I extends string, O extends string> {
         outputs?: O[];
         outputParams?: Partial<Record<O, WebGLFullQuadPassOutput>>;
     });
+    setShader(shader: FragmentShader): void;
     reserveCapacity(): void;
     private _samplingShader;
     setSize(width: number, height: number): void;
@@ -56,9 +57,11 @@ export declare class WebGLFullQuadPass<I extends string, O extends string> {
     private readonly _retainedOutputs;
     retainOutput(texture: Texture2D): void;
     releaseOutput(texture: Texture2D): void;
+    loadDiagnosticOutputs(outputs: Partial<Record<O, Texture2D>>): void;
     getOutput(name: O): Record<O, Texture2D>[O];
     private _prepareOutputs;
-    createPass(inputs: Record<I, Texture2D>, explicitOutputs?: Partial<Record<O, Texture2D>>, options?: WebGLPassOptions): void;
+    isProgramReady(inputs?: Record<I, Texture2D>): boolean;
+    createPass(inputs: Record<I, Texture2D>, explicitOutputs?: Partial<Record<O, Texture2D>>, options?: WebGLPassOptions): boolean;
     releaseTarget(target: object): void;
     getMemoryBytes(target?: object): number;
     dispose(): void;

package/lib/renderer/WebGLFullQuadPass.js

@@ -37,6 +37,10 @@ export class WebGLFullQuadPass {
             options.outputParams?.[name] || {}
         ])));
     }
+    setShader(shader) {
+        this._sourceShader = shader;
+        this._bindings = new WebGLProgramBindings(this._samplingShader(shader, this._reserveCapacity, { ...shader.uniforms, ...this._bindings.uniforms }, this._bindings.defines));
+    }
     reserveCapacity() {
         if (this._reserveCapacity)
             return;
@@ -49,7 +53,7 @@ export class WebGLFullQuadPass {
         if (scratch)
             for (const name of textures)
                 uniforms[`${name}RegionSize`] = { type: 'ivec2', value: [1, 1] };
-        const sampled = new FragmentShader({ name: shader.name, outputs: shader.outputs, defines, uniforms,
+        const sampled = new FragmentShader({ name: shader.name, outputs: shader.outputs, outputTypes: shader.outputTypes, defines, uniforms,
             includes: [{ defines: {}, uniforms: {}, main: '', functions: [() => scratchGLSLFunctions(textures, scratch), ...shader.functions] }],
             main: shader.main });
         sampled.parallelCompile = shader.parallelCompile;
@@ -113,6 +117,13 @@ export class WebGLFullQuadPass {
         if (!Object.values(this._outputTextures).includes(texture))
             texture.dispose(this._renderer.gl);
     }
+    // Internal fixed-accumulation loader; transfer ownership to the selected target.
+    loadDiagnosticOutputs(outputs) {
+        for (const name of Object.keys(outputs)) {
+            this._outputTextures[name]?.dispose(this._renderer.gl);
+            this._outputTextures[name] = outputs[name];
+        }
+    }
     getOutput(name) {
         return this._outputTextures[name];
     }
@@ -132,6 +143,11 @@ export class WebGLFullQuadPass {
             setTextureRegion(texture, this._width, this._height);
         }
     }
+    isProgramReady(inputs) {
+        if (inputs)
+            this._bindings.setUniforms(inputs);
+        return this._renderer.isProgramCompiled(this._bindings.getProgram(this._renderer));
+    }
     createPass(inputs, explicitOutputs, options = {}) {
         const renderer = this._renderer;
         const gl = renderer.gl;
@@ -169,7 +185,10 @@ export class WebGLFullQuadPass {
                 this.setUniform(`${name}RegionSize`, [region.width, region.height]);
             }
         this._bindings.setUniforms(inputs);
-        this._bindings.bind(renderer);
+        if (!this._bindings.bind(renderer)) {
+            gl.disable(gl.SCISSOR_TEST);
+            return false;
+        }
         gl.disable(gl.DEPTH_TEST);
         if (options.blend) {
             gl.enable(gl.BLEND);
@@ -181,6 +200,7 @@ export class WebGLFullQuadPass {
         }
         gl.drawArrays(gl.TRIANGLES, 0, 3);
         gl.disable(gl.SCISSOR_TEST);
+        return true;
     }
     releaseTarget(target) {
         const outputs = this._targetOutputs.get(target);