@swf2es/player 0.0.0-stage → 0.1.1

package/dist/scene/lines.js

@@ -0,0 +1,242 @@
+// A shape layer's lines as the renderer of swf2es's own keeps them: stroked
+// by the tessellator's line builder (strokes.ts) for each transform a layer
+// is seen through, found again
+// by a hash of the transform's numbers, and kept while the geometries keep
+// them, within a budget of vertices for those not drawn lately.
+import { IDLE_FRAMES } from "@swf2es/render";
+import { evenWidth, scalesEvenly } from "../display/stretch.js";
+import { same } from "../display/value-lists.js";
+import { layerStrokes } from "./strokes.js";
+/**
+ * The vertices kept lines may hold before those drawn neither this frame
+ * nor the last go, the least lately drawn first: a layer seen through ever
+ * new transforms, as a zoom shows it, would otherwise keep each for the
+ * geometries' idle frames. Past it with nothing idle, it grows to half
+ * again what is drawn, and comes back down as less is.
+ */
+const LINE_VERTICES = 1_000_000;
+/**
+ * How often, in frames, the kept lines are looked over whatever they hold:
+ * those the geometries let go of, and those that stroked to nothing, add
+ * no vertices that would bring the budget on.
+ */
+const SWEEP_FRAMES = 60;
+/** The bits of a number, read as two ints, for mixHash. */
+const hashFloat = new Float64Array(1);
+const hashInts = new Int32Array(hashFloat.buffer);
+/** `h` mixed with the bits of `x`, zero's two signs alike and every NaN, as same() takes them. */
+function mixHash(h, x) {
+    hashFloat[0] = x === 0 ? 0 : Number.isNaN(x) ? Number.NaN : x;
+    return Math.imul(Math.imul(h ^ hashInts[0], 0x9e3779b1) ^ hashInts[1], 0x85ebca6b);
+}
+/** Each shape layer's lines, by the transform they are stroked through (take). */
+export class LineCache {
+    geometries;
+    tessellator;
+    budget;
+    /**
+     * Lines stroked anew and lines found stroked already, which the bench and the draw counts read.
+     */
+    counts = { strokeContexts: 0, strokeReuses: 0 };
+    byLayer = new WeakMap();
+    /** Every entry, and the vertices they hold. */
+    entries = [];
+    vertices = 0;
+    limit;
+    /** The frame the entries were last looked over. */
+    swept = 0;
+    constructor(geometries, tessellator, budget = LINE_VERTICES) {
+        this.geometries = geometries;
+        this.tessellator = tessellator;
+        this.budget = budget;
+        this.limit = budget;
+    }
+    /** How many transforms' lines are kept, of every layer. */
+    get kept() {
+        return this.entries.length;
+    }
+    /** `layer`'s lines as of its drawing's `version`, what is known of them worked out again for another. */
+    of(layer, version) {
+        let lines = this.byLayer.get(layer);
+        if (!lines) {
+            lines = {
+                version: -1,
+                even: false,
+                width: 0,
+                whole: false,
+                byHash: new Map(),
+            };
+            this.byLayer.set(layer, lines);
+        }
+        if (lines.version !== version) {
+            lines.version = version;
+            lines.even = scalesEvenly(layer);
+            lines.width = evenWidth(layer);
+            lines.whole = false;
+            for (let i = 0; !lines.whole && i < layer.strokes.length; i++) {
+                lines.whole = layer.strokes[i].line.color >>> 24 === 255;
+            }
+        }
+        return lines;
+    }
+    /**
+     * `layer`'s lines through the linear transform (a b c d), at least `least`
+     * wide, drawn opaque or not: stroked again for another transform, screen
+     * or version of its drawing, the old ones kept while drawn as the
+     * geometries keep them.
+     */
+    take(layer, version, a, b, c, d, least, by, drawnOpaque) {
+        const frame = this.geometries.frame;
+        if (frame - this.swept >= SWEEP_FRAMES) {
+            this.trim(frame);
+        }
+        const lines = this.of(layer, version);
+        // Only a line of whole alpha draws otherwise when opaque (layerStrokes): a layer of none keeps
+        // one geometry through a fade.
+        const opaque = drawnOpaque && lines.whole;
+        // Found by a hash of the key's numbers, compared as numbers: a layer seen by many instances
+        // keeps a transform for each, and a key formatted on every frame cost more than drawing it.
+        let hash = mixHash(mixHash(mixHash(mixHash(mixHash(opaque ? 1 : 0, a), b), c), d), least);
+        if (by) {
+            hash = mixHash(mixHash(mixHash(mixHash(hash, by[0]), by[1]), by[2]), by[3]);
+        }
+        let bucket = lines.byHash.get(hash);
+        let known = null;
+        for (let i = 0; bucket && i < bucket.length; i++) {
+            const e = bucket[i];
+            if (same(e.a, a) &&
+                same(e.b, b) &&
+                same(e.c, c) &&
+                same(e.d, d) &&
+                same(e.least, least) &&
+                e.opaque === opaque &&
+                (e.by === null
+                    ? by === null
+                    : by !== null &&
+                        same(e.by[0], by[0]) &&
+                        same(e.by[1], by[1]) &&
+                        same(e.by[2], by[2]) &&
+                        same(e.by[3], by[3]))) {
+                known = e;
+                break;
+            }
+        }
+        if (known &&
+            known.version === version &&
+            (!known.handle || this.geometries.alive(known.handle))) {
+            known.usedAt = frame;
+            this.counts.strokeReuses++;
+            return known.handle;
+        }
+        if (known?.handle && this.geometries.alive(known.handle)) {
+            this.geometries.remove(known.handle.id);
+        }
+        this.counts.strokeContexts++;
+        const data = layerStrokes(layer, a, b, c, d, least, this.tessellator.lines, by, opaque);
+        // Not built, as where no instance could be made: none kept, so that a later frame asks again.
+        if (data === undefined) {
+            return null;
+        }
+        const handle = data ? this.geometries.add(data) : null;
+        const vertices = data ? data.positions.length / 2 : 0;
+        if (known) {
+            this.vertices += vertices - known.vertices;
+            known.handle = handle;
+            known.version = version;
+            known.vertices = vertices;
+            known.usedAt = frame;
+        }
+        else {
+            if (!bucket) {
+                bucket = [];
+                lines.byHash.set(hash, bucket);
+            }
+            const entry = {
+                a,
+                b,
+                c,
+                d,
+                least,
+                by: by ? [by[0], by[1], by[2], by[3]] : null,
+                opaque,
+                handle,
+                version,
+                within: lines,
+                hash,
+                vertices,
+                usedAt: frame,
+            };
+            bucket.push(entry);
+            this.entries.push(entry);
+            this.vertices += vertices;
+        }
+        if (this.vertices > this.limit) {
+            this.trim(frame);
+        }
+        return handle;
+    }
+    /**
+     * The kept lines looked over: those the geometries let go of, or that
+     * stroked to nothing and went undrawn for their idle frames, forgotten;
+     * then, past three quarters of the budget, those drawn neither in this
+     * `frame` nor the last let go of, the least lately drawn first; the limit
+     * set to half again what is left, the budget at least.
+     */
+    trim(frame) {
+        this.swept = frame;
+        const entries = this.entries;
+        const most = (this.budget * 3) / 4;
+        let kept = 0;
+        for (const e of entries) {
+            if (e.handle ? this.geometries.alive(e.handle) : frame - e.usedAt <= IDLE_FRAMES) {
+                entries[kept++] = e;
+            }
+            else {
+                this.forget(e);
+            }
+        }
+        entries.length = kept;
+        if (this.vertices > most) {
+            // Mid-walk, those drawn last frame may yet be drawn in this one.
+            const idle = entries.filter((e) => e.usedAt < frame - 1).sort((x, y) => x.usedAt - y.usedAt);
+            for (let i = 0; i < idle.length && this.vertices > most; i++) {
+                if (idle[i].handle) {
+                    this.geometries.remove(idle[i].handle.id);
+                }
+                this.forget(idle[i]);
+            }
+            kept = 0;
+            for (const e of entries) {
+                if (e.vertices >= 0) {
+                    entries[kept++] = e;
+                }
+            }
+            entries.length = kept;
+        }
+        this.limit = Math.max(this.budget, this.vertices * 1.5);
+    }
+    /** `layer`'s lines let go of, as its drawing draws it no more: the next sweep forgets them. */
+    drop(layer) {
+        for (const bucket of this.byLayer.get(layer)?.byHash.values() ?? []) {
+            for (const e of bucket) {
+                if (e.handle && this.geometries.alive(e.handle)) {
+                    this.geometries.remove(e.handle.id);
+                }
+            }
+        }
+    }
+    /** Line entry `e` taken out of its layer's lines, its vertices no longer counted. */
+    forget(e) {
+        const bucket = e.within.byHash.get(e.hash);
+        const at = bucket ? bucket.indexOf(e) : -1;
+        if (bucket && at >= 0) {
+            bucket.splice(at, 1);
+            if (bucket.length === 0) {
+                e.within.byHash.delete(e.hash);
+            }
+        }
+        this.vertices -= e.vertices;
+        e.vertices = -1;
+    }
+}
+//# sourceMappingURL=lines.js.map

