NAME
    ilbmtoppm - convert an ILBM file into a portable pixmap

SYNOPSIS
    ilbmtoppm [-verbose] [-ignore<chunkID>] [-isham|-isehb] [-adjustcolors]
    [ILBMfile]

DESCRIPTION
    Reads an IFF ILBM file as input.  Produces a portable pixmap as output.
    Supported ILBM types are:

    Normal ILBMs with 1-16 planes.

    Amiga Extra_Halfbrite (EHB)

    Amiga HAM with 3-16 planes.

    24 bit.

    Multiplatte (normal or HAM) pictures.

    Color map (BMHD + CMAP chunk only, nPlanes = 0).

    Unofficial direct color.
    1-16 planes for each color component.

    Chunks used:
    BMHD, CMAP, CAMG (only HAM & EHB flags used), PCHG, BODY unoffi-
    cial DCOL chunk to identify direct color ILBM

    Chunks ignored:
    GRAB, DEST, SPRT, CRNG, CCRT, CLUT, DPPV, DRNG, EPSF

    Other chunks (ignored but displayed in verbose mode):
    NAME, AUTH, (c), ANNO, DPI

    Unknown chunks are skipped.

OPTIONS
    -verbose
    Give some information about the ILBM file.

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

    -isham | -isehb
    Treat the input file as a HAM or Extra_Halfbrite picture, even
    if these flags or not set in the CAMG chunk (or if there is no
    CAMG chunk).

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

BUGS
    The multipalette PCHG BigLineChanges and Huffman decompression code is
    untested.

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

SEE ALSO
    ppm(5),ppmtoilbm(1)

AUTHORS
    Copyright (C) 1989 by Jef Poskanzer.
    Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-olden-
    burg.de)