1Rletopnm User Manual(0)                                Rletopnm User Manual(0)
2
3
4

NAME

6       rletopnm  -  convert  a Utah Raster Tools RLE image file to a PNM image
7       file.
8
9

SYNOPSIS

11       rletopnm
12
13       [--alphaout={alpha-filename,-}] [--headerdump|-h]
14
15       [--verbose|-v]
16
17       [rlefile|-]
18
19       All options may be abbreviated to their minimum unique abbreviation and
20       options and arguments may be in any order.
21
22

DESCRIPTION

24       This program is part of Netpbm(1).
25
26       rletopnm  converts  Utah  Raster  Toolkit  RLE image files to PNM image
27       files.  rletopnm handles four types of  RLE  files:  Grayscale  (8  bit
28       data,  no  color map), Pseudocolor (8 bit data with a color map), True‐
29       color (24 bit data with color map), and Directcolor (24  bit  data,  no
30       color  map).   rletopnm generates a PPM file for all these cases except
31       for the Grayscale file, for which rletopnm generates a PGM file.
32
33       rlefile is the RLE input file.  If it is absent or -, the  input  comes
34       from Standard Input.
35
36

OPTIONS

38       --alphaout=alpha-filename
39              rletopnm   creates  a PGM (portable graymap) file containing the
40              alpha channel values in the input image.   If  the  input  image
41              doesn't  contain  an alpha channel, the alpha-filename file con‐
42              tains all zero (transparent) alpha values.  If you don't specify
43              --alphaout, rletopnm does not generate an alpha file, and if the
44              input image has an alpha channel, rletopnm simply discards it.
45
46              If you specify - as the filename, rletopnm writes the alpha out‐
47              put to Standard Output and discards the image.
48
49              See pamcomp(1)foronewaytouse the alpha output file.
50
51
52       --verbose
53              This  option  causes  rletopnm   to operate in verbose mode.  It
54              prints messages about what it's doing, including the contents of
55              the RLE image header, to Standard Error.
56
57
58       --headerdump
59              This  option causes rletopnm to operate in header dump mode.  It
60              prints the contents of the RLE image header to  Standard  Error,
61              but does not produce any other output.
62
63
64
65

EXAMPLES

67       ·      While  running  in verbose mode, convert lenna.rle to PPM format
68              and store the resulting image as lenna.ppm:
69
70                  rletopnm --verbose lenna.rle >lenna.ppm
71
72
73       ·      Dump the header information of the RLE file called file.rle:
74
75                  rletopnm --headerdump file.rle
76
77
78       ·      Convert RLE file dart.rle to PPM format as dart.ppm.  Store  the
79              alpha  channel of dart.rle as dartalpha.pgm (if dart.rle doesn't
80              have an alpha channel, store a fully transparent alpha  mask  as
81              dartalpha.pgm):
82
83                  rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
84
85
86
87

SEE ALSO

89       pnmtorle(1), pnmconvol(1), pnm(1), ppm(1), pgm(1),
90
91

AUTHOR

93       Wes  Barris  Army  High  Performance Computing Research Center (AHPCRC)
94       Minnesota Supercomputer Center, Inc.
95
96       Modifications by Eric Haines to support raw and plain formats.
97
98       Modifications by Bryan Henderson to create alpha files and use mnemonic
99       options.
100
101
102
103netpbm documentation             13 April 2000         Rletopnm User Manual(0)
Impressum