ppmtowinicon

Section: User Commands (1)
Updated: 22 May 2000
Index Return to Main Contents

NAME

ppmtowinicon - convert 1 or more portable pixmaps into a Windows .ico file

ppmtowinicon [-andpgms] [-output output.ico] [ppmfiles...]

Reads one or more portable pixmaps as input. Produces a Microsoft Windows .ico file as output.

A Windows icon contains 1 or more images, at different resolutions and color depths.

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

Default I/O is STDIN/STDOUT.

-andpgms: If this option is given, every other file is read as an alpha mask to be used by windows for transparancy data for the previous image. (These are set to blank by default). The alpha mask is a PGM image, where any value less than or equal to the maxval means transparent, and anything greater than the maxval means opaque. Note that as with all Netpbm programs, you may use a PBM file here and it will be used as if it were the equivalent PGM.
-output output.ico: File to write. By default, the icon is written to stdout.