Penguin
Recent Changes
Annotated edit history of rletopnm(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 RLETOPNM
2 !!!RLETOPNM
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 EXAMPLES
8 SEE ALSO
9 AUTHOR
10 ----
11 !!NAME
12
13
14 rletopnm - convert a Utah Raster Tools RLE image file into a PNM image file.
15 !!SYNOPSIS
16
17
18 __rletopnm__
19 [[__--alphaout=__{''alpha-filename'',__-__}]
20 [[__--headerdump__|__-h__] [[__--verbose__|__-v__]
21 [[__--plain__|__-p__]
22 [[''rlefile''|__-__]
23
24
25 All options may be abbreviated to their minimum unique
26 abbreviation and options and arguments may be in any
27 order.
28 !!DESCRIPTION
29
30
31 This program converts Utah Raster Toolkit RLE image files
32 into PNM image files. __rletopnm__ handles four types of
33 RLE files: Grayscale (8 bit data, no color map), Pseudocolor
34 (8 bit data with a color map), Truecolor (24 bit data with
35 color map), and Directcolor (24 bit data, no color map).
36 __rletopnm__ generates a PPM file for all these cases
37 except for the Grayscale file, for which __rletopnm__
38 generates a PGM file.
39
40
41 ''rlefile'' is the RLE input file. If it is absent or
42 __-__, the input comes from Standard Input.
43 !!OPTIONS
44
45
46 __--alphaout=__''alpha-filename''
47
48
49 __rletopnm__ creates a PGM (portable graymap) file
50 containing the alpha channel values in the input image. If
51 the input image doesn't contain an alpha channel, the
52 ''alpha-filename'' file contains all zero (transparent)
53 alpha values. If you don't specify __--alphaout__,
54 __rletopnm__ does not generate an alpha file, and if the
55 input image has an alpha channel, __rletopnm__ simply
56 discards it.
57
58
59 If you specify __-__ as the filename, __rletopnm__
60 writes the alpha output to Standard Output and discards the
61 image.
62
63
64 See pnmcomp(1) for one way to use the alpha output
65 file.
66
67
68 __--verbose__
69
70
71 This option causes __rletopnm__ to operate in verbose
72 mode. It prints messages about what it's doing, including
73 the contents of the RLE image header, to Standard
74 Error.
75
76
77 __--headerdump__
78
79
80 This option causes __rletopnm__ to operate in header dump
81 mode. It prints the contents of the RLE image header to
82 Standard Error, but does not produce any other
83 output.
84
85
86 __--plain__
87
88
89 This option causes the PNM output file to be in the
90 ppm__(5) and
91 pgm(5) for details on the difference.
92 !!EXAMPLES
93
94
95 __rletopnm --verbose lenna.rle
96 __
97
98
99 While running in verbose mode, convert lenna.rle to PPM
100 format and store the resulting image as
101 lenna.ppm.
102
103
104 __rletopnm --headerdump file.rle__
105
106
107 Dump the header information of the RLE file called
108 file.rle.
109
110
111 __rletopnm --alphaout=dartalpha.pgm dart.rle
112 __
113
114
115 Convert RLE file dart.rle to PPM format as dart.ppm. Store
116 the alpha channel of dart.rle as dartalpha.pgm (if dart.rle
117 doesn't have an alpha channel, store a fully transparent
118 alpha mask as dartalpha.pgm).
119 !!SEE ALSO
120
121
122 pnmtorle(1), pnmconvol(1), pnm(5),
123 ppm(5), pgm(5), urt(1),
4 perry 124 RLE(5)
1 perry 125 !!AUTHOR
126
127
128 Wes Barris
129 Army High Performance Computing Research Center (AHPCRC)
130 Minnesota Supercomputer Center, Inc.
131
132
133 Modifications by Eric Haines to support raw and plain
134 formats.
135
136
137 Modifications by Bryan Henderson to create alpha files and
138 use mnemonic options.
139 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.