pxart poly

poly FILE[:frame] KEY x,y x,y x,y ... [--fill]

usage: pxart poly [-h] [--fill] [-o O] [--dry-run] file key points [points ...]

  poly FILE[:frame] KEY x,y x,y x,y ... [--fill]
      Draw a closed polygon through the points, optionally --fill'ed.

positional arguments:
  file
  key         a palette key, or '.' to erase
  points

options:
  -h, --help  show this help message and exit
  --fill
  -o O
  --dry-run   print what the edit says and a diff of the file it would change; write nothing

      A closed polygon through the points in order: line's pixels from each point to the
      next and from the last back to the first (1px, the same whichever way round it goes).
      --fill adds every pixel whose center is inside (nonzero winding: a self-crossing star
      is solid). Two points are a line.

See also, in pxart help all: DRAWING (FILE[:SEL], KEY ('.' erases), clipping, 'painted N
  px'); EDITING (-o OUT gets the whole file, only changed lines are rewritten, 'no change');
  FORMAT: selecting frames (FILE:SEL, an unnamed grid's name, zsh's "${F}:sel").

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

This is the output of pxart help poly. The other drawing commands and their shared notes are in pxart help DRAWING.