xenial (1) ppmtowinicon.1.gz

Provided by: netpbm_10.0-15.3_amd64 bug

NAME

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

SYNOPSIS

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

DESCRIPTION

       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 (size and bits-per-pixel):

       16 x 16 - 4 bpp

       32 x 32 - 4 bpp

       48 x 48 - 8 bpp

       Default I/O is STDIN/STDOUT.

OPTIONS

       -andpgms
              If  this  option  is  given,  every second file is read as an "and mask" to be used by windows for
              transparency data for the previous image. (These are set to fully opaque by default). The and mask
              is  a  PGM image, where any pixel with maxval intensity means opaque and any other pixel means not
              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.

              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  follows:  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.

       -output output.ico
              File to write.  By default, the icon is written to stdout.

SEE ALSO

       winicontoppm(1), ppm(5)

AUTHOR

       Copyright (C) 2000 by Lee Benfield.

                                                   22 May 2000                                   ppmtowinicon(1)