1Ppmtowinicon User Manual(0) Ppmtowinicon User Manual(0)
2
6 ppmtowinicon - convert PPM image into a Windows .ico file
7
10 ppmtowinicon
11 [-andpgms]
13 [-output=output.ico]
15 [ppmfile [andfile] ...]
17
20 This program is part of Netpbm(1).
21 This program is essentially obsolete; The newer pamtowinicon is better.
23 ppmtowinicon reads one or more PPM images as input and produces a Mi‐
25 crosoft Windows .ico file as output.
26 A Windows icon contains 1 or more images, at different resolutions and
28 color depths. When Windows wants to display the icon, it searches
29 through the images to find the one that best matches the number of col‐
30 ors and resolution of the display.
31 Microsoft recommends including at least the following formats in each
33 icon.
34 · 16 x 16 - 4 bpp
38 · 32 x 32 - 4 bpp
40 · 48 x 48 - 8 bpp
42 If you don't specify any input files, input is from Standard Input.
45 Output is to Standard Output unless you specify -output.
47 Transparency
50 If you specify the -andmask option, you get (partly) transparent icons.
51 In that case, your arguments are pairs of file names, with the first
52 file name being that of the image and the second file name being that
53 of a standard Netpbm PGM transparency mask (see the pgm format specifi‐
54 cation(1)).
55 In a .ico file, there is no such thing as partial transparency
57 (translucency). Where the PGM mask says completely opaque, the icon
58 will be opaque. Everywhere else, the icon will be transparent. Note
59 that as with any Netpbm program, you can use a PBM image for the trans‐
60 parency mask and ppmtowinicon will treat it like a PGM.
61 The and mask is like a transparency mask, except for what it signifies
63 in the "not opaque" areas. In the usual case, the foreground image is
64 black in those areas, and in that case the areas are fully transparent
65 -- the background shows through the icon. But in general, a not opaque
66 pixel signifies that the background and foreground should be merged as
67 follows: The intensities of the color components in the foreground and
68 background are represented as binary numbers, then corresponding bits
69 of the background and foreground intensities are exclusive-or'ed
70 together. So there is a sort of reverse video effect.
71 If you don't want this special effect and instead want straightforward
73 transparency, use the -truetransparent option. This causes ppmtowini‐
74 con to make the base image black everywhere your transparency mask says
75 transparent, regardless of what color your input image is at that loca‐
76 tion.
77 If you don't specify -andmask, ppmtowinicon puts all-opaque and masks
79 into the .ico file.
80
83 In addition to the options common to all programs based on libnetpbm
84 (most notably -quiet, see
85 Common Options ⟨index.html#commonoptions⟩ ), ppmtowinicon recognizes
86 the following command line options:
87 -andpgms
91 Include transparency information in the icons. See the
92 transparency section ⟨#transparency⟩ .
93 -output=output.ico
96 Name of output file. By default, ppmtowinicon writes the icon
97 to Standard Output.
98 -truetransparent
101 Make transparency in the icon normal instead of the special
102 reverse video effect. See the transparency section
103 ⟨#transparency⟩ .
104
109 pamtowinicon(1), winicontoppm(1), ppm(1) pgm(1)
110
113 Copyright (C) 2000 by Lee Benfield.
114
116 This manual page was generated by the Netpbm tool 'makeman' from HTML
117 source. The master documentation is at
118 http://netpbm.sourceforge.net/doc/ppmtowinicon.html
120netpbm documentation 01 May 2004 Ppmtowinicon User Manual(0)