man-pages/man1/pnmtorle.1.html
2021-03-31 01:06:50 +01:00

148 lines
3.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of PNMTORLE</TITLE>
</HEAD><BODY>
<H1>PNMTORLE</H1>
Section: User Commands (1)<BR>Updated: March 31, 1994<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pnmtorle - convert a Netpbm image file into an RLE image file.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pnmtorle</B>
[
<B>-h</B>
] [
<B>-v</B>
] [
<B>-a</B>
] [
<B>-o</B><I> outfile</I>
] [
<I>pnmfile</I>
]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
This program converts Netpbm image files into Utah
<B><A HREF="/cgi-bin/man/man2html?5+RLE">RLE</A></B>(5)
image files. You can include an alpha mask. If the input is a multiple
image file, the output consists of several concatenated RLE images.
<P>
The RLE file will contain either a three channel color image (24 bits) or
a single channel grayscale image (8 bits) depending upon the pnm file depth.
If a converted ppm is displayed on an 8 bit display, the image must be
dithered. In order to produce a better looking image (on 8 bit displays),
it is recommended that the image be quantizing (to 8 bit mapped color) prior
to its display. This may be done by piping the output of this program into
the Utah
<B><A HREF="/cgi-bin/man/man2html?1+mcut">mcut</A></B>(1)
or
<B><A HREF="/cgi-bin/man/man2html?1+rlequant">rlequant</A></B>(1)
utilities.
An example of this is shown later.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-v</B>
<DD>
This option will cause pnmtorle to operate in verbose mode. The header
information is written to &quot;stderr&quot;. Actually, there is not much header
information stored in a Netpbm file, so this information is minimal.
<DT id="2"><B>-h</B>
<DD>
This option allows the header of the Netpbm image to be dumped to &quot;stderr&quot;
without converting the file. It is equivalent to using the -v option except
that no file conversion takes place.
<DT id="3"><B>-a</B>
<DD>
This option causes pnmtorle to include an alpha channel in the output
image. The alpha channel is based on the image: Wherever a pixel
is black, the corresponding alpha value is transparent. Everywhere
else, the alpha value is fully opaque.
<DT id="4"><B>-o</B><I> outfile</I>
<DD>
If specified, the output will be written to this file. If
<I>outfile</I>
is &quot;-&quot;, or if it is not specified, the output will be written to the
standard output stream.
<DT id="5"><I>pnmfile</I>
<DD>
The name of the Netpbm image data file to be converted. If not specified,
standard input is assumed.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>EXAMPLES</H2>
<DL COMPACT>
<DT id="6">pnmtorle -v file.ppm -o file.rle<DD>
While running in verbose mode, convert file.ppm to RLE format and store
resulting data in file.rle.
<DT id="7">pnmtorle -h file.pgm<DD>
Dump the header information of the Netpbm file called file.pgm.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+rletopnm">rletopnm</A></B>(1),
<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">&nbsp;</A>
<H2>AUTHOR</H2>
<BR>
Wes Barris
<BR>
Army High Performance Computing Research Center (AHPCRC)
<BR>
Minnesota Supercomputer Center, Inc.
<P>
<HR>
<A NAME="index">&nbsp;</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:24 GMT, March 31, 2021
</BODY>
</HTML>