xenial (1) rletopnm.1.gz

NAME

       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 containing 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 header to Standard Error, but does not produce any 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 formats.

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