@swf2es/render 0.0.0-stage → 0.1.0

package/dist/geometry.d.ts

@@ -0,0 +1,83 @@
+import { type Handle, Registry } from "./registry.js";
+/**
+ * How many frames a geometry may go undrawn before it is let go of: a
+ * pool's object or a loop's rarer frame comes back within a few seconds.
+ */
+export declare const IDLE_FRAMES = 300;
+/** Floats a vertex of advanced text's glyph quads (GeometryData.glyphs). */
+export declare const GLYPH_FLOATS = 18;
+/** A geometry as its owner holds it: its id, and the generation the id had, which a reused id moves on. */
+export type GeometryHandle = Handle;
+/**
+ * Triangles to draw under a row's transform: positions on the stage in
+ * pixels, two floats a vertex; each vertex' straight colour, its bytes red,
+ * green, blue and alpha from the lowest; where it samples a texture, where
+ * in texels, two floats a vertex, which a draw divides by the texture's
+ * size; and indices into the vertices, three a triangle. The backend copies
+ * them into its atlas once.
+ */
+export interface GeometryData {
+    positions: Float32Array;
+    /** None for a mesh, whose depths take their place. */
+    colors: Uint32Array;
+    /** A mesh's (MESH) are its u and v from 0 to 1, which its program reads as they are. */
+    texels?: Float32Array;
+    /** A mesh's depth at each vertex, its t, in place of its colour. */
+    depths?: Float32Array;
+    /**
+     * Advanced text's glyph quads: GLYPH_FLOATS floats a vertex, its position
+     * first, as its positions have it, then its glyph's pen and tables,
+     * outline bounds and corner, segments and size, and colour; and the
+     * text's mode and cutoff tables, which its draw takes as uniforms. Drawn
+     * by the glyph program (webgl/programs.ts, glyphsVertex), each pixel of a
+     * quad covered by its distance to the glyph's outline, in the outlines'
+     * segments (WebGLBackend.uploadOutlines), as adl covers it.
+     */
+    glyphs?: {
+        vertices: Float32Array;
+        mode: Float32Array;
+        table: Float32Array;
+    };
+    indices: Uint32Array;
+    /**
+     * No part of it over another: a bitmap's quad, or one fill's triangles.
+     * Alone in a blend mode's layer, such a geometry is drawn straight onto
+     * what is below it, as blending it pixel by pixel blends each pixel once.
+     */
+    flat?: boolean;
+}
+/**
+ * Every geometry a scene list may name, by id. What goes undrawn for
+ * IDLE_FRAMES is let go of; its owner finds it gone by its handle and adds
+ * it again. The backend takes what was added and removed since it last
+ * looked (taken), and keeps its own copies.
+ */
+export declare class Geometries extends Registry {
+    /** Changes only when a handle can have become stale, including expiry and context loss. */
+    removalVersion: number;
+    private readonly data;
+    /** Each geometry's box: its positions' least x and y, then their greatest. */
+    private boxes;
+    /** Added since the backend last took them. */
+    added: number[];
+    /** Changed in place since the backend last took them (update). */
+    updated: number[];
+    add(data: GeometryData): GeometryHandle;
+    /**
+     * Geometry `id`'s arrays changed in place, their lengths as they were: its
+     * box measured again, and its vertices copied again where they lie.
+     */
+    update(id: number): void;
+    private measure;
+    /**
+     * The boxes of every geometry, four floats from `id * 4`: least x and y,
+     * greatest x and y; a geometry of no vertices has its least past its
+     * greatest.
+     */
+    get box(): Float32Array;
+    get(id: number): GeometryData | null;
+    /** The ids of every geometry held, in order. */
+    live(): number[];
+    protected dropped(id: number): void;
+}
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,4EAA4E;AAC5E,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,2GAA2G;AAC3G,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,sDAAsD;IACtD,MAAM,EAAE,WAAW,CAAC;IACpB,wFAAwF;IACxF,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oEAAoE;IACpE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IAC7E,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACtC,2FAA2F;IAC3F,cAAc,SAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,8EAA8E;IAC9E,OAAO,CAAC,KAAK,CAA0B;IACvC,8CAA8C;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAM;IACrB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAM;IAEvB,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAOtC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKvB;IAED,OAAO,CAAC,OAAO;IA2Bf;;;;OAIG;IACH,IAAI,GAAG,IAAI,YAAY,CAEtB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEnC;IAED,gDAAgD;IAChD,IAAI,IAAI,MAAM,EAAE,CASf;IAED,UAAmB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG3C;CACF"}