package/dist/scene/lines.js.map

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

package/dist/scene/masks.d.ts

@@ -0,0 +1,32 @@
+import { type Geometries, type Rows, type SceneList } from "@swf2es/render";
+import { type DisplayObject } from "../display/displayobject.js";
+import type { Parts } from "./parts.js";
+export declare class Masks {
+    private readonly geometries;
+    private readonly parts;
+    /** The masks pushed and not yet popped, as each one's first draw and count. */
+    private readonly stack;
+    constructor(geometries: Geometries, parts: Parts);
+    /** A mask begun: its draws follow, till it is used (maskUse); its first entry's index. */
+    maskBegin(scene: SceneList): number;
+    /**
+     * The mask begun at entry `first` (maskBegin) used from here, its draws
+     * those since. Begun and used around the mask's draws, with no closure:
+     * one in the walk kept every number it took in a context made on each
+     * call, boxed, though no mask was drawn.
+     */
+    maskUse(scene: SceneList, first: number): void;
+    /** The mask pushed last taken out: its draws named again. */
+    popMask(scene: SceneList): void;
+    /** A rectangle of `o`'s space, x y width height, under its transform (a b c d tx ty), as a mask's draw. */
+    rectMask(scene: SceneList, rows: Rows, a: number, b: number, c: number, d: number, tx: number, ty: number, x: number, y: number, width: number, height: number): void;
+    /**
+     * `o` and all in it drawn as a mask, under its parent's transform: fills
+     * alone, a drawing's non-zero, glyphs and bitmaps' rectangles, whatever
+     * their visibility, as Flash masks by them. `own` says (a b c d tx ty) is
+     * already `o`'s own place, as a mask elsewhere on the list is found; else
+     * its own matrix is applied. Flags are cleared as the walk clears them.
+     */
+    walkMask(scene: SceneList, rows: Rows, snapshotting: boolean, o: DisplayObject, pa: number, pb: number, pc: number, pd: number, ptx: number, pty: number, own: boolean): void;
+}
+//# sourceMappingURL=masks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"masks.d.ts","sourceRoot":"","sources":["../../src/scene/masks.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,UAAU,EAKf,KAAK,IAAI,EACT,KAAK,SAAS,EAEf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKxC,qBAAa,KAAK;IAKd,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,YACmB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EAC3B;IAEJ,0FAA0F;IAC1F,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAGlC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7C;IAED,6DAA6D;IAC7D,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAI9B;IAED,2GAA2G;IAC3G,QAAQ,CACN,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,IAAI,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAeN;IAED;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,OAAO,EACrB,CAAC,EAAE,aAAa,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,OAAO,GACX,IAAI,CAmFN;CACF"}

