pxart line

line FILE[:frame] KEY x0,y0 x1,y1 [--width N]

usage: pxart line [-h] [--width WIDTH] [-o O] [--dry-run] file key p0 p1

  line FILE[:frame] KEY x0,y0 x1,y1 [--width N]
      Draw a line of a palette key between two points (Bresenham), --width N wide.

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

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

      Bresenham: one pixel per step along the longer axis, 8-connected, no doubled corners;
      the same pixels whichever end comes first (0,0 8,2 is three runs of 3). --width N
      paints N px across the line (down for a mostly-horizontal line, right for a mostly-
      vertical one), centered, the odd pixel down/right.

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 line. The other drawing commands and their shared notes are in pxart help DRAWING.