@swf2es/player 0.0.0-stage → 0.1.1

package/dist/display/morph.js

@@ -0,0 +1,227 @@
+import { boundsOf, shapeLayers } from "./shapes.js";
+// Grow only after a ratio returns following eviction: longer looping tweens
+// otherwise rebuild every frame, while fresh ratios gain nothing from more space.
+const KEPT_BLENDS = 64;
+const MOST_BLENDS = 256;
+const histories = new WeakMap();
+/**
+ * The shape `character` is at `ratio`, 0 its start to 65535 its end: made
+ * the first time it is asked for and kept while it is among the morph's
+ * latest, as a tween asks for a new ratio on each frame.
+ */
+export function morphAt(character, ratio) {
+    const blends = character.blends;
+    let shape = blends.get(ratio);
+    if (shape) {
+        // Last in the map's order, the most recently asked for.
+        blends.delete(ratio);
+        blends.set(ratio, shape);
+        return shape;
+    }
+    let history = histories.get(character);
+    if (blends.size === 0 && history) {
+        histories.delete(character);
+        history = undefined;
+    }
+    if (history && history.limit < MOST_BLENDS && history.evicted.delete(ratio)) {
+        history.limit *= 2;
+        history.evicted.clear();
+    }
+    const blended = blend(character.morph, ratio / 65535);
+    shape = {
+        type: "shape",
+        id: character.id,
+        shape: boundsOf(blended),
+        layers: shapeLayers(blended, character.bitmap),
+    };
+    blends.set(ratio, shape);
+    const limit = history?.limit ?? KEPT_BLENDS;
+    if (blends.size > limit) {
+        const oldest = blends.keys().next().value;
+        blends.delete(oldest);
+        if (limit < MOST_BLENDS) {
+            if (!history) {
+                history = { limit, evicted: new Set() };
+                histories.set(character, history);
+            }
+            history.evicted.add(oldest);
+            if (history.evicted.size > MOST_BLENDS) {
+                history.evicted.delete(history.evicted.keys().next().value);
+            }
+        }
+    }
+    return shape;
+}
+const mix = (a, b, t) => a + (b - a) * t;
+/** Each channel of two 0xAARRGGBB colours mixed, as a byte. */
+function mixColor(a, b, t) {
+    let out = 0;
+    for (let shift = 24; shift >= 0; shift -= 8) {
+        const channel = Math.round(mix((a >>> shift) & 0xff, (b >>> shift) & 0xff, t));
+        out = out * 256 + channel;
+    }
+    return out;
+}
+function mixMatrix(a, b, t) {
+    return {
+        a: mix(a.a, b.a, t),
+        b: mix(a.b, b.b, t),
+        c: mix(a.c, b.c, t),
+        d: mix(a.d, b.d, t),
+        tx: mix(a.tx, b.tx, t),
+        ty: mix(a.ty, b.ty, t),
+    };
+}
+function mixRect(a, b, t) {
+    return {
+        xMin: mix(a.xMin, b.xMin, t),
+        xMax: mix(a.xMax, b.xMax, t),
+        yMin: mix(a.yMin, b.yMin, t),
+        yMax: mix(a.yMax, b.yMax, t),
+    };
+}
+function mixGradient(a, b, t) {
+    return {
+        matrix: mixMatrix(a.matrix, b.matrix, t),
+        spread: a.spread,
+        interpolation: a.interpolation,
+        stops: a.stops.map((stop, i) => {
+            const other = b.stops[i] ?? stop;
+            return {
+                ratio: Math.round(mix(stop.ratio, other.ratio, t)),
+                color: mixColor(stop.color, other.color, t),
+            };
+        }),
+        focal: mix(a.focal, b.focal, t),
+    };
+}
+/** Two fills of one MORPHFILLSTYLE, which share their type. */
+function mixFill(a, b, t) {
+    if (a.type === "solid" && b.type === "solid") {
+        return { type: "solid", color: mixColor(a.color, b.color, t) };
+    }
+    if (a.type === "bitmap" && b.type === "bitmap") {
+        return { ...a, matrix: mixMatrix(a.matrix, b.matrix, t) };
+    }
+    if (a.type !== "solid" && a.type !== "bitmap" && b.type === a.type) {
+        return { type: a.type, gradient: mixGradient(a.gradient, b.gradient, t) };
+    }
+    return a;
+}
+function mixLine(a, b, t) {
+    return {
+        ...a,
+        width: mix(a.width, b.width, t),
+        color: mixColor(a.color, b.color, t),
+        fill: a.fill && b.fill ? mixFill(a.fill, b.fill, t) : a.fill,
+    };
+}
+const NO_EDGE = { type: "line", dx: 0, dy: 0 };
+/**
+ * An edge from `pen` in absolute twips: its control point, halfway along a straight one, and
+ * anchor.
+ */
+function absolute(e, pen) {
+    if (e.type === "line") {
+        const anchor = { x: pen.x + e.dx, y: pen.y + e.dy };
+        return {
+            control: { x: (pen.x + anchor.x) / 2, y: (pen.y + anchor.y) / 2 },
+            anchor,
+            straight: true,
+        };
+    }
+    const control = { x: pen.x + e.cx, y: pen.y + e.cy };
+    return { control, anchor: { x: control.x + e.ax, y: control.y + e.ay }, straight: false };
+}
+/**
+ * Two points mixed, to the twip: whole twips keep the pen's sums exact, and closed paths closed.
+ */
+const mixPoint = (a, b, t) => ({
+    x: Math.round(mix(a.x, b.x, t)),
+    y: Math.round(mix(a.y, b.y, t)),
+});
+/**
+ * The morph at `t`, 0 to 1. The ends' edges pair in order, a straight
+ * one with a curve as a curve, and their points are mixed where they lie,
+ * not their deltas. A style change is the start's, its move mixed with
+ * the end's where the end has one there, else with the end's pen; a move
+ * only the end has moves the pen from the start's.
+ */
+export function blend(morph, t) {
+    const records = [];
+    const start = morph.start;
+    const end = morph.end;
+    let startPen = { x: 0, y: 0 };
+    let endPen = { x: 0, y: 0 };
+    let pen = { x: 0, y: 0 };
+    let i = 0;
+    let j = 0;
+    while (i < start.length) {
+        const s = start[i];
+        const e = end[j];
+        if (s.type === "style") {
+            const endStyle = e?.type === "style" ? e : null;
+            if (endStyle) {
+                j++;
+                endPen = endStyle.moveTo ?? endPen;
+            }
+            startPen = s.moveTo ?? startPen;
+            const moves = s.moveTo !== null || endStyle?.moveTo;
+            if (moves) {
+                pen = mixPoint(startPen, endPen, t);
+            }
+            records.push({ ...s, moveTo: moves ? pen : null });
+            i++;
+            continue;
+        }
+        if (e?.type === "style") {
+            if (e.moveTo) {
+                endPen = e.moveTo;
+                pen = mixPoint(startPen, endPen, t);
+                records.push({
+                    type: "style",
+                    moveTo: pen,
+                    fill0: null,
+                    fill1: null,
+                    line: null,
+                    styles: null,
+                });
+            }
+            j++;
+            continue;
+        }
+        const a = absolute(s, startPen);
+        const b = absolute(e ?? NO_EDGE, endPen);
+        const anchor = mixPoint(a.anchor, b.anchor, t);
+        if (a.straight && b.straight) {
+            records.push({ type: "line", dx: anchor.x - pen.x, dy: anchor.y - pen.y });
+        }
+        else {
+            const control = mixPoint(a.control, b.control, t);
+            records.push({
+                type: "curve",
+                cx: control.x - pen.x,
+                cy: control.y - pen.y,
+                ax: anchor.x - control.x,
+                ay: anchor.y - control.y,
+            });
+        }
+        startPen = a.anchor;
+        endPen = b.anchor;
+        pen = anchor;
+        i++;
+        j++;
+    }
+    return {
+        id: morph.id,
+        bounds: mixRect(morph.startBounds, morph.endBounds, t),
+        edgeBounds: morph.startEdgeBounds && morph.endEdgeBounds
+            ? mixRect(morph.startEdgeBounds, morph.endEdgeBounds, t)
+            : null,
+        fills: morph.fills.map((f) => mixFill(f.start, f.end, t)),
+        lines: morph.lines.map((l) => mixLine(l.start, l.end, t)),
+        records,
+        truncated: morph.truncated,
+    };
+}
+//# sourceMappingURL=morph.js.map

