on(handle: any, w: number?, ht: number?) → any

Wrap a live pixelArt canvas handle. `w`/`ht` default to Rules.CELL.

px(self: any, x: number, y: number, color: string?) → void

rect(self: any, x0: number, y0: number, x1: number, y1: number, color: string?) → void

blob(self: any, cx: number, cy: number, rx: number, ry: number, color: string?) → void

A filled ellipse — the workhorse for heads, fists, shoulders, pauldrons.

limb(self: any, x0: number, y0: number, x1: number, y1: number, w0: number, w1: number, color: string?) → void

A tapered capsule from (x0,y0) to (x1,y1), width w0 at the start and w1 at the end. This is how every arm, leg, torso and weapon shaft is drawn: the taper is what stops a figure reading as a stack of rectangles.

line(self: any, x0: number, y0: number, x1: number, y1: number, color: string?, thickness: number?) → void

A straight line, optionally thick.

poly(self: any, pts: { { number } }, color: string?) → void

A closed filled polygon (scanline). Points are { {x,y}, ... }.

ribbon(self: any, pts: { { number } }, w0: number, w1: number, color: string?) → void

A tapering strip through a list of points — scarves, coat tails, hair, the chain on a lantern. Give the points a frame of lag against the body and the ribbon leads and trails the motion on its own.

speck(self: any, cx: number, cy: number, rx: number, ry: number, color: string?, density: number?) → void

Scattered pixels in an ellipse — grit, sparks, ash, rust, stubble. `density` is 0..1. Deterministic for a given seed so a frame redraws identically.

rnd( ) → number

clear(self: any) → void

outline(self: any, color: string?) → void

Put a one-pixel rim of `color` around every drawn cluster. Run this LAST. An outline is what makes a sprite read against a busy painted stage; a fighting-game sprite without one disappears into the backdrop.

shadeLeft(self: any, fromColor: string, shadowColor: string, depth: number?) → void

Darken the left third of every filled column with `shadowColor`, leaving `keepColor` pixels alone. A cheap directional light that gives the figure volume — the stage's key light comes from screen-right in every stage.

blend(a: any, b: any, t: number) → any

Linear blend of two pose tables. Numbers interpolate; anything else takes the value from whichever pose is nearer. Nested tables blend recursively.

linear(t: number) → void

inQuad(t: number) → void

outQuad(t: number) → void

inCubic(t: number) → void

outCubic(t: number) → void

snap(t: number) → void

hold(t: number) → void

overshoot(t: number) → void

tween(keys: { any }) → void

Build a clip's frames from key poses. keys = { { pose = P1, hold = 2, ease = "outQuad" }, { pose = P2, hold = 4 }, ... } `hold` is how many rendered frames that key occupies before reaching the next one. Returns an array of pose tables, one per frame.

follow(chain: { { number } }, ax: number, ay: number, seg: number, lag: number, gravity: number?) → void

Trail a chain of segments behind an anchor point. Feed it the anchor each frame and it relaxes toward it with lag — hair, a scarf, a coat tail, a chain. `chain` is mutated in place and returned, ready for `ribbon`.

buildSheet(handle: any, clips: { [string]: any }, drawPose: (any, any) → void

Draw a whole sheet from a clip table and hand back the clip index. clips = { idle = { fps = 10, loop = true, poses = {...} }, ... } drawPose(K, pose) renders one frame. Returns { idle = { from = 1, to = 6, fps = 10, loop = true }, ... } — the exact shape the combat slice expects on an art module's `clips` field.