@meimu/mutracer 0.0.0-stage → 0.1.0

package/lib/renderer/WebGLBloomPass.js

@@ -0,0 +1,113 @@
+import { constants } from './webgl.js';
+import { WebGLFullQuadPass } from './WebGLFullQuadPass.js';
+import { blendCompositeFragment, downsampleCompositeFragment, gaussianBlurCompositeFragment } from './webglShaders.js';
+import { brightFragment } from './glsl/webglPipeline.frag.js';
+const COUNT = 5;
+const outputParams = {
+    color: {
+        type: constants.HALF_FLOAT,
+        minFilter: constants.LINEAR,
+        magFilter: constants.LINEAR
+    }
+};
+/** WebGL implementation of the same explicit bloom pass chain as WGPUBloomPass. */
+export default class WebGLBloomPass {
+    _brightPass;
+    _downsamplePasses = [];
+    _blurHPasses = [];
+    _blurVPasses = [];
+    _blendPasses = [];
+    constructor(renderer) {
+        this._brightPass = new WebGLFullQuadPass('bloomBright', renderer, {
+            shader: brightFragment,
+            outputs: ['color'],
+            outputParams
+        });
+        for (let i = 0; i <= COUNT; i++) {
+            const downsample = new WebGLFullQuadPass(`bloomDownsample${i}`, renderer, { shader: downsampleCompositeFragment, outputs: ['color'], outputParams });
+            const blurH = new WebGLFullQuadPass(`bloomBlurH${i}`, renderer, { shader: gaussianBlurCompositeFragment, outputs: ['color'], outputParams });
+            const blurV = new WebGLFullQuadPass(`bloomBlurV${i}`, renderer, { shader: gaussianBlurCompositeFragment, outputs: ['color'], outputParams });
+            blurH.setUniform('blurDir', 0);
+            blurV.setUniform('blurDir', 1);
+            this._downsamplePasses.push(downsample);
+            this._blurHPasses.push(blurH);
+            this._blurVPasses.push(blurV);
+            if (i > 0) {
+                this._blendPasses.push(new WebGLFullQuadPass(`bloomBlend${i}`, renderer, {
+                    shader: blendCompositeFragment,
+                    outputs: ['color'],
+                    outputParams
+                }));
+            }
+        }
+    }
+    reserveCapacity() {
+        [this._brightPass, ...this._downsamplePasses, ...this._blurHPasses, ...this._blurVPasses, ...this._blendPasses].forEach(pass => pass.reserveCapacity());
+    }
+    setSize(width, height) {
+        this._brightPass.setSize(width, height);
+        for (let i = 0; i <= COUNT; i++) {
+            this._downsamplePasses[i].setSize(width >> (i + 1), height >> (i + 1));
+            this._blurHPasses[i].setSize(width >> (i + 1), height >> (i + 1));
+            this._blurVPasses[i].setSize(width >> i, height >> i);
+            if (i > 0) {
+                this._blendPasses[i - 1].setSize(width >> (i - 1), height >> (i - 1));
+            }
+        }
+    }
+    setBrightThreshold(threshold) {
+        this._brightPass.setUniform('threshold', threshold);
+    }
+    setRadius(radius) {
+        const weight = 1 - Math.max(Math.min(radius ** 0.3 * 0.8, 0.8), 0);
+        this._blendPasses.forEach((pass) => {
+            pass.setUniform('weight1', 1 - weight);
+            pass.setUniform('weight2', weight);
+        });
+        const blurSize = Math.max(Math.min(radius * 2, 1), 0.2);
+        [...this._blurHPasses, ...this._blurVPasses].forEach((pass) => pass.setUniform('blurSize', blurSize));
+    }
+    createPass(colorTex) {
+        this._brightPass.createPass({ colorTex });
+        for (let i = 0; i <= COUNT; i++) {
+            this._downsamplePasses[i].createPass({
+                colorTex: i === 0
+                    ? this._brightPass.getOutput('color')
+                    : this._downsamplePasses[i - 1].getOutput('color')
+            });
+        }
+        for (let i = COUNT; i >= 0; i--) {
+            this._blurHPasses[i].createPass({
+                colorTex: this._downsamplePasses[i].getOutput('color')
+            });
+            this._blurVPasses[i].createPass({
+                colorTex: this._blurHPasses[i].getOutput('color')
+            });
+        }
+        for (let i = COUNT - 1; i >= 0; i--) {
+            this._blendPasses[i].createPass({
+                colorTex1: i === COUNT - 1
+                    ? this._blurVPasses[COUNT].getOutput('color')
+                    : this._blendPasses[i + 1].getOutput('color'),
+                colorTex2: this._blurVPasses[i].getOutput('color')
+            });
+        }
+    }
+    getOutput() {
+        return this._blendPasses[0].getOutput('color');
+    }
+    getMemoryBytes() {
+        return [this._brightPass, ...this._downsamplePasses, ...this._blurHPasses, ...this._blurVPasses, ...this._blendPasses]
+            .reduce((sum, pass) => sum + pass.getMemoryBytes(), 0);
+    }
+    dispose() {
+        [
+            this._brightPass,
+            ...this._downsamplePasses,
+            ...this._blurHPasses,
+            ...this._blurVPasses,
+            ...this._blendPasses
+        ].forEach((pass) => pass.dispose());
+    }
+}
+//# sourceMappingURL=WebGLBloomPass.js.map