package/dist/display/morph.js.map

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

package/dist/display/movieclip.d.ts

@@ -0,0 +1,115 @@
+import type { avm2 } from "@swf2es/runtime";
+import { Container } from "./container.js";
+import type { Library, Timeline } from "./timeline.js";
+export declare class MovieClip extends Container {
+    /** A clip always has its library: the one its timeline came from. */
+    library: Library;
+    private frame;
+    private scripts;
+    private making;
+    private placedByTimeline;
+    private running;
+    /** Its timeline's stream as it plays, for what plays it (TimelineSounds); null while none does. */
+    stream: object | null;
+    /**
+     * Made by a script with `new`, or placed on the first frame of one that
+     * was as it was made: Flash has such a clip sit out the next frame's
+     * advance, wherever it is by then (`fresh-clips`).
+     */
+    fresh: boolean;
+    /**
+     * The frame whose script last ran, so that entering a frame runs its
+     * script once: set to currentFrame alone, as a round's skipping
+     * (scriptWork) has it.
+     */
+    scriptedFrame: number;
+    /** A goto a frame script asked for, taken when the script returns, as Flash defers it; null for none. */
+    queuedGoto: number | null;
+    /** Whether that goto plays or stops the clip, as it happens, not as it is asked for. */
+    queuedPlay: boolean;
+    /**
+     * The frame count (Scripting.frames) at a script's goto in a SWF of
+     * version 9 or earlier, a goto to the frame it is on among them: the next
+     * frame it sits out, with all in it, as Flash has such a clip
+     * (`goto-children`). A stamp, not a flag: one a skipped parent took along,
+     * or a clip no frame reached, is past by the frame after and never skips.
+     * From version 10 a goto leaves its frames as they were.
+     */
+    skipsAfter: number;
+    /** Whether an AVM1 clip ran the actions after its last ShowFrame, which it does once. */
+    private tailed;
+    /** Its frames: its character's, or, once an AVM1 load has filled it, the SWF's root's. */
+    timeline: Timeline;
+    constructor(timeline: Timeline, library: Library);
+    /**
+     * What an AVM1 load puts in it, as Flash keeps the clip and replaces
+     * what it shows: `timeline` of `library` in place of its own, its
+     * children gone, before its first frame and playing. Telling of what it
+     * showed going, its unload, is the caller's.
+     */
+    replaceTimeline(timeline: Timeline, library: Library): void;
+    /** The frame it shows, 1 the first; 0 before its first frame is entered. */
+    get currentFrame(): number;
+    set currentFrame(frame: number);
+    /** The scripts addFrameScript registered, by frame, 1 the first. */
+    get frameScripts(): ReadonlyMap<number, avm2.Value>;
+    /** Register `script` for frame `frame`, or, null, take the frame's away. */
+    setFrameScript(frame: number, script: avm2.Value | null): void;
+    /** Whether its constructor's super() is making its first frame's children. */
+    get makingChildren(): boolean;
+    set makingChildren(making: boolean);
+    /** Placed by a timeline, not made by a script with `new`. */
+    get timelineChild(): boolean;
+    set timelineChild(placed: boolean);
+    /** Whether its playhead moves on; stopped, its stream stops, as in Flash and Ruffle. */
+    get playing(): boolean;
+    set playing(play: boolean);
+    get totalFrames(): number;
+    /** The frame's sounds, where it has any and something plays them. */
+    private frameSounds;
+    /**
+     * First-frame children placed but not yet made alive: placed before the
+     * clip's class constructor runs, made by Sprite's constructChildren in its
+     * super(), as Flash has a constructor find them (`instantiation_on_enter_frame`).
+     */
+    private held;
+    /**
+     * Run frame `frame`'s commands as the playhead reaches it: place, move and
+     * remove the timeline's children. A place without the move flag at a depth
+     * already taken is let be, as Flash lets it (`same-depth`).
+     * A new child is made alive at once, or `later`: by the frame's construct
+     * phase, after ENTER_FRAME, for a frame played on; by constructChildren,
+     * held, for a clip's first frame.
+     */
+    private runFrame;
+    /**
+     * Jump to frame `frame`, as Flash does rather than by running the frames
+     * between: the frames up to it (from the first, for a rewind) are
+     * replayed into one jump per depth. On a rewind the children the timeline
+     * placed after it go, but one at a depth the frames up to it end on a
+     * place without the move flag at, which stays and takes the place; and
+     * any child whose ratio is not the one the replayed frames give goes,
+     * whenever it was placed. Each jump then changes the child still at its
+     * depth, or makes one where the frames placed one anew, or where a
+     * rewind ends on another character or ratio. The result is what playing
+     * the frames would leave, except that a child placed before the frame and
+     * untouched since keeps playing, and its identity; on a rewind a place
+     * puts back what it leaves unsaid too, so it looks as it did when first
+     * placed. A clip's own loop (`looping`) makes the children it places
+     * alive in the frame's construct phase, as playing on does (`loop-ratio`);
+     * a script's goto, at once.
+     */
+    gotoFrame(frame: number, looping?: boolean): void;
+    /** The first frame, as a clip runs it when it is made, its children placed and made alive; once. */
+    enterFirstFrame(): void;
+    /** The first frame's children placed, to be made alive by enterFirstFrame; once. */
+    placeFirstFrame(): void;
+    /**
+     * On to the next frame, if it plays and has one. From the last frame it
+     * loops to the first as a goto, so what the first frame placed stays.
+     */
+    advance(): void;
+}
+/** A timeline of one empty frame: a clip a script makes. */
+export declare const EMPTY_TIMELINE: Timeline;
+//# sourceMappingURL=movieclip.d.ts.map

