@meimu/mutracer 0.1.5 → 0.3.0

package/lib/renderer/WebGLSkyBaker.js

@@ -0,0 +1,422 @@
+/**
+ * Physically based clear sky for the viewer's default environment, baked on
+ * the GPU into an equirectangular radiance map.
+ *
+ * Integrates single scattering through a spherical Rayleigh, Mie and ozone
+ * atmosphere and adds multiple scattering with the isotropic approximation
+ * of Hillaire, "A Scalable and Production Ready Sky and Atmosphere Rendering
+ * Technique" (EGSR 2020). Coefficients are the Earth defaults from Bruneton,
+ * "Precomputed Atmospheric Scattering" (2008/2017). Formulas only; no code is
+ * taken from either reference.
+ *
+ * WebGL 2 passes: transmittance table, multiple scattering by altitude, a
+ * sky-view table by elevation and azimuth relative to the sun, irradiance and
+ * exposure, then the map itself with an anti-aliased, limb-darkened sun disk.
+ * Distances are in kilometers so float32 keeps the horizon precise.
+ */
+import { sunPosition } from '../scene/skyParameters.js';
+import { SUN_RADIUS, TURBIDITY, GROUND_ALBEDO, ILLUMINANCE, REFERENCE_ILLUMINANCE } from './skyModel.js';
+const T_SIZE = [256, 64]; // cos(view zenith) × altitude
+const MS_SIZE = [32, 1]; // altitude
+const SV_SIZE = [96, 192]; // relative azimuth × elevation
+const COMMON = /* glsl */ `#version 300 es
+precision highp float;
+precision highp int;
+precision highp sampler2D;
+out vec4 color;
+const float PI = 3.14159265358979;
+const float R_GROUND = 6360.0;
+const float R_TOP = 6460.0;
+const float CAMERA_ALTITUDE = 0.2;
+const vec3 RAYLEIGH = vec3(5.802e-3, 13.558e-3, 33.1e-3);
+const float MIE_SCATTERING = 3.996e-3;
+const float MIE_EXTINCTION = 4.44e-3;
+const float MIE_G = 0.8;
+const vec3 OZONE = vec3(0.65e-3, 1.881e-3, 0.085e-3);
+const ivec2 T_SIZE = ivec2(${T_SIZE[0]}, ${T_SIZE[1]});
+const int MS_ALTITUDES = ${MS_SIZE[0]};
+const ivec2 SV_SIZE = ivec2(${SV_SIZE[0]}, ${SV_SIZE[1]});
+uniform vec3 uSun; 
+uniform float uTurbidity;
+uniform vec3 uAlbedo;
+
+
+float bj(float r, float mu, float radius) { return (radius - r) * (radius + r) + r * r * mu * mu; }
+bool mV(float r, float mu) { return mu < 0.0 && bj(r, mu, R_GROUND) >= 0.0; }
+float kT(float r, float mu) { return max(-r * mu - sqrt(max(bj(r, mu, R_GROUND), 0.0)), 0.0); }
+float iS(float r, float mu) { return max(-r * mu + sqrt(max(bj(r, mu, R_TOP), 0.0)), 0.0); }
+
+
+vec3 oo(float r) {
+float h = max(r - R_GROUND, 0.0);
+return vec3(exp(-h / 8.0), exp(-h / 1.2) * uTurbidity, max(0.0, 1.0 - abs(h - 25.0) / 15.0));
+}
+vec3 extinction(vec3 d) { return RAYLEIGH * d.x + MIE_EXTINCTION * d.y + OZONE * d.z; }
+
+float mB(float x) { return x * x * (R_TOP - R_GROUND); }
+float hy(float h) { return sqrt(clamp(h / (R_TOP - R_GROUND), 0.0, 1.0)); }
+
+
+vec3 eR(sampler2D table, vec2 p) {
+ivec2 size = textureSize(table, 0);
+vec2 q = clamp(p, vec2(0.0), vec2(size - 1));
+ivec2 i = min(ivec2(floor(q)), max(size - 2, ivec2(0)));
+vec2 f = clamp(q - vec2(i), 0.0, 1.0);
+ivec2 j = min(i + 1, size - 1);
+vec3 a = texelFetch(table, i, 0).rgb, b = texelFetch(table, ivec2(j.x, i.y), 0).rgb;
+vec3 c = texelFetch(table, ivec2(i.x, j.y), 0).rgb, d = texelFetch(table, j, 0).rgb;
+return mix(mix(a, b, f.x), mix(c, d, f.x), f.y);
+}
+`;
+const ATMOSPHERE = /* glsl */ `
+uniform sampler2D uTransmittance;
+uniform sampler2D uMultiple;
+uniform bool uFull;
+uniform vec3 uSkyIrradiance;
+
+
+vec3 fv(float r, float mu) {
+return eR(uTransmittance, vec2((clamp(mu, -1.0, 1.0) + 1.0) * 0.5 * float(T_SIZE.x - 1),
+hy(r - R_GROUND) * float(T_SIZE.y - 1)));
+}
+
+float mI(float nu) {
+float g2 = MIE_G * MIE_G;
+return 3.0 / (8.0 * PI) * ((1.0 - g2) * (1.0 + nu * nu)) / ((2.0 + g2) * pow(1.0 + g2 - 2.0 * MIE_G * nu, 1.5));
+}
+
+
+
+
+
+
+void vG(vec3 origin, vec3 dir, int steps, out vec3 radiance, out vec3 throughput) {
+float r = length(origin);
+float mu = dot(origin, dir) / r;
+bool ground = mV(r, mu);
+float len = ground ? kT(r, mu) : iS(r, mu);
+float nu = dot(dir, uSun);
+float ja = uFull ? 3.0 / (16.0 * PI) * (1.0 + nu * nu) : 1.0 / (4.0 * PI);
+float sh = uFull ? mI(nu) : 1.0 / (4.0 * PI);
+radiance = vec3(0.0);
+throughput = vec3(0.0);
+vec3 view = vec3(1.0);
+float previous = 0.0;
+for (int i = 0; i < steps; i++) {
+
+float s = float(i + 1) / float(steps);
+float next = len * s * s;
+float dt = next - previous;
+vec3 p = origin + dir * (0.5 * (previous + next));
+previous = next;
+float pr = length(p);
+vec3 d = oo(pr);
+vec3 e = extinction(d);
+vec3 vk = fv(pr, dot(p, uSun) / pr);
+vec3 np = RAYLEIGH * d.x;
+float nl = MIE_SCATTERING * d.y;
+vec3 ms = vec3(0.0);
+if (uFull) {
+float x = hy(pr - R_GROUND) * float(MS_ALTITUDES - 1);
+ms = eR(uMultiple, vec2(x, 0.0));
+}
+vec3 source = vk * (np * ja + nl * sh) + (np + nl) * ms;
+
+vec3 segment = exp(-e * dt);
+vec3 weight = (1.0 - segment) / max(e, vec3(1e-9));
+radiance += view * source * weight;
+throughput += view * (np + nl) * weight;
+view *= segment;
+}
+if (ground) {
+vec3 p = origin + dir * len;
+float pr = length(p);
+float tD = dot(p, uSun) / pr;
+vec3 irradiance = fv(pr, tD) * max(tD, 0.0) + uSkyIrradiance;
+radiance += view * uAlbedo / PI * irradiance;
+}
+}
+`;
+const TRANSMITTANCE = COMMON + /* glsl */ `
+void main() {
+ivec2 p = ivec2(gl_FragCoord.xy);
+float mu = float(p.x) / float(T_SIZE.x - 1) * 2.0 - 1.0;
+float r = R_GROUND + mB(float(p.y) / float(T_SIZE.y - 1));
+if (mV(r, mu)) { color = vec4(0.0, 0.0, 0.0, 1.0); return; }
+float len = iS(r, mu);
+vec3 depth = vec3(0.0);
+const int STEPS = 48;
+for (int i = 0; i < STEPS; i++) {
+float t = (float(i) + 0.5) / float(STEPS) * len;
+depth += extinction(oo(sqrt(t * t + 2.0 * r * mu * t + r * r))) * (len / float(STEPS));
+}
+color = vec4(exp(-depth), 1.0);
+}
+`;
+const MULTIPLE = COMMON + ATMOSPHERE + /* glsl */ `
+void main() {
+float r = R_GROUND + mB(floor(gl_FragCoord.x) / float(MS_ALTITUDES - 1));
+const int DIRECTIONS = 64;
+vec3 second = vec3(0.0), qC = vec3(0.0);
+for (int i = 0; i < DIRECTIONS; i++) {
+
+float mu = 1.0 - 2.0 * (float(i) + 0.5) / float(DIRECTIONS);
+float phi = float(i) * PI * (3.0 - sqrt(5.0));
+float s = sqrt(1.0 - mu * mu);
+vec3 radiance, throughput;
+vG(vec3(0.0, r, 0.0), vec3(s * cos(phi), mu, s * sin(phi)), 20, radiance, throughput);
+second += radiance / float(DIRECTIONS);
+qC += throughput / float(DIRECTIONS);
+}
+color = vec4(second / (1.0 - qC), 1.0);
+}
+`;
+// Elevation rows are spaced by the square root so the horizon gets most of them.
+const ELEVATION_MAPPING = /* glsl */ `
+float qd(float row) {
+float x = row / float(SV_SIZE.y - 1) * 2.0 - 1.0;
+return sign(x) * x * x * (PI / 2.0);
+}
+float hL(float e) {
+float x = sign(e) * sqrt(abs(e) / (PI / 2.0));
+return clamp((x + 1.0) * 0.5, 0.0, 1.0) * float(SV_SIZE.y - 1);
+}
+`;
+const SKY_VIEW = COMMON + ATMOSPHERE + ELEVATION_MAPPING + /* glsl */ `
+void main() {
+ivec2 p = ivec2(gl_FragCoord.xy);
+float e = qd(float(p.y));
+float phi = float(p.x) / float(SV_SIZE.x - 1) * PI;
+vec3 radiance, throughput;
+vG(vec3(0.0, R_GROUND + CAMERA_ALTITUDE, 0.0), vec3(cos(e) * cos(phi), sin(e), cos(e) * sin(phi)), 40, radiance, throughput);
+color = vec4(radiance, 1.0);
+}
+`;
+/** Texel 0: sky irradiance on the ground. Texel 1: sun transmittance at the camera and the exposure scale. */
+const IRRADIANCE = COMMON + ELEVATION_MAPPING + /* glsl */ `
+uniform sampler2D uTransmittance;
+uniform sampler2D uSkyView;
+void main() {
+vec3 sky = vec3(0.0);
+const int ROWS = 128, COLUMNS = 48;
+for (int i = 0; i < ROWS; i++) {
+float e = (float(i) + 0.5) / float(ROWS) * (PI / 2.0);
+
+float weight = 2.0 * sin(e) * cos(e) * (PI / 2.0 / float(ROWS)) * (PI / float(COLUMNS));
+for (int j = 0; j < COLUMNS; j++) {
+float phi = (float(j) + 0.5) / float(COLUMNS) * PI;
+sky += eR(uSkyView, vec2(phi / PI * float(SV_SIZE.x - 1), hL(e))) * weight;
+}
+}
+if (int(gl_FragCoord.x) == 0) { color = vec4(sky, 1.0); return; }
+float r = R_GROUND + CAMERA_ALTITUDE;
+vec3 vk = eR(uTransmittance, vec2((uSun.y + 1.0) * 0.5 * float(T_SIZE.x - 1), hy(CAMERA_ALTITUDE) * float(T_SIZE.y - 1)));
+vec3 xE = vec3(0.2126, 0.7152, 0.0722);
+float horizontal = dot(sky, xE) + dot(vk, xE) * max(uSun.y, 0.0);
+
+
+const float REFERENCE = ${REFERENCE_ILLUMINANCE};
+float scale = ${ILLUMINANCE} / sqrt(max(horizontal, REFERENCE * 1e-3) * REFERENCE);
+color = vec4(vk, scale);
+}
+`;
+const MAP = COMMON + ELEVATION_MAPPING + /* glsl */ `
+uniform sampler2D uSkyView;
+uniform sampler2D uIrradiance;
+uniform vec2 uSize;
+uniform float uAzimuth;
+uniform vec3 uSunWorld;
+uniform float uSunRadius;
+
+
+vec3 gU(vec2 cR) {
+float theta = cR.y / uSize.y * PI;
+float phi = cR.x / uSize.x * 2.0 * PI;
+return vec3(-sin(theta) * cos(phi), cos(theta), -sin(theta) * sin(phi));
+}
+
+void main() {
+vec3 dir = gU(gl_FragCoord.xy);
+float dU = abs(atan(dir.z, dir.x) - uAzimuth);
+dU = min(mod(dU, 2.0 * PI), 2.0 * PI - mod(dU, 2.0 * PI));
+float e = asin(clamp(dir.y, -1.0, 1.0));
+vec3 radiance = eR(uSkyView, vec2(dU / PI * float(SV_SIZE.x - 1), hL(e)));
+vec4 sun = texelFetch(uIrradiance, ivec2(1, 0), 0);
+
+
+float rM = PI / uSize.y;
+if (acos(clamp(dot(dir, uSunWorld), -1.0, 1.0)) < uSunRadius + 3.0 * rM / max(sqrt(1.0 - dir.y * dir.y), 0.05)) {
+const int N = 6;
+const float LIMB = 0.6;
+float coverage = 0.0;
+for (int y = 0; y < N; y++) for (int x = 0; x < N; x++) {
+vec3 d = gU(gl_FragCoord.xy - 0.5 + (vec2(x, y) + 0.5) / float(N));
+
+float angle = 2.0 * asin(min(length(d - uSunWorld) * 0.5, 1.0));
+float t = angle / uSunRadius;
+if (t < 1.0) coverage += 1.0 - LIMB * (1.0 - sqrt(1.0 - t * t));
+}
+float rK = 2.0 * PI * (1.0 - cos(uSunRadius));
+radiance += coverage / float(N * N) / (rK * (1.0 - LIMB / 3.0)) * sun.rgb;
+}
+color = vec4(radiance * sun.a, 1.0);
+}
+`;
+const VERTEX = /* glsl */ `#version 300 es
+void main() {
+vec2 p = vec2(gl_VertexID == 1 ? 3.0 : -1.0, gl_VertexID == 2 ? 3.0 : -1.0);
+gl_Position = vec4(p, 0.0, 1.0);
+}
+`;
+/** Bakes skies with its own WebGL 2 context; requires float render targets. */
+export class WebGLSkyBaker {
+    gl;
+    programs;
+    targets;
+    map;
+    constructor() {
+        const canvas = typeof OffscreenCanvas !== 'undefined' ? new OffscreenCanvas(1, 1) : document.createElement('canvas');
+        const gl = canvas.getContext('webgl2', { antialias: false, depth: false, stencil: false, alpha: false });
+        if (!gl)
+            throw new Error('The procedural sky needs WebGL 2.');
+        if (!gl.getExtension('EXT_color_buffer_float'))
+            throw new Error('The procedural sky needs float render targets (EXT_color_buffer_float).');
+        this.gl = gl;
+        gl.bindVertexArray(gl.createVertexArray());
+        this.programs = {
+            transmittance: this.program(TRANSMITTANCE),
+            multiple: this.program(MULTIPLE),
+            skyView: this.program(SKY_VIEW),
+            irradiance: this.program(IRRADIANCE),
+            map: this.program(MAP)
+        };
+        this.targets = {
+            transmittance: this.target(...T_SIZE),
+            multiple: this.target(...MS_SIZE),
+            skyView: this.target(...SV_SIZE),
+            irradiance: this.target(2, 1)
+        };
+    }
+    /** Clear sky at a local solar time, in hours. */
+    bake(hours, width = 2048, height = 1024) {
+        const gl = this.gl;
+        if (gl.isContextLost())
+            throw new Error('The procedural sky lost its WebGL context.');
+        const { elevation, azimuth } = sunPosition(hours);
+        const e = deg(elevation), a = deg(azimuth);
+        const shared = (program) => {
+            gl.useProgram(program);
+            this.uniform(program, 'uSun', (l) => gl.uniform3f(l, Math.cos(e), Math.sin(e), 0));
+            this.uniform(program, 'uTurbidity', (l) => gl.uniform1f(l, TURBIDITY));
+            this.uniform(program, 'uAlbedo', (l) => gl.uniform3fv(l, GROUND_ALBEDO));
+            return program;
+        };
+        const { transmittance, multiple, skyView, irradiance } = this.targets;
+        const atmosphere = (program, full, sky) => {
+            shared(program);
+            this.bind(program, 'uTransmittance', 0, transmittance);
+            // The multiple-scattering pass declares but never reads its own target;
+            // bind another texture so WebGL sees no feedback loop.
+            this.bind(program, 'uMultiple', 1, full ? multiple : irradiance);
+            this.uniform(program, 'uFull', (l) => gl.uniform1i(l, full ? 1 : 0));
+            this.uniform(program, 'uSkyIrradiance', (l) => gl.uniform3fv(l, sky));
+        };
+        this.draw(shared(this.programs.transmittance), transmittance);
+        atmosphere(this.programs.multiple, false, [0, 0, 0]);
+        this.draw(this.programs.multiple, multiple);
+        // Upward views first: the ground seen below is lit by that sky.
+        atmosphere(this.programs.skyView, true, [0, 0, 0]);
+        this.draw(this.programs.skyView, skyView);
+        shared(this.programs.irradiance);
+        this.bind(this.programs.irradiance, 'uTransmittance', 0, transmittance);
+        this.bind(this.programs.irradiance, 'uSkyView', 1, skyView);
+        this.draw(this.programs.irradiance, irradiance);
+        const sky = this.read(irradiance).subarray(0, 3);
+        atmosphere(this.programs.skyView, true, Array.from(sky));
+        this.draw(this.programs.skyView, skyView);
+        if (!this.map || this.map.width !== width || this.map.height !== height) {
+            if (this.map)
+                this.release(this.map);
+            this.map = this.target(width, height);
+        }
+        const map = shared(this.programs.map);
+        this.bind(map, 'uSkyView', 0, skyView);
+        this.bind(map, 'uIrradiance', 1, irradiance);
+        this.uniform(map, 'uSize', (l) => gl.uniform2f(l, width, height));
+        this.uniform(map, 'uAzimuth', (l) => gl.uniform1f(l, a));
+        this.uniform(map, 'uSunWorld', (l) => gl.uniform3f(l, Math.cos(e) * Math.cos(a), Math.sin(e), Math.cos(e) * Math.sin(a)));
+        this.uniform(map, 'uSunRadius', (l) => gl.uniform1f(l, deg(SUN_RADIUS)));
+        this.draw(map, this.map);
+        // Row 0 is the zenith, as in an .hdr file.
+        return { data: this.read(this.map), width, height };
+    }
+    dispose() {
+        this.gl.getExtension('WEBGL_lose_context')?.loseContext();
+    }
+    program(fragment) {
+        const gl = this.gl;
+        const compile = (type, source) => {
+            const shader = gl.createShader(type);
+            gl.shaderSource(shader, source);
+            gl.compileShader(shader);
+            if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS))
+                throw new Error(`Sky shader: ${gl.getShaderInfoLog(shader)}`);
+            return shader;
+        };
+        const program = gl.createProgram();
+        gl.attachShader(program, compile(gl.VERTEX_SHADER, VERTEX));
+        gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fragment));
+        gl.linkProgram(program);
+        if (!gl.getProgramParameter(program, gl.LINK_STATUS))
+            throw new Error(`Sky program: ${gl.getProgramInfoLog(program)}`);
+        return program;
+    }
+    target(width, height) {
+        const gl = this.gl;
+        const texture = gl.createTexture();
+        gl.bindTexture(gl.TEXTURE_2D, texture);
+        gl.texStorage2D(gl.TEXTURE_2D, 1, gl.RGBA32F, width, height);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
+        const framebuffer = gl.createFramebuffer();
+        gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+        gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
+        if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE)
+            throw new Error('The procedural sky cannot render to float textures.');
+        return { texture, framebuffer, width, height };
+    }
+    release(target) {
+        this.gl.deleteFramebuffer(target.framebuffer);
+        this.gl.deleteTexture(target.texture);
+    }
+    uniform(program, name, set) {
+        const location = this.gl.getUniformLocation(program, name);
+        if (location)
+            set(location);
+    }
+    bind(program, name, unit, target) {
+        const gl = this.gl;
+        gl.activeTexture(gl.TEXTURE0 + unit);
+        gl.bindTexture(gl.TEXTURE_2D, target.texture);
+        this.uniform(program, name, (l) => gl.uniform1i(l, unit));
+    }
+    draw(program, target) {
+        const gl = this.gl;
+        gl.useProgram(program);
+        // A texture cannot be sampled while it is the render target.
+        gl.bindFramebuffer(gl.FRAMEBUFFER, target.framebuffer);
+        gl.viewport(0, 0, target.width, target.height);
+        gl.drawArrays(gl.TRIANGLES, 0, 3);
+    }
+    read(target) {
+        const gl = this.gl;
+        const data = new Float32Array(target.width * target.height * 4);
+        gl.bindFramebuffer(gl.FRAMEBUFFER, target.framebuffer);
+        gl.readPixels(0, 0, target.width, target.height, gl.RGBA, gl.FLOAT, data);
+        return data;
+    }
+}
+function deg(d) {
+    return (d * Math.PI) / 180;
+}
+//# sourceMappingURL=WebGLSkyBaker.js.map

