NAME

       winicontoppm - convert a Windows .ico file into 1 or more portable pixmap files

SYNOPSIS

       winicontoppm   [-writeands]   [-allicons|-bestqual]   [-multippm]   [-verbose]  [iconfile]
       [ppmdestfile]

DESCRIPTION

       Reads a Microsoft Windows .ico file, converts it to one or more ppms.

       A Windows icon contains 1 or more images, at different resolutions and color depths.  Each
       image has an 'and' mask, which contains transparancy data.

       By  default,  the output goes to Standard Output.  If you specify ppmdestfile, output goes
       into one or more files named as follows.  If it's just one  file  (i.e.  you  specify  the
       -multippm  option  or don't specify -allicons), the file specification is ppmdestfile.ppm.
       If   it's   multiple   files,   their   file   specifications    are    ppmdestfile_1.ppm,
       ppmdestfile_2.ppm, etc.

       When  you  specify  the -writeands option, the filenames above are modified to include the
       string xor as in ppmdestfile_xor.ppm or ppmdestfile_xor_1.ppm.

       winicontoppm can convert images with 1, 4, 8, 24 or 32 bits per pixel (bpp).

OPTIONS

       -writeands
              For each icon written, also write the 'and' (transparancy) mask as a  seperate  PBM
              file.  It's name is of the form ppmdestfile_and.pbm or ppmdestfile_and_1.pbm.

       -allicons
              Extract all images from the .ico file.

       -bestqual
              Extract only the best quality (largest, then highest bpp) image from the .ico file.

       -multippm
              Write all ppms to a single file.

SEE ALSO

       ppmtowinicon(1), ppm(5)

AUTHOR

       Copyright (C) 2000, 2003 by Lee Benfield.

                                           22 May 2000                            winicontoppm(1)