package/lib/renderer/WebGLBloomPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLBloomPass.js","sourceRoot":"","sources":["../../src/renderer/WebGLBloomPass.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants, WebGLDevice, Texture2D } from './webgl.js';\nimport { WebGLFullQuadPass } from './WebGLFullQuadPass.js';\nimport {\n  blendCompositeFragment,\n  downsampleCompositeFragment,\n  gaussianBlurCompositeFragment\n} from './webglShaders.js';\nimport { brightFragment } from './glsl/webglPipeline.frag.js';\n\nconst COUNT = 5;\nconst outputParams = {\n  color: {\n    type: constants.HALF_FLOAT,\n    minFilter: constants.LINEAR,\n    magFilter: constants.LINEAR\n  }\n};\n\n/** WebGL implementation of the same explicit bloom pass chain as WGPUBloomPass. */\nexport default class WebGLBloomPass {\n  private readonly _brightPass: WebGLFullQuadPass<'colorTex', 'color'>;\n  private readonly _downsamplePasses: WebGLFullQuadPass<'colorTex', 'color'>[] = [];\n  private readonly _blurHPasses: WebGLFullQuadPass<'colorTex', 'color'>[] = [];\n  private readonly _blurVPasses: WebGLFullQuadPass<'colorTex', 'color'>[] = [];\n  private readonly _blendPasses: WebGLFullQuadPass<\n    'colorTex1' | 'colorTex2',\n    'color'\n  >[] = [];\n\n  constructor(renderer: WebGLDevice) {\n    this._brightPass = new WebGLFullQuadPass('bloomBright', renderer, {\n      shader: brightFragment,\n      outputs: ['color'],\n      outputParams\n    });\n    for (let i = 0; i <= COUNT; i++) {\n      const downsample = new WebGLFullQuadPass<'colorTex', 'color'>(\n        `bloomDownsample${i}`,\n        renderer,\n        { shader: downsampleCompositeFragment, outputs: ['color'], outputParams }\n      );\n      const blurH = new WebGLFullQuadPass<'colorTex', 'color'>(\n        `bloomBlurH${i}`,\n        renderer,\n        { shader: gaussianBlurCompositeFragment, outputs: ['color'], outputParams }\n      );\n      const blurV = new WebGLFullQuadPass<'colorTex', 'color'>(\n        `bloomBlurV${i}`,\n        renderer,\n        { shader: gaussianBlurCompositeFragment, outputs: ['color'], outputParams }\n      );\n      blurH.setUniform('blurDir', 0);\n      blurV.setUniform('blurDir', 1);\n      this._downsamplePasses.push(downsample);\n      this._blurHPasses.push(blurH);\n      this._blurVPasses.push(blurV);\n      if (i > 0) {\n        this._blendPasses.push(\n          new WebGLFullQuadPass(`bloomBlend${i}`, renderer, {\n            shader: blendCompositeFragment,\n            outputs: ['color'],\n            outputParams\n          })\n        );\n      }\n    }\n  }\n\n  reserveCapacity() {\n    [this._brightPass, ...this._downsamplePasses, ...this._blurHPasses, ...this._blurVPasses, ...this._blendPasses].forEach(pass => pass.reserveCapacity());\n  }\n\n  setSize(width: number, height: number) {\n    this._brightPass.setSize(width, height);\n    for (let i = 0; i <= COUNT; i++) {\n      this._downsamplePasses[i].setSize(width >> (i + 1), height >> (i + 1));\n      this._blurHPasses[i].setSize(width >> (i + 1), height >> (i + 1));\n      this._blurVPasses[i].setSize(width >> i, height >> i);\n      if (i > 0) {\n        this._blendPasses[i - 1].setSize(width >> (i - 1), height >> (i - 1));\n      }\n    }\n  }\n\n  setBrightThreshold(threshold: number) {\n    this._brightPass.setUniform('threshold', threshold);\n  }\n\n  setRadius(radius: number) {\n    const weight = 1 - Math.max(Math.min(radius ** 0.3 * 0.8, 0.8), 0);\n    this._blendPasses.forEach((pass) => {\n      pass.setUniform('weight1', 1 - weight);\n      pass.setUniform('weight2', weight);\n    });\n    const blurSize = Math.max(Math.min(radius * 2, 1), 0.2);\n    [...this._blurHPasses, ...this._blurVPasses].forEach((pass) =>\n      pass.setUniform('blurSize', blurSize)\n    );\n  }\n\n  createPass(colorTex: Texture2D) {\n    this._brightPass.createPass({ colorTex });\n    for (let i = 0; i <= COUNT; i++) {\n      this._downsamplePasses[i].createPass({\n        colorTex:\n          i === 0\n            ? this._brightPass.getOutput('color')\n            : this._downsamplePasses[i - 1].getOutput('color')\n      });\n    }\n    for (let i = COUNT; i >= 0; i--) {\n      this._blurHPasses[i].createPass({\n        colorTex: this._downsamplePasses[i].getOutput('color')\n      });\n      this._blurVPasses[i].createPass({\n        colorTex: this._blurHPasses[i].getOutput('color')\n      });\n    }\n    for (let i = COUNT - 1; i >= 0; i--) {\n      this._blendPasses[i].createPass({\n        colorTex1:\n          i === COUNT - 1\n            ? this._blurVPasses[COUNT].getOutput('color')\n            : this._blendPasses[i + 1].getOutput('color'),\n        colorTex2: this._blurVPasses[i].getOutput('color')\n      });\n    }\n  }\n\n  getOutput() {\n    return this._blendPasses[0].getOutput('color');\n  }\n\n  getMemoryBytes() {\n    return [this._brightPass, ...this._downsamplePasses, ...this._blurHPasses, ...this._blurVPasses, ...this._blendPasses]\n      .reduce((sum, pass) => sum + pass.getMemoryBytes(), 0);\n  }\n\n  dispose() {\n    [\n      this._brightPass,\n      ...this._downsamplePasses,\n      ...this._blurHPasses,\n      ...this._blurVPasses,\n      ...this._blendPasses\n    ].forEach((pass) => pass.dispose());\n  }\n}\n"]}

