@swf2es/render 0.0.0-stage → 0.1.1

package/dist/webgl/stage.js

@@ -0,0 +1,173 @@
+import { LAYER_UNIT } from "./programs.js";
+import { fittingSamples, LAYER_IDLE_FRAMES, } from "./targets.js";
+/**
+ * The stage's own targets and their way onto the canvas: multisampled
+ * buffers the canvas's size and the texture they resolve into, the layer a
+ * frame that clears the stage is drawn into before an opaque canvas, and
+ * the copies onto the canvas.
+ */
+export class Stage {
+    gl;
+    state;
+    pool;
+    /** The most samples the GPU takes, and whether the canvas has alpha, asked once. */
+    maxSamples = 1;
+    hasAlpha = false;
+    /**
+     * The stage's multisampled buffers, and the texture they resolve into before a canvas they may
+     * not be resolved onto (present), made as first needed.
+     */
+    stageMsaa = null;
+    stageResolved = null;
+    /**
+     * Whether the driver resolves the stage straight onto a canvas with alpha, found as it first does
+     * (present): null till then. SwiftShader refuses it.
+     */
+    directResolve = null;
+    /** The layer a frame that clears the stage is drawn into before an opaque canvas (stageAlpha). */
+    stageLayer = null;
+    constructor(gl, state, pool) {
+        this.gl = gl;
+        this.state = state;
+        this.pool = pool;
+    }
+    /** Whether the canvas has alpha, as asked of the context in setUp. */
+    get canvasAlpha() {
+        return this.hasAlpha;
+    }
+    /** Nothing made yet, and the GPU and the canvas asked again, as the context comes or comes back. */
+    setUp() {
+        const gl = this.gl;
+        this.stageMsaa = null;
+        this.stageResolved = null;
+        this.directResolve = null;
+        this.stageLayer = null;
+        this.maxSamples = gl.getParameter(gl.MAX_SAMPLES);
+        this.hasAlpha = gl.getContextAttributes()?.alpha ?? false;
+    }
+    /**
+     * The stage's multisampled pixels onto the canvas: resolved straight onto one with alpha where
+     * the driver lets a resolve go there, else into a texture first, as an opaque canvas's must be, a
+     * resolve keeping its format. Whether the driver lets it is found once, by the error it raises.
+     */
+    present(msaa) {
+        const gl = this.gl;
+        const { width, height } = msaa;
+        if (this.hasAlpha && this.directResolve !== false) {
+            const finding = this.directResolve === null;
+            if (finding) {
+                gl.getError();
+            }
+            this.toCanvas(msaa.framebuffer, width, height, false);
+            if (finding) {
+                this.directResolve = gl.getError() !== gl.INVALID_OPERATION;
+            }
+            if (this.directResolve) {
+                return;
+            }
+        }
+        const resolved = this.resolveTarget(width, height);
+        this.state.bindFramebuffer(msaa.framebuffer);
+        gl.bindFramebuffer(gl.DRAW_FRAMEBUFFER, resolved.framebuffer);
+        gl.blitFramebuffer(0, 0, width, height, 0, 0, width, height, gl.COLOR_BUFFER_BIT, gl.NEAREST);
+        this.toCanvas(resolved.framebuffer, width, height, false);
+    }
+    /** The texture the stage resolves into before the canvas (present), made as first needed. */
+    resolveTarget(width, height) {
+        if (this.stageResolved) {
+            return this.stageResolved;
+        }
+        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);
+        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);
+        this.stageResolved = { framebuffer, texture };
+        return this.stageResolved;
+    }
+    /**
+     * The first `width` by `height` pixels of `source` copied onto the canvas,
+     * upside down where `flip`. Bound through the state cache first and as
+     * it was after, so the cache holds what is bound, whatever it held.
+     */
+    toCanvas(source, width, height, flip) {
+        const gl = this.gl;
+        this.state.bindFramebuffer(source);
+        gl.bindFramebuffer(gl.DRAW_FRAMEBUFFER, null);
+        const top = flip ? 0 : height;
+        gl.blitFramebuffer(0, 0, width, height, 0, height - top, width, top, gl.COLOR_BUFFER_BIT, gl.NEAREST);
+        gl.bindFramebuffer(gl.DRAW_FRAMEBUFFER, source);
+    }
+    /**
+     * The layer the canvas' size a frame that clears the stage is drawn into
+     * before an opaque canvas (execute): its own, kept apart from the free
+     * layers so that none smaller takes it, made again for another size, let
+     * go of once idle as they are.
+     */
+    stageAlpha(width, height) {
+        const known = this.stageLayer;
+        if (known && known.width === width && known.height === height) {
+            known.usedAt = this.pool.frame;
+            return known;
+        }
+        if (known) {
+            this.pool.deleteLayer(known);
+        }
+        const layer = this.pool.makeLayer(width, height);
+        this.stageLayer = layer;
+        return layer;
+    }
+    /**
+     * The stage's multisampled buffers, made again for another size or samples, their resolve's
+     * texture let go of; none where it takes no samples.
+     */
+    stageBuffers(width, height, wanted) {
+        const samples = fittingSamples(width, height, Math.min(wanted, this.maxSamples), 4);
+        const known = this.stageMsaa;
+        if (known && known.width === width && known.height === height && known.samples === samples) {
+            return known;
+        }
+        this.dropStageBuffers();
+        const msaa = samples > 1 ? this.pool.multisampled(width, height, samples) : null;
+        if (!msaa) {
+            return null;
+        }
+        this.stageMsaa = msaa;
+        return msaa;
+    }
+    /** The stage's multisampled buffers and their resolve let go of, as samples or size change. */
+    dropStageBuffers() {
+        const gl = this.gl;
+        if (this.stageMsaa) {
+            this.pool.deleteMultisampled(this.stageMsaa);
+            this.stageMsaa = null;
+        }
+        if (this.stageResolved) {
+            this.state.dropTexture(this.stageResolved.texture);
+            gl.deleteTexture(this.stageResolved.texture);
+            gl.deleteFramebuffer(this.stageResolved.framebuffer);
+            this.stageResolved = null;
+        }
+    }
+    /** The stage's layer (stageAlpha) let go of, undrawn into for LAYER_IDLE_FRAMES. */
+    dropIdleLayer() {
+        const stage = this.stageLayer;
+        if (stage && this.pool.frame - stage.usedAt > LAYER_IDLE_FRAMES) {
+            this.pool.deleteLayer(stage);
+            this.stageLayer = null;
+        }
+    }
+    /** What the stage made on the context, deleted. */
+    destroy() {
+        this.dropStageBuffers();
+        if (this.stageLayer) {
+            this.pool.deleteLayer(this.stageLayer);
+        }
+    }
+}
+//# sourceMappingURL=stage.js.map

