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       ppmtowinicon  reads  one or more PPM images as input and produces a Mi‐
23       crosoft Windows .ico file as output.
24
25       A Windows icon contains 1 or more images, at different resolutions  and
26       color  depths.   When  Windows  wants  to display the icon, it searches
27       through the images to find the one the best matches the number of  col‐
28       ors and resolution of the display.
29
30       Microsoft  recommends  including at least the following formats in each
31       icon.
32
33
34
35       ·      16 x 16 - 4 bpp
36
37       ·      32 x 32 - 4 bpp
38
39       ·      48 x 48 - 8 bpp
40
41
42       If you don't specify any input files, input is from Standard Input.
43
44       Output is to Standard Output unless you specify -output.
45
46
47   Transparency
48       If you specify the -andmask option, you get (partly) transparent icons.
49       In  that  case,  your arguments are pairs of file names, with the first
50       file name being that of the image and the second file name  being  that
51       of a standard Netpbm PGM transparency mask (see the pgmformatspecifica‐
52       tion(1)).
53
54       In a .ico  file,  there  is  no  such  thing  as  partial  transparency
55       (translucency).   Where  the  PGM mask says completely opaque, the icon
56       will be opaque.  Everywhere else, the icon will be  transparent.   Note
57       that as with any Netpbm program, you can use a PBM image for the trans‐
58       parency mask and ppmtowinicon will treat it like a PGM.
59
60       The and mask is like an alpha mask, except for what it signifies in the
61       "not  opaque"  areas.  In the usual case, the foreground image is black
62       in those areas, and in that case the areas are fully transparent -- the
63       background  shows through the icon.  But in general, a not opaque pixel
64       signifies that the background and foreground should be merged  as  fol‐
65       lows:  The  intensities  of the color components in the forgeground and
66       background are represented as binary numbers, then  corresponding  bits
67       of   the  background  and  foreground  intensities  are  exlusive-or'ed
68       together.  So there is a sort of reverse video effect.
69
70       If you don't want this special effect and instead want  straightforward
71       transparency,  use the -truetransparent option.  This causes ppmtowini‐
72       con to make the base image black everywhere your transparency mask says
73       transparent,  regardless of what color you input image is at that loca‐
74       tion.
75
76       If you don't specify -andmask, ppmtowinicon puts all-opaque  and  masks
77       into the .ico file.
78
79

OPTIONS

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

SEE ALSO

100       winicontoppm(1), ppm(1) pgm(1)
101
102

AUTHOR

104       Copyright (C) 2000 by Lee Benfield.
105
106
107
108netpbm documentation              01 May 2004      Ppmtowinicon User Manual(0)