Command reference

Render frames to a preview PNG with a pixel grid and x/y rulers, to look at while you edit.

Many frames (.px/.png files, or every .px under a directory) side by side on one PNG, each labeled with its id, size and color count.

An animation as one GIF, plus a strip of what changed frame to frame (the whole-sprite shift taken out) and one line of numbers per frame, so a walk that's secretly a bob shows up.

Frame B drawn over A's silhouette, and a readout of how B's edges moved from A's ('top -1'), for a 1px jump too faint to see; --feet N reads only the bottom rows.

Place .px/.png items at x,y (or a text tilemap with --map) on one canvas and render it, optionally in a variant (--variant night) or tinted (--tint).

Lay a translucent color over a PNG, as scene --tint does (a night in one step).

Draw a compiled world (.world, or a lone .tmj): its rooms where they sit, interiors aside, edges, doors and where they lead, the start, markers, and every world-rule issue tagged.

Check .px and .map files: format errors with a code and location, size, colors, budget and unused keys; one line per file. Exits 1 on any failure.

Size, bounding box and colors of frames, a variant's rendered colors (--colors), or one pixel's key and color in every variant (--at x,y).

Compare renders pixel by pixel (a frame, a file, a folder of PNGs) and exit 1 when they differ: proof that a port or a copy renders as its original. -o DIFF.png draws what differs.

List a file's frames and animations; or remove (--rm), move (--after/--before), rename (--rename) or copy them into another file (--copy-to).

Mirror selected frames left-right (--v: top-bottom)

Move a frame's pixels (or a region's) by dx,dy, dropping or wrapping what goes past the edge.

Paint single pixels ('.' erases)

Paint a rectangle (default: the frame; '.' clears)

Start a frame, blank or filled with one key, in a new file or an existing one; or a file with no frames that imports a palette (--empty).

Replace one frame's grid with rows from stdin (palette lines first, optionally).

Erase every pixel outside rectangles or circles (or inside, --invert), or by key; a PNG too.

Cut a rectangle out of one frame into a frame of its own, in the same file or another.

Write only the selected frames to a new file, with their palette, imports and @anim lines.

Repaint, swap or rename palette keys in frames ('a=b', 'a<>b', 'a>b'), or give a key a new color.

Copy one frame (or a region of it) onto another at x,y; '.' never overwrites.

Stack frames from any files (layers at x,y, or a --map's cells) into one frame of OUT, bringing their keys and variants into OUT's palette. Add --rekey when two sources (or a source and OUT) use the same key letter for different colors: E_KEY_CONFLICT says so.

Copy a frame under a new id, placed after its animation's last frame, to edit the copy; or a whole group under a new name, with its timing, pivots and @anim line (dup hero.px:walk/right walk/left).

Write an animation's timing and pivot on its @anim line (or one frame's), or mark it @still.

List a file's palette and what each variant does; or edit it: add keys and variants, derive a night or dusk, hoist, import, remove, order, comment, export.

Draw a line of a palette key between two points (Bresenham), --width N wide.

A 1px border, or filled

Draw a closed polygon through the points, optionally --fill'ed.

Draw a symmetric pixel ellipse (or circle), optionally --fill'ed; .5 centers give even sizes.

Draw part of a circle, from angle a0 to a1 (a smear or swoosh), --width N wide.

Bucket-fill the region of one key that touches x,y.

Turn frames clockwise (a WxH frame becomes HxW)

Mirror across the top-left/bottom-right diagonal

Re-shade a material with a darkest-to-lightest ramp, by how each pixel faces the light.

Outline a frame's shape with a key, optionally lit on the side facing the light (--lit).

Write frames as PNGs (--frames), an Aseprite sheet and JSON (--aseprite) or a Tiled tileset (--tiled), from files or whole folders; or compile a world (world.src.json and its .map rooms) to Tiled maps and a .world (--tiled).

Convert PNGs (loose, a pack with a labels CSV, or one sheet sliced by --grid) to .px with exact pixels.

The reference: all of it, a topic, one command, or the seven worked recipes.