\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ilbmtoppm User Manual" 0 "04 October 1993" "netpbm documentation"

.SH NAME
ilbmtoppm - convert an ILBM file into a PPM image

.UN synopsis
.SH SYNOPSIS

\fBilbmtoppm\fP
[\fB-ignore\fP<chunkID>\fB]\fP
[
\fB-isham\fP | \fB-isnotham\fP |
\fB-isehb\fP | \fB-isnotehb\fP |
\fB-isdeep\fP | \fB-isnotdeep\fP
]
[\fB-cmaponly\fP]
[\fB-adjustcolors\fP]
[\fB-transparent \fP\fIcolor\fP]
[\fB-maskfile\fP \fIfilename\fP
[\fB-verbose\fP]
[\fIILBMfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBilbmtoppm\fP reads an IFF ILBM file as input and produces a PPM
image as output.  \fBilbmtoppm\fP 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.

.PP
\fBilbmtoppm\fP 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.

.UN options
.SH OPTIONS



.TP
\fB-verbose\fP
Give some information about the ILBM file.

.TP
\fB-ignore\fP \fIchunkID\fP
Skip a chunk.  \fIchunkID\fP is the 4-letter IFF chunk identifier
of the chunk to be skipped.

.TP
\fB-isham\fP | \fB-isehb\fP
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).

.TP
\fB-cmaponly\fP
With this option, \fBilbmtoppm\fP generates a PPM of the ILBM's \fIcolor
map\fP, not the image itself.
.sp
\fBilbmtoppm\fP does the same thing even without \fB-cmaponly\fP if the
ILBM is a pure color map stream (it has a bitmap header with an \fInplanes\fP
value of zero or has no BODY chunk.


.TP
\fB-adjustcolors\fP
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.



.UN limitations
.SH LIMITATIONS
.PP
The multipalette PCHG BigLineChanges and Huffman decompression code
is untested.

.UN references
.SH REFERENCES

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

.UN seealso
.SH SEE ALSO
.BR ppmtoilbm (1)
,
.BR ppm (5)


.UN authors
.SH AUTHORS

Copyright (C) 1989 by Jef Poskanzer.
.PP
Modified October 1993 by Ingo Wilken (\fIIngo.Wilken@informatik.uni-oldenburg.de\fP)