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).

       This program is essentially obsolete; The newer pamtowinicon is better.

       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 that
       best matches the number of colors 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
       pgm format specification(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
       transparency mask and ppmtowinicon will treat it like a PGM.

       The and mask is like a transparency 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  foreground  and  background  are
       represented  as  binary  numbers, then corresponding bits of the background and foreground
       intensities are exclusive-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  ppmtowinicon  to  make the base image black
       everywhere your transparency mask says transparent, regardless of what  color  your  input
       image is at that location.

       If you don't specify -andmask, ppmtowinicon puts all-opaque and masks into the .ico file.

OPTIONS

       In addition to the options common to all programs based on libnetpbm (most notably -quiet,
       see
        Common  Options  ⟨index.html#commonoptions⟩  ),  ppmtowinicon  recognizes  the  following
       command line options:

       -andpgms
              Include  transparency  information  in  the  icons.   See  the transparency section
              ⟨#transparency⟩ .

       -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 ⟨#transparency⟩ .

SEE ALSO

       pamtowinicon(1), winicontoppm(1), ppm(1) pgm(1)

AUTHOR

       Copyright (C) 2000 by Lee Benfield.

DOCUMENT SOURCE

       This  manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master
       documentation is at

              http://netpbm.sourceforge.net/doc/ppmtowinicon.html