@tinypoly/gpu-renderer 0.0.0-stage → 0.0.1

package/dist/pathTracePass.js

@@ -0,0 +1,83 @@
+import { FRAME_LAYOUT, FRAME_WORDS } from "./frameLayout.js";
+import { createShaderModule } from "./shaderModule.js";
+import { programsWgsl } from "./shaderProgram.js";
+import { writeStruct } from "./structLayout.js";
+import { BSDF_WGSL } from "./wgsl/bsdf.wgsl.js";
+import { BVH_WGSL } from "./wgsl/bvh.wgsl.js";
+import { COMMON_WGSL } from "./wgsl/common.wgsl.js";
+import { ENVIRONMENT_WGSL } from "./wgsl/environment.wgsl.js";
+import { LIGHTS_WGSL } from "./wgsl/lights.wgsl.js";
+import { PATH_TRACE_WGSL } from "./wgsl/pathTrace.wgsl.js";
+import { RANDOM_WGSL } from "./wgsl/random.wgsl.js";
+import { SAMPLING_WGSL } from "./wgsl/sampling.wgsl.js";
+import { SHADER_SUPPORT_WGSL } from "./wgsl/shaderSupport.wgsl.js";
+import { SURFACE_WGSL } from "./wgsl/surface.wgsl.js";
+import { TEXTURE_WGSL } from "./wgsl/texture.wgsl.js";
+/**
+ * The whole kernel, in the order WGSL needs: every stage may only call what comes before it, as there are no forward
+ * declarations. The scene's translated shaders sit between the texture code they call and the surface code that calls
+ * them.
+ */
+export function pathTraceSource(programs = null) {
+    return COMMON_WGSL + RANDOM_WGSL + BVH_WGSL + SAMPLING_WGSL + TEXTURE_WGSL + SHADER_SUPPORT_WGSL
+        + programsWgsl(programs) + ENVIRONMENT_WGSL + SURFACE_WGSL + BSDF_WGSL + LIGHTS_WGSL + PATH_TRACE_WGSL;
+}
+const FRAME_BYTES = FRAME_WORDS * 4;
+const WORKGROUP = 8;
+export class PathTracePass {
+    device;
+    pipeline;
+    uniforms;
+    values = new ArrayBuffer(FRAME_BYTES);
+    bindGroup = null;
+    programKey = "";
+    constructor(device) {
+        this.device = device;
+        this.pipeline = this.build(null);
+        this.uniforms = device.createBuffer({ size: FRAME_BYTES, usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST });
+    }
+    /** Recompiles the kernel when the scene's shaders changed; the same set of programs keeps the pipeline it has. */
+    setPrograms(programs) {
+        const key = programs?.key ?? "";
+        if (key === this.programKey)
+            return;
+        this.programKey = key;
+        this.pipeline = this.build(programs);
+        this.bindGroup = null;
+    }
+    build(programs) {
+        const module = createShaderModule(this.device, "path trace", pathTraceSource(programs));
+        return this.device.createComputePipeline({ layout: "auto", compute: { module, entryPoint: "main" } });
+    }
+    /** Rebinds after the scene or the accumulation buffer was replaced. */
+    setBindings(scene, accumulation) {
+        this.bindGroup = this.device.createBindGroup({
+            layout: this.pipeline.getBindGroupLayout(0),
+            entries: [
+                { binding: 0, resource: { buffer: this.uniforms } },
+                { binding: 1, resource: { buffer: scene.positions } },
+                { binding: 2, resource: { buffer: scene.attributes } },
+                { binding: 3, resource: { buffer: scene.indices } },
+                { binding: 4, resource: { buffer: scene.materials } },
+                { binding: 5, resource: { buffer: scene.nodes } },
+                { binding: 6, resource: { buffer: scene.lights } },
+                { binding: 7, resource: { buffer: accumulation } },
+                { binding: 8, resource: { buffer: scene.textures } },
+            ],
+        });
+    }
+    encode(encoder, frame) {
+        if (!this.bindGroup)
+            throw new Error("GPU renderer: the path tracing pass has no scene bound.");
+        new Uint32Array(this.values).fill(0);
+        writeStruct(FRAME_LAYOUT, this.values, 0, frame);
+        this.device.queue.writeBuffer(this.uniforms, 0, this.values);
+        const pass = encoder.beginComputePass({ label: "path trace" });
+        const size = frame.bandSize;
+        pass.setPipeline(this.pipeline);
+        pass.setBindGroup(0, this.bindGroup);
+        pass.dispatchWorkgroups(Math.ceil(size[0] / WORKGROUP), Math.ceil(size[1] / WORKGROUP));
+        pass.end();
+    }
+}
+//# sourceMappingURL=pathTracePass.js.map