package/lib/renderer/WebGLSkyBaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLSkyBaker.js","sourceRoot":"","sources":["../../src/renderer/WebGLSkyBaker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Physically based clear sky for the viewer's default environment, baked on\n * the GPU into an equirectangular radiance map.\n *\n * Integrates single scattering through a spherical Rayleigh, Mie and ozone\n * atmosphere and adds multiple scattering with the isotropic approximation\n * of Hillaire, \"A Scalable and Production Ready Sky and Atmosphere Rendering\n * Technique\" (EGSR 2020). Coefficients are the Earth defaults from Bruneton,\n * \"Precomputed Atmospheric Scattering\" (2008/2017). Formulas only; no code is\n * taken from either reference.\n *\n * WebGL 2 passes: transmittance table, multiple scattering by altitude, a\n * sky-view table by elevation and azimuth relative to the sun, irradiance and\n * exposure, then the map itself with an anti-aliased, limb-darkened sun disk.\n * Distances are in kilometers so float32 keeps the horizon precise.\n */\n\nimport { sunPosition } from '../scene/skyParameters.js';\nimport { SUN_RADIUS, TURBIDITY, GROUND_ALBEDO, ILLUMINANCE, REFERENCE_ILLUMINANCE } from './skyModel.js';\n\nexport interface SkyData { data: Float32Array; width: number; height: number; }\n\nconst T_SIZE = [256, 64] as const; // cos(view zenith) × altitude\nconst MS_SIZE = [32, 1] as const; // altitude\nconst SV_SIZE = [96, 192] as const; // relative azimuth × elevation\n\nconst COMMON = /* glsl */ `#version 300 es\nprecision highp float;\nprecision highp int;\nprecision highp sampler2D;\nout vec4 color;\nconst float PI = 3.14159265358979;\nconst float R_GROUND = 6360.0;\nconst float R_TOP = 6460.0;\nconst float CAMERA_ALTITUDE = 0.2;\nconst vec3 RAYLEIGH = vec3(5.802e-3, 13.558e-3, 33.1e-3);\nconst float MIE_SCATTERING = 3.996e-3;\nconst float MIE_EXTINCTION = 4.44e-3;\nconst float MIE_G = 0.8;\nconst vec3 OZONE = vec3(0.65e-3, 1.881e-3, 0.085e-3);\nconst ivec2 T_SIZE = ivec2(${T_SIZE[0]}, ${T_SIZE[1]});\nconst int MS_ALTITUDES = ${MS_SIZE[0]};\nconst ivec2 SV_SIZE = ivec2(${SV_SIZE[0]}, ${SV_SIZE[1]});\nuniform vec3 uSun; // atmosphere frame: the sun's azimuth is +X\nuniform float uTurbidity;\nuniform vec3 uAlbedo;\n\n// (R - r)(R + r) + r²μ² avoids cancelling planet-sized squares.\nfloat discriminant(float r, float mu, float radius) { return (radius - r) * (radius + r) + r * r * mu * mu; }\nbool hitsGround(float r, float mu) { return mu < 0.0 && discriminant(r, mu, R_GROUND) >= 0.0; }\nfloat distanceToGround(float r, float mu) { return max(-r * mu - sqrt(max(discriminant(r, mu, R_GROUND), 0.0)), 0.0); }\nfloat distanceToTop(float r, float mu) { return max(-r * mu + sqrt(max(discriminant(r, mu, R_TOP), 0.0)), 0.0); }\n\n/** Rayleigh, Mie and ozone densities. */\nvec3 densities(float r) {\n  float h = max(r - R_GROUND, 0.0);\n  return vec3(exp(-h / 8.0), exp(-h / 1.2) * uTurbidity, max(0.0, 1.0 - abs(h - 25.0) / 15.0));\n}\nvec3 extinction(vec3 d) { return RAYLEIGH * d.x + MIE_EXTINCTION * d.y + OZONE * d.z; }\n\nfloat altitudeAt(float x) { return x * x * (R_TOP - R_GROUND); }\nfloat altitudeCoord(float h) { return sqrt(clamp(h / (R_TOP - R_GROUND), 0.0, 1.0)); }\n\n/** Bilinear lookup in texel-index space; float textures need not be filterable. */\nvec3 fetchLinear(sampler2D table, vec2 p) {\n  ivec2 size = textureSize(table, 0);\n  vec2 q = clamp(p, vec2(0.0), vec2(size - 1));\n  ivec2 i = min(ivec2(floor(q)), max(size - 2, ivec2(0)));\n  vec2 f = clamp(q - vec2(i), 0.0, 1.0);\n  ivec2 j = min(i + 1, size - 1);\n  vec3 a = texelFetch(table, i, 0).rgb, b = texelFetch(table, ivec2(j.x, i.y), 0).rgb;\n  vec3 c = texelFetch(table, ivec2(i.x, j.y), 0).rgb, d = texelFetch(table, j, 0).rgb;\n  return mix(mix(a, b, f.x), mix(c, d, f.x), f.y);\n}\n`;\n\nconst ATMOSPHERE = /* glsl */ `\nuniform sampler2D uTransmittance;\nuniform sampler2D uMultiple;\nuniform bool uFull;\nuniform vec3 uSkyIrradiance;\n\n/** Transmittance from a point toward the top of the atmosphere. */\nvec3 transmittanceTo(float r, float mu) {\n  return fetchLinear(uTransmittance, vec2((clamp(mu, -1.0, 1.0) + 1.0) * 0.5 * float(T_SIZE.x - 1),\n    altitudeCoord(r - R_GROUND) * float(T_SIZE.y - 1)));\n}\n\nfloat cornetteShanks(float nu) {\n  float g2 = MIE_G * MIE_G;\n  return 3.0 / (8.0 * PI) * ((1.0 - g2) * (1.0 + nu * nu)) / ((2.0 + g2) * pow(1.0 + g2 - 2.0 * MIE_G * nu, 1.5));\n}\n\n/**\n * Radiance arriving at origin from dir, for unit solar irradiance. Without\n * uFull it uses isotropic phase and no multiple scattering, and returns the\n * scattered fraction for the multiple-scattering series.\n */\nvoid march(vec3 origin, vec3 dir, int steps, out vec3 radiance, out vec3 throughput) {\n  float r = length(origin);\n  float mu = dot(origin, dir) / r;\n  bool ground = hitsGround(r, mu);\n  float len = ground ? distanceToGround(r, mu) : distanceToTop(r, mu);\n  float nu = dot(dir, uSun);\n  float rayleighPhase = uFull ? 3.0 / (16.0 * PI) * (1.0 + nu * nu) : 1.0 / (4.0 * PI);\n  float miePhase = uFull ? cornetteShanks(nu) : 1.0 / (4.0 * PI);\n  radiance = vec3(0.0);\n  throughput = vec3(0.0);\n  vec3 view = vec3(1.0);\n  float previous = 0.0;\n  for (int i = 0; i < steps; i++) {\n    // Quadratic spacing keeps long horizon rays resolved near the camera.\n    float s = float(i + 1) / float(steps);\n    float next = len * s * s;\n    float dt = next - previous;\n    vec3 p = origin + dir * (0.5 * (previous + next));\n    previous = next;\n    float pr = length(p);\n    vec3 d = densities(pr);\n    vec3 e = extinction(d);\n    vec3 sunT = transmittanceTo(pr, dot(p, uSun) / pr);\n    vec3 scatterR = RAYLEIGH * d.x;\n    float scatterM = MIE_SCATTERING * d.y;\n    vec3 ms = vec3(0.0);\n    if (uFull) {\n      float x = altitudeCoord(pr - R_GROUND) * float(MS_ALTITUDES - 1);\n      ms = fetchLinear(uMultiple, vec2(x, 0.0));\n    }\n    vec3 source = sunT * (scatterR * rayleighPhase + scatterM * miePhase) + (scatterR + scatterM) * ms;\n    // Analytic integration of the source over the segment's extinction.\n    vec3 segment = exp(-e * dt);\n    vec3 weight = (1.0 - segment) / max(e, vec3(1e-9));\n    radiance += view * source * weight;\n    throughput += view * (scatterR + scatterM) * weight;\n    view *= segment;\n  }\n  if (ground) {\n    vec3 p = origin + dir * len;\n    float pr = length(p);\n    float cosSun = dot(p, uSun) / pr;\n    vec3 irradiance = transmittanceTo(pr, cosSun) * max(cosSun, 0.0) + uSkyIrradiance;\n    radiance += view * uAlbedo / PI * irradiance;\n  }\n}\n`;\n\nconst TRANSMITTANCE = COMMON + /* glsl */ `\nvoid main() {\n  ivec2 p = ivec2(gl_FragCoord.xy);\n  float mu = float(p.x) / float(T_SIZE.x - 1) * 2.0 - 1.0;\n  float r = R_GROUND + altitudeAt(float(p.y) / float(T_SIZE.y - 1));\n  if (hitsGround(r, mu)) { color = vec4(0.0, 0.0, 0.0, 1.0); return; }\n  float len = distanceToTop(r, mu);\n  vec3 depth = vec3(0.0);\n  const int STEPS = 48;\n  for (int i = 0; i < STEPS; i++) {\n    float t = (float(i) + 0.5) / float(STEPS) * len;\n    depth += extinction(densities(sqrt(t * t + 2.0 * r * mu * t + r * r))) * (len / float(STEPS));\n  }\n  color = vec4(exp(-depth), 1.0);\n}\n`;\n\nconst MULTIPLE = COMMON + ATMOSPHERE + /* glsl */ `\nvoid main() {\n  float r = R_GROUND + altitudeAt(floor(gl_FragCoord.x) / float(MS_ALTITUDES - 1));\n  const int DIRECTIONS = 64;\n  vec3 second = vec3(0.0), transfer = vec3(0.0);\n  for (int i = 0; i < DIRECTIONS; i++) {\n    // Fibonacci sphere; the planet is symmetric about the local vertical.\n    float mu = 1.0 - 2.0 * (float(i) + 0.5) / float(DIRECTIONS);\n    float phi = float(i) * PI * (3.0 - sqrt(5.0));\n    float s = sqrt(1.0 - mu * mu);\n    vec3 radiance, throughput;\n    march(vec3(0.0, r, 0.0), vec3(s * cos(phi), mu, s * sin(phi)), 20, radiance, throughput);\n    second += radiance / float(DIRECTIONS);\n    transfer += throughput / float(DIRECTIONS);\n  }\n  color = vec4(second / (1.0 - transfer), 1.0);\n}\n`;\n\n// Elevation rows are spaced by the square root so the horizon gets most of them.\nconst ELEVATION_MAPPING = /* glsl */ `\nfloat elevationAt(float row) {\n  float x = row / float(SV_SIZE.y - 1) * 2.0 - 1.0;\n  return sign(x) * x * x * (PI / 2.0);\n}\nfloat elevationCoord(float e) {\n  float x = sign(e) * sqrt(abs(e) / (PI / 2.0));\n  return clamp((x + 1.0) * 0.5, 0.0, 1.0) * float(SV_SIZE.y - 1);\n}\n`;\n\nconst SKY_VIEW = COMMON + ATMOSPHERE + ELEVATION_MAPPING + /* glsl */ `\nvoid main() {\n  ivec2 p = ivec2(gl_FragCoord.xy);\n  float e = elevationAt(float(p.y));\n  float phi = float(p.x) / float(SV_SIZE.x - 1) * PI;\n  vec3 radiance, throughput;\n  march(vec3(0.0, R_GROUND + CAMERA_ALTITUDE, 0.0), vec3(cos(e) * cos(phi), sin(e), cos(e) * sin(phi)), 40, radiance, throughput);\n  color = vec4(radiance, 1.0);\n}\n`;\n\n/** Texel 0: sky irradiance on the ground. Texel 1: sun transmittance at the camera and the exposure scale. */\nconst IRRADIANCE = COMMON + ELEVATION_MAPPING + /* glsl */ `\nuniform sampler2D uTransmittance;\nuniform sampler2D uSkyView;\nvoid main() {\n  vec3 sky = vec3(0.0);\n  const int ROWS = 128, COLUMNS = 48;\n  for (int i = 0; i < ROWS; i++) {\n    float e = (float(i) + 0.5) / float(ROWS) * (PI / 2.0);\n    // Mirror-symmetric in azimuth: 2 × half circle, dω = cos e de dφ, cosine = sin e.\n    float weight = 2.0 * sin(e) * cos(e) * (PI / 2.0 / float(ROWS)) * (PI / float(COLUMNS));\n    for (int j = 0; j < COLUMNS; j++) {\n      float phi = (float(j) + 0.5) / float(COLUMNS) * PI;\n      sky += fetchLinear(uSkyView, vec2(phi / PI * float(SV_SIZE.x - 1), elevationCoord(e))) * weight;\n    }\n  }\n  if (int(gl_FragCoord.x) == 0) { color = vec4(sky, 1.0); return; }\n  float r = R_GROUND + CAMERA_ALTITUDE;\n  vec3 sunT = fetchLinear(uTransmittance, vec2((uSun.y + 1.0) * 0.5 * float(T_SIZE.x - 1), altitudeCoord(CAMERA_ALTITUDE) * float(T_SIZE.y - 1)));\n  vec3 luma = vec3(0.2126, 0.7152, 0.0722);\n  float horizontal = dot(sky, luma) + dot(sunT, luma) * max(uSun.y, 0.0);\n  // Half of the change from the reference is compensated, like a camera's\n  // partial auto-exposure: low suns stay readable but still look dimmer.\n  const float REFERENCE = ${REFERENCE_ILLUMINANCE};\n  float scale = ${ILLUMINANCE} / sqrt(max(horizontal, REFERENCE * 1e-3) * REFERENCE);\n  color = vec4(sunT, scale);\n}\n`;\n\nconst MAP = COMMON + ELEVATION_MAPPING + /* glsl */ `\nuniform sampler2D uSkyView;\nuniform sampler2D uIrradiance;\nuniform vec2 uSize;\nuniform float uAzimuth;\nuniform vec3 uSunWorld;\nuniform float uSunRadius;\n\n// v = 0 is +Y and u follows atan2(-z, -x), as MuTracer reads equirect maps.\nvec3 mapDirection(vec2 texel) {\n  float theta = texel.y / uSize.y * PI;\n  float phi = texel.x / uSize.x * 2.0 * PI;\n  return vec3(-sin(theta) * cos(phi), cos(theta), -sin(theta) * sin(phi));\n}\n\nvoid main() {\n  vec3 dir = mapDirection(gl_FragCoord.xy);\n  float relative = abs(atan(dir.z, dir.x) - uAzimuth);\n  relative = min(mod(relative, 2.0 * PI), 2.0 * PI - mod(relative, 2.0 * PI));\n  float e = asin(clamp(dir.y, -1.0, 1.0));\n  vec3 radiance = fetchLinear(uSkyView, vec2(relative / PI * float(SV_SIZE.x - 1), elevationCoord(e)));\n  vec4 sun = texelFetch(uIrradiance, ivec2(1, 0), 0);\n  // Supersample texels near the sun for an anti-aliased, limb-darkened disk\n  // that carries the transmitted unit solar irradiance.\n  float texelAngle = PI / uSize.y;\n  if (acos(clamp(dot(dir, uSunWorld), -1.0, 1.0)) < uSunRadius + 3.0 * texelAngle / max(sqrt(1.0 - dir.y * dir.y), 0.05)) {\n    const int N = 6;\n    const float LIMB = 0.6;\n    float coverage = 0.0;\n    for (int y = 0; y < N; y++) for (int x = 0; x < N; x++) {\n      vec3 d = mapDirection(gl_FragCoord.xy - 0.5 + (vec2(x, y) + 0.5) / float(N));\n      // Chord length keeps small angles precise in float32.\n      float angle = 2.0 * asin(min(length(d - uSunWorld) * 0.5, 1.0));\n      float t = angle / uSunRadius;\n      if (t < 1.0) coverage += 1.0 - LIMB * (1.0 - sqrt(1.0 - t * t));\n    }\n    float solidAngle = 2.0 * PI * (1.0 - cos(uSunRadius));\n    radiance += coverage / float(N * N) / (solidAngle * (1.0 - LIMB / 3.0)) * sun.rgb;\n  }\n  color = vec4(radiance * sun.a, 1.0);\n}\n`;\n\nconst VERTEX = /* glsl */ `#version 300 es\nvoid main() {\n  vec2 p = vec2(gl_VertexID == 1 ? 3.0 : -1.0, gl_VertexID == 2 ? 3.0 : -1.0);\n  gl_Position = vec4(p, 0.0, 1.0);\n}\n`;\n\ninterface Target { texture: WebGLTexture; framebuffer: WebGLFramebuffer; width: number; height: number }\n\n/** Bakes skies with its own WebGL 2 context; requires float render targets. */\nexport class WebGLSkyBaker {\n  private readonly gl: WebGL2RenderingContext;\n  private readonly programs: Record<'transmittance' | 'multiple' | 'skyView' | 'irradiance' | 'map', WebGLProgram>;\n  private readonly targets: Record<'transmittance' | 'multiple' | 'skyView' | 'irradiance', Target>;\n  private map?: Target;\n\n  constructor() {\n    const canvas = typeof OffscreenCanvas !== 'undefined' ? new OffscreenCanvas(1, 1) : document.createElement('canvas');\n    const gl = canvas.getContext('webgl2', { antialias: false, depth: false, stencil: false, alpha: false }) as WebGL2RenderingContext | null;\n    if (!gl) throw new Error('The procedural sky needs WebGL 2.');\n    if (!gl.getExtension('EXT_color_buffer_float')) throw new Error('The procedural sky needs float render targets (EXT_color_buffer_float).');\n    this.gl = gl;\n    gl.bindVertexArray(gl.createVertexArray());\n    this.programs = {\n      transmittance: this.program(TRANSMITTANCE),\n      multiple: this.program(MULTIPLE),\n      skyView: this.program(SKY_VIEW),\n      irradiance: this.program(IRRADIANCE),\n      map: this.program(MAP)\n    };\n    this.targets = {\n      transmittance: this.target(...T_SIZE),\n      multiple: this.target(...MS_SIZE),\n      skyView: this.target(...SV_SIZE),\n      irradiance: this.target(2, 1)\n    };\n  }\n\n  /** Clear sky at a local solar time, in hours. */\n  bake(hours: number, width = 2048, height = 1024): SkyData {\n    const gl = this.gl;\n    if (gl.isContextLost()) throw new Error('The procedural sky lost its WebGL context.');\n    const { elevation, azimuth } = sunPosition(hours);\n    const e = deg(elevation), a = deg(azimuth);\n    const shared = (program: WebGLProgram) => {\n      gl.useProgram(program);\n      this.uniform(program, 'uSun', (l) => gl.uniform3f(l, Math.cos(e), Math.sin(e), 0));\n      this.uniform(program, 'uTurbidity', (l) => gl.uniform1f(l, TURBIDITY));\n      this.uniform(program, 'uAlbedo', (l) => gl.uniform3fv(l, GROUND_ALBEDO));\n      return program;\n    };\n    const { transmittance, multiple, skyView, irradiance } = this.targets;\n    const atmosphere = (program: WebGLProgram, full: boolean, sky: number[]) => {\n      shared(program);\n      this.bind(program, 'uTransmittance', 0, transmittance);\n      // The multiple-scattering pass declares but never reads its own target;\n      // bind another texture so WebGL sees no feedback loop.\n      this.bind(program, 'uMultiple', 1, full ? multiple : irradiance);\n      this.uniform(program, 'uFull', (l) => gl.uniform1i(l, full ? 1 : 0));\n      this.uniform(program, 'uSkyIrradiance', (l) => gl.uniform3fv(l, sky));\n    };\n\n    this.draw(shared(this.programs.transmittance), transmittance);\n    atmosphere(this.programs.multiple, false, [0, 0, 0]);\n    this.draw(this.programs.multiple, multiple);\n    // Upward views first: the ground seen below is lit by that sky.\n    atmosphere(this.programs.skyView, true, [0, 0, 0]);\n    this.draw(this.programs.skyView, skyView);\n    shared(this.programs.irradiance);\n    this.bind(this.programs.irradiance, 'uTransmittance', 0, transmittance);\n    this.bind(this.programs.irradiance, 'uSkyView', 1, skyView);\n    this.draw(this.programs.irradiance, irradiance);\n    const sky = this.read(irradiance).subarray(0, 3);\n    atmosphere(this.programs.skyView, true, Array.from(sky));\n    this.draw(this.programs.skyView, skyView);\n\n    if (!this.map || this.map.width !== width || this.map.height !== height) {\n      if (this.map) this.release(this.map);\n      this.map = this.target(width, height);\n    }\n    const map = shared(this.programs.map);\n    this.bind(map, 'uSkyView', 0, skyView);\n    this.bind(map, 'uIrradiance', 1, irradiance);\n    this.uniform(map, 'uSize', (l) => gl.uniform2f(l, width, height));\n    this.uniform(map, 'uAzimuth', (l) => gl.uniform1f(l, a));\n    this.uniform(map, 'uSunWorld', (l) => gl.uniform3f(l, Math.cos(e) * Math.cos(a), Math.sin(e), Math.cos(e) * Math.sin(a)));\n    this.uniform(map, 'uSunRadius', (l) => gl.uniform1f(l, deg(SUN_RADIUS)));\n    this.draw(map, this.map);\n    // Row 0 is the zenith, as in an .hdr file.\n    return { data: this.read(this.map), width, height };\n  }\n\n  dispose() {\n    this.gl.getExtension('WEBGL_lose_context')?.loseContext();\n  }\n\n  private program(fragment: string) {\n    const gl = this.gl;\n    const compile = (type: number, source: string) => {\n      const shader = gl.createShader(type)!;\n      gl.shaderSource(shader, source);\n      gl.compileShader(shader);\n      if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) throw new Error(`Sky shader: ${gl.getShaderInfoLog(shader)}`);\n      return shader;\n    };\n    const program = gl.createProgram()!;\n    gl.attachShader(program, compile(gl.VERTEX_SHADER, VERTEX));\n    gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fragment));\n    gl.linkProgram(program);\n    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) throw new Error(`Sky program: ${gl.getProgramInfoLog(program)}`);\n    return program;\n  }\n\n  private target(width: number, height: number): Target {\n    const gl = this.gl;\n    const texture = gl.createTexture()!;\n    gl.bindTexture(gl.TEXTURE_2D, texture);\n    gl.texStorage2D(gl.TEXTURE_2D, 1, gl.RGBA32F, width, height);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);\n    const framebuffer = gl.createFramebuffer()!;\n    gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);\n    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);\n    if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE) throw new Error('The procedural sky cannot render to float textures.');\n    return { texture, framebuffer, width, height };\n  }\n\n  private release(target: Target) {\n    this.gl.deleteFramebuffer(target.framebuffer);\n    this.gl.deleteTexture(target.texture);\n  }\n\n  private uniform(program: WebGLProgram, name: string, set: (location: WebGLUniformLocation) => void) {\n    const location = this.gl.getUniformLocation(program, name);\n    if (location) set(location);\n  }\n\n  private bind(program: WebGLProgram, name: string, unit: number, target: Target) {\n    const gl = this.gl;\n    gl.activeTexture(gl.TEXTURE0 + unit);\n    gl.bindTexture(gl.TEXTURE_2D, target.texture);\n    this.uniform(program, name, (l) => gl.uniform1i(l, unit));\n  }\n\n  private draw(program: WebGLProgram, target: Target) {\n    const gl = this.gl;\n    gl.useProgram(program);\n    // A texture cannot be sampled while it is the render target.\n    gl.bindFramebuffer(gl.FRAMEBUFFER, target.framebuffer);\n    gl.viewport(0, 0, target.width, target.height);\n    gl.drawArrays(gl.TRIANGLES, 0, 3);\n  }\n\n  private read(target: Target) {\n    const gl = this.gl;\n    const data = new Float32Array(target.width * target.height * 4);\n    gl.bindFramebuffer(gl.FRAMEBUFFER, target.framebuffer);\n    gl.readPixels(0, 0, target.width, target.height, gl.RGBA, gl.FLOAT, data);\n    return data;\n  }\n}\n\nfunction deg(d: number) {\n  return (d * Math.PI) / 180;\n}\n"]}

