CLI reference › PixelLab utilities

font

pixelkiln font --description "warm orange arcade font" --weight Bold --glyph-px 16 --out fonts/arcade

Generates a pixel font with PixelLab's /generate-font-pro and writes two files: <out>.ttf, ready to load in an engine, and <out>.png, the 80-glyph atlas (A-Z, a-z, 0-9, and common game-UI punctuation). A trailing .ttf or .png on --out is treated as part of the base, so --out fonts/arcade.ttf writes the same two files.

  • --weight is Bold or Regular (default); --glyph-px is the native glyph size, 8, 16 (default), 32, or 64; --name sets the font family name (PixelLab otherwise uses the description plus the weight).
  • Costs PixelLab's documented 25 generations, not yet confirmed against a live bill. The command prints that and asks first; --yes skips the question, --budget <n> refuses when n is below it, and --dry-run sends nothing.
  • It waits for the job (PixelLab documents 30-80 s) and then downloads both files. Existing files are replaced only with --force.

A font is deliberately not a manifest generator: it has no style suffix to share, no prompt-per-asset, no candidates to pick, and its main output is not an image, so there is nothing for the lockfile's provenance model to hold.