package/dist/geometry.js

@@ -0,0 +1,93 @@
+import { Registry } from "./registry.js";
+/**
+ * How many frames a geometry may go undrawn before it is let go of: a
+ * pool's object or a loop's rarer frame comes back within a few seconds.
+ */
+export const IDLE_FRAMES = 300;
+/** Floats a vertex of advanced text's glyph quads (GeometryData.glyphs). */
+export const GLYPH_FLOATS = 18;
+/**
+ * Every geometry a scene list may name, by id. What goes undrawn for
+ * IDLE_FRAMES is let go of; its owner finds it gone by its handle and adds
+ * it again. The backend takes what was added and removed since it last
+ * looked (taken), and keeps its own copies.
+ */
+export class Geometries extends Registry {
+    /** Changes only when a handle can have become stale, including expiry and context loss. */
+    removalVersion = 0;
+    data = [];
+    /** Each geometry's box: its positions' least x and y, then their greatest. */
+    boxes = new Float32Array(1024);
+    /** Added since the backend last took them. */
+    added = [];
+    /** Changed in place since the backend last took them (update). */
+    updated = [];
+    add(data) {
+        const handle = this.hold(IDLE_FRAMES);
+        const id = handle.id;
+        this.data[id] = data;
+        this.added.push(id);
+        this.measure(id);
+        return handle;
+    }
+    /**
+     * Geometry `id`'s arrays changed in place, their lengths as they were: its
+     * box measured again, and its vertices copied again where they lie.
+     */
+    update(id) {
+        if (this.data[id]) {
+            this.measure(id);
+            this.updated.push(id);
+        }
+    }
+    measure(id) {
+        const data = this.data[id];
+        if (id * 4 >= this.boxes.length) {
+            const grown = new Float32Array(Math.max(this.boxes.length * 2, id * 4 + 4));
+            grown.set(this.boxes);
+            this.boxes = grown;
+        }
+        const p = data.positions;
+        let x0 = Number.POSITIVE_INFINITY;
+        let y0 = Number.POSITIVE_INFINITY;
+        let x1 = Number.NEGATIVE_INFINITY;
+        let y1 = Number.NEGATIVE_INFINITY;
+        for (let i = 0; i < p.length; i += 2) {
+            x0 = Math.min(x0, p[i]);
+            y0 = Math.min(y0, p[i + 1]);
+            x1 = Math.max(x1, p[i]);
+            y1 = Math.max(y1, p[i + 1]);
+        }
+        const box = this.boxes;
+        box[id * 4] = x0;
+        box[id * 4 + 1] = y0;
+        box[id * 4 + 2] = x1;
+        box[id * 4 + 3] = y1;
+    }
+    /**
+     * The boxes of every geometry, four floats from `id * 4`: least x and y,
+     * greatest x and y; a geometry of no vertices has its least past its
+     * greatest.
+     */
+    get box() {
+        return this.boxes;
+    }
+    get(id) {
+        return this.data[id] ?? null;
+    }
+    /** The ids of every geometry held, in order. */
+    live() {
+        const ids = [];
+        for (let id = 0; id < this.data.length; id++) {
+            if (this.data[id]) {
+                ids.push(id);
+            }
+        }
+        return ids;
+    }
+    dropped(id) {
+        this.removalVersion++;
+        this.data[id] = null;
+    }
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { CLEAR, COMPOSITE, Commands, FILTER, HELD, HOLD_POP, HOLD_PUSH, LAYER_POP, LAYER_PUSH, RUN, STENCIL_POP, STENCIL_PUSH, } from "./commands.js";
+export * as filterShaders from "./filter-shaders.js";
+export { BEVEL, BLEND, BLUR, blurShrink, COLOR_MATRIX, CONVOLUTION, DISPLACEMENT, FILL_SHADER, Filters, GLOW, GRADIENT, SHADER, } from "./filters.js";
+export { Geometries, type GeometryData, type GeometryHandle, GLYPH_FLOATS, IDLE_FRAMES, } from "./geometry.js";
+export { KEEP_IDLE_FRAMES, type KeepHandle, Keeps } from "./keeps.js";
+export { drawnArea, filteredRect, type MeasureTarget, measureLayers, wholeBitmap, } from "./measure.js";
+export { plan } from "./plan.js";
+export { type ColorRow, ROW_FLOATS, ROWS_A_LINE, Rows } from "./rows.js";
+export { ADD, ALPHA, ALPHA_MASK, BLEND_NAMES, CLAMP, DARKEN, DIFFERENCE, DRAW, ERASE, HARDLIGHT, INVERT, KEPT, KERNEL, LAYER, LAYER_BEGIN, LAYER_END, LIGHTEN, MASK_BEGIN, MASK_POP, MASK_USE, MESH, MIRROR, MULTIPLY, NO_WHOLE, NORMAL, OVERLAY, PLANE, REPEAT, SCREEN, SceneList, SHADED, SMOOTH, SNAP, SUBTRACT, WHOLE_ALIASED, WHOLE_SMOOTH, } from "./scene.js";
+export { KEEP_FRAMES, type TextureData, type TextureHandle, Textures } from "./textures.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,EACL,SAAS,EACT,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,GAAG,EACH,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,aAAa,EAClB,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EACL,GAAG,EACH,KAAK,EACL,UAAU,EACV,WAAW,EACX,KAAK,EACL,MAAM,EACN,UAAU,EACV,IAAI,EACJ,KAAK,EACL,SAAS,EACT,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,MAAM,EACN,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// The renderer's core (docs/renderer.md): what a frame draws, as typed
+// arrays, and the planner that turns it into commands. No GPU, no DOM.
+export { CLEAR, COMPOSITE, Commands, FILTER, HELD, HOLD_POP, HOLD_PUSH, LAYER_POP, LAYER_PUSH, RUN, STENCIL_POP, STENCIL_PUSH, } from "./commands.js";
+export * as filterShaders from "./filter-shaders.js";
+export { BEVEL, BLEND, BLUR, blurShrink, COLOR_MATRIX, CONVOLUTION, DISPLACEMENT, FILL_SHADER, Filters, GLOW, GRADIENT, SHADER, } from "./filters.js";
+export { Geometries, GLYPH_FLOATS, IDLE_FRAMES, } from "./geometry.js";
+export { KEEP_IDLE_FRAMES, Keeps } from "./keeps.js";
+export { drawnArea, filteredRect, measureLayers, wholeBitmap, } from "./measure.js";
+export { plan } from "./plan.js";
+export { ROW_FLOATS, ROWS_A_LINE, Rows } from "./rows.js";
+export { ADD, ALPHA, ALPHA_MASK, BLEND_NAMES, CLAMP, DARKEN, DIFFERENCE, DRAW, ERASE, HARDLIGHT, INVERT, KEPT, KERNEL, LAYER, LAYER_BEGIN, LAYER_END, LIGHTEN, MASK_BEGIN, MASK_POP, MASK_USE, MESH, MIRROR, MULTIPLY, NO_WHOLE, NORMAL, OVERLAY, PLANE, REPEAT, SCREEN, SceneList, SHADED, SMOOTH, SNAP, SUBTRACT, WHOLE_ALIASED, WHOLE_SMOOTH, } from "./scene.js";
+export { KEEP_FRAMES, Textures } from "./textures.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,uEAAuE;AACvE,OAAO,EACL,KAAK,EACL,SAAS,EACT,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,GAAG,EACH,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EAGV,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAmB,KAAK,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,SAAS,EACT,YAAY,EAEZ,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAiB,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EACL,GAAG,EACH,KAAK,EACL,UAAU,EACV,WAAW,EACX,KAAK,EACL,MAAM,EACN,UAAU,EACV,IAAI,EACJ,KAAK,EACL,SAAS,EACT,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,MAAM,EACN,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAwC,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/keeps.d.ts

@@ -0,0 +1,17 @@
+import { type Handle, Registry } from "./registry.js";
+/** A kept output as its owner holds it: its id, and the generation the id had. */
+export type KeepHandle = Handle;
+/** Frames a kept output may go undrawn before it is let go of, unless its owner says otherwise. */
+export declare const KEEP_IDLE_FRAMES = 60;
+/**
+ * The layers kept from one frame to the next, as Flash keeps a filtered
+ * object's bitmap while nothing in it changed: an owner adds one, names it
+ * on the layer whose output it keeps, and composites it again while it
+ * stands (SceneList.keptLayer). The backend holds their targets, and lets
+ * go of those removed; what goes undrawn for KEEP_IDLE_FRAMES is removed.
+ */
+export declare class Keeps extends Registry {
+    /** A kept output's id, let go of once undrawn for `idle` frames. */
+    add(idle?: number): KeepHandle;
+}
+//# sourceMappingURL=keeps.d.ts.map

package/dist/keeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeps.d.ts","sourceRoot":"","sources":["../src/keeps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtD,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,QAAQ;IACjC,oEAAoE;IACpE,GAAG,CAAC,IAAI,SAAmB,GAAG,UAAU,CAEvC;CACF"}

package/dist/keeps.js

@@ -0,0 +1,17 @@
+import { Registry } from "./registry.js";
+/** Frames a kept output may go undrawn before it is let go of, unless its owner says otherwise. */
+export const KEEP_IDLE_FRAMES = 60;
+/**
+ * The layers kept from one frame to the next, as Flash keeps a filtered
+ * object's bitmap while nothing in it changed: an owner adds one, names it
+ * on the layer whose output it keeps, and composites it again while it
+ * stands (SceneList.keptLayer). The backend holds their targets, and lets
+ * go of those removed; what goes undrawn for KEEP_IDLE_FRAMES is removed.
+ */
+export class Keeps extends Registry {
+    /** A kept output's id, let go of once undrawn for `idle` frames. */
+    add(idle = KEEP_IDLE_FRAMES) {
+        return this.hold(idle);
+    }
+}
+//# sourceMappingURL=keeps.js.map

package/dist/keeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeps.js","sourceRoot":"","sources":["../src/keeps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKtD,mGAAmG;AACnG,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,OAAO,KAAM,SAAQ,QAAQ;IACjC,oEAAoE;IACpE,GAAG,CAAC,IAAI,GAAG,gBAAgB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/kernel-shaders.d.ts

@@ -0,0 +1,74 @@
+/** The most images a kernel's program binds besides its layer's: one with more is not drawn. */
+export declare const KERNEL_IMAGES = 8;
+/**
+ * An image a kernel samples: its texture number; whether it is the
+ * filtered layer, else a texture of its own; and whether its texels are
+ * floats (RGBA32F), else bytes. For a blend, a layer's image is what is
+ * below where `back`, else the layer blended.
+ */
+export interface KernelImage {
+    texture: number;
+    layer: boolean;
+    float: boolean;
+    back?: boolean;
+}
+/** Whether `images` bind no more textures of their own than a program takes (KERNEL_IMAGES). */
+export declare function kernelImagesFit(images: readonly KernelImage[]): boolean;
+/**
+ * The kernel's GLSL with what every use puts round it: PRELUDE, then each
+ * image, by `layerTexel` for the layer's, its texel at an index, and
+ * ownImage for the others; `layerAt` takes a kernel's coordinate to the
+ * layer's texels.
+ */
+export declare function withImages(kernel: string, images: readonly KernelImage[], layerTexel: (t: number, back: boolean) => string, layerAt: string): string;
+/** A kernel's shader for its images, made once: a frame asks for it again on each of its uses. */
+export declare function madeOnce(made: Map<string, Map<string, string>>, kernel: string, images: readonly KernelImage[], make: () => string): string;
+/**
+ * A ShaderFilter's pass (filter-plan.ts, KERNEL_PASS), run as the
+ * filters' other passes are (webgl/filters.ts): the kernel's output over
+ * the input's frame, `outCoord` its pixel's centre in stage pixels from
+ * the corner of the bitmap the filter reads, `uKernelAt.xy` texels in from
+ * the frame's, which starts at `uOutputAt` in the target drawn into, at
+ * `uKernelAt.z` texels a stage pixel. The layer's image is the input
+ * (uTexture, within uTextureRect), transparent past the frame,
+ * `uKernelFrame` texels, as adl reads a filter's source; the others clamp
+ * to their edges. The output is as adl writes it (pbOutput), and
+ * transparent outside `uKernelRegion`, that bitmap grown by the filter's
+ * extensions, in stage pixels.
+ */
+export declare function filterKernel(kernel: string, images: readonly KernelImage[]): string;
+/**
+ * A blend shader's composite (webgl/composite.ts), drawn as the composite
+ * program is (programs.ts, compositeFragment), its uniforms the same: as
+ * adl runs one, a pixel at a time, each where the layer covers anything
+ * and nothing where it does not, or over its whole rectangle (uWhole),
+ * the kernel's coordinate (0.5, 0.5) and its first two inputs that pixel
+ * of what is below and of the layer, coloured, whatever coordinate it
+ * samples them at; its result in place of what was below, as adl writes
+ * it (pbOutput). `rows` is the colour transform's reading of uRows
+ * (programs.ts, LAYER_COLOR).
+ */
+export declare function blendKernel(kernel: string, images: readonly KernelImage[], rows: string): string;
+/**
+ * The layer shrunk to a texel a stage pixel for a kernel run once a pixel
+ * (filter-plan.ts): each output texel the mean of the `uDown.x` by
+ * `uDown.x` texels of the pixel it stands for, the grid from `uDown.yz`
+ * texels past the input's corner, which may be less than 0; the texels of
+ * a pixel past the frame, `uKernelFrame`, left out of the mean.
+ */
+export declare const PIXELS_DOWN = "#version 300 es\nprecision highp float;\nprecision highp int;\nin vec2 vTextureCoord;\nout vec4 finalColor;\nuniform sampler2D uTexture;\nuniform vec4 uTextureRect;\nuniform vec3 uDown;\nuniform vec2 uKernelFrame;\nuniform vec2 uOutputAt;\nvoid main(void) {\n  int n = int(uDown.x);\n  ivec2 from = ivec2(gl_FragCoord.xy - uOutputAt) * n + ivec2(uDown.yz);\n  ivec2 frame = ivec2(uKernelFrame);\n  vec4 sum = vec4(0.0);\n  float count = 0.0;\n  for (int j = 0; j < 16; j++) {\n    if (j >= n) { break; }\n    for (int i = 0; i < 16; i++) {\n      if (i >= n) { break; }\n      ivec2 at = from + ivec2(i, j);\n      if (all(greaterThanEqual(at, ivec2(0))) && all(lessThan(at, frame))) {\n        sum += texelFetch(uTexture, ivec2(uTextureRect.xy) + at, 0);\n        count += 1.0;\n      }\n    }\n  }\n  finalColor = count > 0.0 ? sum / count : vec4(0.0);\n}\n";
+/**
+ * A kernel's output, run a texel a stage pixel, drawn back over the
+ * layer's frame: each texel its pixel's, the grid as PIXELS_DOWN had it.
+ */
+export declare const PIXELS_BACK = "#version 300 es\nprecision highp float;\nprecision highp int;\nin vec2 vTextureCoord;\nout vec4 finalColor;\nuniform sampler2D uTexture;\nuniform vec4 uTextureRect;\nuniform vec3 uDown;\nuniform vec2 uOutputAt;\nvoid main(void) {\n  ivec2 at = (ivec2(gl_FragCoord.xy - uOutputAt) - ivec2(uDown.yz)) / int(uDown.x);\n  at = clamp(at, ivec2(0), ivec2(uTextureRect.zw) - 1);\n  finalColor = texelFetch(uTexture, ivec2(uTextureRect.xy) + at, 0);\n}\n";
+/**
+ * A shader fill's program, after the mesh's vertex shader (programs.ts,
+ * meshVertex), which carries the kernel's coordinates in vUVT with a depth
+ * of 1: the kernel run once a pixel of Flash's, at its centre (uFrag as the
+ * mesh's has it), its images clamped to their edges; its colours left
+ * past its alpha, as adl composites them, but under a colour transform,
+ * which takes them straight.
+ */
+export declare function fillKernel(kernel: string, images: readonly KernelImage[]): string;
+//# sourceMappingURL=kernel-shaders.d.ts.map

package/dist/kernel-shaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-shaders.d.ts","sourceRoot":"","sources":["../src/kernel-shaders.ts"],"names":[],"mappings":"AAiBA,gGAAgG;AAChG,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CASvE;AAgFD;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,MAAM,EAChD,OAAO,EAAE,MAAM,GACd,MAAM,CAYR;AAKD,kGAAkG;AAClG,wBAAgB,QAAQ,CACtB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,IAAI,EAAE,MAAM,MAAM,GACjB,MAAM,CAwBR;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAEnF;AAiCD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhG;AAkCD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,g2BA2BvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,mcAYvB,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAEjF"}