@swf2es/render 0.0.0-stage → 0.1.1

package/dist/webgl/targets.js

@@ -0,0 +1,323 @@
+import { SizedPool, trimTogether } from "./pool.js";
+import { LAYER_UNIT } from "./programs.js";
+/**
+ * The most a multisampled target may take, colour and depth-stencil
+ * together, 8 bytes a sample, as web's fittingSamples has for the
+ * canvas.
+ */
+export const MSAA_BYTES = 256 * 1024 * 1024;
+/**
+ * The samples a target of `width` by `height` takes for `samples`, a power
+ * of two, as a driver rounds others for colour and depth-stencil alike
+ * or not: halved till its buffers fit MSAA_BYTES, none (1) where two would
+ * not. A layer goes so far, as one padded as far as a texture goes would
+ * take gigabytes; the stage, as web's canvas, keeps 4 at least.
+ */
+export function fittingSamples(width, height, samples, least = 1) {
+    let fitting = 1;
+    while (fitting * 2 <= samples) {
+        fitting *= 2;
+    }
+    const floor = Math.min(fitting, least);
+    while (fitting > floor && width * height * fitting * 8 > MSAA_BYTES) {
+        fitting /= 2;
+    }
+    return fitting;
+}
+/** The sizes a layer's texture is made in: rounded up to a multiple, so that one serves many. */
+export const LAYER_STEP = 128;
+/**
+ * The sizes a small layer's side is made in, under LAYER_STEP: a glow of a
+ * few dozen pixels took a texture of 128 a side, and a crowd keeps
+ * thousands of them as their filters' outputs.
+ */
+const SMALL_STEP = 16;
+/**
+ * The free layers and multisampled buffers kept between frames past what
+ * the last frame drew with, the least lately freed going first as a frame
+ * ends; and the most kept in all. A stretch of frames each drawing
+ * full-screen multisampled layers drew with 150 to 300 MiB a frame, and
+ * trimmed to 128 MiB in all, made seven targets a frame again, as many as
+ * it let go of.
+ */
+const FREE_BYTES = 128 * 1024 * 1024;
+const WORKING_BYTES = 512 * 1024 * 1024;
+/** A side of a layer made for `n` pixels: rounded up to SMALL_STEP, past LAYER_STEP to that. */
+export function layerSide(n) {
+    return n <= LAYER_STEP
+        ? Math.max(SMALL_STEP, Math.ceil(n / SMALL_STEP) * SMALL_STEP)
+        : Math.ceil(n / LAYER_STEP) * LAYER_STEP;
+}
+/** The bytes multisampled buffers take: colour and depth-stencil, 8 a sample. */
+function msaaBytes(msaa) {
+    return msaa.width * msaa.height * msaa.samples * 8;
+}
+/** The bytes a layer takes: its colour, and its stencil where it has one. */
+function layerBytes(layer) {
+    return layer.textureWidth * layer.textureHeight * (layer.stencil ? 8 : 4);
+}
+/** Frames a free layer is kept undrawn into before it is let go of. */
+export const LAYER_IDLE_FRAMES = 60;
+/** A whole layer's object from params `p` from `at` (plan.ts, layerParams): null for none. */
+export function objectOf(p, at) {
+    return p[at + 2] < 0 ? null : { x: p[at], y: p[at + 1], width: p[at + 2], height: p[at + 3] };
+}
+/** The framebuffer `open` is drawn into: its multisampled one while it has one, else its own. */
+export function framebufferOf(open) {
+    return open.msaa?.framebuffer ?? open.layer?.framebuffer ?? null;
+}
+/**
+ * The backend's render targets: layers and the multisampled buffers they
+ * are drawn through, pooled by their size and samples, taken for a frame's
+ * layers, given back and let go of once idle; and the layers kept from
+ * frame to frame.
+ */
+export class TargetPool {
+    gl;
+    state;
+    /** Frames executed, which a layer's idleness is counted in. */
+    frameCount = 0;
+    /**
+     * The samples the layers of the frame drawing take: the stage's, which a
+     * BitmapData's frame draws with none of.
+     */
+    layerSamples = 1;
+    /** Layers free to draw into, by their size. */
+    freeLayers = new SizedPool(layerBytes);
+    /** Multisampled buffers free to draw a layer into, kept while drawn into often enough. */
+    freeMsaa = new SizedPool(msaaBytes);
+    /** The layers kept from frame to frame, by their ids in Keeps. */
+    kept = [];
+    /** The widest and the tallest multisampled buffers found complete, by their samples. */
+    completeMsaa = new Map();
+    constructor(gl, state) {
+        this.gl = gl;
+        this.state = state;
+    }
+    /** The pools and the kept layers emptied, as the context comes or comes back. */
+    setUp() {
+        this.freeLayers = new SizedPool(layerBytes);
+        this.kept = [];
+        this.freeMsaa = new SizedPool(msaaBytes);
+        this.completeMsaa = new Map();
+    }
+    get frame() {
+        return this.frameCount;
+    }
+    get frameSamples() {
+        return this.layerSamples;
+    }
+    /** A frame begun, its layers taking `samples`: the stage's, 1 for a BitmapData's frame. */
+    beginFrame(samples) {
+        this.layerSamples = samples;
+    }
+    /**
+     * A frame of the canvas' ended: the free layers and multisampled buffers
+     * undrawn into for LAYER_IDLE_FRAMES let go of, and the frame counted.
+     */
+    endFrame() {
+        const drop = (l) => this.deleteLayer(l);
+        const dropMsaa = (m) => this.deleteMultisampled(m);
+        this.freeLayers.trimIdle(this.frameCount, LAYER_IDLE_FRAMES, drop);
+        this.freeMsaa.trimIdle(this.frameCount, LAYER_IDLE_FRAMES, dropMsaa);
+        trimTogether([
+            { pool: this.freeLayers, drop },
+            { pool: this.freeMsaa, drop: dropMsaa },
+        ], 
+        // What this frame drew with stays for the next, which likely draws alike: holding it adds
+        // nothing to what the frame itself took.
+        Math.min(WORKING_BYTES, FREE_BYTES +
+            this.freeLayers.bytesFreedIn(this.frameCount) +
+            this.freeMsaa.bytesFreedIn(this.frameCount)));
+        this.frameCount++;
+    }
+    /** The layer kept as output `id` (Keeps), or none. */
+    keptLayer(id) {
+        return this.kept[id] ?? null;
+    }
+    /** `layer` kept as output `id` (Keeps) for the frames after, the one kept before given back. */
+    keep(id, layer) {
+        const before = this.kept[id];
+        if (before && before !== layer) {
+            this.giveLayer(before);
+        }
+        this.kept[id] = layer;
+    }
+    /** The layer kept as output `id` given back, as Keeps let go of it. */
+    release(id) {
+        const layer = this.kept[id];
+        if (layer) {
+            this.giveLayer(layer);
+            this.kept[id] = null;
+        }
+    }
+    /**
+     * `open`'s multisampled pixels resolved into its layer's texture, its
+     * first `width` by `height`, once: what reads it after reads them.
+     */
+    resolve(open, width, height) {
+        const msaa = open.msaa;
+        const layer = open.layer;
+        if (!msaa || !layer) {
+            return;
+        }
+        const gl = this.gl;
+        gl.bindFramebuffer(gl.READ_FRAMEBUFFER, msaa.framebuffer);
+        gl.bindFramebuffer(gl.DRAW_FRAMEBUFFER, layer.framebuffer);
+        // The blit writes the whole rectangle, so what the layer held there goes:
+        // said so, as ANGLE's Vulkan back end, SwiftShader's and a GPU's alike,
+        // otherwise left a reused layer's old pixels where the blit had written
+        // (tests/player/packed-filters.ts, once the pool keeps layers a frame).
+        gl.invalidateSubFramebuffer(gl.DRAW_FRAMEBUFFER, [gl.COLOR_ATTACHMENT0], 0, 0, width, height);
+        gl.blitFramebuffer(0, 0, width, height, 0, 0, width, height, gl.COLOR_BUFFER_BIT, gl.NEAREST);
+        // Bound as the state cache has it.
+        gl.bindFramebuffer(gl.FRAMEBUFFER, msaa.framebuffer);
+        open.msaa = null;
+        // Free for the next layer: only those drawn into now hold multisampled buffers.
+        this.freeMsaa.give(msaa, this.frameCount, msaa.samples);
+    }
+    /**
+     * Multisampled buffers to draw `layer` into at `wanted` samples, as many
+     * as fit, reusing its size or a slightly larger buffer; none where it
+     * takes none, its own stencil then made if it has none.
+     */
+    layerMsaa(layer, wanted) {
+        const samples = fittingSamples(layer.width, layer.height, wanted);
+        // The resolve copies only the layer's rectangle. A larger MSAA buffer can serve it,
+        // but bounding its area avoids clearing a large page for a small layer.
+        const kept = samples > 1
+            ? (this.freeMsaa.take(layer.width, layer.height, samples) ??
+                this.freeMsaa.takeFitting(layer.width, layer.height, samples, layer.width * layer.height * 2))
+            : null;
+        if (kept) {
+            return kept;
+        }
+        const msaa = samples > 1 ? this.multisampled(layer.width, layer.height, samples) : null;
+        if (!msaa && !layer.stencil) {
+            const gl = this.gl;
+            const stencil = gl.createRenderbuffer();
+            gl.bindRenderbuffer(gl.RENDERBUFFER, stencil);
+            gl.renderbufferStorage(gl.RENDERBUFFER, gl.DEPTH24_STENCIL8, layer.textureWidth, layer.textureHeight);
+            this.state.bindFramebuffer(layer.framebuffer);
+            gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_STENCIL_ATTACHMENT, gl.RENDERBUFFER, stencil);
+            layer.stencil = stencil;
+        }
+        return msaa;
+    }
+    /** Multisampled buffers, or none where the driver leaves their framebuffer incomplete. */
+    multisampled(width, height, samples) {
+        const gl = this.gl;
+        const color = gl.createRenderbuffer();
+        gl.bindRenderbuffer(gl.RENDERBUFFER, color);
+        gl.renderbufferStorageMultisample(gl.RENDERBUFFER, samples, gl.RGBA8, width, height);
+        const depthStencil = gl.createRenderbuffer();
+        gl.bindRenderbuffer(gl.RENDERBUFFER, depthStencil);
+        gl.renderbufferStorageMultisample(gl.RENDERBUFFER, samples, gl.DEPTH24_STENCIL8, width, height);
+        const framebuffer = gl.createFramebuffer();
+        this.state.bindFramebuffer(framebuffer);
+        gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.RENDERBUFFER, color);
+        gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_STENCIL_ATTACHMENT, gl.RENDERBUFFER, depthStencil);
+        const msaa = {
+            framebuffer,
+            color,
+            depthStencil,
+            width,
+            height,
+            samples,
+            usedAt: this.frameCount,
+        };
+        // Asking waits for the GPU process, milliseconds at a time, and the
+        // answer hangs on the formats and the samples, which are always these,
+        // and on each side against the largest a renderbuffer may have: one no
+        // wider than the widest found complete of its samples, and no taller
+        // than the tallest, which may be another, is not asked about.
+        const complete = this.completeMsaa.get(samples);
+        if (complete && width <= complete.width && height <= complete.height) {
+            return msaa;
+        }
+        if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE) {
+            this.deleteMultisampled(msaa);
+            return null;
+        }
+        this.completeMsaa.set(samples, {
+            width: Math.max(width, complete?.width ?? 0),
+            height: Math.max(height, complete?.height ?? 0),
+        });
+        return msaa;
+    }
+    deleteMultisampled(msaa) {
+        this.gl.deleteFramebuffer(msaa.framebuffer);
+        this.gl.deleteRenderbuffer(msaa.color);
+        this.gl.deleteRenderbuffer(msaa.depthStencil);
+    }
+    /**
+     * A layer of at least `width` by `height`, the smallest of those free
+     * that is, or one made, its sides rounded as layerSide rounds them;
+     * `exact`, used as just the rounded size, which filters take so that a
+     * frame's targets are alike: a larger texture serves it as one of that
+     * size, as filters read it within its size (FilterTarget), so that a
+     * layer whose size changes as its content moves finds one free.
+     */
+    takeLayer(width, height, exact = false) {
+        width = layerSide(width);
+        height = layerSide(height);
+        // Bound excess area: oversized texture reuse also enlarges the MSAA target and clears. An
+        // exact one takes its multisampled buffers and clears at its own size, so may go further.
+        const found = this.freeLayers.take(width, height) ??
+            this.freeLayers.takeFitting(width, height, 0, width * height * (exact ? 4 : 2));
+        if (found) {
+            found.usedAt = this.frameCount;
+            found.width = exact ? width : found.textureWidth;
+            found.height = exact ? height : found.textureHeight;
+            return found;
+        }
+        return this.makeLayer(width, height);
+    }
+    /** A layer just `width` by `height`, made. */
+    makeLayer(width, height) {
+        const gl = this.gl;
+        const texture = gl.createTexture();
+        this.state.bindTexture(LAYER_UNIT, texture);
+        this.state.activeTexture(LAYER_UNIT);
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+        // Read texel by texel: with no mipmaps, the default filter would leave it incomplete, reading 0.
+        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();
+        this.state.bindFramebuffer(framebuffer);
+        gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
+        return {
+            framebuffer,
+            texture,
+            stencil: null,
+            width,
+            height,
+            textureWidth: width,
+            textureHeight: height,
+            usedAt: this.frameCount,
+        };
+    }
+    /** A layer free again, kept for the layers after it while it is drawn into often enough. */
+    giveLayer(layer) {
+        this.freeLayers.give(layer, this.frameCount);
+    }
+    deleteLayer(layer) {
+        this.state.dropTexture(layer.texture);
+        this.gl.deleteFramebuffer(layer.framebuffer);
+        this.gl.deleteTexture(layer.texture);
+        if (layer.stencil) {
+            this.gl.deleteRenderbuffer(layer.stencil);
+        }
+    }
+    /** The free and the kept layers, and the free multisampled buffers, deleted. */
+    destroy() {
+        this.freeLayers.clear((l) => this.deleteLayer(l));
+        for (const layer of this.kept) {
+            if (layer) {
+                this.deleteLayer(layer);
+            }
+        }
+        this.freeMsaa.clear((m) => this.deleteMultisampled(m));
+    }
+}
+//# sourceMappingURL=targets.js.map