package/lib/renderer/WebGLFullQuadPass.d.ts

@@ -0,0 +1,65 @@
+import { FragmentShader, ShaderDefineValue } from './shader.js';
+import { WebGLDevice, Texture2D, TextureOptions } from './webgl.js';
+export interface WebGLFullQuadPassOutput extends TextureOptions {
+}
+export interface WebGLPassOptions {
+    clear?: boolean;
+    blend?: boolean;
+    viewport?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    scissor?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Explicit WebGL 2.0 render pass matching the lifecycle of WGPUFullQuadPass.
+ * It owns its output textures and framebuffer; there is no render graph.
+ */
+export declare class WebGLFullQuadPass<I extends string, O extends string> {
+    private readonly _renderer;
+    private _bindings;
+    private readonly _sourceShader;
+    private readonly _outputs;
+    private readonly _frameBuffer;
+    private _outputTextures;
+    private readonly _targetOutputs;
+    useTarget(target: object): void;
+    private _outputParams;
+    private _reserveCapacity;
+    private _capacityWidth;
+    private _capacityHeight;
+    private _width;
+    private _height;
+    private _renderToScreen;
+    constructor(_label: string, renderer: WebGLDevice, options: {
+        shader: FragmentShader;
+        outputs?: O[];
+        outputParams?: Partial<Record<O, WebGLFullQuadPassOutput>>;
+    });
+    reserveCapacity(): void;
+    private _samplingShader;
+    setSize(width: number, height: number): void;
+    setOutputs(outputs: readonly O[]): void;
+    setOutputParams(params: Record<O, WebGLFullQuadPassOutput>): void;
+    setRenderToScreen(renderToScreen?: boolean): void;
+    setUniform(label: string, data: unknown): boolean;
+    setUniforms(values: Record<string, unknown>): void;
+    getUniform(label: string): any;
+    setDefines(defines: Record<string, ShaderDefineValue | undefined>): boolean;
+    private readonly _retainedOutputs;
+    retainOutput(texture: Texture2D): void;
+    releaseOutput(texture: Texture2D): void;
+    getOutput(name: O): Record<O, Texture2D>[O];
+    private _prepareOutputs;
+    createPass(inputs: Record<I, Texture2D>, explicitOutputs?: Partial<Record<O, Texture2D>>, options?: WebGLPassOptions): void;
+    releaseTarget(target: object): void;
+    getMemoryBytes(target?: object): number;
+    dispose(): void;
+}

package/lib/renderer/WebGLFullQuadPass.js

@@ -0,0 +1,208 @@
+import { scratchGLSLFunctions } from './scratchSampling.js';
+import { setTextureRegion, textureRegion } from './textureRegion.js';
+import { FragmentShader } from './shader.js';
+import { FrameBuffer, Texture2D, WebGLProgramBindings } from './webgl.js';
+/**
+ * Explicit WebGL 2.0 render pass matching the lifecycle of WGPUFullQuadPass.
+ * It owns its output textures and framebuffer; there is no render graph.
+ */
+export class WebGLFullQuadPass {
+    _renderer;
+    _bindings;
+    _sourceShader;
+    _outputs;
+    _frameBuffer = new FrameBuffer();
+    _outputTextures = {};
+    _targetOutputs = new Map();
+    useTarget(target) {
+        let outputs = this._targetOutputs.get(target);
+        if (!outputs)
+            this._targetOutputs.set(target, outputs = {});
+        this._outputTextures = outputs;
+    }
+    _outputParams = {};
+    _reserveCapacity = false;
+    _capacityWidth = 1;
+    _capacityHeight = 1;
+    _width = 1;
+    _height = 1;
+    _renderToScreen = false;
+    constructor(_label, renderer, options) {
+        this._renderer = renderer;
+        this._sourceShader = options.shader;
+        this._bindings = new WebGLProgramBindings(this._samplingShader(options.shader));
+        this._outputs = options.outputs || options.shader.outputs;
+        this.setOutputParams(Object.fromEntries(this._outputs.map((name) => [
+            name,
+            options.outputParams?.[name] || {}
+        ])));
+    }
+    reserveCapacity() {
+        if (this._reserveCapacity)
+            return;
+        this._reserveCapacity = true;
+        this._bindings = new WebGLProgramBindings(this._samplingShader(this._sourceShader, true, this._bindings.uniforms, this._bindings.defines));
+    }
+    _samplingShader(shader, scratch = false, uniforms = shader.uniforms, defines = shader.defines) {
+        const textures = Object.keys(shader.uniforms).filter(name => shader.uniforms[name].type === 'sampler2D');
+        uniforms = { ...uniforms };
+        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,
+            includes: [{ defines: {}, uniforms: {}, main: '', functions: [() => scratchGLSLFunctions(textures, scratch), ...shader.functions] }],
+            main: shader.main });
+        sampled.parallelCompile = shader.parallelCompile;
+        return sampled;
+    }
+    setSize(width, height) {
+        if (this._width === width && this._height === height)
+            return;
+        this._width = Math.max(1, width);
+        this._height = Math.max(1, height);
+        this._capacityWidth = Math.max(this._capacityWidth, this._width);
+        this._capacityHeight = Math.max(this._capacityHeight, this._height);
+        this.setUniform('viewportSize', [this._width, this._height]);
+    }
+    setOutputs(outputs) {
+        for (const name of this._outputs)
+            if (!outputs.includes(name)) {
+                this._outputTextures[name]?.dispose(this._renderer.gl);
+                delete this._outputTextures[name];
+            }
+        this._outputs.splice(0, this._outputs.length, ...outputs);
+    }
+    setOutputParams(params) {
+        this._outputParams = params;
+    }
+    setRenderToScreen(renderToScreen = true) {
+        this._renderToScreen = renderToScreen;
+    }
+    setUniform(label, data) {
+        return this._bindings.set(label, data);
+    }
+    setUniforms(values) {
+        this._bindings.setUniforms(values);
+    }
+    getUniform(label) {
+        return this._bindings.get(label);
+    }
+    setDefines(defines) {
+        let changed = false;
+        for (const [name, value] of Object.entries(defines)) {
+            const oldValue = this._bindings.defines[name];
+            if (!value) {
+                if (name in this._bindings.defines) {
+                    this._bindings.deleteDefine(name);
+                    changed = true;
+                }
+            }
+            else if (oldValue !== value) {
+                this._bindings.setDefine(name, value);
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    _retainedOutputs = new Set();
+    retainOutput(texture) { if (Object.values(this._outputTextures).includes(texture))
+        this._retainedOutputs.add(texture); }
+    releaseOutput(texture) {
+        if (!this._retainedOutputs.delete(texture))
+            return;
+        if (!Object.values(this._outputTextures).includes(texture))
+            texture.dispose(this._renderer.gl);
+    }
+    getOutput(name) {
+        return this._outputTextures[name];
+    }
+    _prepareOutputs(explicitOutputs) {
+        const gl = this._renderer.gl;
+        for (const name of this._outputs) {
+            const explicit = explicitOutputs?.[name];
+            const current = this._outputTextures[name];
+            const retainedResize = current && this._retainedOutputs.has(current) &&
+                (current.width !== this._width || current.height !== this._height);
+            const texture = explicit ||
+                (retainedResize ? new Texture2D(this._outputParams[name]) : undefined) ||
+                this._outputTextures[name] ||
+                new Texture2D(this._outputParams[name]);
+            texture.ensureStorage(gl, this._reserveCapacity ? this._capacityWidth : this._width, this._reserveCapacity ? this._capacityHeight : this._height, this._outputParams[name]);
+            this._outputTextures[name] = texture;
+            setTextureRegion(texture, this._width, this._height);
+        }
+    }
+    createPass(inputs, explicitOutputs, options = {}) {
+        const renderer = this._renderer;
+        const gl = renderer.gl;
+        if (this._renderToScreen) {
+            gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+        }
+        else {
+            this._prepareOutputs(explicitOutputs);
+            this._frameBuffer.bind(renderer, this._outputs.map((name) => this._outputTextures[name]));
+        }
+        const viewport = options.viewport || {
+            x: 0,
+            y: 0,
+            width: this._width,
+            height: this._height
+        };
+        renderer.setViewport(viewport.x, viewport.y, viewport.width, viewport.height);
+        // Clear the full accumulation target before enabling the tile scissor.
+        // Otherwise every tile outside the first one retains stale camera data.
+        if (options.clear) {
+            gl.disable(gl.SCISSOR_TEST);
+            gl.clearColor(0, 0, 0, 0);
+            gl.clear(gl.COLOR_BUFFER_BIT);
+        }
+        if (options.scissor) {
+            gl.enable(gl.SCISSOR_TEST);
+            gl.scissor(options.scissor.x, options.scissor.y, options.scissor.width, options.scissor.height);
+        }
+        else {
+            gl.disable(gl.SCISSOR_TEST);
+        }
+        if (this._reserveCapacity)
+            for (const [name, texture] of Object.entries(inputs)) {
+                const region = textureRegion(texture);
+                this.setUniform(`${name}RegionSize`, [region.width, region.height]);
+            }
+        this._bindings.setUniforms(inputs);
+        this._bindings.bind(renderer);
+        gl.disable(gl.DEPTH_TEST);
+        if (options.blend) {
+            gl.enable(gl.BLEND);
+            gl.blendEquation(gl.FUNC_ADD);
+            gl.blendFunc(gl.ONE, gl.ONE);
+        }
+        else {
+            gl.disable(gl.BLEND);
+        }
+        gl.drawArrays(gl.TRIANGLES, 0, 3);
+        gl.disable(gl.SCISSOR_TEST);
+    }
+    releaseTarget(target) {
+        const outputs = this._targetOutputs.get(target);
+        if (!outputs)
+            return;
+        this._targetOutputs.delete(target);
+        for (const texture of Object.values(outputs))
+            texture.dispose(this._renderer.gl);
+        if (outputs === this._outputTextures)
+            this._outputTextures = {};
+    }
+    getMemoryBytes(target) {
+        const outputs = target ? this._targetOutputs.get(target) ?? {} : this._outputTextures;
+        return Array.from(new Set([...Object.values(outputs), ...this._retainedOutputs]))
+            .reduce((sum, texture) => sum + texture.getMemoryBytes(), 0);
+    }
+    dispose() {
+        const gl = this._renderer.gl;
+        Array.from(new Set([this._outputTextures, ...this._targetOutputs.values()])).flatMap(outputs => Object.values(outputs)).forEach((texture) => texture.dispose(gl));
+        this._retainedOutputs.forEach(texture => texture.dispose(gl));
+        this._retainedOutputs.clear();
+        this._frameBuffer.dispose(this._renderer);
+    }
+}
+//# sourceMappingURL=WebGLFullQuadPass.js.map

package/lib/renderer/WebGLFullQuadPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLFullQuadPass.js","sourceRoot":"","sources":["../../src/renderer/WebGLFullQuadPass.ts"],"names":[],"mappings":"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","sourcesContent":["import {scratchGLSLFunctions} from './scratchSampling.js';\nimport {setTextureRegion, textureRegion} from './textureRegion.js';\nimport { FragmentShader, ShaderDefineValue } from './shader.js';\nimport {\n  FrameBuffer,\n  WebGLDevice,\n  Texture2D,\n  TextureOptions,\n  WebGLProgramBindings\n} from './webgl.js';\n\nexport interface WebGLFullQuadPassOutput extends TextureOptions {}\n\nexport interface WebGLPassOptions {\n  clear?: boolean;\n  blend?: boolean;\n  viewport?: { x: number; y: number; width: number; height: number };\n  scissor?: { x: number; y: number; width: number; height: number };\n}\n\n/**\n * Explicit WebGL 2.0 render pass matching the lifecycle of WGPUFullQuadPass.\n * It owns its output textures and framebuffer; there is no render graph.\n */\nexport class WebGLFullQuadPass<I extends string, O extends string> {\n  private readonly _renderer: WebGLDevice;\n  private _bindings: WebGLProgramBindings;\n  private readonly _sourceShader: FragmentShader;\n  private readonly _outputs: O[];\n  private readonly _frameBuffer = new FrameBuffer();\n  private _outputTextures = {} as Record<O, Texture2D>;\n  private readonly _targetOutputs = new Map<object, Record<O, Texture2D>>();\n  useTarget(target: object) {\n    let outputs = this._targetOutputs.get(target);\n    if (!outputs) this._targetOutputs.set(target, outputs = {} as Record<O, Texture2D>);\n    this._outputTextures = outputs;\n  }\n\n  private _outputParams = {} as Record<O, WebGLFullQuadPassOutput>;\n  private _reserveCapacity = false;\n  private _capacityWidth = 1;\n  private _capacityHeight = 1;\n  private _width = 1;\n  private _height = 1;\n  private _renderToScreen = false;\n\n  constructor(\n    _label: string,\n    renderer: WebGLDevice,\n    options: {\n      shader: FragmentShader;\n      outputs?: O[];\n      outputParams?: Partial<Record<O, WebGLFullQuadPassOutput>>;\n    }\n  ) {\n    this._renderer = renderer;\n    this._sourceShader = options.shader;\n    this._bindings = new WebGLProgramBindings(this._samplingShader(options.shader));\n    this._outputs = options.outputs || (options.shader.outputs as O[]);\n    this.setOutputParams(\n      Object.fromEntries(\n        this._outputs.map((name) => [\n          name,\n          options.outputParams?.[name] || {}\n        ])\n      ) as Record<O, WebGLFullQuadPassOutput>\n    );\n  }\n\n  reserveCapacity() {\n    if (this._reserveCapacity) return;\n    this._reserveCapacity = true;\n    this._bindings = new WebGLProgramBindings(this._samplingShader(\n      this._sourceShader, true, this._bindings.uniforms, this._bindings.defines\n    ));\n  }\n\n  private _samplingShader(\n    shader: FragmentShader,\n    scratch = false,\n    uniforms = shader.uniforms,\n    defines = shader.defines\n  ) {\n    const textures = Object.keys(shader.uniforms).filter(name => shader.uniforms[name].type === 'sampler2D');\n    uniforms = {...uniforms};\n    if (scratch) for (const name of textures) uniforms[`${name}RegionSize`] = {type: 'ivec2', value: [1, 1]};\n    const sampled = new FragmentShader({name: shader.name, outputs: shader.outputs, defines, uniforms,\n      includes: [{defines: {}, uniforms: {}, main: '', functions: [() => scratchGLSLFunctions(textures, scratch), ...shader.functions]}],\n      main: shader.main});\n    sampled.parallelCompile = shader.parallelCompile;\n    return sampled;\n  }\n\n  setSize(width: number, height: number) {\n    if (this._width === width && this._height === height) return;\n    this._width = Math.max(1, width);\n    this._height = Math.max(1, height);\n    this._capacityWidth = Math.max(this._capacityWidth, this._width);\n    this._capacityHeight = Math.max(this._capacityHeight, this._height);\n    this.setUniform('viewportSize', [this._width, this._height]);\n  }\n\n  setOutputs(outputs: readonly O[]) {\n    for (const name of this._outputs) if (!outputs.includes(name)) {\n      this._outputTextures[name]?.dispose(this._renderer.gl); delete this._outputTextures[name];\n    }\n    this._outputs.splice(0, this._outputs.length, ...outputs);\n  }\n  setOutputParams(params: Record<O, WebGLFullQuadPassOutput>) {\n    this._outputParams = params;\n  }\n\n  setRenderToScreen(renderToScreen = true) {\n    this._renderToScreen = renderToScreen;\n  }\n\n  setUniform(label: string, data: unknown) {\n    return this._bindings.set(label, data);\n  }\n\n  setUniforms(values: Record<string, unknown>) {\n    this._bindings.setUniforms(values);\n  }\n\n  getUniform(label: string) {\n    return this._bindings.get(label);\n  }\n\n  setDefines(\n    defines: Record<\n      string,\n      ShaderDefineValue | undefined\n    >\n  ) {\n    let changed = false;\n    for (const [name, value] of Object.entries(defines)) {\n      const oldValue = this._bindings.defines[name];\n      if (!value) {\n        if (name in this._bindings.defines) {\n          this._bindings.deleteDefine(name);\n          changed = true;\n        }\n      } else if (oldValue !== value) {\n        this._bindings.setDefine(name, value);\n        changed = true;\n      }\n    }\n    return changed;\n  }\n\n  private readonly _retainedOutputs = new Set<Texture2D>();\n  retainOutput(texture: Texture2D) { if (Object.values(this._outputTextures).includes(texture)) this._retainedOutputs.add(texture); }\n  releaseOutput(texture: Texture2D) {\n    if (!this._retainedOutputs.delete(texture)) return;\n    if (!Object.values(this._outputTextures).includes(texture)) texture.dispose(this._renderer.gl);\n  }\n\n  getOutput(name: O) {\n    return this._outputTextures[name];\n  }\n\n  private _prepareOutputs(explicitOutputs?: Partial<Record<O, Texture2D>>) {\n    const gl = this._renderer.gl;\n    for (const name of this._outputs) {\n      const explicit = explicitOutputs?.[name];\n      const current = this._outputTextures[name];\n      const retainedResize = current && this._retainedOutputs.has(current) &&\n        (current.width !== this._width || current.height !== this._height);\n      const texture =\n        explicit ||\n        (retainedResize ? new Texture2D(this._outputParams[name]) : undefined) ||\n        this._outputTextures[name] ||\n        new Texture2D(this._outputParams[name]);\n      texture.ensureStorage(\n        gl,\n        this._reserveCapacity ? this._capacityWidth : this._width,\n        this._reserveCapacity ? this._capacityHeight : this._height,\n        this._outputParams[name]\n      );\n      this._outputTextures[name] = texture;\n      setTextureRegion(texture, this._width, this._height);\n    }\n  }\n\n  createPass(\n    inputs: Record<I, Texture2D>,\n    explicitOutputs?: Partial<Record<O, Texture2D>>,\n    options: WebGLPassOptions = {}\n  ) {\n    const renderer = this._renderer;\n    const gl = renderer.gl;\n\n    if (this._renderToScreen) {\n      gl.bindFramebuffer(gl.FRAMEBUFFER, null);\n    } else {\n      this._prepareOutputs(explicitOutputs);\n      this._frameBuffer.bind(\n        renderer,\n        this._outputs.map((name) => this._outputTextures[name])\n      );\n    }\n\n    const viewport = options.viewport || {\n      x: 0,\n      y: 0,\n      width: this._width,\n      height: this._height\n    };\n    renderer.setViewport(\n      viewport.x,\n      viewport.y,\n      viewport.width,\n      viewport.height\n    );\n\n    // Clear the full accumulation target before enabling the tile scissor.\n    // Otherwise every tile outside the first one retains stale camera data.\n    if (options.clear) {\n      gl.disable(gl.SCISSOR_TEST);\n      gl.clearColor(0, 0, 0, 0);\n      gl.clear(gl.COLOR_BUFFER_BIT);\n    }\n\n    if (options.scissor) {\n      gl.enable(gl.SCISSOR_TEST);\n      gl.scissor(\n        options.scissor.x,\n        options.scissor.y,\n        options.scissor.width,\n        options.scissor.height\n      );\n    } else {\n      gl.disable(gl.SCISSOR_TEST);\n    }\n\n    if (this._reserveCapacity) for (const [name, texture] of Object.entries(inputs) as [string, Texture2D][]) {\n      const region = textureRegion(texture);\n      this.setUniform(`${name}RegionSize`, [region.width, region.height]);\n    }\n    this._bindings.setUniforms(inputs);\n    this._bindings.bind(renderer);\n    gl.disable(gl.DEPTH_TEST);\n    if (options.blend) {\n      gl.enable(gl.BLEND);\n      gl.blendEquation(gl.FUNC_ADD);\n      gl.blendFunc(gl.ONE, gl.ONE);\n    } else {\n      gl.disable(gl.BLEND);\n    }\n    gl.drawArrays(gl.TRIANGLES, 0, 3);\n    gl.disable(gl.SCISSOR_TEST);\n  }\n\n  releaseTarget(target: object) {\n    const outputs = this._targetOutputs.get(target);\n    if (!outputs) return;\n    this._targetOutputs.delete(target);\n    for (const texture of (Object.values(outputs) as Texture2D[])) texture.dispose(this._renderer.gl);\n    if (outputs === this._outputTextures) this._outputTextures = {} as Record<O, Texture2D>;\n  }\n\n  getMemoryBytes(target?: object): number {\n    const outputs = target ? this._targetOutputs.get(target) ?? {} : this._outputTextures;\n    return Array.from(new Set([...Object.values(outputs) as Texture2D[], ...this._retainedOutputs]))\n      .reduce((sum, texture) => sum + texture.getMemoryBytes(), 0);\n  }\n\n  dispose() {\n    const gl = this._renderer.gl;\n    (Array.from(new Set([this._outputTextures, ...this._targetOutputs.values()])).flatMap(outputs => Object.values(outputs)) as Texture2D[]).forEach((texture) =>\n      texture.dispose(gl)\n    );\n    this._retainedOutputs.forEach(texture => texture.dispose(gl));\n    this._retainedOutputs.clear();\n    this._frameBuffer.dispose(this._renderer);\n  }\n}\n"]}

package/lib/renderer/WebGLJNLMDenoiser.d.ts

@@ -0,0 +1,32 @@
+import { WebGLDevice, Texture2D } from './webgl.js';
+import { type JNLMFilterShape } from './jnlm.js';
+export interface WebGLJNLMInputs {
+    width: number;
+    height: number;
+    /** Main trace pass moments: guide sum, sum of squares and count. */
+    moments: Texture2D;
+    /** Catcher trace pass moments, when the scene has a shadow catcher. */
+    catcherMoments?: Texture2D;
+    /** Display-encoded composition to filter. */
+    color: Texture2D;
+    albedo: Texture2D;
+    normal: Texture2D;
+    /** Normalized shadow-catcher mask; red is the catcher coverage. */
+    shadowCatcher: Texture2D;
+    strength: number;
+    shape: JNLMFilterShape;
+}
+export declare class WebGLJNLMDenoisePass {
+    private _renderer;
+    private _guidePass;
+    private _variancePass;
+    private _filterPasses;
+    constructor(renderer: WebGLDevice);
+    /** Runs the denoiser and returns the display-encoded result. */
+    render(inputs: WebGLJNLMInputs): Texture2D;
+    reserveCapacity(): void;
+    retainOutput(texture: Texture2D): void;
+    releaseOutput(texture: Texture2D): void;
+    getMemoryBytes(): number;
+    dispose(): void;
+}