1Rletopnm User Manual(0) Rletopnm User Manual(0)
2
3
4
6 rletopnm - convert a Utah Raster Tools RLE image file to a PNM image
7 file.
8
9
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
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
38 In addition to the options common to all programs based on libnetpbm
39 (most notably -quiet, see
40 Common Options ⟨index.html#commonoptions⟩ ), rletopnm recognizes the
41 following command line options:
42
43
44
45 --alphaout=alpha-filename
46 rletopnm creates a PGM (portable graymap) file containing the
47 transparency channel values in the input image. If the input
48 image doesn't contain an transparency channel, the alpha-file‐
49 name file contains all zero (transparent) transparency values.
50 If you don't specify --alphaout, rletopnm does not generate a
51 transparency file, and if the input image has a transparency
52 channel, rletopnm simply discards it.
53
54 If you specify - as the filename, rletopnm writes the transpar‐
55 ency output to Standard Output and discards the image.
56
57 See pamcomp(1) for one way to use the transparency output file.
58
59
60 --verbose
61 This option causes rletopnm to operate in verbose mode. It
62 prints messages about what it's doing, including the contents of
63 the RLE image header, to Standard Error.
64
65
66 --headerdump
67 This option causes rletopnm to operate in header dump mode. It
68 prints the contents of the RLE image header to Standard Error,
69 but does not produce any other output.
70
71
72
73
75 • While running in verbose mode, convert lenna.rle to PPM format
76 and store the resulting image as lenna.ppm:
77
78 rletopnm --verbose lenna.rle >lenna.ppm
79
80
81
82 • Dump the header information of the RLE file called file.rle:
83
84 rletopnm --headerdump file.rle
85
86
87
88 • Convert RLE file dart.rle to PPM format as dart.ppm. Store the
89 transparency channel of dart.rle as dartalpha.pgm (if dart.rle
90 doesn't have a transparency channel, store a fully transparent
91 transparency mask as dartalpha.pgm):
92
93 rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm
94
95
96
97
98
100 pnmtorle(1), pnmconvol(1), pnm(1), ppm(1), pgm(1),
101
102
104 Wes Barris Army High Performance Computing Research Center (AHPCRC)
105 Minnesota Supercomputer Center, Inc.
106
107 Modifications by Eric Haines to produce raw and plain formats.
108
109 Modifications by Bryan Henderson to create transparency files and use
110 mnemonic options.
111
113 This manual page was generated by the Netpbm tool 'makeman' from HTML
114 source. The master documentation is at
115
116 http://netpbm.sourceforge.net/doc/rletopnm.html
117
118netpbm documentation 13 April 2000 Rletopnm User Manual(0)