package/dist/webgl/targets.js.map

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

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@swf2es/render",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "swf2es's own renderer: a scene list, a planner and a WebGL 2 backend (docs/renderer.md)",
+  "keywords": [
+    "swf",
+    "flash",
+    "renderer",
+    "webgl2"
+  ],
+  "homepage": "https://swf2es.github.io/swf2es/",
+  "bugs": "https://github.com/swf2es/swf2es/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swf2es/swf2es.git",
+    "directory": "packages/render"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./webgl": {
+      "types": "./dist/webgl/index.d.ts",
+      "default": "./dist/webgl/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/.tsbuildinfo",
+    "src"
+  ],
+  "dependencies": {
+    "@swf2es/context3d": "0.1.1"
+  }
 }

package/src/commands.ts

@@ -0,0 +1,98 @@
+/** Clear the target to a colour: params red, green, blue, alpha. */
+export const CLEAR = 1;
+/** Draw the scene list's entries from `a`, `b` of them, under blend mode `c`. */
+export const RUN = 2;
+/**
+ * A mask: entries from `a`, `b` of them, drawn into the stencil, where what
+ * follows is drawn; and taken out again, the same entries, once it is.
+ */
+export const STENCIL_PUSH = 3;
+export const STENCIL_POP = 4;
+/**
+ * A layer begun, drawn into a target of its own over the rectangle of the
+ * target whose x, y, width and height are params from `a`, `b` 1 where
+ * filters will read it past that rectangle, which is then clear too; and
+ * composited onto the one below in blend mode `a`, coloured by row `b`
+ * (or -1), its output kept as kept output `c` (Keeps), or not (-1).
+ */
+export const LAYER_PUSH = 5;
+export const LAYER_POP = 6;
+/** The filters of chain `a` of the frame's filter list run over the layer drawn into, in turn. */
+export const FILTER = 7;
+/**
+ * A kept output (Keeps) composited again onto the target drawn into, in
+ * blend mode `b`, coloured by row `c` (or -1): its rectangle's x, y, width
+ * and height, then its id, are params from `a`.
+ */
+export const COMPOSITE = 8;
+/**
+ * A filtered layer drawn ahead of the stage (plan), its draws, masks and
+ * held layers' composites the operations between: begun over the
+ * rectangle of params from `a`, its output held as held output `b`, at
+ * level `c`, one past the deepest held layer in it; ended with chain `a`
+ * of the frame's filters run over it, held output `b`. Held layers come
+ * before the stage's CLEAR, a level's after those it holds, and the
+ * backend draws a level's side by side, their passes too.
+ */
+export const HOLD_PUSH = 9;
+export const HOLD_POP = 10;
+/** Held output `a` composited onto the target drawn into, in blend mode `b`, coloured by row `c` (or -1). */
+export const HELD = 11;
+
+/**
+ * What a frame asks of the backend, in order: each operation an opcode and
+ * three integers, with the floats some take apart.
+ */
+export class Commands {
+  ops = new Int32Array(256);
+  params = new Float32Array(64);
+  length = 0;
+  paramLength = 0;
+  /**
+   * Whether a layer is composited onto the target itself in erase or alpha,
+   * which leaves it less than opaque where it covers, as adl clears the
+   * stage, for the blends after it to read.
+   */
+  clearsTarget = false;
+  /**
+   * Whether the stage stays opaque throughout: cleared to an opaque colour,
+   * and nothing composited onto it that leaves less, erase, alpha or a
+   * blend shader. GL's blending computes more of Flash's blends over it.
+   */
+  opaqueStage = false;
+
+  reset(): void {
+    this.length = 0;
+    this.paramLength = 0;
+    this.clearsTarget = false;
+    this.opaqueStage = false;
+  }
+
+  push(op: number, a = 0, b = 0, c = 0): void {
+    if ((this.length + 1) * 4 > this.ops.length) {
+      const grown = new Int32Array(this.ops.length * 2);
+      grown.set(this.ops);
+      this.ops = grown;
+    }
+
+    const at = this.length++ * 4;
+    this.ops[at] = op;
+    this.ops[at + 1] = a;
+    this.ops[at + 2] = b;
+    this.ops[at + 3] = c;
+  }
+
+  /** Floats for the operation pushed next, where it reads them from. */
+  param(...values: number[]): number {
+    const at = this.paramLength;
+    if (at + values.length > this.params.length) {
+      const grown = new Float32Array(Math.max(this.params.length * 2, at + values.length));
+      grown.set(this.params);
+      this.params = grown;
+    }
+
+    this.params.set(values, at);
+    this.paramLength += values.length;
+    return at;
+  }
+}