.TL
Ilbmtoppm User Manual
.SH 1
ilbmtoppm
.LP
Updated: 04 October 1993
.br
Table Of Contents
.SH 2
NAME
.LP
ilbmtoppm - convert an ILBM file into a PPM image
.SH 2
SYNOPSIS
.LP
\fBilbmtoppm\fR
[\fB-verbose\fR]
[\fB-ignore\fR<chunkID>\fB]\fR
[\fB-isham\fR|\fB-isehb\fR]
[\fB-adjustcolors\fR]
[\fIILBMfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBilbmtoppm\fR reads an IFF ILBM file as input and produces a PPM
image as output.  \fBilbmtoppm\fR can handle the following ILBM types:
.IP \(bu
Normal ILBMs with 1-16 planes.
.IP \(bu
Amiga Extra_Halfbrite (EHB)
.IP \(bu
Amiga HAM with 3-16 planes.
.IP \(bu
24 bit.
.IP \(bu
Multiplatte (normal or HAM) pictures.
.IP \(bu
Color map (BMHD + CMAP chunk only, nPlanes = 0).
.IP \(bu
Unofficial direct color.
1-16 planes for each color component.
.LP
.LP
\fBilbmtoppm\fR 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.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-verbose\fR"
Give some information about the ILBM file.
.IP "\fB-ignore\fR \fIchunkID\fR"
Skip a chunk.  \fIchunkID\fR is the 4-letter IFF chunk identifier
of the chunk to be skipped.
.IP "\fB-isham\fR | \fB-isehb\fR"
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).
.IP "\fB-adjustcolors\fR"
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.
.RE
.SH 2
LIMITATIONS
.LP
.LP
The multipalette PCHG BigLineChanges and Huffman decompression code
is untested.
.SH 2
REFERENCES
.LP
Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
Addison Wesley, ISBN 0-201-56775-X
.SH 2
SEE ALSO
.LP
ppmtoilbm,
ppm
.SH 2
AUTHORS
.LP
Copyright (C) 1989 by Jef Poskanzer.
.LP
Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de)
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
LIMITATIONS
.IP \(bu
REFERENCES
.IP \(bu
SEE ALSO
.IP \(bu
AUTHORS
.LP