@swf2es/player 0.0.0-stage → 0.1.0

package/dist/scene/view.d.ts

@@ -0,0 +1,277 @@
+import { type BitmapStore } from "../bitmap/bitmap.js";
+import { type DisplayObject } from "../display/displayobject.js";
+import type { Drawer } from "../hosts.js";
+import type { Player } from "../player.js";
+import type { FillTessellator } from "./fills.js";
+import { LineCache } from "./lines.js";
+export interface RenderViewOptions {
+    /** The stage's size in pixels, and the canvas' pixels a stage pixel. */
+    width: number;
+    height: number;
+    resolution?: number;
+    /** The canvas to draw on; one is made if left out. */
+    canvas?: HTMLCanvasElement;
+    /** The stage's colour, 0xRRGGBB, and whether the canvas is left clear instead. */
+    background?: number;
+    transparent?: boolean;
+    /** Keep what was drawn after it is shown, for a page to read it back. */
+    preserveDrawingBuffer?: boolean;
+    /**
+     * The fills' and lines' tessellator, as @swf2es/native's Tessellator gives
+     * it; left out, the view makes one of its own, which it disposes of with
+     * itself. Either way the render module must compile: where a page does
+     * not let it (no WebAssembly or SIMD, or a CSP without
+     * 'wasm-unsafe-eval'), the view throws.
+     */
+    fillTessellator?: FillTessellator;
+    /** Samples a pixel the stage and its layers are multisampled with (`samples`); 1, none, if left out. */
+    samples?: number;
+}
+/**
+ * Draws the player's display list on a canvas of its own. Each render
+ * walks the whole list, writing a row for each object drawn and an entry
+ * for each of its layers' geometries, each geometry made once and kept
+ * while drawn; then plans the frame and has the backend draw it.
+ */
+export declare class RenderView implements Drawer {
+    readonly canvas: HTMLCanvasElement;
+    readonly gl: WebGL2RenderingContext;
+    /** View pixels a stage pixel, before the resolution: a host showing the stage larger. */
+    scale: number;
+    /** Screen pixels a stage pixel, which hairlines will be drawn a pixel of; the scale's if null. */
+    screenScale: number | null;
+    background: number;
+    transparent: boolean;
+    /** Lines stroked anew and lines found stroked already (LineCache.counts). */
+    readonly counts: LineCache["counts"];
+    private resolution;
+    private width;
+    private height;
+    private stageQuality;
+    private readonly backend;
+    private readonly tessellator;
+    /** Whether the view made its canvas, whose context it then loses with itself. */
+    private readonly ownCanvas;
+    /** The tessellator the view made, which it disposes of with itself; none if it was given one. */
+    private readonly ownTessellator;
+    private scene;
+    private rows;
+    private readonly geometries;
+    private readonly textures;
+    private commands;
+    private filters;
+    private readonly lineCache;
+    private readonly parts;
+    private readonly paints;
+    private readonly staleShapes;
+    private readonly textItems;
+    private readonly advancedTexts;
+    private readonly masks;
+    private readonly filterLayers;
+    private readonly planes;
+    /** The largest texture side the context makes, which a filtered layer's padding must fit. */
+    private readonly textureLimit;
+    /** The outlines' store kept while the view is (text/saffron.ts, holdSegments), let go of with it. */
+    private readonly releaseOutlines;
+    /** The walk's depth, and a colour transform a depth, which a concatenation there is made in. */
+    private walkDepth;
+    /** Each depth's transform on the stage, a b c d tx ty, which its children are placed under. */
+    private places;
+    /** A Bitmap's placement moved onto whole pixels (wholePixels). */
+    private moved;
+    private readonly colorSlots;
+    /** The sliced owner whose children are walked now, its slice, and its parent's linear transform. */
+    private sliceOwner;
+    private ownerSlice;
+    private ownerParent;
+    /** The outputs kept: filtered objects' (FilterLayers) and 3D objects' bitmaps (Planes). */
+    private readonly keeps;
+    /** Moves on as what every kept output was made at changes: the scale, the stage's quality. */
+    private keptGeneration;
+    private keptScale;
+    private keptQuality;
+    private keptScreen;
+    /** The stage's frames drawn. */
+    private frames;
+    /** Where a frame is drawn, filled in as it is. */
+    private target;
+    /**
+     * What BitmapData.draw draws alone, while it is drawn (snapshot), and the
+     * matrix it is drawn through, after its scroll's shift.
+     */
+    private drawRoot;
+    /**
+     * Whether the walk is BitmapData.draw's, which leaves the objects' flags
+     * for the stage's frame; a 3D object's pass in the frame clears them, as
+     * the frame's walk would.
+     */
+    private snapshotting;
+    /** Target pixels a pixel of what filters run on, where not the scale: in a 3D object's bitmap. */
+    private filterUnits;
+    private drawMatrix;
+    /**
+     * The alpha mask drawn for what it masks (drawAlphaMask), which the walk
+     * places where it stands on the stage and draws though it is a mask.
+     */
+    private placedAlphaMask;
+    /**
+     * Whether an alpha mask's objects are walked, whose flags their own place
+     * on the list may have cleared first: their filters run anew, keeping no
+     * output, as nothing would say when one changed.
+     */
+    private inAlphaMask;
+    /** An object's transform's linear part, made its stretch in place (stretchOf). */
+    private readonly stretchScratch;
+    constructor(options: RenderViewOptions);
+    /** A lost context is asked back, as Flash's player would have it, by preventing the default. */
+    private readonly lost;
+    /** The context came back: the backend made again, and every texture added again as it is drawn. */
+    private readonly restored;
+    /**
+     * Whether bitmaps that ask to be are smoothed: not at the stage's low
+     * quality, nor in a draw for BitmapData at a sample a pixel.
+     */
+    private get smoothing();
+    /**
+     * Samples a pixel the stage and its blend and filter layers are
+     * multisampled with, as the GPU allows, 1 for none: Flash's anti-aliasing,
+     * which its host sets by the stage's quality, none at low whatever is set.
+     * A BitmapData's draw supersamples instead, as Flash's does.
+     */
+    get samples(): number;
+    set samples(samples: number);
+    /** The samples the host asked for, which the stage's low quality sets aside (`samples`). */
+    private wantedSamples;
+    /** The stage's quality, "LOW" to "BEST", which will decide bitmaps' smoothing. */
+    get quality(): string;
+    set quality(quality: string);
+    /**
+     * The rectangle of the stage, from (x, y), the canvas shows: its size
+     * the canvas's (resize), in stage
+     * pixels, where a host's margins or alignment show more of the stage or
+     * less than its own.
+     */
+    setViewport(x: number, y: number, _width: number, _height: number): void;
+    /** The stage's point the canvas's corner shows (setViewport). */
+    private viewX;
+    private viewY;
+    /** Canvas pixels a stage pixel (resize). */
+    get canvasResolution(): number;
+    /** How many geometries it keeps, which a page may check. */
+    get geometryCount(): number;
+    /** How many device texts' runs it keeps drawn (rasterized device text), which a page may check. */
+    get textRuns(): number;
+    /** The canvas made `width` by `height` stage pixels at `resolution` canvas pixels each. */
+    resize(width: number, height: number, resolution?: number): void;
+    /** Draw `root`'s display list. */
+    render(root: DisplayObject): void;
+    /**
+     * `o` and what is in it, under its parent's transform on the stage (a b
+     * c d tx ty) and colour transform. Masks are walked but not drawn, nor
+     * what is hidden; every object's flags are cleared, as the player
+     * expects of a renderer.
+     */
+    private walk;
+    /**
+     * `mask`, an alpha mask, drawn into a layer of its own as it would be
+     * drawn where it stands on the stage, though it is a mask: in its colour
+     * and its ancestors', its filters run, from a slot of the walk's above
+     * the object it masks. The layer is composited onto that object's
+     * (ALPHA_MASK), which ends after it.
+     */
+    private drawAlphaMask;
+    /**
+     * The linear transform a Shape child of a sliced owner draws its lines
+     * as wide through: the owner's parent's, kept as the owner's children
+     * are walked, times its own matrix.
+     */
+    private childLineSpace;
+    /** `o` walked from the stage's origin, untinted; the stage's, moved by its viewport. */
+    private walkFrom;
+    /** `parent` and `child` concatenated into depth `depth`'s colour slot, made once and kept. */
+    private concatAt;
+    /**
+     * A 3D object drawn as Flash draws it (display/plane.ts): what it and its
+     * children draw, in its own space, a texel a pixel at `samples` a side
+     * and averaged down, into a bitmap kept as a kept output, in a pass of
+     * its own before the frame's (drawPlaneContent), in its colour `full`,
+     * filtered; then the bitmap's quad, placed by its plane in its parent's
+     * space (a b c d tx ty on the stage), smoothed at each pixel of Flash's.
+     * The bitmap is kept while nothing it holds changes (unchanged). Nothing
+     * where its quad has a corner behind the eye, or it draws nothing, or a
+     * 3D object masks it, which leaves nothing of it in Flash. Whether all in
+     * it was walked, or needs no walk, its flags clear.
+     */
+    private drawPlane;
+    /**
+     * A 3D object's content drawn into its bitmap, kept as kept output `keep`:
+     * walked with the object as the root of a pass of its own, as
+     * BitmapData.draw walks its object, placed by its own space's pixels from
+     * the bitmap's corner (left, top) at `texels` a pixel, at `samples` target pixels
+     * each, with lists of its own, which a 3D object in it nests in again.
+     */
+    private drawPlaneContent;
+    /** What advanced text's quads name of the outlines' store, uploaded. */
+    private uploadOutlines;
+    /**
+     * `o` drawn alone, as BitmapData.draw takes a display object, through `m`
+     * into a `width` by `height` bitmap, read back as premultiplied ARGB: at
+     * `samples` a side and averaged, as Flash covers edges (4 at its high
+     * quality). Built at the draw's own
+     * scale, a hairline a pixel of the bitmap, then drawn `samples` times
+     * larger, filters and device text at that many units a pixel; no flag of
+     * any object is cleared, nor an output kept, which are the stage's.
+     */
+    snapshot(o: DisplayObject, m: {
+        a: number;
+        b: number;
+        c: number;
+        d: number;
+        tx: number;
+        ty: number;
+    }, width: number, height: number, samples?: number): Uint32Array;
+    /**
+     * `o` drawn as `snapshot` draws it, then composited source over into
+     * `store` at (x, y) on the GPU, into the store's texture, where it stays
+     * till a script reads the pixels (Paints): nothing is read back, nor the
+     * store uploaded again to show it. Not for a store too large for a
+     * texture, nor an opaque one holding alpha, whose pixels read two ways
+     * (BitmapStore.holdsAlpha); false, having drawn nothing, for those.
+     */
+    drawInto(store: BitmapStore, o: DisplayObject, m: {
+        a: number;
+        b: number;
+        c: number;
+        d: number;
+        tx: number;
+        ty: number;
+    }, x: number, y: number, width: number, height: number, samples: number): boolean;
+    /**
+     * `o` walked and planned alone, through `m` into a `width` by `height`
+     * bitmap at `samples` a side, as few as a texture holds, then `draw`n
+     * with the samples taken; null for a size no texture holds.
+     */
+    private drawAlone;
+    /**
+     * What a pass of its own, BitmapData.draw's or a 3D object's bitmap's,
+     * swaps out of the walk, for it to be put back (restorePass).
+     */
+    private passState;
+    private restorePass;
+    /**
+     * Where a mask is drawn: on the stage, or, in a draw for BitmapData, in
+     * the bitmap, where it stands to what is drawn as it stands on the stage.
+     */
+    private placedMask;
+    /**
+     * Where a mask is drawn in the bitmap of `o`, a 3D object, the root of its
+     * bitmap's pass: one in the object by its matrices up to it; one outside
+     * it by Flash's rule for that (display/plane.ts, outsideMaskMap).
+     */
+    private planeMask;
+    /** The mouse, touches and wheel on the canvas to `player`'s stage (pointer.ts); what undoes it. */
+    bindPointer(player: Player): () => void;
+    /** What the view made on its context let go of, the context with it if the canvas is its own, and its tessellator. */
+    destroy(): void;
+}
+//# sourceMappingURL=view.d.ts.map

package/dist/scene/view.d.ts.map

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