Rletopnm User Manual(1) General Commands Manual Rletopnm User Manual(1)
NAME
rletopnm - convert a Utah Raster Tools RLE image file to a PNM image
file.
SYNOPSIS
rletopnm
[--alphaout={alpha-filename,-}] [--headerdump|-h]
[--verbose|-v]
[rlefile|-]
All options may be abbreviated to their minimum unique abbreviation and
options and arguments may be in any order.
DESCRIPTION
This program is part of Netpbm(1).
rletopnm converts Utah Raster Toolkit RLE image files to 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
In addition to the options common to all programs based on libnetpbm
(most notably -quiet, see ]8;;index.html#commonoptions\ Common Options]8;;\ ), rletopnm recognizes the
following command line options:
--alphaout=alpha-filename
rletopnm creates a PGM (portable graymap) file containing the
transparency channel values in the input image. If the input im-
age doesn't contain an transparency channel, the alpha-filename
file contains all zero (transparent) transparency values. If you
don't specify --alphaout, rletopnm does not generate a trans-
parency file, and if the input image has a transparency channel,
rletopnm simply discards it.
If you specify - as the filename, rletopnm writes the trans-
parency output to Standard Output and discards the image.
See pamcomp(1) for one way to use the transparency 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.
EXAMPLES
• While running in verbose mode, convert lenna.rle to PPM format
and store the resulting image as lenna.ppm:
rletopnm --verbose lenna.rle >lenna.ppm
• Dump the header information of the RLE file called file.rle:
rletopnm --headerdump file.rle
• Convert RLE file dart.rle to PPM format as dart.ppm. Store the
transparency channel of dart.rle as dartalpha.pgm (if dart.rle
doesn't have a transparency channel, store a fully transparent
transparency mask as dartalpha.pgm):
rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
SEE ALSO
pnmtorle(1), pnmconvol(1), pnm(1), ppm(1), pgm(1),
AUTHOR
Wes Barris Army High Performance Computing Research Center (AHPCRC) Min-
nesota Supercomputer Center, Inc.
Modifications by Eric Haines to produce raw and plain formats.
Modifications by Bryan Henderson to create transparency files and use
mnemonic options.
DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
http://netpbm.sourceforge.net/doc/rletopnm.html
netpbm documentation 13 April 2000 Rletopnm User Manual(1)
Generated by dwww version 1.16 on Tue Dec 16 06:30:09 CET 2025.