package/dist/pathTracePass.js.map

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

package/dist/planarCapture.d.ts

@@ -0,0 +1,38 @@
+import type { CameraState, RenderBackgroundMode, SerializedScene } from "./upstream.js";
+/**
+ * The CPU renderer's planar captures (`userData.cpuRenderer.planarCapture`): a flat surface whose shader samples what is
+ * reflected in it and seen through it, as `tReflectionMap`, `tEnvironmentReflectionMap`, `tRefractionMap` and
+ * `tRefractionDepth`, through `reflectionMatrix` and `refractionMatrix`. The cameras, the clip planes and the matrices are
+ * `pipeline.js`'s own; the images are rendered by this renderer, path traced from those cameras.
+ */
+export interface PlanarCapture {
+    /** The texture the image goes to, and the depth texture for the refraction capture. */
+    texture: string;
+    depth?: string;
+    camera: CameraState;
+    /** Whether the capture sees the scene, without its planar surfaces, or only the environment. */
+    scene: "scene" | "environment";
+    background: RenderBackgroundMode;
+    /** Drops what lies behind the plane, as the capture's clip plane does: `dot(xyz, p) + w < 0` is cut. */
+    clip?: number[];
+}
+export interface PlanarCaptures {
+    /** The scene with the capture textures in its table and each material's capture uniforms bound. */
+    scene: SerializedScene;
+    /** The scene the captures see: everything but the planar surfaces, which never appear in one. */
+    captureScene: SerializedScene;
+    captures: PlanarCapture[];
+    width: number;
+    height: number;
+}
+/** The captures a scene needs from this camera, or null when it has no planar surface. */
+export declare function planarCaptures(source: SerializedScene, camera: CameraState, width: number, height: number): PlanarCaptures | null;
+export declare class CaptureResolvePass {
+    private readonly device;
+    private readonly pipeline;
+    private readonly uniforms;
+    constructor(device: GPUDevice);
+    /** `color` and `depth` are word offsets of the textures' texels; a depth of 0xffffffff writes none. */
+    encode(encoder: GPUCommandEncoder, accumulation: GPUBuffer, textures: GPUBuffer, width: number, height: number, color: number, depth: number): void;
+}
+//# sourceMappingURL=planarCapture.d.ts.map

package/dist/planarCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planarCapture.d.ts","sourceRoot":"","sources":["../src/planarCapture.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAsB,eAAe,EAAqB,MAAM,eAAe,CAAC;AAE/H;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,gGAAgG;IAChG,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC;IAC/B,UAAU,EAAE,oBAAoB,CAAC;IACjC,wGAAwG;IACxG,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,KAAK,EAAE,eAAe,CAAC;IACvB,iGAAiG;IACjG,YAAY,EAAE,eAAe,CAAC;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD,0FAA0F;AAC1F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA4FpG;AA6CD,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;gBAER,MAAM,EAAE,SAAS;IAO9C,uGAAuG;IACvG,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAC7E,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAmB9D"}

package/dist/planarCapture.js

