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