package/lib/renderer/WebGLSkySource.d.ts

@@ -0,0 +1,9 @@
+import type { EnvironmentMapSource, EnvironmentSource } from './envMapDistribution.js';
+/** CPU-backed compatibility path for WebGL environment uploads. */
+export declare class WebGLSkySource {
+    private baker?;
+    private readonly images;
+    private sky?;
+    resolve(source: EnvironmentSource | undefined): EnvironmentMapSource | undefined;
+    dispose(): void;
+}

package/lib/renderer/WebGLSkySource.js

@@ -0,0 +1,28 @@
+import { WebGLSkyBaker } from './WebGLSkyBaker.js';
+/** CPU-backed compatibility path for WebGL environment uploads. */
+export class WebGLSkySource {
+    baker;
+    images = new WeakMap();
+    sky;
+    resolve(source) {
+        if (!source || !('sky' in source))
+            return source;
+        const cached = this.images.get(source);
+        if (cached)
+            return cached;
+        const { width, height, sky: { time }, intensity, ambient } = source;
+        this.baker ??= new WebGLSkyBaker();
+        if (!this.sky || this.sky.time !== time || this.sky.width !== width || this.sky.height !== height) {
+            this.sky = { time, ...this.baker.bake(time, width, height) };
+        }
+        let data = this.sky.data;
+        if (intensity !== 1 || ambient.some(value => value !== 0)) {
+            data = data.map((value, index) => index % 4 === 3 ? value : value * intensity + ambient[index % 4]);
+        }
+        const result = { width, height, data };
+        this.images.set(source, result);
+        return result;
+    }
+    dispose() { this.baker?.dispose(); this.baker = undefined; this.sky = undefined; }
+}
+//# sourceMappingURL=WebGLSkySource.js.map

