Ppmtowinicon User Manual(0) Ppmtowinicon User Manual(0)
NAME
ppmtowinicon - convert PPM image into a Windows .ico file
SYNOPSIS
ppmtowinicon
[-andpgms]
[-output=output.ico]
[ppmfile [andfile] ...]
DESCRIPTION
This program is part of Netpbm(1).
ppmtowinicon reads one or more PPM images as input and produces a
Microsoft Windows .ico file as output.
A Windows icon contains 1 or more images, at different resolutions and
color depths. When Windows wants to display the icon, it searches
through the images to find the one the best matches the number of col-
ors and resolution of the display.
Microsoft recommends including at least the following formats in each
icon.
· 16 x 16 - 4 bpp
· 32 x 32 - 4 bpp
· 48 x 48 - 8 bpp
If you don’t specify any input files, input is from Standard Input.
Output is to Standard Output unless you specify -output.
Transparency
If you specify the -andmask option, you get (partly) transparent icons.
In that case, your arguments are pairs of file names, with the first
file name being that of the image and the second file name being that
of a standard Netpbm PGM transparency mask (see the pgmformatspecifica-
tion(1)).
In a .ico file, there is no such thing as partial transparency
(translucency). Where the PGM mask says completely opaque, the icon
will be opaque. Everywhere else, the icon will be transparent. Note
that as with any Netpbm program, you can use a PBM image for the trans-
parency mask and ppmtowinicon will treat it like a PGM.
The and mask is like an alpha mask, except for what it signifies in the
"not opaque" areas. In the usual case, the foreground image is black
in those areas, and in that case the areas are fully transparent -- the
background shows through the icon. But in general, a not opaque pixel
signifies that the background and foreground should be merged as fol-
lows: The intensities of the color components in the forgeground and
background are represented as binary numbers, then corresponding bits
of the background and foreground intensities are exlusive-or’ed
together. So there is a sort of reverse video effect.
If you don’t want this special effect and instead want straightforward
transparency, use the -truetransparent option. This causes ppmtowini-
con to make the base image black everywhere your transparency mask says
transparent, regardless of what color you input image is at that loca-
tion.
If you don’t specify -andmask, ppmtowinicon puts all-opaque and masks
into the .ico file.
OPTIONS
-andpgms
Include transparency information in the icons. See the trans-
parency section .
-output=output.ico
Name of output file. By default, ppmtowinicon writes the icon
to Standard Output.
-truetransparent
Make transparency in the icon normal instead of the special
reverse video effect. See the transparency section .
SEE ALSO
winicontoppm(1), ppm(1) pgm(1)
AUTHOR
Copyright (C) 2000 by Lee Benfield.
netpbm documentation 01 May 2004 Ppmtowinicon User Manual(0)
