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

NAME

6       ppmtowinicon - convert PPM image into a Windows .ico file
7
8

SYNOPSIS

10       ppmtowinicon
11
12       [-andpgms]
13
14       [-output=output.ico]
15
16       [ppmfile [andfile] ...]
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       This program is essentially obsolete; The newer pamtowinicon is better.
23
24       ppmtowinicon  reads  one or more PPM images as input and produces a Mi‐
25       crosoft Windows .ico file as output.
26
27       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
32       Microsoft  recommends  including at least the following formats in each
33       icon.
34
35
36
37       ·      16 x 16 - 4 bpp
38
39       ·      32 x 32 - 4 bpp
40
41       ·      48 x 48 - 8 bpp
42
43
44       If you don't specify any input files, input is from Standard Input.
45
46       Output is to Standard Output unless you specify -output.
47
48
49   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
56       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
62       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
72       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
78       If you don't specify -andmask, ppmtowinicon puts all-opaque  and  masks
79       into the .ico file.
80
81

OPTIONS

83       -andpgms
84              Include   transparency   information  in  the  icons.   See  the
85              transparency section ⟨#transparency⟩ .
86
87
88       -output=output.ico
89              Name of output file.  By default, ppmtowinicon writes  the  icon
90              to Standard Output.
91
92
93       -truetransparent
94              Make  transparency  in  the  icon  normal instead of the special
95              reverse   video   effect.    See   the   transparency    section
96              ⟨#transparency⟩ .
97
98
99
100

SEE ALSO

102       pamtowinicon(1), winicontoppm(1), ppm(1) pgm(1)
103
104

AUTHOR

106       Copyright (C) 2000 by Lee Benfield.
107

DOCUMENT SOURCE

109       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
110       source.  The master documentation is at
111
112              http://netpbm.sourceforge.net/doc/ppmtowinicon.html
113
114netpbm documentation              01 May 2004      Ppmtowinicon User Manual(0)