<!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><chunkID><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
& 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 "show through" 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>