RLETOPNM(1) General Commands Manual RLETOPNM(1)
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 argu-
ments 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 al-
pha-filename file contains all zero (transparent) alpha values. If you don't spec-
ify --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 Out-
put 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 re-
sulting 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.
1 13 April 2000 RLETOPNM(1)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-21 17:31 @216.73.216.164 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)