ohrrpgce-picture v1.1.2

This program is public domain and is use for reading and writing pictures
in OHRRPGCE files.

The programs to read the pictures from the .RPG file are always taking the
RPG filename on the first command-line argument and data on stdout in
farbfeld format.

The prorgams to write the pictures into the .RPG file are also always
taking the RPG filename on the first command-line argument and reads the
data from stdin in farbfeld format. The picture must already be reduced to
the global palette if it is to be loaded; use read-mas.js to read the
global palette.

There is currently no RGFX support. When there is (once the RGFX format is
finalized), then the "reload-form" package will also be a dependency. (The
currently only dependency is "hamarc" package.)

(Note: These programs will refuse to work with passworded .RPG files, and
will also refuse to work with .RPG files with older password formats that
PW4 (even if they aren't passworded). It is easy enough to bypass this if
you really need to though.)

common-read.js
  Contains common code for the reading programs. (Not for executing
  directly; it is meant to be required by other program.)

common-write.js
  Contains common code for the writing programs. (Not for executing
  directly; it is meant to be required by other program.)

read-mas.js
  Read the master palette. If any non-empty second argument is given, then
  the output is a 16x16 picture, otherwise the hex codes for the colours
  are output, one per line.

read-mxs.js
  Read a MXS picture. Second argument is either "mxs" or "til" (it is case
  insensitive, though). Third argument is the number to indicate which
  picture from that group.

read-pt.js
  Read a PT# picture. Second argument is the group number (0 for hero
  graphics, 1 and 2 and 3 for enemy graphics, 4 for walkabouts, 5 for
  weapons, 6 for attacks, 7 for borders, and 8 for portraits), and the
  third argument is the number of the picture within that group. Further
  optional arguments can be "p" and a number for palette override, and
  can be "t" and a number for transparency by that colour index (you can
  also specify "t" without a number if index zero is transparent). The
  frames will be output in a vertical strip.

write-fnt.js
  Write a font; second and subsequence argument is not in use. The input
  is a vertical strip of 240 or 256 characters of 8x8 size each. Any
  transparent pixel is treated as a background pixel; opaque pixels are
  treated as foreground pixels regardless of colour. (You can use external
  programs such as ff-colorkey and ff-strip to convert the picture into
  the required format if it isn't already in such format.)

write-mxs.js
  Write a MXS picture. Arguments are same as read-mxs.js. It is possible
  to add new pictures with this, as well as replace existing pictures.

write-pt.js (not yet implemented; may change!)
  Write a PT# picture. Arguments are same as read-pt.js, but the
  transparency index is now zero by default without having to specify (if
  you don't want transparency, specify -1). The frames are expected to be
  in a vertical strip (use ff-strip to make it so if it isn't). If the
  palette to use is not specified, it will try to look for a suitable
  existing palette; if none exists, a new one is defined. You can also
  specify a "m" option to start the search for a suitable or new palette
  at a specified number. You can explicitly specify an incomplete palette
  in order to add to that palette as needed.