summary refs log tree commit diff
path: root/ilbmtoppm.html
blob: 313c6cec32443ff146f044e65726a469b48d29f1 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Ilbmtoppm User Manual</TITLE></HEAD>
<BODY>
<H1>ilbmtoppm</H1>
Updated: 12 November 2014
<BR>

<A HREF="#index">Table Of Contents</A>

<H2>NAME</H2>
ilbmtoppm - convert an ILBM file into a PPM image

<H2 id="synopsis">SYNOPSIS</H2>

<B>ilbmtoppm</B>
[<B>-ignore</B>&lt;chunkID&gt;<B>]</B>
[
<B>-isham</B> | <b>-isnotham</b> |
<B>-isehb</B> | <b>-isnotehb</b> |
<b>-isdeep</b> | <b>-isnotdeep</b>
]
[<B>-cmaponly</B>]
[<B>-adjustcolors</B>]
[<b>-transparent </b><i>color</i>]
[<b>-maskfile</b> <i>filename</i>
[<B>-verbose</B>]
[<I>ILBMfile</I>]


<H2 id="description">DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>ilbmtoppm</b> reads an IFF ILBM file as input and produces a PPM
image as output.  <b>ilbmtoppm</b> can handle the following ILBM types:

<UL>
<LI>Normal ILBMs with 1-16 planes.
<LI>Amiga Extra_Halfbrite (EHB)
<LI>Amiga HAM with 3-16 planes.
<LI>24 bit.
<LI>Multiplatte (normal or HAM) pictures.
<LI>Color map (BMHD + CMAP chunk only, nPlanes = 0).
<LI>Unofficial direct color.
1-16 planes for each color component.
</UL>

<P><B>ilbmtoppm</b> uses these ILBM chunks: BMHD, CMAP, CAMG (only HAM
&amp; EHB flags used), PCHG, BODY unofficial DCOL chunk to identify
direct color ILBM.  It ignores these chunks: GRAB, DEST, SPRT, CRNG,
CCRT, CLUT, DPPV, DRNG, EPSF.  It ignores, but displays in verbose
mode, these: NAME, AUTH, (c), ANNO, DPI.  It skips chunks whose type
it doesn't recognize.

<H2 id="options">OPTIONS</H2>

<DL COMPACT>

<dt><b>-transparent </b><i>color</i>
<dd>This is the color that should &quot;show through&quot; in places where
the image is transparent.

<P><i>color</i> is like the <a href="libppm.html#colorname">argument of
the <b>ppm_parsecolor()</b> library routine</a>.

<DT><B>-verbose</B>

<DD>Give some information about the ILBM file.

<DT><B>-ignore</b> <i>chunkID</i>

<DD>Skip a chunk.  <i>chunkID</i> is the 4-letter IFF chunk identifier
of the chunk to be skipped.

<DT><B>-isham</b> | <b>-isehb</B>

<DD>Treat the input file as a HAM or Extra_Halfbrite picture, even if
these flags are not set in the CAMG chunk (or if there is no CAMG
chunk).

<dt><b>-maskfile</b> <i>filename</i>

<dd>This names a file for <b>ilbmtoppm</b> to create with the image's
transparency mask.  The mask file is a PBM image which maps to the input image
with white pixels representing transparent pixels in the image and black
pixels representing opaque pixels.

<p>If you don't specfy this, or the image does not contain transparency
information, <b>ilbmtoppm</b> does not create a mask file.

<dt><b>-cmaponly</b>

<dd>With this option, <b>ilbmtoppm</b> generates a PPM of the ILBM's <em>color
map</em>, not the image itself.

<p><b>ilbmtoppm</b> does the same thing even without <b>-cmaponly</b> if the
ILBM is a pure color map stream (it has a bitmap header with an <i>nplanes</i>
value of zero or has no BODY chunk.

<DT><B>-adjustcolors</B>

<DD>If all colors in the CMAP have a value of less then 16, ilbmtoppm
assumes a 4-bit colormap and gives a warning.  With this option the
colormap is scaled to 8 bits.

</DL>


<H2 id="limitations">LIMITATIONS</H2>

<p>The multipalette PCHG BigLineChanges and Huffman decompression code
is untested.

<H2 id="references">REFERENCES</H2>

Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
Addison Wesley, ISBN 0-201-56775-X

<H2 id="seealso">SEE ALSO</H2>

<A HREF="ppmtoilbm.html">ppmtoilbm</A>,
<A HREF="ppm.html">ppm</A>

<H2 id="authors">AUTHORS</H2>

Copyright (C) 1989 by Jef Poskanzer.

<p>Modified October 1993 by Ingo Wilken (<A
HREF="mailto:Ingo.Wilken@informatik.uni-oldenburg.de">Ingo.Wilken@informatik.uni-oldenburg.de</A>)

<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#limitations">LIMITATIONS</A>
<LI><A HREF="#references">REFERENCES</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#authors">AUTHORS</A>
</UL>
</BODY>
</HTML>