package/dist/scene/masks.js

@@ -0,0 +1,136 @@
+// Masks as the view draws them (RenderView): a mask's draws begun, used
+// for what it masks and popped, as stencil markers in the scene list; a
+// rectangle, a scroll's or a text's gutter, as the unit quad; and an
+// object drawn whole as a mask, fills alone.
+import { IDENTITY } from "@swf2es/format";
+import { MASK_BEGIN, MASK_POP, MASK_USE, NORMAL, SNAP, } from "@swf2es/render";
+import { BitmapObject } from "../display/bitmapobject.js";
+import { Container } from "../display/container.js";
+import { CLEAN } from "../display/displayobject.js";
+import { ShapeObject } from "../display/shapeobject.js";
+import { facing } from "../display/shapes.js";
+import { StaticTextObject, TextObject } from "../display/textobjects.js";
+import { unsupported } from "./shapes.js";
+import { fieldItems, staticItems } from "./text.js";
+import { placedRow } from "./text-items.js";
+export class Masks {
+    geometries;
+    parts;
+    /** The masks pushed and not yet popped, as each one's first draw and count. */
+    stack = [];
+    constructor(geometries, parts) {
+        this.geometries = geometries;
+        this.parts = parts;
+    }
+    /** A mask begun: its draws follow, till it is used (maskUse); its first entry's index. */
+    maskBegin(scene) {
+        scene.marker(MASK_BEGIN);
+        return scene.length;
+    }
+    /**
+     * The mask begun at entry `first` (maskBegin) used from here, its draws
+     * those since. Begun and used around the mask's draws, with no closure:
+     * one in the walk kept every number it took in a context made on each
+     * call, boxed, though no mask was drawn.
+     */
+    maskUse(scene, first) {
+        const count = scene.length - first;
+        scene.marker(MASK_USE, first, count);
+        this.stack.push(first, count);
+    }
+    /** The mask pushed last taken out: its draws named again. */
+    popMask(scene) {
+        const count = this.stack.pop();
+        const first = this.stack.pop();
+        scene.marker(MASK_POP, first, count);
+    }
+    /** A rectangle of `o`'s space, x y width height, under its transform (a b c d tx ty), as a mask's draw. */
+    rectMask(scene, rows, a, b, c, d, tx, ty, x, y, width, height) {
+        const quad = this.parts.unitQuad();
+        const row = placedRow(rows, a, b, c, d, tx, ty, { a: width, b: 0, c: 0, d: height, tx: x, ty: y }, null);
+        this.geometries.use(quad.id);
+        scene.draw(quad.id, row, NORMAL);
+    }
+    /**
+     * `o` and all in it drawn as a mask, under its parent's transform: fills
+     * alone, a drawing's non-zero, glyphs and bitmaps' rectangles, whatever
+     * their visibility, as Flash masks by them. `own` says (a b c d tx ty) is
+     * already `o`'s own place, as a mask elsewhere on the list is found; else
+     * its own matrix is applied. Flags are cleared as the walk clears them.
+     */
+    walkMask(scene, rows, snapshotting, o, pa, pb, pc, pd, ptx, pty, own) {
+        const m = own ? IDENTITY : o.flatPlaced;
+        // What would clip a mask's own coverage needs a stencil within the stencil: drawn whole, and counted.
+        if (o.mask || o.scroll || o.clipDepth > 0) {
+            unsupported.masks++;
+        }
+        const a = pa * m.a + pc * m.b;
+        const b = pb * m.a + pd * m.b;
+        const c = pa * m.c + pc * m.d;
+        const d = pb * m.c + pd * m.d;
+        const tx = pa * m.tx + pc * m.ty + ptx;
+        const ty = pb * m.tx + pd * m.ty + pty;
+        const shape = o instanceof ShapeObject ? o.drawn() : null;
+        const version = o.drawing ? o.drawing.version : 0;
+        const layers = o.drawing
+            ? facing(o.drawing.layers, a * d - b * c < 0, version)
+            : (shape?.layers ?? null);
+        // A mask's drawing drawn again lets go of its old layers too.
+        if (o.drawing && layers) {
+            this.parts.dropUndrawn(o, layers, version);
+        }
+        // Its row made as its first draw needs it, in place: a closure here kept every number it took
+        // in a context made on each call, boxed, as the walk's did.
+        let row = -1;
+        if (layers) {
+            for (let i = 0; i < layers.length; i++) {
+                for (const { part, handle } of this.parts.partsOf(layers[i], version, o.drawing !== null)) {
+                    // A mesh of a bitmap disposed of draws nothing, as it is drawn, and so masks nothing.
+                    if (part.mesh?.image.disposed) {
+                        continue;
+                    }
+                    this.geometries.use(handle.id);
+                    if (row < 0) {
+                        row = rows.add(a, b, c, d, tx, ty, null);
+                    }
+                    scene.draw(handle.id, row, NORMAL);
+                }
+            }
+        }
+        if (o instanceof TextObject || o instanceof StaticTextObject) {
+            const omitted = { advanced: false, clip: null, clipFrom: 0, clipTo: 0 };
+            for (const item of o instanceof TextObject
+                ? fieldItems(o, omitted)
+                : staticItems(o, omitted)) {
+                const geometry = item.kind === "glyph" ? this.parts.glyphGeometry(item.glyph) : null;
+                if (item.kind === "glyph" && geometry) {
+                    const glyphRow = placedRow(rows, a, b, c, d, tx, ty, item.m, null);
+                    this.geometries.use(geometry.id);
+                    scene.draw(geometry.id, glyphRow, NORMAL, -1, SNAP);
+                }
+            }
+        }
+        const store = o instanceof BitmapObject ? o.store : null;
+        if (store && !store.disposed && store.width > 0 && store.height > 0) {
+            const quad = this.parts.quad(store.width, store.height);
+            this.geometries.use(quad.id);
+            if (row < 0) {
+                row = rows.add(a, b, c, d, tx, ty, null);
+            }
+            scene.draw(quad.id, row, NORMAL);
+        }
+        if (o instanceof Container) {
+            for (const child of o.children) {
+                this.walkMask(scene, rows, snapshotting, child, a, b, c, d, tx, ty, false);
+            }
+            if (!snapshotting) {
+                o.descendantsDirty = false;
+            }
+        }
+        // A draw for BitmapData leaves them for the stage's.
+        if (!snapshotting) {
+            o.dirty = CLEAN;
+        }
+    }
+}
+//# sourceMappingURL=masks.js.map