@@ -0,0 +1,163 @@
+import { Matrix3, Matrix4, Plane, Vector3 } from "three";
+import { cameraProjection } from "./camera.js";
+import { createShaderModule } from "./shaderModule.js";
+/** A capture is rendered at most this wide; it is a texture a shader blurs and distorts, not the image itself. */
+const MAX_CAPTURE = 512;
+function placeholder(id, width, height) {
+    return {
+        id,
+        width,
+        height,
+        data: new Float32Array(width * height * 4),
+        colorSpace: "srgb-linear",
+        wrapS: 1001,
+        wrapT: 1001,
+        matrix: [1, 0, 0, 0, 1, 0, 0, 0, 1],
+        // The rows are written top first, as the CPU renderer writes them.
+        flipY: true,
+        channel: 0,
+        nearest: false,
+    };
+}
+/** The captures a scene needs from this camera, or null when it has no planar surface. */
+export function planarCaptures(source, camera, width, height) {
+    const planar = source.meshes.filter(mesh => !mesh.primitive && mesh.materials.some(material => material?.planarCapture && material.shader));
+    if (!planar.length)
+        return null;
+    const scale = Math.min(1, MAX_CAPTURE / Math.max(width, height));
+    const captureWidth = Math.max(1, Math.round(width * scale));
+    const captureHeight = Math.max(1, Math.round(height * scale));
+    const textures = [...source.textures];
+    const captures = [];
+    const copies = new Map();
+    const cameraWorld = new Matrix4().fromArray(camera.matrixWorld);
+    const projection = cameraProjection(camera, width / height);
+    const bias = new Matrix4().set(0.5, 0, 0, 0.5, 0, 0.5, 0, 0.5, 0, 0, 0.5, 0.5, 0, 0, 0, 1);
+    for (const mesh of planar) {
+        const model = new Matrix4().fromArray(mesh.matrixWorld);
+        const normal = new Vector3(0, 1, 0).applyMatrix3(new Matrix3().getNormalMatrix(model)).normalize();
+        const point = new Vector3().setFromMatrixPosition(model);
+        const plane = new Plane().setFromNormalAndCoplanarPoint(normal, point);
+        const { x, y, z } = normal, d = plane.constant;
+        const mirror = new Matrix4().set(1 - 2 * x * x, -2 * x * y, -2 * x * z, -2 * d * x, -2 * y * x, 1 - 2 * y * y, -2 * y * z, -2 * d * y, -2 * z * x, -2 * z * y, 1 - 2 * z * z, -2 * d * z, 0, 0, 0, 1);
+        const reflected = { ...camera, matrixWorld: mirror.clone().multiply(cameraWorld).toArray() };
+        const side = plane.distanceToPoint(new Vector3().setFromMatrixPosition(cameraWorld)) >= 0 ? 1 : -1;
+        const textureMatrix = (world) => bias.clone().multiply(projection)
+            .multiply(new Matrix4().fromArray(world).invert()).multiply(model).toArray();
+        for (const material of mesh.materials) {
+            if (!material?.planarCapture || !material.shader)
+                continue;
+            const id = material.planarCapture.id;
+            const copy = {
+                ...material,
+                shader: { ...material.shader, uniforms: { ...material.shader.uniforms } },
+            };
+            const uniforms = copy.shader.uniforms;
+            const names = {
+                reflection: `${id}:tReflectionMap`,
+                environment: `${id}:tEnvironmentReflectionMap`,
+                refraction: `${id}:tRefractionMap`,
+                depth: `${id}:tRefractionDepth`,
+            };
+            Object.assign(uniforms, {
+                reflectionMatrix: textureMatrix(reflected.matrixWorld),
+                refractionMatrix: textureMatrix(camera.matrixWorld),
+                cameraNear: camera.near,
+                cameraFar: camera.far,
+                tReflectionMap: { texture: names.reflection },
+                tEnvironmentReflectionMap: { texture: names.environment },
+                tRefractionMap: { texture: names.refraction },
+                tRefractionDepth: { texture: names.depth },
+            });
+            copies.set(material, copy);
+            for (const name of Object.values(names))
+                textures.push(placeholder(name, captureWidth, captureHeight));
+            captures.push({ texture: names.reflection, camera: reflected, scene: "scene", background: "transparent",
+                clip: [x * side, y * side, z * side, d * side + 0.01] }, { texture: names.environment, camera: reflected, scene: "environment", background: "environment" }, { texture: names.refraction, depth: names.depth, camera, scene: "scene", background: "environment",
+                clip: [-x * side, -y * side, -z * side, -d * side + 0.01] });
+        }
+    }
+    const scene = {
+        ...source,
+        textures,
+        meshes: source.meshes.map(mesh => ({ ...mesh, materials: mesh.materials.map(m => (m && copies.get(m)) ?? m) })),
+    };
+    return {
+        scene,
+        captureScene: { ...source, meshes: source.meshes.filter(mesh => !planar.includes(mesh)) },
+        captures,
+        width: captureWidth,
+        height: captureHeight,
+    };
+}
+/** Writes a finished capture from its accumulation buffer into the texels of its texture, and the depth into another. */
+const RESOLVE_WGSL = /* wgsl */ `
+struct Resolve {
+  size: vec2<u32>,
+  color: u32,
+  depth: u32,
+};
+
+@group(0) @binding(0) var<uniform> resolve: Resolve;
+@group(0) @binding(1) var<storage, read> accumulation: array<vec4<f32>>;
+@group(0) @binding(2) var<storage, read_write> textures: array<u32>;
+
+@compute @workgroup_size(64, 1, 1)
+fn main(@builtin(global_invocation_id) id: vec3<u32>) {
+  let count = resolve.size.x * resolve.size.y;
+  let i = id.x;
+
+  if (i >= count) {
+    return;
+  }
+
+  let sum = accumulation[i];
+  let extra = accumulation[count + i];
+  let n = max(sum.w, 1.0);
+  // Linear light, premultiplied by the coverage, as the CPU renderer's capture holds it.
+  let color = vec4<f32>(sum.rgb / n, extra.x / n);
+
+  for (var c = 0u; c < 4u; c = c + 1u) {
+    textures[resolve.color + i * 4u + c] = bitcast<u32>(color[c]);
+  }
+
+  if (resolve.depth != 0xffffffffu) {
+    let depth = extra.y / n;
+
+    for (var c = 0u; c < 3u; c = c + 1u) {
+      textures[resolve.depth + i * 4u + c] = bitcast<u32>(depth);
+    }
+
+    textures[resolve.depth + i * 4u + 3u] = bitcast<u32>(1.0);
+  }
+}
+`;
+export class CaptureResolvePass {
+    device;
+    pipeline;
+    uniforms;
+    constructor(device) {
+        this.device = device;
+        const module = createShaderModule(device, "capture resolve", RESOLVE_WGSL);
+        this.pipeline = device.createComputePipeline({ layout: "auto", compute: { module, entryPoint: "main" } });
+        this.uniforms = device.createBuffer({ size: 16, usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST });
+    }
+    /** `color` and `depth` are word offsets of the textures' texels; a depth of 0xffffffff writes none. */
+    encode(encoder, accumulation, textures, width, height, color, depth) {
+        this.device.queue.writeBuffer(this.uniforms, 0, new Uint32Array([width, height, color, depth]));
+        const group = this.device.createBindGroup({
+            layout: this.pipeline.getBindGroupLayout(0),
+            entries: [
+                { binding: 0, resource: { buffer: this.uniforms } },
+                { binding: 1, resource: { buffer: accumulation } },
+                { binding: 2, resource: { buffer: textures } },
+            ],
+        });
+        const pass = encoder.beginComputePass({ label: "capture resolve" });
+        pass.setPipeline(this.pipeline);
+        pass.setBindGroup(0, group);
+        pass.dispatchWorkgroups(Math.ceil(width * height / 64));
+        pass.end();
+    }
+}
+//# sourceMappingURL=planarCapture.js.map

