196 lines
4.8 KiB
HTML
196 lines
4.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of RLETOPNM</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>RLETOPNM</H1>
|
|
Section: User Commands (1)<BR>Updated: 13 April 2000<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
rletopnm - convert a Utah Raster Tools RLE image file into a PNM image file.
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>rletopnm</B>
|
|
|
|
[<B>--alphaout=</B>{<I>alpha-filename</I>,<B>-</B>}]
|
|
[<B>--headerdump</B>|<B>-h</B>]
|
|
|
|
[<B>--verbose</B>|<B>-v</B>]
|
|
|
|
[<B>--plain</B>|<B>-p</B>]
|
|
|
|
[<I>rlefile</I>|<I></I><B>-</B>]
|
|
|
|
<P>
|
|
All options may be abbreviated to their minimum unique abbreviation and
|
|
options and arguments may be in any order.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
This program converts Utah Raster Toolkit RLE image files into PNM
|
|
image files.
|
|
<B>rletopnm</B>
|
|
|
|
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).
|
|
<B>rletopnm</B>
|
|
|
|
generates a PPM file for all these cases except for the Grayscale file, for
|
|
which
|
|
<B>rletopnm</B>
|
|
|
|
generates a PGM file.
|
|
<P>
|
|
<I>rlefile</I>
|
|
|
|
is the RLE input file. If it is absent or
|
|
<B>-</B>,
|
|
|
|
the input comes from Standard Input.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>--alphaout=</B><I>alpha-filename</I>
|
|
|
|
<DD>
|
|
<B>rletopnm </B>
|
|
|
|
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
|
|
<I>alpha-filename</I>
|
|
|
|
file contains all zero (transparent) alpha values. If you don't specify
|
|
<B>--alphaout</B>,
|
|
|
|
<B>rletopnm</B>
|
|
|
|
does not generate an alpha file, and if the input image has an alpha channel,
|
|
<B>rletopnm</B>
|
|
|
|
simply discards it.
|
|
<P>
|
|
If you specify
|
|
<B>-</B>
|
|
|
|
as the filename,
|
|
<B>rletopnm</B>
|
|
|
|
writes the alpha output to Standard Output and discards the image.
|
|
<P>
|
|
See
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmcomp">pnmcomp</A></B>(1)
|
|
|
|
for one way to use the alpha output file.
|
|
<DT id="2"><B>--verbose</B>
|
|
|
|
<DD>
|
|
This option causes
|
|
<B>rletopnm </B>
|
|
|
|
to operate in verbose mode. It prints messages about what it's doing,
|
|
including the contents of the RLE image header, to Standard Error.
|
|
<DT id="3"><B>--headerdump</B>
|
|
|
|
<DD>
|
|
This option causes
|
|
<B>rletopnm</B>
|
|
|
|
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.
|
|
<DT id="4"><B>--plain</B>
|
|
|
|
<DD>
|
|
This option causes the PNM output file to be in the "plain" (text) format,
|
|
instead of the default "raw" (binary) format. See
|
|
<B><A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A></B>(5)
|
|
|
|
and
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pgm">pgm</A></B>(5)
|
|
|
|
for details on the difference.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><B>rletopnm --verbose lenna.rle >lenna.ppm</B>
|
|
|
|
<DD>
|
|
While running in verbose mode, convert lenna.rle to PPM format and
|
|
store the resulting image as lenna.ppm.
|
|
<DT id="6"><B>rletopnm --headerdump file.rle</B>
|
|
|
|
<DD>
|
|
Dump the header information of the RLE file called file.rle.
|
|
<DT id="7"><B>rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm</B>
|
|
|
|
<DD>
|
|
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).
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmtorle">pnmtorle</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmconvol">pnmconvol</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pgm">pgm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+urt">urt</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+RLE">RLE</A></B>(5)
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<BR>
|
|
|
|
Wes Barris
|
|
<BR>
|
|
|
|
Army High Performance Computing Research Center (AHPCRC)
|
|
<BR>
|
|
|
|
Minnesota Supercomputer Center, Inc.
|
|
<P>
|
|
Modifications by Eric Haines to support raw and plain formats.
|
|
<P>
|
|
Modifications by Bryan Henderson to create alpha files and use mnemonic
|
|
options.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="8"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="9"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="10"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="11"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="12"><A HREF="#lbAF">EXAMPLES</A><DD>
|
|
<DT id="13"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="14"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:26 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|