Reference · Editing

pxart shift

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

shift FILE [-o OUT] --dx N --dy N [--region x,y,w,h] [--wrap] [--fill KEY]
usage: pxart shift [-h] [-o O] [--dx DX] [--dy DY] [--region REGION] [--wrap] [--fill FILL]
                   [--dry-run]
                   file

  shift FILE [-o OUT] --dx N --dy N [--region x,y,w,h] [--wrap] [--fill KEY]
      Move a frame's pixels (or a region's) by dx,dy, dropping or wrapping what goes past the edge.

positional arguments:
  file

options:
  -h, --help       show this help message and exit
  -o O
  --dx DX
  --dy DY
  --region REGION
  --wrap
  --fill FILL      key for the pixels the shift leaves behind (default '.')
  --dry-run        print what the edit says and a diff of the file it would change; write nothing

      Move the frame's pixels (or only the region's) by dx,dy. Pixels moved past the frame's
      edge are dropped, and the pixels the move leaves behind (vacated) become '.', or KEY
      with --fill KEY (a floor under a moved prop). With --region the moved block may land
      outside the region; its '.' pixels don't overwrite what they land on.
      --wrap scrolls pixels around the edges (for animating tiles) instead of dropping them.

See also, in pxart help all: 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 shift. The other editing commands and their shared notes are in pxart help EDITING.

This page is built from site/src/data/reference.json in the repository.Edit on GitHub