package/lib/renderer/WebGLSkySource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLSkySource.js","sourceRoot":"","sources":["../../src/renderer/WebGLSkySource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,mEAAmE;AACnE,MAAM,OAAO,cAAc;IACjB,KAAK,CAAiB;IACb,MAAM,GAAG,IAAI,OAAO,EAA2C,CAAC;IACzE,GAAG,CAAuE;IAElF,OAAO,CAAC,MAAqC;QAC3C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QACpE,IAAI,CAAC,KAAK,KAAK,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAClG,IAAI,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACzB,IAAI,SAAS,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1D,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC;CACnF","sourcesContent":["import type { EnvironmentMapSource, EnvironmentSource } from './envMapDistribution.js';\nimport { WebGLSkyBaker } from './WebGLSkyBaker.js';\n\n/** CPU-backed compatibility path for WebGL environment uploads. */\nexport class WebGLSkySource {\n  private baker?: WebGLSkyBaker;\n  private readonly images = new WeakMap<EnvironmentSource, EnvironmentMapSource>();\n  private sky?: { time: number; width: number; height: number; data: Float32Array };\n\n  resolve(source: EnvironmentSource | undefined): EnvironmentMapSource | undefined {\n    if (!source || !('sky' in source)) return source;\n    const cached = this.images.get(source);\n    if (cached) return cached;\n    const { width, height, sky: { time }, intensity, ambient } = source;\n    this.baker ??= new WebGLSkyBaker();\n    if (!this.sky || this.sky.time !== time || this.sky.width !== width || this.sky.height !== height) {\n      this.sky = { time, ...this.baker.bake(time, width, height) };\n    }\n    let data = this.sky.data;\n    if (intensity !== 1 || ambient.some(value => value !== 0)) {\n      data = data.map((value, index) => index % 4 === 3 ? value : value * intensity + ambient[index % 4]);\n    }\n    const result = { width, height, data };\n    this.images.set(source, result);\n    return result;\n  }\n  dispose() { this.baker?.dispose(); this.baker = undefined; this.sky = undefined; }\n}\n"]}

