rletopnm - convert a Utah Raster Tools RLE image file into
       a PNM image file.


SYNOPSIS

       rletopnm [--alphaout={alpha-filename,-}] [--headerdump|-h]
       [--verbose|-v] [--plain|-p] [rlefile|-]

       All  options  may  be  abbreviated to their minimum unique
       abbreviation and options  and  arguments  may  be  in  any
       order.


DESCRIPTION

       This  program converts Utah Raster Toolkit RLE image files
       into PNM image files.  rletopnm handles four types of  RLE
       files:  Grayscale  (8 bit data, no color map), Pseudocolor
       (8 bit data with a color map), Truecolor (24 bit data with
       color  map),  and Directcolor (24 bit data, no color map).
       rletopnm generates a PPM file for all these  cases  except
       for the Grayscale file, for which rletopnm generates a PGM
       file.

       rlefile is the RLE input file.  If it is absent or -,  the
       input comes from Standard Input.


OPTIONS

       --alphaout=alpha-filename
              rletopnm creates a PGM (portable graymap) file con­
              taining the  alpha  channel  values  in  the  input
              image.  If the input image doesn't contain an alpha
              channel, the alpha-filename file contains all  zero
              (transparent)  alpha  values.  If you don't specify
              --alphaout, rletopnm does  not  generate  an  alpha
              file,  and if the input image has an alpha channel,
              rletopnm simply discards it.

              If you specify - as the filename,  rletopnm  writes
              the  alpha  output  to Standard Output and discards
              the image.

              See pnmcomp(1) for one way to use the alpha  output
              file.

       --verbose
              This  option  causes rletopnm to operate in verbose
              mode.  It prints messages about  what  it's  doing,
              including  the contents of the RLE image header, to
              Standard Error.

       --headerdump
              This option causes rletopnm to  operate  in  header
              dump mode.  It prints the contents of the RLE image

              other output.

       --plain
              This option causes the PNM output file to be in the
              "plain" (text) format, instead of the default "raw"
              (binary) format.  See ppm(5) and pgm(5) for details
              on the difference.


EXAMPLES

       rletopnm --verbose lenna.rle >lenna.ppm
              While running in verbose mode, convert lenna.rle to
              PPM   format  and  store  the  resulting  image  as
              lenna.ppm.

       rletopnm --headerdump file.rle
              Dump the header information of the RLE file  called
              file.rle.

       rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
              Convert   RLE   file  dart.rle  to  PPM  format  as
              dart.ppm.  Store the alpha channel of  dart.rle  as
              dartalpha.pgm  (if  dart.rle  doesn't have an alpha
              channel, store a fully transparent  alpha  mask  as
              dartalpha.pgm).


SEE ALSO

       pnmtorle(1), pnmconvol(1), pnm(5), ppm(5), pgm(5), urt(1),
       RLE(5)


AUTHOR

       Wes Barris
       Army High Performance Computing Research Center (AHPCRC)
       Minnesota Supercomputer Center, Inc.

       Modifications by Eric Haines to support raw and plain for­
       mats.

       Modifications by Bryan Henderson to create alpha files and
       use mnemonic options.


Man(1) output converted with man2html