package/dist/planarCapture.js.map

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

package/dist/presentPass.d.ts

@@ -0,0 +1,31 @@
+import type { RenderToneMapping } from "./upstream.js";
+export interface PresentUniforms {
+    width: number;
+    height: number;
+    exposure: number;
+    toneMapping: RenderToneMapping;
+    vignette: number;
+    grain: number;
+    frameIndex: number;
+    transparent: boolean;
+    /** The denoiser's output, which the colour is read from instead of the accumulation when given. */
+    denoised?: GPUBuffer | null;
+}
+/** Resolves the accumulation buffer onto the canvas: divide by the sample count, expose, tone map, encode. */
+export declare class PresentPass {
+    private readonly device;
+    readonly format: GPUTextureFormat;
+    private readonly pipeline;
+    private readonly uniforms;
+    private readonly values;
+    private readonly floats;
+    private readonly integers;
+    private bindGroup;
+    private accumulation;
+    private source;
+    constructor(device: GPUDevice, format: GPUTextureFormat);
+    setAccumulation(accumulation: GPUBuffer): void;
+    private bind;
+    encode(encoder: GPUCommandEncoder, view: GPUTextureView, present: PresentUniforms): void;
+}
+//# sourceMappingURL=presentPass.d.ts.map

package/dist/presentPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentPass.d.ts","sourceRoot":"","sources":["../src/presentPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAC7B;AAOD,8GAA8G;AAC9G,qBAAa,WAAW;IAUV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAa,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IATjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,MAAM,CAA0B;gBAEX,MAAM,EAAE,SAAS,EAAW,MAAM,EAAE,gBAAgB;IAejF,eAAe,CAAC,YAAY,EAAE,SAAS;IAKvC,OAAO,CAAC,IAAI;IAmBZ,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe;CA0BlF"}

