@oidoid/void 0.1.0-3 → 0.1.0-6

package/dist/src/graphics/gl.js

@@ -0,0 +1,70 @@
+import { debug } from "../utils/debug.js";
+/** @internal */
+export function Shader(gl, vertGLSL, fragGLSL, textures) {
+    const program = loadProgram(gl, vertGLSL, fragGLSL);
+    gl.useProgram(program);
+    return {
+        buffer: gl.createBuffer(),
+        program,
+        textures,
+        uniform: GLUniformMap(gl, program),
+        vao: gl.createVertexArray()
+    };
+}
+function GLUniformMap(gl, pgm) {
+    const len = pgm ? gl.getProgramParameter(pgm, gl.ACTIVE_UNIFORMS) : 0;
+    const map = debug?.render
+        ? new Proxy({}, {
+            get(target, k) {
+                if (target[k] == null)
+                    throw Error(`no shader uniform "${k}"`);
+                return target[k];
+            }
+        })
+        : {};
+    for (let i = 0; i < len; ++i) {
+        const uniform = gl.getActiveUniform(pgm, i);
+        if (!uniform)
+            throw Error(`no shader uniform at index ${i}`);
+        const location = gl.getUniformLocation(pgm, uniform.name);
+        if (!location)
+            throw Error(`no shader uniform "${uniform.name}"`);
+        const name = uniform.name.replace('[0]', ''); // arrays.
+        map[name] = location;
+    }
+    return map;
+}
+function loadProgram(gl, vertGLSL, fragGLSL) {
+    const pgm = gl.createProgram();
+    if (!pgm)
+        return null;
+    const vert = compileShader(gl, 'VERTEX_SHADER', vertGLSL);
+    const frag = compileShader(gl, 'FRAGMENT_SHADER', fragGLSL);
+    if (!vert || !frag)
+        return null;
+    gl.attachShader(pgm, vert);
+    gl.attachShader(pgm, frag);
+    gl.linkProgram(pgm);
+    if (debug?.render && !gl.getProgramParameter(pgm, gl.LINK_STATUS)) {
+        const log = gl.getProgramInfoLog(pgm)?.slice(0, -1);
+        throw Error(`shader link failure; ${log}`);
+    }
+    gl.detachShader(pgm, frag);
+    gl.detachShader(pgm, vert);
+    gl.deleteShader(frag);
+    gl.deleteShader(vert);
+    return pgm;
+}
+function compileShader(gl, type, glsl) {
+    const shader = gl.createShader(gl[type]);
+    if (!shader)
+        return shader;
+    gl.shaderSource(shader, glsl.trim());
+    gl.compileShader(shader);
+    if (debug?.render && !gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+        const log = gl.getShaderInfoLog(shader)?.slice(0, -1);
+        throw Error(`shader compile failure; ${log}`);
+    }
+    return shader;
+}
+//# sourceMappingURL=gl.js.map

package/dist/src/graphics/gl.js.map

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

package/dist/src/graphics/layer.d.ts

@@ -0,0 +1,21 @@
+export declare const Layer: {
+    readonly Top: 0;
+    readonly UIA: 1;
+    readonly UIB: 2;
+    readonly UIC: 3;
+    readonly UID: 4;
+    readonly UIE: 5;
+    readonly UIF: 6;
+    readonly UIG: 7;
+    readonly A: 8;
+    readonly B: 9;
+    readonly C: 10;
+    readonly D: 11;
+    readonly E: 12;
+    readonly F: 13;
+    readonly Bottom: 14;
+    readonly Hidden: 15;
+};
+export type Layer = (typeof Layer)[keyof typeof Layer];
+/** negative is above. returns [top, bottom]; hidden is out of domain. */
+export declare function layerOffset(layer: Layer, offset: number): Layer;

package/dist/src/graphics/layer.js

