bionic (1) pnmtorle.1.gz

NAME

       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 quantizing (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 verbose mode.  The header information is written to
              "stderr".  Actually, there is not much header  information  stored  in  a  Netpbm  file,  so  this
              information 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.
              Everywhere 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
              specified, the output will be written to the standard output stream.

       pnmfile
              The  name  of  the  Netpbm  image  data file to be converted.  If not specified, standard input is
              assumed.

EXAMPLES

       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.