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

LIMITATIONS

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

REFERENCES

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

HISTORY

192       For about a year in 1993-1994, there was a -savemem option.
193
194
195

AUTHORS

197       Copyright (C) 1989 by Jef Poskanzer.
198
199       Modified October 1993 by Ingo Wilken (Ingo.Wilken@informatik.uni-olden‐
200       burg.de)
201

DOCUMENT SOURCE

203       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
204       source.  The master documentation is at
205
206              http://netpbm.sourceforge.net/doc/ppmtoilbm.html
207
208netpbm documentation             28 June 2015         Ppmtoilbm User Manual(0)