@swf2es/player 0.0.0-stage → 0.1.0

package/dist/render/blend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.d.ts","sourceRoot":"","sources":["../../src/render/blend.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,MAAM,EACX,SAAS,EACT,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,kGAAkG;IAClG,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACxD,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtD;AAoCD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAQnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GACnB,IAAI,CAMN;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACxD;AA4HD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAoB1D"}

package/dist/render/blend.js

@@ -0,0 +1,195 @@
+// Blend modes as Flash composites them (docs/architecture.md, "Blend
+// modes"): the object drawn as a layer, its children together, then that
+// layer blended with what is below by the mode's formula, which a filter
+// that reads the back buffer computes. Colours are premultiplied.
+import { AlphaFilter, BlendModeFilter, Container, } from "pixi.js";
+/** The keeper of the instruction's area, where it is measured as Pixi measures a container. */
+function keeperOf(instruction) {
+    const container = instruction.container;
+    const first = instruction.filterEffect.filters?.[0];
+    if (!container ||
+        !first?.keptArea ||
+        instruction.renderables ||
+        instruction.filterEffect.filterArea) {
+        return null;
+    }
+    const group = container.renderGroup || container.parentRenderGroup;
+    return group?.cacheToLocalTransform ? null : first;
+}
+/** What a filter's area is measured from, and whether a mask outside it bounds something in it. */
+const areaWatch = {
+    root: null,
+    outside: false,
+};
+/** Whether `inner` is `outer` or under it. */
+function within(outer, inner) {
+    for (let p = inner; p; p = p.parent) {
+        if (p === outer) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * A masked container Pixi's bounds walk measured (render/hooks.ts): a mask
+ * from outside the area watched may bound what is in it, and move as
+ * nothing in it changes, so that area is not kept.
+ */
+export function noteMask(container) {
+    const watch = areaWatch.root;
+    if (watch && !areaWatch.outside) {
+        const mask = container.mask;
+        if (mask instanceof Container && !within(watch, mask)) {
+            areaWatch.outside = true;
+        }
+    }
+}
+/**
+ * The area a filter instruction is applied to, measured in place of Pixi's
+ * filter system (render/hooks.ts): a filter that keeps its object's area
+ * gives it again while the object has only moved, and keeps the area
+ * measured otherwise, unless a mask from outside bounds something in it.
+ */
+export function measureFilterArea(instruction, bounds, system) {
+    measureArea(instruction, bounds, system);
+    // The area known, a filter that pads past what the GPU can draw round it pads less.
+    for (const filter of instruction.filterEffect.filters ?? []) {
+        filter.fitPadding?.(bounds, system);
+    }
+}
+function measureArea(instruction, bounds, system) {
+    const keeper = keeperOf(instruction);
+    const container = instruction.container;
+    if (keeper?.keptArea(container, bounds)) {
+        return;
+    }
+    areaWatch.root = keeper ? container : null;
+    areaWatch.outside = false;
+    try {
+        system.measureFilterArea(instruction, bounds);
+        // An object that draws nothing is filtered into nothing, as adl draws a glow or a shadow of
+        // it (the `filters-empty` case). Pixi measures it as a point at its group's origin, which its
+        // padding made an area it ran every filter on: emptied, the push skips them.
+        if (!instruction.renderables &&
+            !instruction.filterEffect.filterArea &&
+            !(bounds.maxX > bounds.minX && bounds.maxY > bounds.minY)) {
+            bounds.clear();
+            return;
+        }
+        if (keeper && !areaWatch.outside) {
+            keeper.keepArea(container, bounds);
+        }
+    }
+    finally {
+        areaWatch.root = null;
+    }
+}
+/** Each separable mode's B(back, front) of straight colours, GLSL and WGSL. */
+const SEPARABLE = {
+    multiply: ["cb * cf", "cb * cf"],
+    screen: ["cb + cf - cb * cf", "cb + cf - cb * cf"],
+    lighten: ["max(cb, cf)", "max(cb, cf)"],
+    darken: ["min(cb, cf)", "min(cb, cf)"],
+    difference: ["abs(cb - cf)", "abs(cb - cf)"],
+    hardlight: ["hardlight(cb, cf)", "hardlight(cb, cf)"],
+    overlay: ["hardlight(cf, cb)", "hardlight(cf, cb)"],
+};
+const GL_FUNCTIONS = `
+  vec3 straight(vec4 c) { return c.a > 0.0 ? c.rgb / c.a : vec3(0.0); }
+  vec3 hardlight(vec3 cb, vec3 cf) {
+    vec3 multiply = 2.0 * cb * cf;
+    vec3 screen = 1.0 - 2.0 * (1.0 - cb) * (1.0 - cf);
+    return mix(multiply, screen, step(0.5, cf));
+  }
+`;
+const GPU_FUNCTIONS = `
+  fn straight(c: vec4<f32>) -> vec3<f32> { return select(vec3<f32>(0.0), c.rgb / c.a, c.a > 0.0); }
+  fn hardlight(cb: vec3<f32>, cf: vec3<f32>) -> vec3<f32> {
+    let multiply = 2.0 * cb * cf;
+    let screen = 1.0 - 2.0 * (1.0 - cb) * (1.0 - cf);
+    return mix(multiply, screen, step(vec3<f32>(0.5), cf));
+  }
+`;
+/** The result of a mode that is no separable blend, premultiplied, GLSL and WGSL. */
+const SPECIAL = {
+    add: [
+        "vec4(min(front.rgb + back.rgb, 1.0), min(front.a + back.a, 1.0))",
+        "vec4<f32>(min(front.rgb + back.rgb, vec3<f32>(1.0)), min(front.a + back.a, 1.0))",
+    ],
+    // What is below less the object, its alpha the two's as the object over it: over a layer's
+    // clear ground, adl's subtract leaves the object's alpha in black.
+    subtract: [
+        "vec4(max(back.rgb - front.rgb, 0.0), front.a + back.a * (1.0 - front.a))",
+        "vec4<f32>(max(back.rgb - front.rgb, vec3<f32>(0.0)), front.a + back.a * (1.0 - front.a))",
+    ],
+    // What is below inverted, as far as the object covers it.
+    invert: [
+        "vec4((back.a - back.rgb) * front.a + back.rgb * (1.0 - front.a), back.a)",
+        "vec4<f32>((back.a - back.rgb) * front.a + back.rgb * (1.0 - front.a), back.a)",
+    ],
+    // The layer below takes the object's alpha where the object has any, or
+    // loses it; what the object leaves clear stays, as adl leaves it.
+    alpha: ["(front.a > 0.0 ? back * front.a : back)", "select(back, back * front.a, front.a > 0.0)"],
+    erase: ["back * (1.0 - front.a)", "back * (1.0 - front.a)"],
+};
+function blendFilter(mode) {
+    const special = SPECIAL[mode];
+    let gl;
+    let gpu;
+    if (special) {
+        gl = `finalColor = ${special[0]} * uBlend;`;
+        gpu = `out = ${special[1]} * blendUniforms.uBlend;`;
+    }
+    else {
+        const [glB, gpuB] = SEPARABLE[mode];
+        gl = `
+      vec3 cb = straight(back);
+      vec3 cf = straight(front);
+      vec3 co = front.rgb * (1.0 - back.a) + back.rgb * (1.0 - front.a) + front.a * back.a * (${glB});
+      finalColor = vec4(co, blendedAlpha) * uBlend;
+    `;
+        gpu = `
+      let cb = straight(back);
+      let cf = straight(front);
+      let co = front.rgb * (1.0 - back.a) + back.rgb * (1.0 - front.a) + front.a * back.a * (${gpuB});
+      out = vec4<f32>(co, blendedAlpha) * blendUniforms.uBlend;
+    `;
+    }
+    const filter = new BlendModeFilter({
+        gl: { functions: GL_FUNCTIONS, main: gl },
+        gpu: { functions: GPU_FUNCTIONS, main: gpu },
+    });
+    // At the target's resolution, as the stage is drawn; its result is the
+    // whole composite, back included, so it replaces what is there, which
+    // alpha and erase make more transparent.
+    filter.resolution = "inherit";
+    filter.antialias = "inherit";
+    filter.blendMode = "none";
+    return filter;
+}
+/** One filter a mode, shared by every object blended so. */
+const filters = new Map();
+/**
+ * The filters that composite an object in `mode`: none for normal; for
+ * layer one that only makes it a layer; for any other the mode's blend.
+ */
+export function blendFilters(mode) {
+    if (mode === "normal" || !(mode === "layer" || SEPARABLE[mode] || SPECIAL[mode])) {
+        return null;
+    }
+    let made = filters.get(mode);
+    if (!made) {
+        if (mode === "layer") {
+            const layer = new AlphaFilter({ alpha: 1 });
+            layer.resolution = "inherit";
+            layer.antialias = "inherit";
+            made = [layer];
+        }
+        else {
+            made = [blendFilter(mode)];
+        }
+        filters.set(mode, made);
+    }
+    return made;
+}
+//# sourceMappingURL=blend.js.map

package/dist/render/blend.js.map

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

package/dist/render/color.d.ts

@@ -0,0 +1,111 @@
+import type { ColorTransform } from "@swf2es/format";
+import { type BatchableElement, Batcher, type BatcherOptions, type Container, type DefaultBatchableMeshElement, type DefaultBatchableQuadElement, ExtensionType, Geometry, Graphics, type GraphicsContext, type Renderer, Shader } from "pixi.js";
+declare class ColorShader extends Shader {
+    readonly maxTextures: number;
+    constructor(maxTextures: number);
+}
+declare class ColorGeometry extends Geometry {
+    constructor();
+}
+export declare class ColorBatcher extends Batcher {
+    static extension: {
+        type: ExtensionType[];
+        name: string;
+    };
+    name: string;
+    vertexSize: number;
+    geometry: ColorGeometry;
+    shader: ColorShader;
+    constructor(options: BatcherOptions);
+    /** The vertex's colour, texture and transform after its position and UV, which `at` holds. */
+    private tail;
+    packAttributes(element: DefaultBatchableMeshElement, f32: Float32Array, u32: Uint32Array, index: number, textureId: number): void;
+    packQuadAttributes(element: DefaultBatchableQuadElement, f32: Float32Array, u32: Uint32Array, index: number, textureId: number): void;
+}
+/**
+ * The batcher an element goes to (render/hooks.ts): a Graphics' or a
+ * sprite's under a colour transform to this batcher, any other to the one
+ * it names, Pixi's "default" or another a host gives.
+ */
+export declare function batcherNameFor(element: BatchableElement): string;
+/** A context destroyed: its batched copy, if it has one, taken for it to destroy too. */
+export declare function takeBatchedCopy(context: GraphicsContext): GraphicsContext | undefined;
+/**
+ * A Graphics that may show another context than the one it stands for: the
+ * shared one it was given (`shared`), and `show` to draw another, as a
+ * shape's lines swap theirs (render/shared.ts, SharedGraphics).
+ */
+export type SharingGraphics = Graphics & {
+    shared?: GraphicsContext;
+    show?: (context: GraphicsContext) => void;
+    /** Whether it is in a render group settled long enough to batch it (render/settle.ts, settle). */
+    settled?: boolean;
+};
+/**
+ * Whether `context` has ALONE_VERTICES or more, weighed from its paths
+ * before it is built, as a part may show under a transform it then keeps,
+ * and lines are swapped for new contexts as they turn: a fill a vertex a
+ * point, a line as lineVertices says, a texture four. Weighed once built
+ * too, as a view's contexts let go of their paths then (render/tessellate.ts).
+ */
+export declare function weigh(context: GraphicsContext): boolean;
+/**
+ * Notes each renderer as it is made, of any kind, as a renderer that is
+ * not WebGL may come after Graphics were shown alone for one that is.
+ */
+export declare class ColorAloneSystem {
+    static extension: {
+        readonly type: readonly [ExtensionType.WebGLSystem, ExtensionType.WebGPUSystem, ExtensionType.CanvasSystem];
+        readonly name: "flashColorAlone";
+    };
+    constructor(renderer: {
+        type: number;
+    });
+    destroy(): void;
+}
+/** A Graphics destroyed: no longer one to show otherwise. */
+export declare function forgetShown(g: SharingGraphics): void;
+/**
+ * The context a Graphics should draw under `ct`. An unbatched one, as a
+ * shape's are (render/tessellate.ts), Pixi draws with its own shader, which
+ * has no colour transform, so under one it draws a batched copy; but a
+ * large one, as a creature's parts are, is drawn alone still, by the
+ * transform table (render/table.ts), whose rows carry a colour transform,
+ * or by Pixi's pipe with the colour shader (colorShaderFor),
+ * where every renderer is WebGL; a SharedGraphics alone, which forgets it
+ * as it goes (render/shared.ts). The
+ * context it stands for is shared by every instance of a character, and
+ * every text in a font, and is never changed: switched to batched, the
+ * Graphics of the others, made unbatched, drew nothing.
+ *
+ * In a settled group, batched copies are packed once and drawn in a few
+ * calls. In one rebuilt often, as an animated character's is, a batched
+ * copy's vertices were packed again with every rebuild, and a tween of the
+ * transform repacked them each frame: a creature fading out packed and
+ * uploaded every vertex of its every part, frame after frame. Drawn alone,
+ * a draw writes a row or a few uniforms instead. Small ones stay batched:
+ * a draw apiece costs more than packing their few vertices
+ * (`bench.ts --branches 64`).
+ */
+export declare function showFor(g: SharingGraphics, ct: ColorTransform | null): void;
+/**
+ * The shader a Graphics drawn alone is drawn with (render/hooks.ts): under
+ * a colour transform, as in a render group that has not settled, the
+ * colour shader, the transform and the Graphics' own tint and alpha in its
+ * uniforms, which Pixi's pipe then fills its local uniforms of; otherwise
+ * Pixi's, from null. Its context, shared, is never packed: a gradient's or
+ * a bitmap's, which the table cannot draw. It leans on the order of the
+ * shader's sections, Pixi's local uniforms' colour applied in the vertex's
+ * main before aloneBitGl's end replaces it.
+ */
+export declare function colorShaderFor(graphics: Graphics, renderer: Renderer): Shader | null;
+/**
+ * Draw `leaf` and what is in it under `ct`, or under Pixi's tint again for
+ * null. Moving between batchers rebuilds the render group's instructions;
+ * another transform in the same batcher packs the vertices again. A
+ * Graphics the table draws, before and after, reads its transform as its
+ * row is written, and needs neither.
+ */
+export declare function setFlashColor(leaf: Container, ct: ColorTransform | null): void;
+export {};
+//# sourceMappingURL=color.d.ts.map

package/dist/render/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/render/color.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,KAAK,gBAAgB,EAGrB,OAAO,EACP,KAAK,cAAc,EAGnB,KAAK,SAAS,EAGd,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,aAAa,EAEb,QAAQ,EACR,QAAQ,EACR,KAAK,eAAe,EAOpB,KAAK,QAAQ,EAIb,MAAM,EAEP,MAAM,SAAS,CAAC;AA4HjB,cAAM,WAAY,SAAQ,MAAM;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,YAAY,WAAW,EAAE,MAAM,EAa9B;CACF;AAED,cAAM,aAAc,SAAQ,QAAQ;IAClC,cAwBC;CACF;AA4CD,qBAAa,YAAa,SAAQ,OAAO;IACvC,MAAM,CAAC,SAAS;;;MAAiD;IAEjE,IAAI,SAAQ;IACZ,UAAU,SAAe;IACzB,QAAQ,gBAAuB;IAC/B,MAAM,EAAE,WAAW,CAAC;IAEpB,YAAY,OAAO,EAAE,cAAc,EAUlC;IAED,8FAA8F;IAC9F,OAAO,CAAC,IAAI;IAoBZ,cAAc,CACZ,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,IAAI,CAkBN;IAED,kBAAkB,CAChB,OAAO,EAAE,2BAA2B,EACpC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,IAAI,CAmBN;CACF;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQhE;AAgCD,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS,CAIrF;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG;IACvC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA+BF;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAwBvD;AAQD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,SAAS;iBACd,IAAI;iBACJ,IAAI,EAAE,iBAAiB;MACd;IAEX,YAAY,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAQrC;IAED,OAAO,IAAI,IAAI,CAGd;CACF;AAID,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAEpD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CA0B3E;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAyBpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CA4B9E"}