package/dist/display/movieclip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movieclip.d.ts","sourceRoot":"","sources":["../../src/display/movieclip.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK3C,OAAO,KAAK,EAA+B,OAAO,EAAkB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAyGpG,qBAAa,SAAU,SAAQ,SAAS;IACtC,qEAAqE;IAC7D,OAAO,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,mGAAmG;IACnG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B;;;;OAIG;IACH,KAAK,UAAS;IACd;;;;OAIG;IACH,aAAa,SAAK;IAClB,yGAAyG;IACzG,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjC,wFAAwF;IACxF,UAAU,UAAS;IACnB;;;;;;;OAOG;IACH,UAAU,SAAM;IAChB,yFAAyF;IACzF,OAAO,CAAC,MAAM,CAAS;IAEvB,0FAA0F;IAC1F,QAAQ,EAAE,QAAQ,CAAC;IAEnB,YAAY,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAK/C;IAED;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB1D;IAED,4EAA4E;IAC5E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED,oEAAoE;IACpE,IAAI,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAElD;IAED,4EAA4E;IAC5E,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAQ7D;IAED,8EAA8E;IAC9E,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,EAKjC;IAED,6DAA6D;IAC7D,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,EAKhC;IAED,wFAAwF;IACxF,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,EAKxB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,qEAAqE;IACrE,OAAO,CAAC,WAAW;IAOnB;;;;OAIG;IACH,OAAO,CAAC,IAAI,CAAiE;IAE7E;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAqEhB;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,IAAI,CAsQ9C;IAED,oGAAoG;IACpG,eAAe,IAAI,IAAI,CActB;IAED,oFAAoF;IACpF,eAAe,IAAI,IAAI,CAetB;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI,CA8Cd;CACF;AA4CD,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,QAS5B,CAAC"}