ohrrpgce-picture
v1.1.2
Published
Read/write OHRRPGCE pictures
Downloads
5
Readme
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.