rletopnm(1) [redhat man page]

RLETOPNM(1)						      General Commands Manual						       RLETOPNM(1)

NAME

       rletopnm - convert a Utah Raster Tools RLE image file into a PNM image file.

SYNOPSIS

       rletopnm [--alphaout={alpha-filename,-}] [--headerdump|-h] [--verbose|-v] [--plain|-p] [rlefile|-]

       All options may be abbreviated to their minimum unique abbreviation and options and arguments may be in any order.

DESCRIPTION

       This program converts Utah Raster Toolkit RLE image files into 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

       --alphaout=alpha-filename
	      rletopnm	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 alpha-filename file contains all zero (transparent) alpha values.  If you  don't  specify  --alphaout,
	      rletopnm does not generate an alpha file, and if the input image has an alpha channel, rletopnm simply discards it.

	      If you specify - as the filename, rletopnm writes the alpha output to Standard Output and discards the image.

	      See pnmcomp(1) for one way to use the alpha 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.

       --plain
	      This option causes the PNM output file to be in the "plain" (text) format, instead of the default "raw" (binary) format.	See ppm(5)
	      and pgm(5) for details on the difference.

EXAMPLES

       rletopnm --verbose lenna.rle >lenna.ppm
	      While running in verbose mode, convert lenna.rle to PPM format and store the resulting image as lenna.ppm.

       rletopnm --headerdump file.rle
	      Dump the header information of the RLE file called file.rle.

       rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
	      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).

SEE ALSO

       pnmtorle(1), pnmconvol(1), pnm(5), ppm(5), pgm(5), urt(1), RLE(5)

AUTHOR

       Wes Barris
       Army High Performance Computing Research Center (AHPCRC)
       Minnesota Supercomputer Center, Inc.

       Modifications by Eric Haines to support raw and plain formats.

       Modifications by Bryan Henderson to create alpha files and use mnemonic options.

1								   13 April 2000						       RLETOPNM(1)

Check Out this Related Man Page

PNMTORLE(1)						      General Commands Manual						       PNMTORLE(1)

NAME

       pnmtorle - convert a Netpbm image file into an RLE image file.

SYNOPSIS

       pnmtorle [ -h ] [ -v ] [ -a ] [ -o outfile ] [ pnmfile ]

DESCRIPTION

       This  program  converts	Netpbm image files into Utah RLE(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.

       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 pip-
       ing the output of this program into the Utah mcut(1) or rlequant(1) utilities.  An example of this is shown later.

OPTIONS

       -v     This  option will cause pnmtorle to operate in verbose mode.  The header information is written to "stderr".  Actually, there is not
	      much header information stored in a Netpbm file, so this information is minimal.

       -h     This option allows the header of the Netpbm image to be dumped to "stderr" without converting the file.  It is equivalent  to  using
	      the -v option except that no file conversion takes place.

       -a     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.

       -o outfile
	      If specified, the output will be written to this file.  If outfile is "-", or if it is not specified, the output will be written	to
	      the standard output stream.

       pnmfile
	      The name of the Netpbm image data file to be converted.  If not specified, standard input is assumed.

EXAMPLES

       pnmtorle -v file.ppm -o file.rle
	      While running in verbose mode, convert file.ppm to RLE format and store resulting data in file.rle.

       pnmtorle -h file.pgm
	      Dump the header information of the Netpbm file called file.pgm.

SEE ALSO

       rletopnm(1), urt(1), RLE(5).

AUTHOR

       Wes Barris
       Army High Performance Computing Research Center (AHPCRC)
       Minnesota Supercomputer Center, Inc.

1								  March 31, 1994						       PNMTORLE(1)

Linux and UNIX Man Pages

rletopnm(1) [redhat man page]

Check Out this Related Man Page