package/lib/renderer/accumulationTarget.d.ts

@@ -10,6 +10,12 @@ export interface TargetPipeline extends RenderPasses {
     configure(settings: TraceSettings): void;
     synchronizeBackground(background: Scene['background']): void;
     canCompleteSampleWithin(timeBudgetMs: number): boolean;
+    /** Optional WebGPU throughput controls; do not alter the tile budget. */
+    setRealtimeBatchBudget?(milliseconds: number): void;
+    setRealtimeDeferPostProcess?(defer: boolean): void;
+    getRealtimeSampleTime?(): number | undefined;
+    getRealtimeTileTime?(): number | undefined;
+    whenTraceAvailable?(): Promise<boolean>;
     present(): void;
     readPresentation(): Promise<{
         width: number;

package/lib/renderer/accumulationTarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"accumulationTarget.js","sourceRoot":"","sources":["../../src/renderer/accumulationTarget.ts"],"names":[],"mappings":"","sourcesContent":["import type { Scene } from '../scene/Scene.js';\nimport type { TraceSettings } from './renderPipeline.js';\nimport type { RenderPasses } from './RenderingPipeline.js';\n\n/** Backend-owned execution and outputs of one resident accumulation. */\nexport interface TargetPipeline extends RenderPasses {\n  activate(): void;\n  invalidateDenoisedOutput(): void;\n  /** Refreshes backend timing after structural scene changes; optional without GPU timestamps. */\n  invalidateTiming?(): void;\n  configure(settings: TraceSettings): void;\n  synchronizeBackground(background: Scene['background']): void;\n  canCompleteSampleWithin(timeBudgetMs: number): boolean;\n  present(): void;\n  readPresentation(): Promise<{width: number; height: number; data: Float32Array}>;\n  readonly presentationComplete: boolean;\n  readonly presentationDenoised: boolean;\n  getMemory(): {width: number; height: number; bytes: number};\n}\n"]}
+{"version":3,"file":"accumulationTarget.js","sourceRoot":"","sources":["../../src/renderer/accumulationTarget.ts"],"names":[],"mappings":"","sourcesContent":["import type { Scene } from '../scene/Scene.js';\nimport type { TraceSettings } from './renderPipeline.js';\nimport type { RenderPasses } from './RenderingPipeline.js';\n\n/** Backend-owned execution and outputs of one resident accumulation. */\nexport interface TargetPipeline extends RenderPasses {\n  activate(): void;\n  invalidateDenoisedOutput(): void;\n  /** Refreshes backend timing after structural scene changes; optional without GPU timestamps. */\n  invalidateTiming?(): void;\n  configure(settings: TraceSettings): void;\n  synchronizeBackground(background: Scene['background']): void;\n  canCompleteSampleWithin(timeBudgetMs: number): boolean;\n  /** Optional WebGPU throughput controls; do not alter the tile budget. */\n  setRealtimeBatchBudget?(milliseconds: number): void;\n  setRealtimeDeferPostProcess?(defer: boolean): void;\n  getRealtimeSampleTime?(): number | undefined;\n  getRealtimeTileTime?(): number | undefined;\n  whenTraceAvailable?(): Promise<boolean>;\n  present(): void;\n  readPresentation(): Promise<{width: number; height: number; data: Float32Array}>;\n  readonly presentationComplete: boolean;\n  readonly presentationDenoised: boolean;\n  getMemory(): {width: number; height: number; bytes: number};\n}\n"]}

package/lib/renderer/aov.d.ts

@@ -0,0 +1,42 @@
+/** Optional primary-surface outputs, separate from beauty and OIDN guides. */
+export type AovKind = 'depth' | 'position' | 'roughness' | 'diffuseAlbedo' | 'specularAlbedo' | 'id' | 'motion';
+export declare const AOV_KINDS: readonly AovKind[];
+export declare const AOV_BACKGROUND_ID = 4294967295;
+export declare const AOV_LAYOUT: {
+    readonly accumulatedBytes: 64;
+    readonly centerBytes: 32;
+    readonly depthRoughness: 0;
+    readonly position: 4;
+    readonly diffuseAlbedo: 8;
+    readonly specularAlbedo: 12;
+    readonly id: 0;
+    readonly motion: 4;
+};
+export declare function allocateAovId(): number;
+export declare function validateAovId(value: number): number;
+export declare function aovMask(kinds: readonly AovKind[]): number;
+export interface AovInstanceSnapshot {
+    object: number;
+    instance: number;
+    topology: number;
+    vertices: number;
+    transform: Float32Array;
+}
+export interface AovFrameSnapshot {
+    width: number;
+    height: number;
+    projection: string;
+    cameraEye?: Float32Array;
+    cameraForward?: Float32Array;
+    viewProjection: Float32Array;
+    instances: readonly AovInstanceSnapshot[];
+}
+/** Per-render history; camera pose and rigid transforms may change without resetting. */
+export declare class AovHistory {
+    private frame?;
+    private instances;
+    clear(): void;
+    previous(next: AovFrameSnapshot): AovFrameSnapshot | undefined;
+    match(next: AovFrameSnapshot, instance: AovInstanceSnapshot): AovInstanceSnapshot | undefined;
+    accept(frame: AovFrameSnapshot): void;
+}

package/lib/renderer/aov.js

@@ -0,0 +1,50 @@
+export const AOV_KINDS = ['depth', 'position', 'roughness', 'diffuseAlbedo', 'specularAlbedo', 'id', 'motion'];
+export const AOV_BACKGROUND_ID = 0xffffffff;
+// Four vec4 lanes for accumulated geometry/reflectance; two for center ID/motion.
+// Depth and roughness share a lane; coverage is position.w.
+export const AOV_LAYOUT = { accumulatedBytes: 64, centerBytes: 32,
+    depthRoughness: 0, position: 4, diffuseAlbedo: 8, specularAlbedo: 12,
+    id: 0, motion: 4 };
+let nextId = 0;
+export function allocateAovId() {
+    if (nextId >= AOV_BACKGROUND_ID)
+        throw new RangeError('AOV ID space exhausted');
+    return nextId++;
+}
+export function validateAovId(value) {
+    if (!Number.isInteger(value) || value < 0 || value >= AOV_BACKGROUND_ID)
+        throw new RangeError('AOV ID must be uint32 excluding 0xFFFFFFFF');
+    return value;
+}
+export function aovMask(kinds) {
+    let mask = 0;
+    for (const kind of kinds) {
+        const index = AOV_KINDS.indexOf(kind);
+        if (index < 0)
+            throw new RangeError(`Unknown AOV: ${kind}`);
+        mask |= 1 << index;
+    }
+    return mask;
+}
+/** Per-render history; camera pose and rigid transforms may change without resetting. */
+export class AovHistory {
+    frame;
+    instances = new Map();
+    clear() { this.frame = undefined; this.instances.clear(); }
+    previous(next) {
+        const old = this.frame;
+        return old && old.width === next.width && old.height === next.height && old.projection === next.projection ? old : undefined;
+    }
+    match(next, instance) {
+        const old = this.previous(next) ? this.instances.get(`${instance.object}:${instance.instance}`) : undefined;
+        return old && old.topology === instance.topology && old.vertices === instance.vertices ? old : undefined;
+    }
+    accept(frame) {
+        this.frame = { ...frame, cameraEye: frame.cameraEye?.slice(), cameraForward: frame.cameraForward?.slice(), viewProjection: frame.viewProjection.slice(),
+            instances: frame.instances.map(i => ({ ...i, transform: i.transform.slice() })) };
+        this.instances.clear();
+        for (const instance of this.frame.instances)
+            this.instances.set(`${instance.object}:${instance.instance}`, instance);
+    }
+}
+//# sourceMappingURL=aov.js.map