Blame userguide/rletopnm.html

Packit 78deda
Packit 78deda
<HTML><HEAD><TITLE>Rletopnm User Manual</TITLE></HEAD>
Packit 78deda
<BODY>
Packit 78deda

RLETOPNM

Packit 78deda
Updated: 13 April 2000
Packit 78deda

Packit 78deda
Table Of Contents
Packit 78deda

NAME

Packit 78deda
Packit 78deda
rletopnm - convert a Utah Raster Tools RLE image file to a PNM image file.
Packit 78deda
Packit 78deda

SYNOPSIS

Packit 78deda
Packit 78deda
rletopnm
Packit 78deda
Packit 78deda
[--alphaout={alpha-filename,-}]
Packit 78deda
[--headerdump|-h]
Packit 78deda
Packit 78deda
[--verbose|-v]
Packit 78deda
Packit 78deda
[rlefile|-]
Packit 78deda
Packit 78deda

All options may be abbreviated to their minimum unique abbreviation

Packit 78deda
and options and arguments may be in any order.
Packit 78deda
Packit 78deda

DESCRIPTION

Packit 78deda
Packit 78deda

This program is part of Netpbm.

Packit 78deda
Packit 78deda

rletopnm converts Utah Raster Toolkit RLE image files to PNM

Packit 78deda
image files.  rletopnm handles four types of RLE files:
Packit 78deda
Grayscale (8 bit data, no color map), Pseudocolor (8 bit data with a
Packit 78deda
color map), Truecolor (24 bit data with color map), and Directcolor
Packit 78deda
(24 bit data, no color map).  rletopnm generates a PPM file for
Packit 78deda
all these cases except for the Grayscale file, for which
Packit 78deda
rletopnm generates a PGM file.
Packit 78deda
Packit 78deda

rlefile is the RLE input file. If it is absent or -,

Packit 78deda
the input comes from Standard Input.
Packit 78deda
Packit 78deda

OPTIONS

Packit 78deda
Packit 78deda
Packit 78deda
--alphaout=alpha-filename
Packit 78deda
Packit 78deda
Packit 78deda
rletopnm  creates a PGM (portable graymap) file containing the
Packit 78deda
transparency channel values in the input image.  If the input image doesn't
Packit 78deda
contain an transparency channel, the alpha-filename file contains all
Packit 78deda
zero (transparent) transparency values.  If you don't specify
Packit 78deda
--alphaout, rletopnm does not generate a transparency file,
Packit 78deda
and if the input image has a transparency channel, rletopnm simply
Packit 78deda
discards it.
Packit 78deda
Packit 78deda

If you specify - as the filename, rletopnm writes the

Packit 78deda
transparency output to Standard Output and discards the image.
Packit 78deda
Packit 78deda

See pamcomp for one way to use

Packit 78deda
the transparency output file.
Packit 78deda
Packit 78deda
--verbose
Packit 78deda
Packit 78deda
This option causes rletopnm to operate in verbose mode.
Packit 78deda
It prints messages about what it's doing, including the contents of
Packit 78deda
the RLE image header, to Standard Error.
Packit 78deda
Packit 78deda
--headerdump
Packit 78deda
Packit 78deda
This option causes rletopnm to operate in header dump mode.
Packit 78deda
It prints the contents of the RLE image header to Standard Error, but
Packit 78deda
does not produce any other output.
Packit 78deda
Packit 78deda
Packit 78deda
Packit 78deda

EXAMPLES

Packit 78deda
Packit 78deda
    Packit 78deda
  • While running in verbose mode, convert lenna.rle to PPM format and
  • Packit 78deda
    store the resulting image as lenna.ppm:
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
        rletopnm --verbose lenna.rle >lenna.ppm
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
  • Dump the header information of the RLE file called file.rle:
  • Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
        rletopnm --headerdump file.rle
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
  • Convert RLE file dart.rle to PPM format as dart.ppm. Store the
  • Packit 78deda
    transparency channel of dart.rle as dartalpha.pgm (if dart.rle doesn't have
    Packit 78deda
    a transparency channel, store a fully transparent transparency mask as
    Packit 78deda
    dartalpha.pgm):
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
        rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda

    SEE ALSO

    Packit 78deda
    Packit 78deda
    pnmtorle,
    Packit 78deda
    Packit 78deda
    pnmconvol,
    Packit 78deda
    Packit 78deda
    pnm,
    Packit 78deda
    Packit 78deda
    ppm,
    Packit 78deda
    Packit 78deda
    pgm,
    Packit 78deda
    Packit 78deda

    AUTHOR

    Packit 78deda
    Packit 78deda
    Wes Barris
    Packit 78deda

    Packit 78deda
    Packit 78deda
    Army High Performance Computing Research Center (AHPCRC)
    Packit 78deda

    Packit 78deda
    Packit 78deda
    Minnesota Supercomputer Center, Inc.
    Packit 78deda
    Packit 78deda

    Modifications by Eric Haines to support raw and plain formats.

    Packit 78deda
    Packit 78deda

    Modifications by Bryan Henderson to create transparency files and use

    Packit 78deda
    mnemonic options.
    Packit 78deda
    Packit 78deda

    Packit 78deda

    Table Of Contents

    Packit 78deda
      Packit 78deda
    • SYNOPSIS
    • Packit 78deda
    • DESCRIPTION
    • Packit 78deda
    • OPTIONS
    • Packit 78deda
    • EXAMPLES
    • Packit 78deda
    • SEE ALSO
    • Packit 78deda
    • AUTHOR
    • Packit 78deda
      Packit 78deda
      </BODY>
      Packit 78deda
      </HTML>