ilbmtoppm(1)

1Ilbmtoppm User Manual(0)                              Ilbmtoppm User Manual(0)
2
3
4

NAME

6       ilbmtoppm - convert an ILBM file into a PPM image
7
8

SYNOPSIS

10       ilbmtoppm  [-ignore<chunkID>] [ -isham | -isnotham | -isehb | -isnotehb
11       | -isdeep |  -isnotdeep  ]  [-cmaponly]  [-adjustcolors]  [-transparent
12       color] [-maskfile filename [-verbose] [ILBMfile]
13
14
15

DESCRIPTION

17       This program is part of Netpbm(1).
18
19       ilbmtoppm  reads  an IFF ILBM file as input and produces a PPM image as
20       output.  ilbmtoppm can handle the following ILBM types:
21
22
23
24       ·      Normal ILBMs with 1-16 planes.
25
26       ·      Amiga Extra_Halfbrite (EHB)
27
28       ·      Amiga HAM with 3-16 planes.
29
30       ·      24 bit.
31
32       ·      Multiplatte (normal or HAM) pictures.
33
34       ·      Color map (BMHD + CMAP chunk only, nPlanes = 0).
35
36       ·      Unofficial direct color.  1-16 planes for each color component.
37
38
39       ilbmtoppm uses these ILBM chunks: BMHD, CMAP,  CAMG  (only  HAM  &  EHB
40       flags  used), PCHG, BODY unofficial DCOL chunk to identify direct color
41       ILBM.  It ignores these chunks: GRAB, DEST,  SPRT,  CRNG,  CCRT,  CLUT,
42       DPPV,  DRNG,  EPSF.   It  ignores, but displays in verbose mode, these:
43       NAME, AUTH, (c), ANNO, DPI.  It skips chunks whose type it doesn't rec‐
44       ognize.
45
46

OPTIONS

48       -transparent color
49              This is the color that should "show through" in places where the
50              image is transparent.
51
52              color is like  the  argument  of  the  pnm_parsecolor()  library
53              routine ⟨libnetpbm_image.html#colorname⟩ .
54
55
56       -verbose
57              Give some information about the ILBM file.
58
59
60       -ignore chunkID
61              Skip  a  chunk.  chunkID is the 4-letter IFF chunk identifier of
62              the chunk to be skipped.
63
64
65       -isham | -isehb
66              Treat the input file as a HAM or Extra_Halfbrite  picture,  even
67              if  these flags are not set in the CAMG chunk (or if there is no
68              CAMG chunk).
69
70
71       -maskfile filename
72              This names a file for  ilbmtoppm  to  create  with  the  image's
73              transparency  mask.   The mask file is a PBM image which maps to
74              the input image with white pixels representing transparent  pix‐
75              els in the image and black pixels representing opaque pixels.
76
77              If  you  don't specfy this, or the image does not contain trans‐
78              parency information, ilbmtoppm does not create a mask file.
79
80
81       -cmaponly
82              With this option, ilbmtoppm generates a PPM of the ILBM's  color
83              map, not the image itself.
84
85              ilbmtoppm does the same thing even without -cmaponly if the ILBM
86              is a pure color map stream (it  has  a  bitmap  header  with  an
87              nplanes value of zero or has no BODY chunk.
88
89
90       -adjustcolors
91              If  all  colors  in the CMAP have a value of less then 16, ilbm‐
92              toppm assumes a 4-bit colormap and gives a warning.   With  this
93              option the colormap is scaled to 8 bits.
94
95
96
97
98

LIMITATIONS

100       The  multipalette PCHG BigLineChanges and Huffman decompression code is
101       untested.
102
103

REFERENCES

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

AUTHORS

114       Copyright (C) 1989 by Jef Poskanzer.
115
116       Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-olden‐
117       burg.de)
118

DOCUMENT SOURCE

120       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
121       source.  The master documentation is at
122
123              http://netpbm.sourceforge.net/doc/ilbmtoppm.html
124
125netpbm documentation           12 November 2014       Ilbmtoppm User Manual(0)