ppmtoilbm(1)

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

NAME

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

SYNOPSIS

10       ppmtoilbm
11
12       [-maxplanes|-mp N]
13
14       [-fixplanes|-fp N]
15
16       [-ham6|-ham8]
17
18       [{-dcbits|-dcplanes} r g b]
19
20       [ -normal|-hamif|-hamforce|-24if|-24force| -dcif|-dcforce|-cmaponly ]
21
22       [-ecs|-aga]
23
24       [-compress|-nocompress]
25
26       [-cmethod type]
27
28       [-map ppmfile]
29
30       [ppmfile]
31
32
33

DESCRIPTION

35       This program is part of Netpbm(1).
36
37       ppmtoilbm reads a PPM image as input.  Produces an ILBM file as output.
38       ppmtoilbm understands the following ILBM types:
39
40
41
42
43       ·      Normal ILBMs with 1-16 planes
44
45
46       ·      Amiga HAM with 3-16 planes
47
48
49       ·      24 bit
50
51
52       ·      Color map (BMHD + CMAP chunk only, nPlanes = 0)
53
54
55       ·      Unofficial direct color.  1-16 planes for each color component.
56
57
58
59       Chunks written: BMHD, CMAP, CAMG (only for HAM), BODY (not for colormap
60       files) unofficial DCOL chunk for direct color ILBM.
61
62
63

OPTIONS

65       Options  marked  with (*) can be prefixed with a "no", e.g. "-nohamif".
66       All options can be abbreviated to their shortest unique prefix.
67
68
69
70       -maxplanes | -mp n
71              (default 5, minimum 1, maximum 16) Maximum planes to write in  a
72              normal  ILBM.   If  the image does not fit into <n> planes, ppm‐
73              toilbm writes a HAM file (if -hamif is used), a 24bit  file  (if
74              -24if  is  used)  or  a  direct color file (if -dcif is used) or
75              aborts with an error.
76
77
78       -fixplanes | -fp b
79              (min 1, max 16) If a  normal  ILBM  is  written,  it  will  have
80              exactly <n> planes.
81
82
83       -hambits | -hamplanes n
84              (default  6, min 3, max 16) Select number of planes for HAM pic‐
85              ture.  The current Amiga hardware supports 6 and  8  planes,  so
86              for now you should only use this values.
87
88
89       -normal
90              Turns  off  -hamif/-24if/-dcif,  -hamforce/-24force/-dcforce and
91              -cmaponly.  Also sets compression type to byterun1.
92
93              This is the default.
94
95
96       -hamif (*)
97
98       -24if (*)
99
100       -dcif (*)
101              Write a HAM/24bit/direct color file if the image  does  not  fit
102              into <maxplanes> planes.
103
104
105       -hamforce (*)
106
107       -24force (*)
108
109       -dcforce (*)
110              Write a HAM/24bit/direct color file.
111
112
113       -dcbits r g b
114
115       -dcplanes r g b
116              (default  5,  min  1,  max  16).  Select number of bits for red,
117              green and blue in a direct color ILBM.
118
119
120       -ecs   Shortcut for: -hamplanes 6 -maxplanes 5
121
122              This is the default.
123
124
125       -aga   Shortcut for: -hamplanes 8 -maxplanes 8
126
127
128       -ham6  Shortcut for: -hamplanes 6 -hamforce
129
130
131       -ham8  Shortcut for: -hamplanes 8 -hamforce
132
133
134       -compress (*)
135              This is the default.  Compress the BODY chunk.  The default com‐
136              pression  method is byterun1.  Compression requires building the
137              ILBM image in memory; turning  compression  off  allows  stream-
138              writing of the image, but the resulting file will usually be 30%
139              to 50% larger.  Another alternative is the -savemem option, this
140              will  keep memory requirements for compression at a minimum, but
141              is very slow.
142
143
144       -cmethod none|byterun1
145              This option does the same thing as -compress.
146
147
148       -map ppmfile
149              Write a normal ILBM using the colors in <ppmfile>  as  the  col‐
150              ormap.   The colormap file also determines the number of planes,
151              a -maxplanes or -fixplanes option is ignored.
152
153
154       -cmaponly
155              Write a colormap file: only BMHD and CMAP chunks, no BODY chunk,
156              nPlanes = 0.
157
158
159       -savemem
160              See the -compress option.
161
162
163
164
165

LIMITATIONS

167       HAM  pictures will always get a grayscale colormap; a real color selec‐
168       tion algorithm might give better results.   On  the  other  hand,  this
169       allows  row-by-row  operation  on HAM images, and all HAM images of the
170       same depth (no. of planes) share a common colormap, which is useful for
171       building HAM animations.
172
173
174

REFERENCES

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

HISTORY

187       For about a year in 1993-1994, there was a -savemem option.
188
189
190

AUTHORS

192       Copyright (C) 1989 by Jef Poskanzer.
193
194       Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-olden‐
195       burg.de)
196

DOCUMENT SOURCE

198       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
199       source.  The master documentation is at
200
201              http://netpbm.sourceforge.net/doc/ppmtoilbm.html
202
203netpbm documentation             28 June 2015         Ppmtoilbm User Manual(0)