@@ -0,0 +1,23 @@
+export const Layer = {
+    Top: 0,
+    UIA: 1,
+    UIB: 2,
+    UIC: 3,
+    UID: 4,
+    UIE: 5,
+    UIF: 6,
+    UIG: 7,
+    A: 8,
+    B: 9,
+    C: 10,
+    D: 11,
+    E: 12,
+    F: 13,
+    Bottom: 14,
+    Hidden: 15
+};
+/** negative is above. returns [top, bottom]; hidden is out of domain. */
+export function layerOffset(layer, offset) {
+    return Math.max(Layer.Top, Math.min(Layer.Bottom, layer + offset));
+}
+//# sourceMappingURL=layer.js.map

package/dist/src/graphics/layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.js","sourceRoot":"","sources":["../../../src/graphics/layer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE;IACL,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;CACF,CAAA;AAGV,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,MAAc;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAU,CAAA;AAC7E,CAAC"}

package/dist/src/graphics/renderer.d.ts

@@ -0,0 +1,22 @@
+import type { Pool } from '../mem/pool.ts';
+import type { Millis } from '../types/time.ts';
+import type { Atlas, TagFormat } from './atlas.ts';
+import type { Cam } from './cam.ts';
+import { type Sprite } from './sprite.ts';
+export declare class Renderer {
+    #private;
+    /** when off, ents should avoid requesting renders. */
+    always: boolean;
+    invalid: boolean;
+    loseContext: WEBGL_lose_context | undefined;
+    constructor(preloadAtlas: Readonly<Atlas>, canvas: HTMLCanvasElement);
+    clear(rgba: number): void;
+    draw(pool: Readonly<Pool<Sprite<TagFormat>>>): void;
+    load(preloadAtlas: Readonly<HTMLImageElement> | undefined): void;
+    predraw(cam: Readonly<Cam>, framer: {
+        readonly age: Millis;
+    }): void;
+    register(op: 'add' | 'remove'): this;
+    setDepth(enable: boolean): void;
+    [Symbol.dispose](): void;
+}

package/dist/src/graphics/renderer.js