package/dist/presentPass.js

@@ -0,0 +1,78 @@
+import { createShaderModule } from "./shaderModule.js";
+import { PRESENT_WGSL } from "./wgsl/present.wgsl.js";
+/** The order the shader's `toneMapping` switch expects. */
+const TONE_MAPPING = ["aces", "agx", "neutral", "linear"];
+const PRESENT_BYTES = 48;
+/** Resolves the accumulation buffer onto the canvas: divide by the sample count, expose, tone map, encode. */
+export class PresentPass {
+    device;
+    format;
+    pipeline;
+    uniforms;
+    values = new ArrayBuffer(PRESENT_BYTES);
+    floats = new Float32Array(this.values);
+    integers = new Uint32Array(this.values);
+    bindGroup = null;
+    accumulation = null;
+    source = null;
+    constructor(device, format) {
+        this.device = device;
+        this.format = format;
+        const module = createShaderModule(device, "present", PRESENT_WGSL);
+        this.pipeline = device.createRenderPipeline({
+            layout: "auto",
+            vertex: { module, entryPoint: "vertexMain" },
+            fragment: { module, entryPoint: "fragmentMain", targets: [{ format }] },
+            primitive: { topology: "triangle-list" },
+        });
+        this.uniforms = device.createBuffer({
+            size: PRESENT_BYTES,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+    }
+    setAccumulation(accumulation) {
+        this.accumulation = accumulation;
+        this.bind(null);
+    }
+    bind(denoised) {
+        if (!this.accumulation)
+            return;
+        // Without a denoised image the accumulation stands in for it; the uniform says which one to read.
+        const source = denoised ?? this.accumulation;
+        if (this.bindGroup && source === this.source)
+            return;
+        this.source = source;
+        this.bindGroup = this.device.createBindGroup({
+            layout: this.pipeline.getBindGroupLayout(0),
+            entries: [
+                { binding: 0, resource: { buffer: this.uniforms } },
+                { binding: 1, resource: { buffer: this.accumulation } },
+                { binding: 2, resource: { buffer: source } },
+            ],
+        });
+    }
+    encode(encoder, view, present) {
+        this.bind(present.denoised ?? null);
+        if (!this.bindGroup)
+            throw new Error("GPU renderer: the presentation pass has no accumulation buffer bound.");
+        this.integers[0] = present.width;
+        this.integers[1] = present.height;
+        this.floats[2] = present.exposure;
+        this.integers[3] = Math.max(0, TONE_MAPPING.indexOf(present.toneMapping));
+        this.floats[4] = present.vignette;
+        this.floats[5] = present.grain;
+        this.integers[6] = present.frameIndex;
+        this.integers[7] = present.transparent ? 1 : 0;
+        this.integers[8] = present.denoised ? 1 : 0;
+        this.device.queue.writeBuffer(this.uniforms, 0, this.values);
+        const pass = encoder.beginRenderPass({
+            label: "present",
+            colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: { r: 0, g: 0, b: 0, a: 1 } }],
+        });
+        pass.setPipeline(this.pipeline);
+        pass.setBindGroup(0, this.bindGroup);
+        pass.draw(3);
+        pass.end();
+    }
+}
+//# sourceMappingURL=presentPass.js.map

