RLETOPNM
Section: User Commands (1)
Updated: 13 April 2000
Index
Return to Main Contents
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.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 08:55:10 GMT, December 16, 2021