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       Minimum unique abbreviation of option is acceptable.  You may use  dou‐
14       ble  hyphens  instead  of single hyphen to denote options.  You may use
15       white space in place of the equals sign to separate an option name from
16       its value.
17
18

EXAMPLES

20       By default, infotopam converts the first icon in a .info file:
21
22           infotopam amiga.info > amiga.first.pam
23
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
31       Use the -forcecolor option to force color conversion for a 1  bit-plane
32       .info file:
33
34           infotopam -forcecolor bw.info > bw.pam
35
36
37       Use  -numcolors to override colors for indexes 0 and 3.  Notice the two
38       ways to specify the color:
39
40           infotopam -numcolors 2 0 green 3 #FF0000 icon.info > icon.pam
41
42
43       Since Amiga monitors do not use square pixels, some  icons  may  appear
44       squished.  Filtering the output through pamscale can fix this:
45
46            infotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm
47
48
49

DESCRIPTION

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

OPTIONS

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

SEE ALSO

128       pam(1) pamtopnm(1) pamscale(1)
129
130
131

NOTES

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

HISTORY

191       infotopam was new in Netpbm 10.22 (April 2004).
192
193

LIMITATIONS

195       infotopam currently only handles 1 and 2 bit-plane icons.
196
197       There is no pamtoinfo command, since the .info files contain a lot more
198       than just icon data, and mapping the colors would be difficult.
199
200

AUTHOR

202       Copyright (C) 2000, 2004 by Richard Griswold.
203

DOCUMENT SOURCE

205       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
206       source.  The master documentation is at
207
208              http://netpbm.sourceforge.net/doc/infotopam.html
209
210netpbm documentation             07 April 2004        Infotopam User Manual(0)
Impressum