Manual: rletopnm

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	  Common Options  ),
       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 image doesn't contain an transparency channel, the alpha-filename file contains all zero (trans‐
	      parent) transparency values.  If you don't specify --alphaout, rletopnm does not generate a transparency file,
	      and if the input image has a transparency channel, rletopnm simply discards it.

	      If you specify - as the filename, rletopnm writes the transparency 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  dartal‐
	      pha.pgm  (if dart.rle doesn't have a transparency channel, store a fully transparent transparency mask as dar‐
	      talpha.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) Minnesota 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)