<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> <HTML><HEAD><TITLE>Rletopnm User Manual</TITLE></HEAD> <BODY> <H1>RLETOPNM</H1> Updated: 13 April 2000 <BR> <A HREF="#index">Table Of Contents</A> <H2>NAME</H2> rletopnm - convert a Utah Raster Tools RLE image file to a PNM image file. <H2 id="synopsis">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>] [<I>rlefile</I>|<B>-</B>] <P>All options may be abbreviated to their minimum unique abbreviation and options and arguments may be in any order. <H2 id="description">DESCRIPTION</H2> <p>This program is part of <a href="index.html">Netpbm</a>. <p><b>rletopnm</b> converts Utah Raster Toolkit RLE image files to 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. <H2 id="options">OPTIONS</H2> <DL COMPACT> <DT><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="pamcomp.html">pamcomp</A></B> for one way to use the alpha output file. <DT><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><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. </DL> <H2 id="examples">EXAMPLES</H2> <ul> <li>While running in verbose mode, convert lenna.rle to PPM format and store the resulting image as lenna.ppm: <pre> <kbd> rletopnm --verbose lenna.rle >lenna.ppm </kbd> </pre> <li>Dump the header information of the RLE file called file.rle: <pre> <kbd> rletopnm --headerdump file.rle </kbd> </pre> <li>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): <pre> <kbd> rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm </kbd> </pre> </ul> <H2 id="seealso">SEE ALSO</H2> <B><A HREF="pnmtorle.html">pnmtorle</A></B>, <B><A HREF="pnmconvol.html">pnmconvol</A></B>, <B><A HREF="pnm.html">pnm</A></B>, <B><A HREF="ppm.html">ppm</A></B>, <B><A HREF="pgm.html">pgm</A></B>, <H2 id="author">AUTHOR</H2> 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. <HR> <A NAME="index"> </A> <H2>Table Of Contents</H2> <UL> <LI><A HREF="#synopsis">SYNOPSIS</A> <LI><A HREF="#description">DESCRIPTION</A> <LI><A HREF="#options">OPTIONS</A> <LI><A HREF="#examples">EXAMPLES</A> <LI><A HREF="#seealso">SEE ALSO</A> <LI><A HREF="#author">AUTHOR</A> </UL> </BODY> </HTML>