Blame userguide/ilbmtoppm.html

Packit 78deda
Packit 78deda
<HTML><HEAD><TITLE>Ilbmtoppm User Manual</TITLE></HEAD>
Packit 78deda
<BODY>
Packit 78deda

ilbmtoppm

Packit 78deda
Updated: 12 November 2014
Packit 78deda

Packit 78deda
Packit 78deda
Table Of Contents
Packit 78deda
Packit 78deda

NAME

Packit 78deda
ilbmtoppm - convert an ILBM file into a PPM image
Packit 78deda
Packit 78deda

SYNOPSIS

Packit 78deda
Packit 78deda
ilbmtoppm
Packit 78deda
[-ignore<chunkID>]
Packit 78deda
[
Packit 78deda
-isham | -isnotham |
Packit 78deda
-isehb | -isnotehb |
Packit 78deda
-isdeep | -isnotdeep
Packit 78deda
]
Packit 78deda
[-cmaponly]
Packit 78deda
[-adjustcolors]
Packit 78deda
[-transparent color]
Packit 78deda
[-maskfile filename
Packit 78deda
[-verbose]
Packit 78deda
[ILBMfile]
Packit 78deda
Packit 78deda
Packit 78deda

DESCRIPTION

Packit 78deda
Packit 78deda

This program is part of Netpbm.

Packit 78deda
Packit 78deda

ilbmtoppm reads an IFF ILBM file as input and produces a PPM

Packit 78deda
image as output.  ilbmtoppm can handle the following ILBM types:
Packit 78deda
Packit 78deda
    Packit 78deda
  • Normal ILBMs with 1-16 planes.
  • Packit 78deda
  • Amiga Extra_Halfbrite (EHB)
  • Packit 78deda
  • Amiga HAM with 3-16 planes.
  • Packit 78deda
  • 24 bit.
  • Packit 78deda
  • Multiplatte (normal or HAM) pictures.
  • Packit 78deda
  • Color map (BMHD + CMAP chunk only, nPlanes = 0).
  • Packit 78deda
  • Unofficial direct color. 1-16 planes for each color component.
  • Packit 78deda
    Packit 78deda
    Packit 78deda

    ilbmtoppm uses these ILBM chunks: BMHD, CMAP, CAMG (only HAM

    Packit 78deda
    & EHB flags used), PCHG, BODY unofficial DCOL chunk to identify
    Packit 78deda
    direct color ILBM.  It ignores these chunks: GRAB, DEST, SPRT, CRNG,
    Packit 78deda
    CCRT, CLUT, DPPV, DRNG, EPSF.  It ignores, but displays in verbose
    Packit 78deda
    mode, these: NAME, AUTH, (c), ANNO, DPI.  It skips chunks whose type
    Packit 78deda
    it doesn't recognize.
    Packit 78deda
    Packit 78deda

    OPTIONS

    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
    -transparent color
    Packit 78deda
    This is the color that should "show through" in places where
    Packit 78deda
    the image is transparent.
    Packit 78deda
    Packit 78deda

    color is like the argument of

    Packit 78deda
    the ppm_parsecolor() library routine.
    Packit 78deda
    Packit 78deda
    -verbose
    Packit 78deda
    Packit 78deda
    Give some information about the ILBM file.
    Packit 78deda
    Packit 78deda
    -ignore chunkID
    Packit 78deda
    Packit 78deda
    Skip a chunk. chunkID is the 4-letter IFF chunk identifier
    Packit 78deda
    of the chunk to be skipped.
    Packit 78deda
    Packit 78deda
    -isham | -isehb
    Packit 78deda
    Packit 78deda
    Treat the input file as a HAM or Extra_Halfbrite picture, even if
    Packit 78deda
    these flags are not set in the CAMG chunk (or if there is no CAMG
    Packit 78deda
    chunk).
    Packit 78deda
    Packit 78deda
    -maskfile filename
    Packit 78deda
    Packit 78deda
    This names a file for ilbmtoppm to create with the image's
    Packit 78deda
    transparency mask.  The mask file is a PBM image which maps to the input image
    Packit 78deda
    with white pixels representing transparent pixels in the image and black
    Packit 78deda
    pixels representing opaque pixels.
    Packit 78deda
    Packit 78deda

    If you don't specfy this, or the image does not contain transparency

    Packit 78deda
    information, ilbmtoppm does not create a mask file.
    Packit 78deda
    Packit 78deda
    -cmaponly
    Packit 78deda
    Packit 78deda
    With this option, ilbmtoppm generates a PPM of the ILBM's color
    Packit 78deda
    map, not the image itself.
    Packit 78deda
    Packit 78deda

    ilbmtoppm does the same thing even without -cmaponly if the

    Packit 78deda
    ILBM is a pure color map stream (it has a bitmap header with an nplanes
    Packit 78deda
    value of zero or has no BODY chunk.
    Packit 78deda
    Packit 78deda
    -adjustcolors
    Packit 78deda
    Packit 78deda
    If all colors in the CMAP have a value of less then 16, ilbmtoppm
    Packit 78deda
    assumes a 4-bit colormap and gives a warning.  With this option the
    Packit 78deda
    colormap is scaled to 8 bits.
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda
    Packit 78deda

    LIMITATIONS

    Packit 78deda
    Packit 78deda

    The multipalette PCHG BigLineChanges and Huffman decompression code

    Packit 78deda
    is untested.
    Packit 78deda
    Packit 78deda

    REFERENCES

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

    SEE ALSO

    Packit 78deda
    Packit 78deda
    ppmtoilbm,
    Packit 78deda
    ppm
    Packit 78deda
    Packit 78deda

    AUTHORS

    Packit 78deda
    Packit 78deda
    Copyright (C) 1989 by Jef Poskanzer.
    Packit 78deda
    Packit 78deda

    Modified October 1993 by Ingo Wilken (

    Packit 78deda
    HREF="mailto:Ingo.Wilken@informatik.uni-oldenburg.de">Ingo.Wilken@informatik.uni-oldenburg.de)
    Packit 78deda
    Packit 78deda

    Packit 78deda

    Table Of Contents

    Packit 78deda
      Packit 78deda
    • SYNOPSIS
    • Packit 78deda
    • DESCRIPTION
    • Packit 78deda
    • OPTIONS
    • Packit 78deda
    • LIMITATIONS
    • Packit 78deda
    • REFERENCES
    • Packit 78deda
    • SEE ALSO
    • Packit 78deda
    • AUTHORS
    • Packit 78deda
      Packit 78deda
      </BODY>
      Packit 78deda
      </HTML>