pnmtorle - convert a Netpbm image file into an RLE image
file.
SYNOPSIS
pnmtorle [ -h ] [ -v ] [ -a ] [ -o outfile ] [ pnmfile ]
DESCRIPTION
This program converts Netpbm image files into Utah RLE(5)
image files. You can include an alpha mask. If the input
is a multiple image file, the output consists of several
concatenated RLE images.
The RLE file will contain either a three channel color
image (24 bits) or a single channel grayscale image (8
bits) depending upon the pnm file depth. If a converted
ppm is displayed on an 8 bit display, the image must be
dithered. In order to produce a better looking image (on
8 bit displays), it is recommended that the image be quan
tizing (to 8 bit mapped color) prior to its display. This
may be done by piping the output of this program into the
Utah mcut(1) or rlequant(1) utilities. An example of this
is shown later.
OPTIONS
-v This option will cause pnmtorle to operate in ver
bose mode. The header information is written to
"stderr". Actually, there is not much header
information stored in a Netpbm file, so this infor
mation is minimal.
-h This option allows the header of the Netpbm image
to be dumped to "stderr" without converting the
file. It is equivalent to using the -v option
except that no file conversion takes place.
-a This option causes pnmtorle to include an alpha
channel in the output image. The alpha channel is
based on the image: Wherever a pixel is black, the
corresponding alpha value is transparent. Every
where else, the alpha value is fully opaque.
-o outfile
If specified, the output will be written to this
file. If outfile is "-", or if it is not speci
fied, the output will be written to the standard
output stream.
pnmfile
The name of the Netpbm image data file to be con
verted. If not specified, standard input is
assumed.
pnmtorle -v file.ppm -o file.rle
While running in verbose mode, convert file.ppm to
RLE format and store resulting data in file.rle.
pnmtorle -h file.pgm
Dump the header information of the Netpbm file
called file.pgm.
SEE ALSO
rletopnm(1), urt(1), RLE(5).
AUTHOR
Wes Barris
Army High Performance Computing Research Center (AHPCRC)
Minnesota Supercomputer Center, Inc.
Man(1) output converted with
man2html