package/dist/scene/masks.js.map

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

package/dist/scene/paints.d.ts

@@ -0,0 +1,86 @@
+import { type TextureHandle, type Textures } from "@swf2es/render";
+import { BitmapStore, type PixelRect } from "../bitmap/bitmap.js";
+import { type Part } from "./shapes.js";
+/**
+ * How many frames a gradient's texture may go undrawn: a morph tweening a
+ * gradient makes a new one for each ratio, up to a megabyte each, which
+ * the usual idle frames would hold hundreds of.
+ */
+export declare const GRADIENT_IDLE_FRAMES = 30;
+/** What a store's GPU copy asks of the renderer, on textures by id; each null or false where it cannot. */
+export interface StoreGpu {
+    /** Texture `id`'s `width` by `height` texels read back, premultiplied RGBA. */
+    read(id: number, width: number, height: number): Uint8Array | null;
+    /** A rectangle of texture `id` cleared to `pixel`, premultiplied ARGB. */
+    fill(id: number, rect: PixelRect, pixel: number): boolean;
+    /** A rectangle of texture `from` copied to (dx, dy) of `to`, as a memmove where they are one. */
+    copy(from: number, rect: PixelRect, to: number, dx: number, dy: number): boolean;
+}
+/** Bitmaps' and gradients' textures, made as first drawn and kept while they are. */
+export declare class Paints {
+    private readonly textures;
+    private readonly gpu;
+    private readonly stores;
+    /** Each gradient's textures, by the region a radial one covers (null for a linear one), the latest used last. */
+    private readonly gradients;
+    /** A store's texture held for draws alone let go of if the store is collected undisposed. */
+    private readonly collected;
+    constructor(textures: Textures, gpu?: StoreGpu | null);
+    /**
+     * The texture a part's paint or mesh samples: its bitmap's, else null till
+     * it is decoded, or its gradient's.
+     */
+    paintTexture(part: Part): TextureHandle | null;
+    /**
+     * `store`'s texture, its pixels as drawn (`drawable`) uploaded again if
+     * they changed since, converted into the bytes the texture keeps (Textures'
+     * `bytes`), so that a store drawn into every frame allocates none.
+     */
+    storeTexture(store: BitmapStore, idle?: number): TextureHandle;
+    /**
+     * `store` drawn into on the GPU, its texture (`storeTexture`) the newest
+     * of its pixels now: kept however long it goes undrawn, till they are
+     * read back, the store disposed or collected.
+     */
+    drawn(store: BitmapStore): void;
+    /**
+     * `store`'s texture read back: the CPU holds the pixels again, and the
+     * texture goes idle as any other.
+     */
+    readBack(store: BitmapStore): void;
+    /** Texture `handle`'s pixels read back for a store `width` by `height`; null once it is gone. */
+    readStore(handle: TextureHandle, width: number, height: number): Uint8Array | null;
+    /** `rect` of texture `handle` cleared to `pixel`: a store's fill on the GPU. */
+    fillStore(handle: TextureHandle, rect: PixelRect, pixel: number): boolean;
+    /**
+     * `rect` of `source` copied to (dx, dy) of texture `handle`, a store's
+     * copy on the GPU: the source's texture first made of its pixels where
+     * they are newer, as when it is drawn. Not from an opaque store holding
+     * alpha, whose texture holds its pixels as drawn, not as they are.
+     */
+    copyStore(source: BitmapStore, rect: PixelRect, handle: TextureHandle, dx: number, dy: number): boolean;
+    /** `store`'s texture let go of, as the store is disposed. */
+    release(store: BitmapStore, handle: TextureHandle): void;
+    /**
+     * `store`'s pixels as drawn, in bytes Textures lends for texture `id`: an
+     * opaque store holding alpha made opaque as they are converted, rather
+     * than through a copy of its own.
+     */
+    private bytesOf;
+    /** Premultiplied ARGB in bytes Textures lends. */
+    private rgba;
+    /**
+     * A gradient's texture: a linear one's ramp of 256 colours, a radial one
+     * computed over its region, a texel a pixel up to 512 a side
+     * (display/gradients.ts).
+     */
+    private gradientTexture;
+}
+/**
+ * How a part's paint is sampled. A bitmap fill, or a mesh's bitmap:
+ * smoothed if it asks and `smoothing` (RenderView.smoothing), repeated or
+ * clamped. A linear gradient's ramp: texel by texel, spread as it wraps; a
+ * radial one's, smoothed.
+ */
+export declare function paintSampler(part: Part, smoothing: boolean): number;
+//# sourceMappingURL=paints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paints.d.ts","sourceRoot":"","sources":["../../src/scene/paints.ts"],"names":[],"mappings":"AAMA,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,WAAW,EAGX,KAAK,SAAS,EAEf,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAuB,KAAK,IAAI,EAAgB,MAAM,aAAa,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAevC,2GAA2G;AAC3G,MAAM,WAAW,QAAQ;IACvB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACnE,0EAA0E;IAC1E,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1D,iGAAiG;IACjG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAClF;AAoCD,qFAAqF;AACrF,qBAAa,MAAM;IAgBf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAhBtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,iHAAiH;IACjH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIvB;IAEH,YACmB,QAAQ,EAAE,QAAQ,EAClB,GAAG,GAAE,QAAQ,GAAG,IAAW,EAC1C;IAEJ;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,IAAI,CAa7C;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAqC7D;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAkB9B;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAOjC;IAED,iGAAiG;IACjG,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAEjF;IAED,gFAAgF;IAChF,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAExE;IAED;;;;;OAKG;IACH,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAOT;IAED,6DAA6D;IAC7D,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAUvD;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAOf,kDAAkD;IAClD,OAAO,CAAC,IAAI;IAMZ;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAsExB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAgBnE"}