package/dist/webgl/stage.js.map

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

package/dist/webgl/targets.d.ts

@@ -0,0 +1,172 @@
+import type { GlState } from "@swf2es/context3d/device";
+import type { KernelObject } from "../filter-plan.js";
+/** Where a frame is drawn: the target's size in pixels, and how stage pixels map onto it. */
+export interface Target {
+    width: number;
+    height: number;
+    /** Target pixels a stage pixel, and where the stage's origin lies on the target. */
+    scale: number;
+    x: number;
+    y: number;
+    /** Target pixels a unit of the target's own, which filters read their input's size in. */
+    resolution: number;
+    /**
+     * Target pixels a side of a pixel of Flash's, which a mesh's texture is
+     * read once in: a pixel of the screen, or a BitmapData's draw's sample.
+     */
+    pixel: number;
+}
+/**
+ * A target a layer is drawn into: a texture at least its rectangle's size,
+ * with a stencil of its own for masks within it. Its rows run down, the
+ * first the rectangle's top, as filters read them.
+ */
+export interface Layer {
+    framebuffer: WebGLFramebuffer;
+    texture: WebGLTexture;
+    /** Its stencil, made as it is first drawn into unmultisampled; filters' targets take none. */
+    stencil: WebGLRenderbuffer | null;
+    /**
+     * The size it is used as, which filters read it as a texture of: its
+     * texture's, or less where a filter's target takes a larger one (takeLayer).
+     */
+    width: number;
+    height: number;
+    /** Its texture's size, and its stencil's. */
+    textureWidth: number;
+    textureHeight: number;
+    /** The frame it was last drawn into. */
+    usedAt: number;
+}
+/**
+ * Multisampled colour and depth-stencil a target is drawn into, its edges
+ * covered by `samples` a pixel, then resolved into a texture to be read.
+ */
+export interface Multisampled {
+    framebuffer: WebGLFramebuffer;
+    color: WebGLRenderbuffer;
+    depthStencil: WebGLRenderbuffer;
+    width: number;
+    height: number;
+    samples: number;
+    /** The frame it was last drawn into. */
+    usedAt: number;
+}
+/**
+ * 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 declare const MSAA_BYTES: number;
+/**
+ * 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 declare function fittingSamples(width: number, height: number, samples: number, least?: number): number;
+/** The sizes a layer's texture is made in: rounded up to a multiple, so that one serves many. */
+export declare const LAYER_STEP = 128;
+/** A side of a layer made for `n` pixels: rounded up to SMALL_STEP, past LAYER_STEP to that. */
+export declare function layerSide(n: number): number;
+/** Frames a free layer is kept undrawn into before it is let go of. */
+export declare const LAYER_IDLE_FRAMES = 60;
+/**
+ * A target drawn into: its rectangle of the canvas, in pixels from the
+ * top left, and the layer it is drawn into, or none for the canvas itself.
+ */
+export interface Open {
+    layer: Layer | null;
+    /** What it is drawn into while it is multisampled, resolved before it is read. */
+    msaa: Multisampled | null;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Where its rectangle's corner is in its framebuffer, a page's (HOLD_PUSH); else 0, 0. */
+    ox?: number;
+    oy?: number;
+    /** Where a whole layer's object lies in it, which its ShaderFilters read (filter-plan.ts). */
+    object?: KernelObject | null;
+    /** Whether it is opaque throughout, as the stage is (Commands.opaqueStage). */
+    opaque?: boolean;
+}
+/** A whole layer's object from params `p` from `at` (plan.ts, layerParams): null for none. */
+export declare function objectOf(p: Float32Array, at: number): KernelObject | null;
+/** The framebuffer `open` is drawn into: its multisampled one while it has one, else its own. */
+export declare function framebufferOf(open: Open): WebGLFramebuffer | 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 declare class TargetPool {
+    private readonly gl;
+    private readonly state;
+    /** Frames executed, which a layer's idleness is counted in. */
+    private frameCount;
+    /**
+     * The samples the layers of the frame drawing take: the stage's, which a
+     * BitmapData's frame draws with none of.
+     */
+    private layerSamples;
+    /** Layers free to draw into, by their size. */
+    private freeLayers;
+    /** Multisampled buffers free to draw a layer into, kept while drawn into often enough. */
+    private freeMsaa;
+    /** The layers kept from frame to frame, by their ids in Keeps. */
+    private kept;
+    /** The widest and the tallest multisampled buffers found complete, by their samples. */
+    private completeMsaa;
+    constructor(gl: WebGL2RenderingContext, state: GlState);
+    /** The pools and the kept layers emptied, as the context comes or comes back. */
+    setUp(): void;
+    get frame(): number;
+    get frameSamples(): number;
+    /** A frame begun, its layers taking `samples`: the stage's, 1 for a BitmapData's frame. */
+    beginFrame(samples: number): void;
+    /**
+     * 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(): void;
+    /** The layer kept as output `id` (Keeps), or none. */
+    keptLayer(id: number): Layer | null;
+    /** `layer` kept as output `id` (Keeps) for the frames after, the one kept before given back. */
+    keep(id: number, layer: Layer): void;
+    /** The layer kept as output `id` given back, as Keeps let go of it. */
+    release(id: number): void;
+    /**
+     * `open`'s multisampled pixels resolved into its layer's texture, its
+     * first `width` by `height`, once: what reads it after reads them.
+     */
+    resolve(open: Open, width: number, height: number): void;
+    /**
+     * 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: Layer, wanted: number): Multisampled | null;
+    /** Multisampled buffers, or none where the driver leaves their framebuffer incomplete. */
+    multisampled(width: number, height: number, samples: number): Multisampled | null;
+    deleteMultisampled(msaa: Multisampled): void;
+    /**
+     * 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: number, height: number, exact?: boolean): Layer;
+    /** A layer just `width` by `height`, made. */
+    makeLayer(width: number, height: number): Layer;
+    /** A layer free again, kept for the layers after it while it is drawn into often enough. */
+    giveLayer(layer: Layer): void;
+    deleteLayer(layer: Layer): void;
+    /** The free and the kept layers, and the free multisampled buffers, deleted. */
+    destroy(): void;
+}
+//# sourceMappingURL=targets.d.ts.map

package/dist/webgl/targets.d.ts.map

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