spryte 0.3.0 → 0.4.1

package/dist/phaser.js

@@ -0,0 +1,100 @@
+import { createSharedRenderer } from "./shared.js";
+/**
+ * Draw with spryte in an `Extern`'s slot: `render` is called each frame with a `Draw` whose transform is the
+ * Extern's `calcMatrix` (the camera, and any Container it's in), so world coordinates are Phaser's. Filters on the
+ * Extern or its camera, camera viewports and `Stencil` masks apply, since spryte draws into Phaser's drawing context
+ * under its state. The game must run on a WebGL2 context (`createPhaserContext`).
+ */
+export function spryteExtern(extern, render, options = {}) {
+    let shared = null;
+    extern.render = (renderer, context, m) => {
+        const gl = renderer.gl;
+        if (typeof WebGL2RenderingContext === "undefined" || !(gl instanceof WebGL2RenderingContext))
+            throw new Error("spryte/phaser: Phaser is on a WebGL1 context. Create the game with `...createPhaserContext()` in its config.");
+        shared ??= createSharedRenderer(gl, options);
+        // Phaser's full state for this destination, forced: it has only reset blend, VAO and textures for the Extern.
+        renderer.glWrapper.update(context.state, true);
+        shared.target(context.framebuffer?.webGLFramebuffer ?? null, context.width, context.height);
+        const draw = shared.draw;
+        draw.begin(null, context.width, context.height, 1);
+        draw.transform(m.a, m.b, m.c, m.d, m.e, m.f);
+        render(draw);
+        draw.end();
+    };
+    const dispose = () => {
+        shared?.draw.dispose();
+        shared = null;
+    };
+    extern.once?.("destroy", dispose);
+    return {
+        get draw() {
+            return shared?.draw ?? null;
+        },
+        dispose,
+    };
+}
+/**
+ * A WebGL2 context for Phaser to run on, with its shaders translated to GLSL ES 3.00 (`shimShaders`). Spread the
+ * result into the game config, with `type: Phaser.WEBGL`. `attributes` are the context's, defaulting to Phaser's
+ * (opaque, antialiased, premultiplied, with a stencil buffer, on the high-performance GPU). `gl` is the context;
+ * `context` is the same object, typed to fit whatever Phaser's config declares (a 2D context, in 4.2.1).
+ */
+export function createPhaserContext(canvas = document.createElement("canvas"), attributes = {}) {
+    const gl = canvas.getContext("webgl2", {
+        alpha: false,
+        antialias: true,
+        premultipliedAlpha: true,
+        stencil: true,
+        powerPreference: "high-performance",
+        ...attributes,
+    });
+    if (!gl)
+        throw new Error("spryte/phaser: WebGL2 is unavailable in this browser");
+    shimShaders(gl);
+    return { canvas, context: gl, gl };
+}
+/**
+ * Translate every GLSL ES 1.00 shader compiled on `gl` to ES 3.00. Phaser 4's shaders are ES 1.00, and on a WebGL2
+ * context the ones that use derivatives (`Gradient`, noise objects with `noiseNormalMap`, `smoothPixelArt`) fail
+ * to compile, since `OES_standard_derivatives` is a WebGL1 extension (Phaser 4.2.1). Install it before
+ * `new Phaser.Game`; `createPhaserContext` does. Shaders that already declare `#version 300 es` pass through.
+ */
+export function shimShaders(gl) {
+    const types = new WeakMap();
+    const createShader = gl.createShader.bind(gl);
+    gl.createShader = (type) => {
+        const shader = createShader(type);
+        if (shader)
+            types.set(shader, type);
+        return shader;
+    };
+    const shaderSource = gl.shaderSource.bind(gl);
+    gl.shaderSource = (shader, source) => shaderSource(shader, /^\s*#version\s+300/.test(source) ? source : toEs300(source, types.get(shader) === gl.FRAGMENT_SHADER));
+    // Uniforms and attributes renamed in the source are looked up and bound by their new names.
+    const getUniformLocation = gl.getUniformLocation.bind(gl);
+    gl.getUniformLocation = (program, name) => getUniformLocation(program, renameIdentifier(name));
+    const getAttribLocation = gl.getAttribLocation.bind(gl);
+    gl.getAttribLocation = (program, name) => getAttribLocation(program, renameIdentifier(name));
+    const bindAttribLocation = gl.bindAttribLocation.bind(gl);
+    gl.bindAttribLocation = (program, index, name) => bindAttribLocation(program, index, renameIdentifier(name));
+}
+/** Identifiers that are keywords or built-in functions in ES 3.00 but were free in ES 1.00. */
+const RESERVED = /\b(sample|centroid|smooth|layout|patch|uint|uvec[234]|texture)\b/g;
+/** A uniform or attribute name (`smooth`, `smooth[0]`, `light.sample`) as `toEs300` renamed it. */
+function renameIdentifier(name) {
+    return name.replace(RESERVED, "$1_");
+}
+/** @internal GLSL ES 1.00 to 3.00, for the constructs Phaser's shaders use. Exported for tests. */
+export function toEs300(source, fragment) {
+    let out = source
+        .replace(/^[ \t]*#version\s+100.*$/m, "")
+        .replace(/^[ \t]*#extension\s+GL_(OES_standard_derivatives|EXT_shader_texture_lod)\b.*$/gm, "")
+        .replace(RESERVED, "$1_")
+        .replace(/\btexture(2D|Cube)(Lod|Proj)?(EXT)?\b/g, (_, _dim, fn) => (fn ? `texture${fn}` : "texture"));
+    if (fragment)
+        out = out.replace(/\bvarying\b/g, "in").replace(/\bgl_FragColor\b/g, "spryte_FragColor");
+    else
+        out = out.replace(/\battribute\b/g, "in").replace(/\bvarying\b/g, "out");
+    return `#version 300 es\n${fragment ? "out highp vec4 spryte_FragColor;\n" : ""}${out}`;
+}
+//# sourceMappingURL=phaser.js.map

package/dist/phaser.js.map

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

package/dist/shared.d.ts

@@ -0,0 +1,29 @@
+import { Draw } from "./draw.js";
+export interface SharedRendererOptions {
+    /** Linear filtering for images by default. Pass false for pixel art. Default true. */
+    smooth?: boolean;
+}
+/** spryte drawing on a WebGL2 context another engine owns. See `createSharedRenderer`. */
+export interface SharedRenderer {
+    readonly draw: Draw;
+    /**
+     * Where the next `draw.begin()` draws: the host's framebuffer (null for the canvas) and its size in pixels. Call it
+     * when the host's destination changes, such as a filter or post-processing pass that renders into its own
+     * framebuffer. Until it's called, drawing goes to the canvas at its current size.
+     */
+    target(framebuffer: WebGLFramebuffer | null, width: number, height: number): void;
+}
+/**
+ * A `Draw` for a WebGL2 context another engine owns (Phaser, PixiJS, your own code), to draw with spryte inside the
+ * host's frame and in its draw order, on one GPU context with no overlay canvas. Create it inside the slot the host
+ * gives you for foreign drawing, since creating it changes GL state. Each frame, in that slot:
+ * `shared.target(...)` if the host's destination changed, `draw.begin(null, width, height, scale)` (null draws
+ * over the host's frame), draw, `draw.end()`.
+ *
+ * What spryte sets at `begin()` and leaves to the host afterwards is listed in `docs/architecture.md`. The host's
+ * scissor and stencil are respected: a camera viewport or mask applies to spryte's drawing too, and spryte's own
+ * clips intersect the host's scissor. Context loss is the host's: it must `preventDefault` on `webglcontextlost`
+ * for the browser to restore the context, and spryte rebuilds its GPU objects at the first `begin()` after.
+ */
+export declare function createSharedRenderer(gl: WebGL2RenderingContext, options?: SharedRendererOptions): SharedRenderer;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAapH"}

package/dist/shared.js

@@ -0,0 +1,134 @@
+import { Draw } from "./draw.js";
+import { WebGL2Backend } from "./webgl2.js";
+/**
+ * A `Draw` for a WebGL2 context another engine owns (Phaser, PixiJS, your own code), to draw with spryte inside the
+ * host's frame and in its draw order, on one GPU context with no overlay canvas. Create it inside the slot the host
+ * gives you for foreign drawing, since creating it changes GL state. Each frame, in that slot:
+ * `shared.target(...)` if the host's destination changed, `draw.begin(null, width, height, scale)` (null draws
+ * over the host's frame), draw, `draw.end()`.
+ *
+ * What spryte sets at `begin()` and leaves to the host afterwards is listed in `docs/architecture.md`. The host's
+ * scissor and stencil are respected: a camera viewport or mask applies to spryte's drawing too, and spryte's own
+ * clips intersect the host's scissor. Context loss is the host's: it must `preventDefault` on `webglcontextlost`
+ * for the browser to restore the context, and spryte rebuilds its GPU objects at the first `begin()` after.
+ */
+export function createSharedRenderer(gl, options = {}) {
+    const backend = new SharedBackend(gl);
+    const draw = new Draw(backend, options.smooth ?? true);
+    draw.resize(gl.drawingBufferWidth, gl.drawingBufferHeight);
+    return {
+        draw,
+        target(framebuffer, width, height) {
+            backend.fb = framebuffer;
+            backend.fbW = width;
+            backend.fbH = height;
+            draw.resize(width, height);
+        },
+    };
+}
+/**
+ * The WebGL2 backend on a host's context: draws into the host's framebuffer, assumes nothing about GL state between
+ * frames, keeps the host's scissor and stencil, and leaves no sampler objects bound (a host written for WebGL1 never
+ * binds samplers, so spryte's would override its texture filtering).
+ */
+class SharedBackend extends WebGL2Backend {
+    fb = null;
+    fbW;
+    fbH;
+    /** The host's scissor box at `begin()`, or null when its scissor test was off. */
+    hostScissor = null;
+    constructor(gl) {
+        super(gl);
+        this.fbW = gl.drawingBufferWidth;
+        this.fbH = gl.drawingBufferHeight;
+        // The host owns context loss; begin() notices it instead.
+        gl.canvas.removeEventListener("webglcontextlost", this.onLost);
+        gl.canvas.removeEventListener("webglcontextrestored", this.onRestored);
+    }
+    begin(clear, width, height) {
+        const gl = this.gl;
+        if (gl.isContextLost()) {
+            this.lost = true;
+            return;
+        }
+        if (this.lost)
+            this.onRestored();
+        // The host drew since last frame: rebind everything spryte otherwise assumes stays bound.
+        gl.useProgram(this.active.program);
+        gl.bindVertexArray(this.vao);
+        gl.enable(gl.BLEND);
+        gl.blendEquation(gl.FUNC_ADD);
+        this.applyBlend();
+        gl.disable(gl.DEPTH_TEST);
+        gl.disable(gl.CULL_FACE);
+        gl.colorMask(true, true, true, true);
+        gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
+        // Scissor and stencil stay as the host set them: its camera viewport or mask applies to spryte too.
+        this.hostScissor = gl.isEnabled(gl.SCISSOR_TEST) ? gl.getParameter(gl.SCISSOR_BOX) : null;
+        super.begin(clear, width, height);
+    }
+    bindOutput() {
+        const gl = this.gl;
+        gl.bindFramebuffer(gl.FRAMEBUFFER, this.fb);
+        gl.viewport(0, 0, this.fbW, this.fbH);
+        this.outH = this.fbH;
+        // Back on the host's framebuffer, where its scissor applies again (a render target had it off).
+        this.scissor(null);
+    }
+    setClip(rect) {
+        // Inside a render target the host's scissor doesn't apply: it's in the host framebuffer's pixels.
+        if (this.target || this.lost) {
+            super.setClip(rect);
+            return;
+        }
+        this.flush();
+        this.scissor(rect);
+    }
+    setTarget(target, clear, width, height) {
+        if (target && !this.lost && this.hostScissor) {
+            // Submit what's queued for the host's framebuffer under its scissor, then draw the target unscissored.
+            this.flush();
+            this.gl.disable(this.gl.SCISSOR_TEST);
+        }
+        super.setTarget(target, clear, width, height);
+    }
+    end() {
+        this.flush();
+        if (this.lost)
+            return;
+        const gl = this.gl;
+        this.scissor(null);
+        for (let i = 0; i < 8; i++)
+            gl.bindSampler(i, null);
+    }
+    /** Set the scissor to spryte's clip (in the host framebuffer's top-left pixels) intersected with the host's. */
+    scissor(rect) {
+        const gl = this.gl;
+        const host = this.hostScissor;
+        if (!rect) {
+            if (host) {
+                gl.enable(gl.SCISSOR_TEST);
+                gl.scissor(host[0], host[1], host[2], host[3]);
+            }
+            else
+                gl.disable(gl.SCISSOR_TEST);
+            return;
+        }
+        // WebGL's scissor origin is bottom-left.
+        let x = rect.x;
+        let y = this.fbH - rect.y - rect.h;
+        let w = rect.w;
+        let h = rect.h;
+        if (host) {
+            const x1 = Math.min(x + w, host[0] + host[2]);
+            const y1 = Math.min(y + h, host[1] + host[3]);
+            x = Math.max(x, host[0]);
+            y = Math.max(y, host[1]);
+            w = Math.max(0, x1 - x);
+            h = Math.max(0, y1 - y);
+        }
+        gl.enable(gl.SCISSOR_TEST);
+        gl.scissor(x, y, w, h);
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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

package/dist/webgl2.d.ts

@@ -3,11 +3,18 @@ import { type CopySpec } from "./copies.js";
 import type { Shader } from "./shader.js";
 import type { ShapeBuffer } from "./shapes.js";
 import { RenderTarget } from "./target.js";
+/** A linked program and the view size last uploaded to it, so `u_view` is only sent when it changes. */
+interface ProgramInfo {
+    program: WebGLProgram;
+    view: WebGLUniformLocation | null;
+    w: number;
+    h: number;
+}
 /** Instanced, multi-texture WebGL2 sprite batcher behind the `draw` API. */
 export declare class WebGL2Backend implements Backend {
     readonly kind: "webgl2";
     readonly raw: RawContext;
-    private readonly gl;
+    protected readonly gl: WebGL2RenderingContext;
     private readonly capacity;
     private readonly data;
     private readonly f32;
@@ -20,10 +27,10 @@ export declare class WebGL2Backend implements Backend {
     private linear;
     private main;
     /** The program sprite batches draw with: `main`, or a custom shader's inside `withShader`. */
-    private active;
+    protected active: ProgramInfo;
     private shader;
     private readonly customs;
-    private vao;
+    protected vao: WebGLVertexArrayObject;
     private quadBuffer;
     private copyPipe;
     private each;
@@ -35,15 +42,15 @@ export declare class WebGL2Backend implements Backend {
     private staging;
     private readonly targets;
     /** Where drawing goes: a render target, or null for the canvas. */
-    private target;
+    protected target: RenderTarget | null;
     /** Height in pixels of the current destination, for flipping scissor rectangles. */
-    private outH;
+    protected outH: number;
     private viewW;
     private viewH;
     /** True between webglcontextlost and webglcontextrestored: drawing is skipped. */
-    private lost;
-    private readonly onLost;
-    private readonly onRestored;
+    protected lost: boolean;
+    protected readonly onLost: (e: Event) => void;
+    protected readonly onRestored: () => void;
     private readonly units;
     private readonly unitSmooth;
     private unitCount;
@@ -61,7 +68,9 @@ export declare class WebGL2Backend implements Backend {
     get contextLost(): boolean;
     /** Create program, buffers and the white texture. Runs at start and after a context restore. */
     private setup;
-    begin(clear: number, width: number, height: number): void;
+    begin(clear: number | null, width: number, height: number): void;
+    /** Bind the frame's destination, the canvas, with the viewport sized to it. Shared mode binds the host's framebuffer instead. */
+    protected bindOutput(): void;
     quad(m: Matrix, src: TextureSource | null, sx: number, sy: number, sw: number, sh: number, color: number, flash: number, smooth: boolean): void;
     quads(t: Matrix, m: Matrix, positions: ArrayLike<number>, count: number, src: TextureSource, sx: number, sy: number, sw: number, sh: number, color: number, flash: number, smooth: boolean, snap: boolean): void;
     copies(c: CopySpec): void;
@@ -85,7 +94,7 @@ export declare class WebGL2Backend implements Backend {
     path(m: Matrix, points: ArrayLike<number>, n: number, closed: boolean, width: number, color: number, aa: number, tessellator: new () => ShapeBuffer): void;
     private flushShapes;
     private shapePipeline;
-    private flush;
+    protected flush(): void;
     /** Upload `u_view` to a program if the destination size changed since it last drew. The program must be bound. */
     private syncView;
     private syncUniforms;
@@ -93,6 +102,7 @@ export declare class WebGL2Backend implements Backend {
     private texture;
     /** Texture parameters for the bound texture. Filtering comes from the samplers; this keeps the texture complete without them. */
     private wrap;
-    private applyBlend;
+    protected applyBlend(): void;
 }
+export {};
 //# sourceMappingURL=webgl2.d.ts.map

package/dist/webgl2.d.ts.map

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

package/dist/webgl2.js

@@ -296,21 +296,27 @@ export class WebGL2Backend {
         if (this.lost)
             return;
         const gl = this.gl;
-        if (this.target)
-            gl.bindFramebuffer(gl.FRAMEBUFFER, null);
         this.target = null;
-        this.outH = gl.drawingBufferHeight;
-        gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
+        this.bindOutput();
         if (this.active !== this.main)
             this.setShader(null);
         this.viewW = width;
         this.viewH = height;
-        // The canvas is premultiplied, so a see-through clear colour is premultiplied too (opaque colours are unchanged).
-        const a = (clear & 0xff) / 255;
-        gl.clearColor(((clear >>> 24) / 255) * a, (((clear >>> 16) & 0xff) / 255) * a, (((clear >>> 8) & 0xff) / 255) * a, a);
-        gl.clear(gl.COLOR_BUFFER_BIT);
+        if (clear !== null) {
+            // The canvas is premultiplied, so a see-through clear colour is premultiplied too (opaque colours are unchanged).
+            const a = (clear & 0xff) / 255;
+            gl.clearColor(((clear >>> 24) / 255) * a, (((clear >>> 16) & 0xff) / 255) * a, (((clear >>> 8) & 0xff) / 255) * a, a);
+            gl.clear(gl.COLOR_BUFFER_BIT);
+        }
         this.submitted = 0;
     }
+    /** Bind the frame's destination, the canvas, with the viewport sized to it. Shared mode binds the host's framebuffer instead. */
+    bindOutput() {
+        const gl = this.gl;
+        gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+        gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
+        this.outH = gl.drawingBufferHeight;
+    }
     quad(m, src, sx, sy, sw, sh, color, flash, smooth) {
         if (this.lost)
             return;
@@ -637,11 +643,8 @@ export class WebGL2Backend {
             gl.viewport(0, 0, target.width, target.height);
             this.outH = target.height;
         }
-        else {
-            gl.bindFramebuffer(gl.FRAMEBUFFER, null);
-            gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);
-            this.outH = gl.drawingBufferHeight;
-        }
+        else
+            this.bindOutput();
         this.target = target;
         this.viewW = width;
         this.viewH = height;