@react-x11/components 0.1.0 → 0.2.0

package/dist/three/postprocess.d.ts

@@ -0,0 +1,85 @@
+type GL = any;
+import type { DirectRenderer } from './renderer-direct.js';
+import type { EffectComposer } from './passes.js';
+interface FrameInfo {
+    width: number;
+    height: number;
+}
+/**
+ * The pass chain for one surface: its render targets, its programs and the
+ * full-screen quad they all draw. Owned by the canvas, which lends it the
+ * direct renderer — so a pass that will not build is reported exactly the
+ * way a material that will not build is, and `<shaderPass uniforms>` takes
+ * exactly what `<shaderMaterial uniforms>` takes.
+ */
+export declare class PostProcessor {
+    private owner;
+    private targets;
+    private bloom;
+    private width;
+    private height;
+    private programs;
+    private quad;
+    private passes;
+    private read;
+    private startedAt;
+    private _usable;
+    constructor(owner: DirectRenderer);
+    /**
+     * Bind the scene's render target, so the surface's clear and the scene's
+     * draws land in a texture. False means "draw straight to the window" —
+     * because there is nothing to compose, or because something is missing —
+     * and is the answer the caller acts on.
+     */
+    begin(gl: GL, info: FrameInfo, composer: EffectComposer): boolean;
+    /**
+     * Run the chain. Each pass reads the target the previous one wrote; the
+     * last writes framebuffer 0, which is what `SwapBuffers` presents.
+     */
+    end(gl: GL, info: FrameInfo): boolean;
+    private runPass;
+    /**
+     * Bright pass, blur across, blur down, composite — four draws, the middle
+     * two at half resolution. Blurring at half size is both cheaper and wider:
+     * the same kernel covers twice as many source pixels.
+     */
+    private bloomPass;
+    /** The image, unchanged, into `target` — a pass that could not run. */
+    private copy;
+    /** `null` is the window's own framebuffer, the one that gets presented. */
+    private bindTarget;
+    private bindSource;
+    /**
+     * The three a post shader almost always wants. They are *set*, not
+     * injected — a pass that does not declare one gets no location back and
+     * the write is dropped, which is what keeps a shader copied from three.js
+     * (where these names are the author's to define) compiling unchanged.
+     */
+    private commonUniforms;
+    /** `<shaderPass uniforms>`, in three.js's `{ name: { value } }` shape. */
+    private userUniforms;
+    private drawQuad;
+    private quadBuffer;
+    /**
+     * One program per pass configuration. A `<shaderPass>` is keyed by its
+     * source, so editing the GLSL recompiles and changing a uniform does not.
+     */
+    private programFor;
+    /**
+     * Does this context have framebuffer objects? The direct backend exposes
+     * whatever `x11-dri` provides, so "the GL has no FBOs" is a real state.
+     * Reported once; the scene then draws to the window uncomposed, which is
+     * the same picture without the effects.
+     */
+    private usable;
+    private ensureTargets;
+    private ensureBloom;
+    private createTarget;
+    private destroyTarget;
+    private releaseTargets;
+    /** Every render target, on a resize or on the way out. */
+    private release;
+    dispose(gl: GL): void;
+}
+export {};
+//# sourceMappingURL=postprocess.d.ts.map

package/dist/three/postprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postprocess.d.ts","sourceRoot":"","sources":["../../src/three/postprocess.ts"],"names":[],"mappings":"AAeA,KAAK,EAAE,GAAG,GAAG,CAAC;AAEd,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAsLpE,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAA6D;IAC7E,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAsB;IAErC,YAAY,KAAK,EAAE,cAAc,EAEhC;IAED;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAahE;IAED;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAyBpC;IAED,OAAO,CAAC,OAAO;IA8Bf;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAiDjB,uEAAuE;IACvE,OAAO,CAAC,IAAI;IAcZ,2EAA2E;IAC3E,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,UAAU;IAYlB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAmBtB,0EAA0E;IAC1E,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAQlB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAgClB;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IAkBd,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,YAAY;IA+EpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,cAAc;IAOtB,0DAA0D;IAC1D,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAapB;CACF"}

