Debian Codegraph @

upstream/debian-unstable/man1/ilbmtoppm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ilbmtoppm User Manual" 1 "12 November 2014" "netpbm documentation"
7
8 .SH NAME
9 ilbmtoppm - convert an ILBM file into a PPM image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBilbmtoppm\fP
15 [\fB-ignore\fP<chunkID>\fB]\fP
16 [
17 \fB-isham\fP | \fB-isnotham\fP |
18 \fB-isehb\fP | \fB-isnotehb\fP |
19 \fB-isdeep\fP | \fB-isnotdeep\fP
20 ]
21 [\fB-cmaponly\fP]
22 [\fB-adjustcolors\fP]
23 [\fB-transparent \fP\fIcolor\fP]
24 [\fB-maskfile\fP \fIfilename\fP
25 [\fB-verbose\fP]
26 [\fIILBMfile\fP]
27
28
29 .UN description
30 .SH DESCRIPTION
31 .PP
32 This program is part of
33 .BR "Netpbm" (1)\c
34 \&.
35 .PP
36 \fBilbmtoppm\fP reads an IFF ILBM file as input and produces a PPM
37 image as output. \fBilbmtoppm\fP can handle the following ILBM types:
38
39
40 .IP \(bu
41 Normal ILBMs with 1-16 planes.
42 .IP \(bu
43 Amiga Extra_Halfbrite (EHB)
44 .IP \(bu
45 Amiga HAM with 3-16 planes.
46 .IP \(bu
47 24 bit.
48 .IP \(bu
49 Multiplatte (normal or HAM) pictures.
50 .IP \(bu
51 Color map (BMHD + CMAP chunk only, nPlanes = 0).
52 .IP \(bu
53 Unofficial direct color. 1-16 planes for each color component.
54
55 .PP
56 \fBilbmtoppm\fP uses these ILBM chunks: BMHD, CMAP, CAMG (only HAM
57 & EHB flags used), PCHG, BODY unofficial DCOL chunk to identify
58 direct color ILBM. It ignores these chunks: GRAB, DEST, SPRT, CRNG,
59 CCRT, CLUT, DPPV, DRNG, EPSF. It ignores, but displays in verbose
60 mode, these: NAME, AUTH, (c), ANNO, DPI. It skips chunks whose type
61 it doesn't recognize.
62
63 .UN options
64 .SH OPTIONS
65 .PP
66 In addition to the options common to all programs based on libnetpbm
67 (most notably \fB-quiet\fP, see
68 .UR index.html#commonoptions
69 Common Options
70 .UE
71 \&), \fBilbmtoppm\fP recognizes the following
72 command line options:
73
74
75
76 .TP
77 \fB-transparent \fP\fIcolor\fP
78 This is the color that should "show through" in places where
79 the image is transparent.
80 .sp
81 \fIcolor\fP is like the
82 .UR libnetpbm_image.html#colorname
83 argument of the \fBpnm_parsecolor()\fP library routine
84 .UE
85 \&.
86
87 .TP
88 \fB-verbose\fP
89 Give some information about the ILBM file.
90
91 .TP
92 \fB-ignore\fP \fIchunkID\fP
93 Skip a chunk. \fIchunkID\fP is the 4-letter IFF chunk identifier
94 of the chunk to be skipped.
95
96 .TP
97 \fB-isham\fP | \fB-isehb\fP
98 Treat the input file as a HAM or Extra_Halfbrite picture, even if
99 these flags are not set in the CAMG chunk (or if there is no CAMG
100 chunk).
101
102 .TP
103 \fB-maskfile\fP \fIfilename\fP
104 This names a file for \fBilbmtoppm\fP to create with the image's
105 transparency mask. The mask file is a PBM image which maps to the input image
106 with white pixels representing transparent pixels in the image and black
107 pixels representing opaque pixels.
108 .sp
109 If you don't specify this, or the image does not contain transparency
110 information, \fBilbmtoppm\fP does not create a mask file.
111
112 .TP
113 \fB-cmaponly\fP
114 With this option, \fBilbmtoppm\fP generates a PPM of the ILBM's \fIcolor
115 map\fP, not the image itself.
116 .sp
117 \fBilbmtoppm\fP does the same thing even without \fB-cmaponly\fP if the
118 ILBM is a pure color map stream (it has a bitmap header with an \fInplanes\fP
119 value of zero or has no BODY chunk.
120
121 .TP
122 \fB-adjustcolors\fP
123 If all colors in the CMAP have a value of less then 16, ilbmtoppm
124 assumes a 4-bit colormap and gives a warning. With this option the
125 colormap is scaled to 8 bits.
126
127
128
129
130 .UN limitations
131 .SH LIMITATIONS
132 .PP
133 The multipalette PCHG BigLineChanges and Huffman decompression code
134 is untested.
135
136 .UN references
137 .SH REFERENCES
138
139 Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
140 Addison Wesley, ISBN 0-201-56775-X
141
142 .UN seealso
143 .SH SEE ALSO
144 .BR "ppmtoilbm" (1)\c
145 \&,
146 .BR "ppm" (1)\c
147 \&
148
149 .UN authors
150 .SH AUTHORS
151
152 Copyright (C) 1989 by Jef Poskanzer.
153 .PP
154 Modified October 1993 by Ingo Wilken (\[email protected]\fP)
155 .SH DOCUMENT SOURCE
156 This manual page was generated by the Netpbm tool 'makeman' from HTML
157 source. The master documentation is at
158 .IP
159 .B http://netpbm.sourceforge.net/doc/ilbmtoppm.html
160 .PP