@@ -0,0 +1,168 @@
+import { whEq } from "../types/geo.js";
+import { debug } from "../utils/debug.js";
+import { Shader } from "./gl.js";
+import { drawableBytes } from "./sprite.js";
+import { spriteFragGLSL } from "./sprite-frag.glsl.js";
+import { spriteVertGLSL } from "./sprite-vert.glsl.js";
+const uv = new Int8Array([1, 1, 0, 1, 1, 0, 0, 0]);
+export class Renderer {
+    /** when off, ents should avoid requesting renders. */
+    always = false;
+    invalid = false;
+    loseContext;
+    #canvas;
+    #clearRGBA = 0;
+    #ctx;
+    #preloadAtlas;
+    #preloadAtlasImage;
+    constructor(preloadAtlas, canvas) {
+        this.#preloadAtlas = preloadAtlas;
+        this.#canvas = canvas;
+        this.#ctx = this.#Context();
+    }
+    clear(rgba) {
+        if (!this.#ctx)
+            return;
+        const { gl } = this.#ctx;
+        if (this.#clearRGBA !== rgba) {
+            this.#clearRGBA = rgba;
+            gl.clearColor(((rgba >>> 24) & 0xff) / 0xff, ((rgba >>> 16) & 0xff) / 0xff, ((rgba >>> 8) & 0xff) / 0xff, ((rgba >>> 0) & 0xff) / 0xff);
+        }
+        gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);
+    }
+    draw(pool) {
+        if (!this.#preloadAtlasImage || !this.#ctx)
+            return;
+        const { gl, spriteShader } = this.#ctx;
+        gl.bindBuffer(gl.ARRAY_BUFFER, spriteShader.buffer);
+        gl.bufferData(gl.ARRAY_BUFFER, pool.view, gl.DYNAMIC_DRAW, 0, pool.size * drawableBytes);
+        gl.bindBuffer(gl.ARRAY_BUFFER, null);
+        gl.bindVertexArray(spriteShader.vao);
+        gl.drawArraysInstanced(gl.TRIANGLE_STRIP, 0, uv.length / 2, // d
+        pool.size);
+        gl.bindVertexArray(null);
+        this.invalid = false;
+    }
+    load(preloadAtlas) {
+        this.#preloadAtlasImage = preloadAtlas;
+        this.#ctx = this.#Context();
+    }
+    predraw(cam, framer) {
+        if (!this.#ctx)
+            return;
+        const { gl, spriteShader, viewport } = this.#ctx;
+        if (!whEq(viewport, cam)) {
+            gl.viewport(0, 0, cam.w, cam.h);
+            viewport.w = cam.w;
+            viewport.h = cam.h;
+        }
+        gl.useProgram(spriteShader.program);
+        gl.uniform4i(spriteShader.uniform.uCam, cam.x, cam.y, cam.w, cam.h);
+        gl.uniform1f(spriteShader.uniform.uAge, framer.age);
+        for (const [i, tex] of spriteShader.textures.entries()) {
+            gl.activeTexture(gl.TEXTURE0 + i);
+            gl.bindTexture(gl.TEXTURE_2D, tex);
+        }
+    }
+    register(op) {
+        this.#canvas[`${op}EventListener`]('webglcontextlost', this.#onContextLost);
+        this.#canvas[`${op}EventListener`]('webglcontextrestored', this.#onContextRestored);
+        return this;
+    }
+    setDepth(enable) {
+        if (!this.#ctx)
+            return;
+        if (enable)
+            this.#ctx.gl.enable(this.#ctx.gl.DEPTH_TEST);
+        else
+            this.#ctx.gl.disable(this.#ctx.gl.DEPTH_TEST);
+    }
+    [Symbol.dispose]() {
+        this.register('remove');
+    }
+    #Context() {
+        const gl = this.#ctx?.gl ?? GL2(this.#canvas);
+        if (!gl)
+            return;
+        const shader = Shader(gl, spriteVertGLSL, spriteFragGLSL, [
+            gl.createTexture(),
+            gl.createTexture()
+        ]);
+        // allow translucent textures to be layered.
+        gl.enable(gl.BLEND);
+        gl.blendFuncSeparate(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA, gl.ONE, gl.ONE_MINUS_SRC_ALPHA);
+        // enable z-buffer for [0, 1] ([foreground, background]).
+        gl.depthRange(0, 1);
+        gl.clearDepth(1);
+        gl.depthFunc(gl.LESS);
+        // disable image colorspace conversions. the default is browser dependent.
+        gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, false);
+        gl.bindVertexArray(shader.vao);
+        gl.bindBuffer(gl.ARRAY_BUFFER, gl.createBuffer());
+        gl.bufferData(gl.ARRAY_BUFFER, uv, gl.STATIC_DRAW);
+        gl.enableVertexAttribArray(0);
+        gl.vertexAttribIPointer(0, 2, gl.BYTE, 0, 0);
+        gl.bindBuffer(gl.ARRAY_BUFFER, null);
+        gl.bindBuffer(gl.ARRAY_BUFFER, shader.buffer);
+        gl.enableVertexAttribArray(1);
+        gl.vertexAttribIPointer(1, 1, gl.UNSIGNED_INT, drawableBytes, 0);
+        gl.vertexAttribDivisor(1, 1);
+        gl.enableVertexAttribArray(2);
+        gl.vertexAttribIPointer(2, 1, gl.UNSIGNED_INT, drawableBytes, 4);
+        gl.vertexAttribDivisor(2, 1);
+        gl.enableVertexAttribArray(3);
+        gl.vertexAttribIPointer(3, 1, gl.UNSIGNED_INT, drawableBytes, 8);
+        gl.vertexAttribDivisor(3, 1);
+        gl.bindBuffer(gl.ARRAY_BUFFER, null);
+        gl.bindTexture(gl.TEXTURE_2D, shader.textures[0]);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
+        if (this.#preloadAtlasImage)
+            gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, this.#preloadAtlasImage);
+        gl.bindTexture(gl.TEXTURE_2D, null);
+        gl.bindTexture(gl.TEXTURE_2D, shader.textures[1]);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
+        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA16UI, // source XYWH cannot be > 65535.
+        1, this.#preloadAtlas.celXYWH.length / 4, // 4 u16s per row
+        0, gl.RGBA_INTEGER, gl.UNSIGNED_SHORT, new Uint16Array(this.#preloadAtlas.celXYWH));
+        gl.bindTexture(gl.TEXTURE_2D, null);
+        gl.bindVertexArray(null);
+        gl.uniform1i(shader.uniform.uTex, 0);
+        gl.uniform1i(shader.uniform.uCels, 1);
+        if (this.#preloadAtlasImage)
+            gl.uniform2ui(shader.uniform.uTexWH, this.#preloadAtlasImage.naturalWidth, this.#preloadAtlasImage.naturalHeight);
+        this.invalid = true;
+        // keep outside of #context so it can be restored.
+        this.loseContext = gl.getExtension('WEBGL_lose_context') ?? undefined;
+        return (this.#ctx = { gl, spriteShader: shader, viewport: { w: 0, h: 0 } });
+    }
+    #onContextLost = (ev) => {
+        ev.preventDefault(); // required.
+        console.debug('[render] WebGL context lost');
+        this.#ctx = undefined;
+    };
+    #onContextRestored = () => {
+        console.debug('[render] WebGL context restored');
+        this.#ctx = this.#Context();
+    };
+}
+function GL2(canvas) {
+    const gl = canvas.getContext('webgl2', {
+        // to-do: expose.
+        antialias: false,
+        powerPreference: 'low-power',
+        // avoid flicker caused by clearing the drawing buffer. see
+        // https://developer.chrome.com/blog/desynchronized/.
+        preserveDrawingBuffer: true,
+        ...(!debug?.render && { desynchronized: true })
+    });
+    if (!gl) {
+        console.debug('[render] no GL context');
+        return;
+    }
+    if (debug?.render && !gl.getContextAttributes()?.desynchronized)
+        console.debug('[render] no WebGL DOM desynchronization');
+    return gl;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/src/graphics/renderer.js.map

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

package/dist/src/graphics/sprite-frag.glsl.d.ts

@@ -0,0 +1 @@
+export declare const spriteFragGLSL: string;

package/dist/src/graphics/sprite-frag.glsl.js

@@ -0,0 +1,35 @@
+export const spriteFragGLSL = `#version 300 es
+#pragma debug(${debug?.render ? 'on' : 'off'})   
+#pragma optimize(${debug?.render ? 'off' : 'on'})
+
+precision highp int;
+precision highp float;
+precision highp usampler2D;
+
+uniform sampler2D uTex;
+uniform uvec2 uTexWH;
+
+flat in uint vStretch;
+flat in ivec4 vTexXYWH;
+flat in int vZ;
+in vec2 vDstWH;
+flat in ivec2 vDstWHFixed;
+
+out vec4 oRGBA;
+
+void main() {
+  if (vZ == ${Layer.Hidden} || vDstWHFixed.x == 0 || vDstWHFixed.y == 0)
+    discard;
+
+  vec2 px = vec2(vTexXYWH.xy) + (
+    vStretch == 1u ? (vDstWH * vec2(vTexXYWH.zw) / vec2(vDstWHFixed))
+                   : mod(vDstWH, vec2(vTexXYWH.zw))
+  );
+
+  oRGBA = texture(uTex, px / vec2(uTexWH));
+  if(oRGBA.a < .001) discard;
+}
+`;
+import { debug } from "../utils/debug.js";
+import { Layer } from "./layer.js";
+//# sourceMappingURL=sprite-frag.glsl.js.map

package/dist/src/graphics/sprite-frag.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-frag.glsl.js","sourceRoot":"","sources":["../../../src/graphics/sprite-frag.glsl.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAW;gBACtB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;mBACzB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;cAkBjC,KAAK,CAAC,MAAM;;;;;;;;;;;CAWzB,CAAA;AAED,OAAO,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAA;AACvC,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA"}

package/dist/src/graphics/sprite-vert.glsl.d.ts

@@ -0,0 +1 @@
+export declare const spriteVertGLSL: string;

package/dist/src/graphics/sprite-vert.glsl.js

@@ -0,0 +1,68 @@
+export const spriteVertGLSL = `#version 300 es
+#pragma debug(${debug?.render ? 'on' : 'off'})   
+#pragma optimize(${debug?.render ? 'off' : 'on'})
+
+// https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#essl300_minimum_requirements_webgl_2
+precision highp int;
+precision highp float;
+precision highp usampler2D;
+
+uniform ivec4 uCam;
+uniform usampler2D uCels;
+uniform float uAge;
+
+layout (location=0) in ivec2 iUV;
+layout (location=1) in uint iy8_x24;
+layout (location=2) in uint iw8_sxyz_llll_y16;
+layout (location=3) in uint ii11_c5_h12_w4;
+
+const int maxY = 0x20000;
+const int layers = 16;
+const int maxDepth = maxY * layers;
+
+flat out uint vStretch;
+flat out ivec4 vTexXYWH;
+flat out int vZ;
+out vec2 vDstWH;
+flat out ivec2 vDstWHFixed;
+
+void main() {
+  int x = (int((iy8_x24 & 0xffffffu) << 8) >> 8) / 64;
+  int y = (int(iy8_x24 >> 24) | (int(iw8_sxyz_llll_y16 & 0xffffu) << 16 >> 8)) / 64;
+  int z = int((iw8_sxyz_llll_y16 >> 16) & 0xfu);
+  bool zend = bool(iw8_sxyz_llll_y16 & 0x100000u);
+  bool flipY = bool(iw8_sxyz_llll_y16 & 0x200000u);
+  bool flipX = bool(iw8_sxyz_llll_y16 & 0x400000u);
+  bool stretch = bool(iw8_sxyz_llll_y16 & 0x800000u);
+  int id = int((ii11_c5_h12_w4 >> 17) & 0x7ff0u); // ignore cel.
+  int cel = int((ii11_c5_h12_w4 >> 16) & 0xfu); // ignore the MSB.
+  int w = int(((ii11_c5_h12_w4 & 0xfu) << 8) | (iw8_sxyz_llll_y16 >> 24));
+  int h = int((ii11_c5_h12_w4 >> 4) & 0xfffu);
+
+  // https://www.patternsgameprog.com/opengl-2d-facade-25-get-the-z-of-a-pixel
+  float depth = float((z + 1) * maxY - (y + (zend ? 0 : h))) / float(maxDepth);
+
+  ivec2 targetWH = iUV * ivec2(w, h);
+
+  vec2 end = vec2(x + targetWH.x, y + targetWH.y);
+  // UI layers are always given in screen coordinates.
+  // to-do: how to handle non-int mode?
+  vec2 camXY = z < ${Layer.A} ? vec2(0, 0) : vec2(uCam.xy);
+  vec2 clip = ((-2. * camXY  + 2. * end) / vec2(uCam.zw) - 1.) * vec2(1, -1);
+  gl_Position = vec4(clip, depth, 1);
+
+  int frame = (((int(uAge / ${celMillis}) & 0x1f) - cel) + ${animCels}) & 0xf;
+  uvec4 texXYWH = texelFetch(uCels, ivec2(0, id + frame), 0);
+  vTexXYWH = ivec4(texXYWH);
+  vZ = z;
+
+  vDstWH = vec2(targetWH * ivec2(flipX ? -1 : 1, flipY ? -1 : 1));
+  vDstWHFixed = ivec2(w, h) * ivec2(flipX ? -1 : 1, flipY ? -1 : 1);
+
+  vStretch = stretch ? 1u : 0u;
+}
+`;
+import { debug } from "../utils/debug.js";
+import { animCels, celMillis } from "./atlas.js";
+import { Layer } from "./layer.js";
+//# sourceMappingURL=sprite-vert.glsl.js.map

package/dist/src/graphics/sprite-vert.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-vert.glsl.js","sourceRoot":"","sources":["../../../src/graphics/sprite-vert.glsl.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAW;gBACtB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;mBACzB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA+C1B,KAAK,CAAC,CAAC;;;;8BAIE,SAAS,sBAAsB,QAAQ;;;;;;;;;;CAUpE,CAAA;AAED,OAAO,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAA;AACvC,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAC,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA"}

package/dist/src/graphics/sprite.d.ts

@@ -0,0 +1,108 @@
+import { type Anim, type Atlas, type TagFormat } from '../graphics/atlas.ts';
+import type { Block } from '../mem/pool.ts';
+import { type Box, type WH, type XY } from '../types/geo.ts';
+import type { Millis } from '../types/time.ts';
+import type { Layer } from './layer.ts';
+export declare const drawableBytes: number;
+/** granularity (0.015625) of `Drawable` coords. */
+export declare const drawableEpsilon: number;
+export declare const drawableMaxWH: WH;
+/**
+ * everything not requiring an atlas. the box is the drawn region. assume little
+ * endian.
+ *
+ * 0 xxxx xxxx x [-131072, 131071.984375] (1/64th fixed-point). 1b sign, 17b
+ * 1 xxxx xxxx int, 6b fraction.
+ * 2 xxxx xxxx
+ * 3 yyyy yyyy y.
+ * 4 yyyy yyyy
+ * 5 yyyy yyyy
+ * 6 sxyz llll stretch, flip x, flip y, zend, z layer (4b).
+ * 7 wwww wwww width [0, 4095]. zero means discard.
+ * 8 hhhh wwww height. zero means discard.
+ * 9 hhhh hhhh
+ * a iiic cccc animation ID [0, 2047], animation cel [0, 31].
+ * b iiii iiii
+ *
+ * animations default to looping without CPU interaction.
+ * @internal
+ */
+export declare abstract class Drawable implements Block, Box {
+    #private;
+    i: number;
+    constructor(pool: {
+        readonly view: DataView<ArrayBuffer>;
+    }, i: number);
+    above(draw: Readonly<Drawable>): boolean;
+    get cel(): number;
+    /**
+     * [0, 31]. rendered cel offset. call reset() to play animation from start.
+     */
+    set cel(cel: number);
+    /** test if render area overlaps box or sprite render area. */
+    clips(box: Readonly<XY & Partial<WH>>): boolean;
+    get flipX(): boolean;
+    set flipX(flip: boolean);
+    get flipY(): boolean;
+    set flipY(flip: boolean);
+    get h(): number;
+    /** [0, 4095]. */
+    set h(h: number);
+    get id(): number;
+    /** [0, 2047]. */
+    set id(id: number);
+    get stretch(): boolean;
+    /** wrap texture (default) or stretch to width and height. */
+    set stretch(stretch: boolean);
+    get w(): number;
+    /** [0, 4095]. */
+    set w(w: number);
+    get x(): number;
+    /** [-131072, 131071.984375] with 1/64th (0.015625) granularity. */
+    set x(x: number);
+    get xy(): XY;
+    set xy(xy: Readonly<XY>);
+    get y(): number;
+    /** [-131072, 131071.984375] with 1/64th (0.015625) granularity. */
+    set y(y: number);
+    get z(): Layer;
+    /** layer [0 (closest), 14 (furthest)]; 15 is hidden. */
+    set z(z: Layer);
+    get zend(): boolean;
+    /** z-order by top (default) or bottom of box. */
+    set zend(end: boolean);
+}
+export declare class Sprite<out Tag extends TagFormat> extends Drawable {
+    #private;
+    constructor(pool: {
+        readonly view: DataView<ArrayBuffer>;
+    }, i: number, atlas: Readonly<Atlas>, framer: {
+        readonly age: Millis;
+    });
+    get anim(): Anim;
+    get flipX(): boolean;
+    set flipX(flip: boolean);
+    get flipY(): boolean;
+    set flipY(flip: boolean);
+    get h(): number;
+    set h(h: number);
+    get hitbox(): Box | undefined;
+    hits(box: Readonly<XY | Box>): boolean;
+    get hurtbox(): Box | undefined;
+    get id(): number;
+    set id(id: number);
+    /** true if animation has played once. */
+    get looped(): boolean;
+    /** sets cel to animation start. */
+    reset(): void;
+    get tag(): Tag;
+    /** sets animation, resets cel, dimensions, hitbox, and hurtbox. */
+    set tag(tag: Tag);
+    toString(): string;
+    get w(): number;
+    set w(w: number);
+    get x(): number;
+    set x(x: number);
+    get y(): number;
+    set y(y: number);
+}