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

NAME

6       infotopam - convert Amiga .info icons to PAM
7
8

SYNOPSIS

10       infotopam [-forcecolor] [-numcolors numcolors] [-selected] [index color
11       ...]  [filename]
12
13
14       Minimum unique abbreviation of option is acceptable.  You may use  dou‐
15       ble  hyphens  instead  of single hyphen to denote options.  You may use
16       white space in place of the equals sign to separate an option name from
17       its value.
18
19

EXAMPLES

21       By default, infotopam converts the first icon in a .info file:
22
23           infotopam amiga.info > amiga.first.pam
24
25       Use  the  -selected  option to convert the second icon in a .info file.
26       Here infotopam reads from Standard Input:
27
28           infotopam -selected < amiga.info > amiga.second.pam
29
30       Use the -forcecolor option to force color conversion for a 1  bit-plane
31       .info file:
32
33           infotopam -forcecolor bw.info > bw.pam
34
35       Use  -numcolors to override colors for indexes 0 and 3.  Notice the two
36       ways to specify the color:
37
38           infotopam -numcolors 2 0 green 3 #FF0000 icon.info > icon.pam
39
40       Since Amiga monitors do not use square pixels, some  icons  may  appear
41       squished.  Filtering the output through pamscale can fix this:
42
43            infotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm
44
45

DESCRIPTION

47       This program is part of Netpbm(1).
48
49       infotopam  converts  an  Amiga .info (icon) file to a PAM image.  info‐
50       topam reads a .info file from filename, or from Standard Input  if  you
51       do not specify a file name, and writes the converted PAM image to Stan‐
52       dard Output.
53
54       infotopam currently handles 1 and 2 bit-plane icons.  If the .info icon
55       only  has  1  bit-plane, infotopam generates a bitmap (black&white) PAM
56       image; otherwise it generates a color PAM image.  You can  force  info‐
57       topam  to  convert  1 bit-plane images to color PAM images by using the
58       -forcecolor option.
59
60

OPTIONS

62       -forcecolor
63
64
65
66              Forces infotopam to convert 1 bit-plane icons to color PAM
67                images instead of bitmap PAM images.  infotopam uses the index
68              2
69                color for black and the index 1 color for white (more on this
70                below).
71
72
73       -numcolors numcolors
74
75
76
77              Tells infotopam how many colors to override.  Pixels in the
78                Amiga  .info  files  are assigned an index value rather than a
79              specific color.
80                The standard colors for a 2 bit-plane icon are:
81
82                  Index 0:  Blue   (00, 55, AA)
83                  Index 1:  White  (FF, FF, FF)
84                  Index 2:  Black  (00, 00, 20)
85                  Index 3:  Orange (FF, 8A, 00)
86
87              To override the colors, first specify how many colors  to  over‐
88              ride using
89                -numcolors, then specify an (index color) pair for each color
90                you want to override, where index is a value from 0 to 3 and
91                color the the new color for that index.  Specify color as
92                described      for     the     ppm_parsecolor()       argument
93              ⟨libppm.html#colorname⟩ .
94
95
96       -selected
97
98
99              Tells infotopam to convert the selected (second) icon instead of
100                the normal (first) icon.  Each Amiga .info icon file  contains
101              two icon
102                images.   The  first image is the normal, unselected icon, and
103              the second
104                image is the selected icon.  By default infotopam converts the
105              first
106                icon.   You  can  tell infotopam to convert the second icon by
107              using the
108                -selected option.
109
110
111
112       All options can be abbreviated to their shortest unique prefix.
113
114

SEE ALSO

116       pam(1) pamtopnm(1) pamscale(1)
117
118
119

NOTES

121       Thanks to the following people on  comp.sys.amiga.programmer  for  tips
122       and pointers on decoding the info file format:
123
124
125
126       ·      Ben Hutchings
127
128       ·      Thomas Richter
129
130       ·      Kjetil Svalastog Matheussen
131
132       ·      Anders Melchiorsen
133
134       ·      Dirk Stoecker
135
136       ·      Ronald V.D.
137
138
139       The format of the Amiga .info file is as follows:
140
141           DiskObject header            78 bytes
142           Optional DrawerData header   56 bytes
143           First icon header            20 bytes
144           First icon data              Varies
145           Second icon header           20 bytes
146           Second icon data             Varies
147
148       The  DiskObject  header  contains, among other things, the magic number
149       (0xE310), the object width  and  height  (inside  the  embedded  Gadget
150       header), and the version.
151
152       Each  icon  header  contains  the  icon  width and height, which can be
153       smaller than the object width and height, and the number of bit-planes.
154
155       The icon data has the following format:
156
157
158
159              BIT-PLANE planes, each with HEIGHT rows of (WIDTH
160                  +15) / 16 * 2 bytes length.
161
162       So if you have a 9x3x2 icon, the icon data will look like this:
163
164           aaaa aaaa a000 0000
165           aaaa aaaa a000 0000
166           aaaa aaaa a000 0000
167           bbbb bbbb b000 0000
168           bbbb bbbb b000 0000
169           bbbb bbbb b000 0000
170
171       where a is a bit for the first bit-plane, b is a  bit  for  the  second
172       bit-plane,  and  0  is  padding.  Thanks again to Ben Hutchings for his
173       very helpful post!
174
175

HISTORY

177       infotopam was new in Netpbm 10.22 (April 2004).
178
179

LIMITATIONS

181       infotopam currently only handles 1 and 2 bit-plane icons.
182
183       There is no pamtoinfo command, since the .info files contain a lot more
184       than just icon data, and mapping the colors would be difficult.
185
186

AUTHOR

188       Copyright (C) 2000, 2004 by Richard Griswold.
189
190
191
192netpbm documentation             07 April 2004        Infotopam User Manual(0)
Impressum