package/dist/three/postprocess.js

@@ -0,0 +1,503 @@
+import { BloomPass, VignettePass } from './passes.js';
+import { now } from './globals.js';
+/**
+ * Post shaders run at `highp`, both stages: `varying vec2 vUv` is declared
+ * by our vertex shader and again by the pass's fragment shader (that is how
+ * three.js's post shaders are written), and GLSL ES fails to link when the
+ * two precisions disagree. `mediump` guarantees only ~10 bits, which at
+ * 1080p is coarser than a texel — visible as stair-stepping in any blur.
+ */
+const PRECISION = 'precision highp float;\n';
+/**
+ * The full-screen triangle strip, in clip space. No uv attribute: the quad
+ * covers exactly [-1, 1], so the vertex shader derives the coordinate free.
+ */
+const QUAD_VERTICES = new Float32Array([-1, -1, 1, -1, -1, 1, 1, 1]);
+const QUAD_VERTEX_SHADER = `${PRECISION}attribute vec2 position;
+varying vec2 vUv;
+void main() {
+  vUv = position * 0.5 + 0.5;
+  gl_Position = vec4(position, 0.0, 1.0);
+}`;
+/** Hand the image on unchanged — the last pass of a chain that went wrong. */
+const COPY_SHADER = `uniform sampler2D tDiffuse;
+varying vec2 vUv;
+void main() {
+  gl_FragColor = texture2D(tDiffuse, vUv);
+}`;
+const VIGNETTE_SHADER = `uniform sampler2D tDiffuse;
+uniform float offset;
+uniform float darkness;
+varying vec2 vUv;
+void main() {
+  vec4 texel = texture2D(tDiffuse, vUv);
+  // 0 at the centre, 1 in the corners
+  float d = distance(vUv, vec2(0.5)) * 1.41421356;
+  float v = smoothstep(offset, 1.0, d);
+  gl_FragColor = vec4(texel.rgb * (1.0 - v * darkness), texel.a);
+}`;
+// FXAA, the reduced form: find the local luma gradient from four diagonal
+// neighbours, then blend along it. Worth having because the direct backend
+// has no multisampling — an FBO with an MSAA attachment is an ES 3 feature —
+// so this is the only antialiasing a composed scene can get.
+const FXAA_SHADER = `uniform sampler2D tDiffuse;
+uniform vec2 texelSize;
+varying vec2 vUv;
+
+const vec3 LUMA = vec3(0.299, 0.587, 0.114);
+const float SPAN_MAX = 8.0;
+const float REDUCE_MUL = 0.125;
+const float REDUCE_MIN = 0.0078125;
+
+void main() {
+  vec3 nw = texture2D(tDiffuse, vUv + vec2(-1.0, -1.0) * texelSize).rgb;
+  vec3 ne = texture2D(tDiffuse, vUv + vec2( 1.0, -1.0) * texelSize).rgb;
+  vec3 sw = texture2D(tDiffuse, vUv + vec2(-1.0,  1.0) * texelSize).rgb;
+  vec3 se = texture2D(tDiffuse, vUv + vec2( 1.0,  1.0) * texelSize).rgb;
+  vec4 texel = texture2D(tDiffuse, vUv);
+
+  float lumaNW = dot(nw, LUMA);
+  float lumaNE = dot(ne, LUMA);
+  float lumaSW = dot(sw, LUMA);
+  float lumaSE = dot(se, LUMA);
+  float lumaM = dot(texel.rgb, LUMA);
+  float lumaMin = min(lumaM, min(min(lumaNW, lumaNE), min(lumaSW, lumaSE)));
+  float lumaMax = max(lumaM, max(max(lumaNW, lumaNE), max(lumaSW, lumaSE)));
+
+  // the edge runs perpendicular to the luma gradient
+  vec2 dir = vec2(
+    -((lumaNW + lumaNE) - (lumaSW + lumaSE)),
+     ((lumaNW + lumaSW) - (lumaNE + lumaSE))
+  );
+  float reduce = max(
+    (lumaNW + lumaNE + lumaSW + lumaSE) * 0.25 * REDUCE_MUL,
+    REDUCE_MIN
+  );
+  float scale = 1.0 / (min(abs(dir.x), abs(dir.y)) + reduce);
+  dir = clamp(dir * scale, vec2(-SPAN_MAX), vec2(SPAN_MAX)) * texelSize;
+
+  vec3 inner = 0.5 * (
+    texture2D(tDiffuse, vUv + dir * (1.0 / 3.0 - 0.5)).rgb +
+    texture2D(tDiffuse, vUv + dir * (2.0 / 3.0 - 0.5)).rgb
+  );
+  vec3 outer = inner * 0.5 + 0.25 * (
+    texture2D(tDiffuse, vUv - dir * 0.5).rgb +
+    texture2D(tDiffuse, vUv + dir * 0.5).rgb
+  );
+  // the wider blend overshot the local range, so keep the narrow one
+  float lumaOuter = dot(outer, LUMA);
+  vec3 color = (lumaOuter < lumaMin || lumaOuter > lumaMax) ? inner : outer;
+  gl_FragColor = vec4(color, texel.a);
+}`;
+const BLOOM_BRIGHT_SHADER = `uniform sampler2D tDiffuse;
+uniform float threshold;
+varying vec2 vUv;
+void main() {
+  vec3 color = texture2D(tDiffuse, vUv).rgb;
+  float luma = dot(color, vec3(0.2126, 0.7152, 0.0722));
+  // a soft knee rather than a step, so a surface drifting past the
+  // threshold brightens gradually instead of popping on
+  float keep = smoothstep(threshold, threshold + 0.15, luma);
+  gl_FragColor = vec4(color * keep, 1.0);
+}`;
+// A separable nine-tap Gaussian sampled at five points: each off-centre tap
+// sits between two texels and lets the bilinear filter average them, which
+// is nine texels' worth of blur for five fetches.
+const BLOOM_BLUR_SHADER = `uniform sampler2D tDiffuse;
+uniform vec2 direction;
+varying vec2 vUv;
+void main() {
+  vec3 sum = texture2D(tDiffuse, vUv).rgb * 0.2270270270;
+  sum += (texture2D(tDiffuse, vUv + direction * 1.3846153846).rgb +
+          texture2D(tDiffuse, vUv - direction * 1.3846153846).rgb) * 0.3162162162;
+  sum += (texture2D(tDiffuse, vUv + direction * 3.2307692308).rgb +
+          texture2D(tDiffuse, vUv - direction * 3.2307692308).rgb) * 0.0702702703;
+  gl_FragColor = vec4(sum, 1.0);
+}`;
+const BLOOM_COMPOSITE_SHADER = `uniform sampler2D tDiffuse;
+uniform sampler2D tBloom;
+uniform float strength;
+varying vec2 vUv;
+void main() {
+  vec4 base = texture2D(tDiffuse, vUv);
+  gl_FragColor = vec4(base.rgb + texture2D(tBloom, vUv).rgb * strength, base.a);
+}`;
+/** Single-shader passes: one program, one draw, fields straight to uniforms. */
+const SIMPLE_PASSES = {
+    vignettePass: {
+        fragmentShader: VIGNETTE_SHADER,
+        uniforms(gl, program, pass) {
+            const vignette = pass;
+            gl.uniform1f(program.uniform('offset'), vignette.offset);
+            gl.uniform1f(program.uniform('darkness'), vignette.darkness);
+        },
+    },
+    fxaaPass: {
+        fragmentShader: FXAA_SHADER,
+        // `texelSize` is one of the uniforms every pass gets
+        uniforms() { },
+    },
+};
+/** The GL a render target needs, beyond what drawing a mesh needs. */
+const FBO_ENTRY_POINTS = [
+    'createFramebuffer',
+    'bindFramebuffer',
+    'framebufferTexture2D',
+    'createRenderbuffer',
+    'bindRenderbuffer',
+    'renderbufferStorage',
+    'framebufferRenderbuffer',
+    'checkFramebufferStatus',
+    'deleteFramebuffer',
+    'deleteRenderbuffer',
+];
+const half = (n) => Math.max(1, n >> 1);
+/**
+ * The pass chain for one surface: its render targets, its programs and the
+ * full-screen quad they all draw. Owned by the canvas, which lends it the
+ * direct renderer — so a pass that will not build is reported exactly the
+ * way a material that will not build is, and `<shaderPass uniforms>` takes
+ * exactly what `<shaderMaterial uniforms>` takes.
+ */
+export class PostProcessor {
+    owner;
+    targets = [null, null];
+    bloom = [null, null];
+    width = 0;
+    height = 0;
+    programs = new Map();
+    quad = null;
+    passes = null;
+    read = 0;
+    startedAt = null;
+    _usable;
+    constructor(owner) {
+        this.owner = owner;
+    }
+    /**
+     * Bind the scene's render target, so the surface's clear and the scene's
+     * draws land in a texture. False means "draw straight to the window" —
+     * because there is nothing to compose, or because something is missing —
+     * and is the answer the caller acts on.
+     */
+    begin(gl, info, composer) {
+        this.passes = null;
+        const passes = composer.enabled
+            ? composer.passes.filter((pass) => pass.enabled)
+            : [];
+        if (passes.length === 0)
+            return false;
+        if (!this.usable(gl))
+            return false;
+        if (!this.ensureTargets(gl, info.width, info.height))
+            return false;
+        this.passes = passes;
+        this.read = 0;
+        gl.bindFramebuffer(gl.FRAMEBUFFER, this.targets[0].framebuffer);
+        return true;
+    }
+    /**
+     * Run the chain. Each pass reads the target the previous one wrote; the
+     * last writes framebuffer 0, which is what `SwapBuffers` presents.
+     */
+    end(gl, info) {
+        const passes = this.passes;
+        this.passes = null;
+        if (!passes)
+            return false;
+        // a full-screen quad is not part of the scene: nothing occludes it,
+        // nothing culls it, and it replaces rather than blends with what is there
+        gl.disable(gl.DEPTH_TEST);
+        gl.disable(gl.CULL_FACE);
+        gl.disable(gl.BLEND);
+        gl.depthMask(false);
+        for (let i = 0; i < passes.length; i++) {
+            const last = i === passes.length - 1;
+            const source = this.targets[this.read];
+            const target = last ? null : this.targets[this.read ^ 1];
+            this.runPass(gl, passes[i], source, target, info);
+            if (!last)
+                this.read ^= 1;
+        }
+        // hand the context back as the scene expects to find it
+        gl.bindFramebuffer(gl.FRAMEBUFFER, 0);
+        gl.depthMask(true);
+        gl.enable(gl.DEPTH_TEST);
+        return true;
+    }
+    runPass(gl, pass, source, target, info) {
+        if (pass instanceof BloomPass) {
+            this.bloomPass(gl, pass, source, target, info);
+            return;
+        }
+        const program = this.programFor(gl, pass);
+        // A pass whose shader will not build hands the image on unchanged. The
+        // alternative is a frame of whatever was last in the target, which reads
+        // as a corrupt renderer rather than as one broken effect.
+        if (!program) {
+            this.copy(gl, source, target, info);
+            return;
+        }
+        this.bindTarget(gl, target, info);
+        gl.useProgram(program.program);
+        this.bindSource(gl, program, 'tDiffuse', source, 0);
+        this.commonUniforms(gl, program, info);
+        const simple = SIMPLE_PASSES[pass.kind];
+        if (simple)
+            simple.uniforms(gl, program, pass);
+        else
+            this.userUniforms(gl, program, pass);
+        this.drawQuad(gl, program);
+    }
+    /**
+     * Bright pass, blur across, blur down, composite — four draws, the middle
+     * two at half resolution. Blurring at half size is both cheaper and wider:
+     * the same kernel covers twice as many source pixels.
+     */
+    bloomPass(gl, pass, source, target, info) {
+        const bright = this.programFor(gl, pass, 'bright', BLOOM_BRIGHT_SHADER);
+        const blur = this.programFor(gl, pass, 'blur', BLOOM_BLUR_SHADER);
+        const composite = this.programFor(gl, pass, 'composite', BLOOM_COMPOSITE_SHADER);
+        const scratch = this.ensureBloom(gl, info.width, info.height);
+        if (!bright || !blur || !composite || !scratch) {
+            this.copy(gl, source, target, info);
+            return;
+        }
+        const radius = pass.radius;
+        this.bindTarget(gl, scratch[0], info);
+        gl.useProgram(bright.program);
+        this.bindSource(gl, bright, 'tDiffuse', source, 0);
+        gl.uniform1f(bright.uniform('threshold'), pass.threshold);
+        this.drawQuad(gl, bright);
+        // separable: across the half-size target, then down it
+        gl.useProgram(blur.program);
+        for (const [from, to, direction] of [
+            [0, 1, [radius / scratch[0].width, 0]],
+            [1, 0, [0, radius / scratch[0].height]],
+        ]) {
+            this.bindTarget(gl, scratch[to], info);
+            this.bindSource(gl, blur, 'tDiffuse', scratch[from], 0);
+            gl.uniform2fv(blur.uniform('direction'), new Float32Array(direction));
+            this.drawQuad(gl, blur);
+        }
+        this.bindTarget(gl, target, info);
+        gl.useProgram(composite.program);
+        this.bindSource(gl, composite, 'tDiffuse', source, 0);
+        this.bindSource(gl, composite, 'tBloom', scratch[0], 1);
+        gl.uniform1f(composite.uniform('strength'), pass.strength);
+        this.drawQuad(gl, composite);
+    }
+    /** The image, unchanged, into `target` — a pass that could not run. */
+    copy(gl, source, target, info) {
+        const program = this.programFor(gl, COPY_PASS);
+        if (!program)
+            return;
+        this.bindTarget(gl, target, info);
+        gl.useProgram(program.program);
+        this.bindSource(gl, program, 'tDiffuse', source, 0);
+        this.drawQuad(gl, program);
+    }
+    /** `null` is the window's own framebuffer, the one that gets presented. */
+    bindTarget(gl, target, info) {
+        gl.bindFramebuffer(gl.FRAMEBUFFER, target ? target.framebuffer : 0);
+        gl.viewport(0, 0, target ? target.width : info.width, target ? target.height : info.height);
+    }
+    bindSource(gl, program, name, target, unit) {
+        gl.activeTexture(gl.TEXTURE0 + unit);
+        gl.bindTexture(gl.TEXTURE_2D, target.texture);
+        gl.uniform1i(program.uniform(name), unit);
+    }
+    /**
+     * The three a post shader almost always wants. They are *set*, not
+     * injected — a pass that does not declare one gets no location back and
+     * the write is dropped, which is what keeps a shader copied from three.js
+     * (where these names are the author's to define) compiling unchanged.
+     */
+    commonUniforms(gl, program, info) {
+        const { width, height } = info;
+        gl.uniform2fv(program.uniform('resolution'), new Float32Array([width, height]));
+        gl.uniform2fv(program.uniform('texelSize'), new Float32Array([1 / Math.max(1, width), 1 / Math.max(1, height)]));
+        const time = now();
+        if (this.startedAt === null)
+            this.startedAt = time;
+        gl.uniform1f(program.uniform('time'), (time - this.startedAt) / 1000);
+    }
+    /** `<shaderPass uniforms>`, in three.js's `{ name: { value } }` shape. */
+    userUniforms(gl, program, pass) {
+        const uniforms = pass.uniforms;
+        if (!uniforms)
+            return;
+        for (const [name, entry] of Object.entries(uniforms)) {
+            this.owner.setUniform(gl, program.uniform(name), entry.value);
+        }
+    }
+    drawQuad(gl, program) {
+        const location = program.attribute('position');
+        if (location < 0)
+            return;
+        gl.bindBuffer(gl.ARRAY_BUFFER, this.quadBuffer(gl));
+        gl.enableVertexAttribArray(location);
+        gl.vertexAttribPointer(location, 2, gl.FLOAT, false, 0, 0);
+        gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    }
+    quadBuffer(gl) {
+        if (this.quad)
+            return this.quad;
+        this.quad = gl.createBuffer();
+        gl.bindBuffer(gl.ARRAY_BUFFER, this.quad);
+        gl.bufferData(gl.ARRAY_BUFFER, QUAD_VERTICES, gl.STATIC_DRAW);
+        return this.quad;
+    }
+    /**
+     * One program per pass configuration. A `<shaderPass>` is keyed by its
+     * source, so editing the GLSL recompiles and changing a uniform does not.
+     */
+    programFor(gl, pass, part = '', override = null) {
+        const kind = pass.kind;
+        const custom = kind === 'shaderPass';
+        const shader = pass;
+        const fragmentShader = override ??
+            (custom ? shader.fragmentShader : SIMPLE_PASSES[kind]?.fragmentShader) ??
+            COPY_SHADER;
+        const vertexShader = custom && shader.vertexShader ? shader.vertexShader : QUAD_VERTEX_SHADER;
+        const signature = custom
+            ? `shaderPass|${vertexShader}|${fragmentShader}`
+            : `${kind}|${part}`;
+        const cached = this.programs.get(signature);
+        if (cached)
+            return cached.program ? cached : null;
+        const entry = this.owner.compile(gl, { vertex: vertexShader, fragment: `${PRECISION}${fragmentShader}` }, signature, `<${kind}>`);
+        this.programs.set(signature, entry);
+        return entry.program ? entry : null;
+    }
+    /**
+     * Does this context have framebuffer objects? The direct backend exposes
+     * whatever `x11-dri` provides, so "the GL has no FBOs" is a real state.
+     * Reported once; the scene then draws to the window uncomposed, which is
+     * the same picture without the effects.
+     */
+    usable(gl) {
+        if (this._usable !== undefined)
+            return this._usable;
+        const missing = FBO_ENTRY_POINTS.filter((name) => typeof gl[name] !== 'function');
+        this._usable = missing.length === 0;
+        if (!this._usable) {
+            this.owner.report('post-unavailable', `<effectComposer>: this GL context is missing ${missing.join(', ')}, ` +
+                'so the scene cannot be rendered to a texture and the passes are ' +
+                'skipped. Check with `npm ls x11-dri`.', 'GL_POST_UNAVAILABLE');
+        }
+        return this._usable;
+    }
+    ensureTargets(gl, width, height) {
+        if (this.width !== width || this.height !== height)
+            this.release(gl);
+        if (this.targets[0] && this.targets[1])
+            return this.targets;
+        this.width = width;
+        this.height = height;
+        // only the scene's target needs depth: everything after it is a quad
+        // drawn with the depth test off
+        this.targets[0] ??= this.createTarget(gl, width, height, { depth: true });
+        this.targets[1] ??= this.createTarget(gl, width, height);
+        if (this.targets[0] && this.targets[1])
+            return this.targets;
+        this.release(gl);
+        return null;
+    }
+    ensureBloom(gl, width, height) {
+        if (this.bloom[0] && this.bloom[1])
+            return this.bloom;
+        const w = half(width);
+        const h = half(height);
+        this.bloom[0] ??= this.createTarget(gl, w, h);
+        this.bloom[1] ??= this.createTarget(gl, w, h);
+        if (this.bloom[0] && this.bloom[1])
+            return this.bloom;
+        this.releaseTargets(gl, this.bloom);
+        return null;
+    }
+    createTarget(gl, width, height, { depth = false } = {}) {
+        const texture = gl.createTexture();
+        gl.activeTexture(gl.TEXTURE0);
+        gl.bindTexture(gl.TEXTURE_2D, texture);
+        // null pixels: the storage is allocated and the contents are whatever
+        // the first draw into it writes
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+        // a surface is almost never a power of two, and ES 2 allows an NPOT
+        // texture only with CLAMP_TO_EDGE and no mipmaps
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+        const framebuffer = gl.createFramebuffer();
+        gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+        gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
+        let depthBuffer = null;
+        if (depth) {
+            depthBuffer = gl.createRenderbuffer();
+            gl.bindRenderbuffer(gl.RENDERBUFFER, depthBuffer);
+            gl.renderbufferStorage(gl.RENDERBUFFER, gl.DEPTH_COMPONENT16, width, height);
+            gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, gl.RENDERBUFFER, depthBuffer);
+        }
+        const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
+        gl.bindFramebuffer(gl.FRAMEBUFFER, 0);
+        const target = {
+            framebuffer,
+            texture,
+            depth: depthBuffer,
+            width,
+            height,
+        };
+        if (status !== gl.FRAMEBUFFER_COMPLETE) {
+            this.owner.report('post-target', `<effectComposer>: a ${width}x${height} render target is not ` +
+                `complete (status 0x${(status >>> 0).toString(16)}), so the ` +
+                'passes are skipped and the scene draws to the window directly.', 'GL_POST_TARGET_FAILED');
+            this.destroyTarget(gl, target);
+            return null;
+        }
+        return target;
+    }
+    destroyTarget(gl, target) {
+        if (!target)
+            return;
+        gl.deleteFramebuffer(target.framebuffer);
+        gl.deleteTexture(target.texture);
+        if (target.depth)
+            gl.deleteRenderbuffer(target.depth);
+    }
+    releaseTargets(gl, list) {
+        for (let i = 0; i < list.length; i++) {
+            this.destroyTarget(gl, list[i]);
+            list[i] = null;
+        }
+    }
+    /** Every render target, on a resize or on the way out. */
+    release(gl) {
+        if (!gl) {
+            this.targets = [null, null];
+            this.bloom = [null, null];
+            return;
+        }
+        this.releaseTargets(gl, this.targets);
+        this.releaseTargets(gl, this.bloom);
+    }
+    dispose(gl) {
+        this.release(gl);
+        if (gl) {
+            for (const { program } of this.programs.values()) {
+                if (program)
+                    gl.deleteProgram(program);
+            }
+            if (this.quad)
+                gl.deleteBuffer(this.quad);
+        }
+        this.programs.clear();
+        this.quad = null;
+        this.passes = null;
+        this.width = 0;
+        this.height = 0;
+    }
+}
+/** The stand-in pass `copy` compiles its program under. */
+const COPY_PASS = { kind: 'copy' };
+//# sourceMappingURL=postprocess.js.map

