pxart sheet

sheet FILE|DIR... -o sheet.png [--scale 8] [--cols 8] [--grid] [--variant V] [--bg COLOR] [--fit] [--align bottom|pivot] [--rows cols|group|file] [--slots N|K=I] [--exclude GLOB] [--plain ...] [--dry-run]

usage: pxart sheet [-h] [-o O] [--scale SCALE] [--cols COLS] [--bg BG] [--grid] [--variant V]
                   [--slots N|K=I] [--fit] [--align {bottom,pivot}] [--rows {cols,group,file}]
                   [--plain] [--with-1x] [--cells CELLS.json] [--ticks N] [--dry-run]
                   [--exclude GLOB]
                   files [files ...]

  sheet FILE|DIR... -o sheet.png [--scale 8] [--cols 8] [--grid] [--variant V] [--bg COLOR]
        [--fit] [--align bottom|pivot] [--rows cols|group|file] [--slots N|K=I] [--exclude GLOB]
        [--plain ...] [--dry-run]
      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.

positional arguments:
  files

options:
  -h, --help                show this help message and exit
  -o O
  --scale SCALE
  --cols COLS
  --bg BG                   a flat color behind each frame (default: a grey checkerboard)
  --grid
  --variant V               draw every frame in V; each label says so (idle/0%night), as FILE%V's do, and an argument's own %VARIANT wins
  --slots N|K=I             draw the frames in N combinations of their slots' colors (the base, then others, the same every run), or with K=I,... those slots' colors by index, 0 the base: 'N,f=2' mixes both (help slots)
  --fit                     each cell its own frame's size, each row its tallest frame's
  --align {bottom,pivot}    pivot: line up each animation's frames by pivot, as anim does (default: bottom)
  --rows {cols,group,file}  group: one animation group per row; file: one input file per row; either wraps past --cols (default: --cols a row)
  --plain                   no text at all (no ids, sizes or color counts) and a fixed integer layout; PNG inputs placed as they are, unscaled
  --with-1x                 with --plain: each frame's true 1x beside its --scale copy
  --cells CELLS.json        with --plain: write a JSON sidecar of every image's rect (x, y, w, h), file, frame id and scale
  --ticks N                 with --plain: tick marks every N source px along each scaled copy's top and left edges, in the gutter
  --dry-run                 print the readout and each output's size and layout, write nothing ('(dry run; nothing written)'); -o may be left off
  --exclude GLOB            leave out files whose name or path under DIR matches GLOB, or under a matching directory (repeatable)

      Compare any mix of .px/.png frames, labeled with id, WxH and color count. A directory
      stands for every .px under it, recursively, sorted by path (PNGs in it are left out, a
      sheet rendered there too). --exclude GLOB (repeatable) leaves files out: one whose
      name or path under the directory matches ('_*.px', 'wip/*.px'), or every file under a
      directory that does ('wip'). A glob that leaves out every file is E_FILE. A palette
      file (no frames) among the inputs, a directory's or a glob's, is skipped with a note
      ('note: sheet skips palette.px: a palette file, no frames'); given alone it is
      E_NO_FRAMES. Every cell is the largest frame's size (a frame over 8x the median
      frame's area gets a note); --fit makes each cell its own frame's width (or its
      label's, if wider) and each row as tall as its tallest frame, --cols cells to a row,
      frames bottom-aligned in their row. A PNG whose four corners are exactly the --bg
      color (a scene rendered with the same --bg) doesn't count that color: it's the
      backdrop. Frames with the same id from different files are labeled with their file's
      stem in front (hero:idle/0, beast:idle/0); render and anim label them the same way.
      --align pivot lines up each animation group's frames by pivot, as anim and onion do
      (default: bottom-aligned in the cell).
      --rows group starts a row for each animation group (one file's walk/down, then its
      walk/up, ...; a file's top-level frames share one; a PNG has its own) and wraps within
      a group only when it has more than --cols frames: 'sheet party.px --fit --rows group
      --align pivot -o party.png' is one walk per row. The default, --rows cols, fills each
      row with --cols frames; --rows file, a row per input file. --plain: no text, a fixed
      layout ('pxart help plain').

See also, in pxart help all: FORMAT: variants (@variant, %VARIANT); LOOKING: centering
  (frames of different sizes, --bg, --dry-run).

pxart help all has the whole reference, pxart help TOPIC one part of it.

This is the output of pxart help sheet. The other looking commands and their shared notes are in pxart help LOOKING.