package/dist/presentPass.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,209 @@
+import { type BvhWorkerFactory } from "./bvhBuilder.js";
+import { type DenoiserSettings } from "./denoise.js";
+import { EventEmitter, type Bucket, type RenderCamera, type RenderEnvironment, type RenderImage, type RenderPhase, type RenderPixels, type RenderScene, type RenderSettings, type RenderSettingsInput, type SerializedScene } from "./upstream.js";
+export type { RenderCamera, RenderImage, RenderPhase, RenderPixels, RenderScene } from "./upstream.js";
+/**
+ * The CPU renderer's events, with the same payloads, so a host listens to either renderer the same way. What differs
+ * is when they fire: nothing is finished until the last sample lands, so the pixels arrive once.
+ */
+export interface GpuRendererEvents {
+    /** The scene is on the device and tracing starts; `image` has the render size and is empty. */
+    start: {
+        width: number;
+        height: number;
+    };
+    /** The finished image, once, as a single region at (0, 0). `image` already holds it. */
+    pixels: RenderPixels;
+    /** Rows traced out of `total`, over every sample. `"prepare"` while the scene uploads, `"shade"` while it traces. */
+    progress: {
+        completed: number;
+        total: number;
+        phase: RenderPhase;
+    };
+    /** The band of rows being traced, as a bucket of worker 0, or `null` when the device is idle. */
+    bucket: {
+        worker: number;
+        bucket: Bucket | null;
+        width: number;
+        height: number;
+    };
+    /** One more sample per pixel finished over the whole image. Only this renderer has it. */
+    sample: {
+        samples: number;
+        target: number;
+    };
+    /** `image` is finished. */
+    complete: void;
+    /** The frame failed; `render()` rejects with the same error. */
+    error: Error;
+}
+/** The CPU renderer's options without its worker pool, which has no counterpart on a device. */
+export interface GpuRendererOptions {
+    scene?: RenderScene | SerializedScene;
+    /** Defaults to a perspective camera at (5, 5, 5) looking at the origin. */
+    camera?: RenderCamera;
+    /** Merged over `DEFAULT_RENDER_SETTINGS`, group by group. */
+    settings?: RenderSettingsInput;
+    /** Defaults to `DEFAULT_RENDER_ENVIRONMENT`. */
+    environment?: RenderEnvironment;
+    /** Image size in CSS pixels; the render size also applies `pixelRatio` and `settings.renderScale`. */
+    width: number;
+    height: number;
+    /** Defaults to 1. */
+    pixelRatio?: number;
+    /** How the denoiser filters, when `settings.globalIllumination.denoise` turns it on. Merged over `DEFAULT_DENOISER`. */
+    denoiser?: Partial<DenoiserSettings>;
+    /**
+     * Builds the BVH of a large scene in a Web Worker, so the page keeps responding while it is split. The tree is the
+     * same either way. Defaults to true where Web Workers exist, or when `createBvhWorker` is given; false builds on the
+     * main thread. If the worker cannot start, the renderer warns once and builds on the main thread.
+     */
+    bvhWorker?: boolean;
+    /**
+     * Starts the BVH worker. Replace it when the bundler cannot follow `new URL("./bvhWorker.js", import.meta.url)`, or
+     * outside the browser, with anything shaped like a Web Worker that runs `dist/bvhWorker.js`.
+     */
+    createBvhWorker?: BvhWorkerFactory;
+}
+/** `render()` rejects with this when a newer frame, `cancel()` or `dispose()` replaced the frame it started. */
+export declare const isAbortError: (error: unknown) => boolean;
+/**
+ * Path traces a Three.js scene on the GPU, behind the same API as `CpuRenderer`. The setters record the inputs;
+ * `render()` opens a frame with whatever is current and accumulates samples until it reaches `settings.samples`.
+ */
+export declare class GpuRenderer extends EventEmitter<GpuRendererEvents> {
+    private current;
+    private environment;
+    private scene;
+    private probe;
+    private camera;
+    private width;
+    private height;
+    private pixelRatio;
+    private output;
+    private frame;
+    private isPaused;
+    private resumed;
+    private unpaused;
+    private ready;
+    private gpu;
+    private accumulator;
+    private pathTrace;
+    private present;
+    private buffers;
+    private packed;
+    private sceneDirty;
+    private assets;
+    private packedView;
+    private target;
+    private planar;
+    private resolve;
+    private denoisePass;
+    private denoiserSettings;
+    private finished;
+    private denoised;
+    private denoiseView;
+    private environmentSource;
+    private environmentImage;
+    private canvas;
+    private context;
+    private scheduler;
+    private revision;
+    private frameIndex;
+    private disposed;
+    private bvh;
+    constructor(options: GpuRendererOptions);
+    /** The settings the next frame renders with. */
+    get settings(): Readonly<RenderSettings>;
+    /** How the denoiser filters. */
+    get denoiser(): Readonly<DenoiserSettings>;
+    /**
+     * Merges the given fields into the denoiser's settings. Filtering costs nothing like tracing, so a finished image is
+     * filtered again at once, without tracing anything: `image` and the canvas take the result and `pixels` fires. A frame
+     * in flight uses them from its next pass on.
+     */
+    setDenoiser(input: Partial<DenoiserSettings>): void;
+    /** Filters the finished image again with the current denoiser settings, or shows it unfiltered when it is off. */
+    private refilter;
+    /** A frame is in flight: `render()` was called and has not settled. */
+    get rendering(): boolean;
+    get paused(): boolean;
+    /**
+     * The image of the last finished frame, or an empty one of the render size while a frame traces; `null` before the
+     * first frame starts. Each frame allocates a new buffer, so a reference taken at `complete` stays as it is.
+     */
+    get image(): RenderImage | null;
+    get renderWidth(): number;
+    get renderHeight(): number;
+    /** Image size in CSS pixels for the next frame; `pixelRatio` stays as it is when omitted. */
+    setSize(width: number, height: number, pixelRatio?: number): void;
+    setPixelRatio(pixelRatio: number): void;
+    /**
+     * Takes a Three scene, serialized in the background, or the result of `serializeScene`. The live scene is not read
+     * again until this is called once more.
+     */
+    setScene(scene: RenderScene | SerializedScene): void;
+    /**
+     * A Three camera is read at every `render()`, so moving it or changing its aspect only needs a new frame.
+     * A `CameraState` snapshot is used as it is.
+     */
+    setCamera(camera: RenderCamera): void;
+    /**
+     * Merges the given fields into the current settings, group by group. Turning the denoiser on or off also filters the
+     * finished image again at once, as `setDenoiser` does, since that needs no tracing.
+     */
+    setSettings(settings: RenderSettingsInput): void;
+    setEnvironment(environment: RenderEnvironment): void;
+    /** Used by `attachCanvas`; pass `null` to detach. */
+    setOutputCanvas(canvas: HTMLCanvasElement | null): void;
+    /**
+     * Starts a frame with the current scene, camera, settings, environment and size, discarding any frame in
+     * progress, and accumulates `settings.samples` samples per pixel. Resolves with the finished image. Rejects with an
+     * `AbortError` when a later `render()`, `cancel()` or `dispose()` replaces the frame, and with the error when the
+     * frame fails.
+     */
+    render(): Promise<RenderImage>;
+    /** Stops between two dispatches; `resume()` continues the same frame. */
+    pause(): void;
+    resume(): void;
+    /**
+     * Stops the frame in flight and keeps the device for the next one. `render()` rejects with an `AbortError` and
+     * `image` keeps what it held. A paused frame is cancelled too, and the next one starts unpaused. Does nothing
+     * without a frame in flight.
+     */
+    cancel(): void;
+    /** Releases the device. A frame in flight rejects with an `AbortError`. */
+    dispose(): void;
+    /** Takes the frame in flight, if any, so it can be settled after the events go out. */
+    private settle;
+    /** Settles the frame in flight, if any, with an `AbortError`. */
+    private abort;
+    private fail;
+    private emitIdle;
+    private device;
+    private accumulate;
+    /** The rows a pass still traced something in, read back from the accumulator's row flags. */
+    private activeRows;
+    private check;
+    /** Uploads what changed and makes sure the passes point at the current buffers. */
+    private prepare;
+    /** Packs and uploads one scene: its textures, geometry, hierarchy, lights and every extra word they point at. */
+    private packScene;
+    /**
+     * Renders a scene's planar captures with this renderer, from the mirrored and the real camera, and writes each into
+     * the texels of its placeholder in the main scene's texture buffer. Everything is queued ahead of the frame itself,
+     * which the queue then runs in order.
+     */
+    private renderCaptures;
+    private configureCanvas;
+    private encodePresent;
+    /** Denoises the accumulation as it stands, for the canvas and for the finished image. */
+    private encodeDenoise;
+    private frameUniforms;
+    /**
+     * Copies the accumulation buffer back and resolves it on the CPU, with the same exposure, tone mapping and sRGB
+     * encoding the presentation pass applies. Grain is a presentation effect and is not part of the returned image.
+     */
+    private readImage;
+}
+//# sourceMappingURL=renderer.d.ts.map