package/dist/three/postprocess.js.map

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

package/dist/three/raycast.d.ts

@@ -0,0 +1,24 @@
+import type { Vec3Tuple } from './math.js';
+import type { Mesh, Object3D } from './objects.js';
+import type { FrameCamera } from './renderer-indirect.js';
+/** The world-space ray through a pixel of the surface. */
+export declare function rayThrough(x: number, y: number, camera: FrameCamera): {
+    origin: Vec3Tuple;
+    direction: Vec3Tuple;
+} | null;
+export declare const hasPointerHandlers: (object: Object3D) => boolean;
+/** Does anything in this subtree listen for pointer events? */
+export declare function sceneWantsPointer(nodes: Object3D[]): boolean;
+export interface RayHit {
+    object: Mesh;
+    distance: number;
+    point: Vec3Tuple;
+    face: number;
+    uv: [number, number];
+}
+/**
+ * Intersect the scene with the ray through pixel (x, y). World matrices come
+ * from the last rendered frame. Nearest first.
+ */
+export declare function raycast(roots: Object3D[], x: number, y: number, camera: FrameCamera): RayHit[];
+//# sourceMappingURL=raycast.d.ts.map

package/dist/three/raycast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raycast.d.ts","sourceRoot":"","sources":["../../src/three/raycast.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAQ,SAAS,EAAE,MAAM,WAAW,CAAC;AAOjD,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA6C1D,0DAA0D;AAC1D,wBAAgB,UAAU,CACxB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAepD;AAED,eAAO,MAAM,kBAAkB,WAAY,QAAQ,KAAG,OACmB,CAAC;AAE1E,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAO5D;AA+BD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,QAAQ,EAAE,EACjB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,GAClB,MAAM,EAAE,CA4CV"}