winicontoppm

   Updated: 23 March 2003
   Table Of Contents

NAME

   winicontoppm - convert a Windows .ico image into 1 or more PPM
images

SYNOPSIS

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

DESCRIPTION

   This program is part of Netpbm.

   winicontoppm	 reads a Microsoft Windows .ico file and converts
it to one or
   more PPMs.

   A Windows icon contains one or more images, at different reso-
lutions 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 -alli-
cons), the file
   name	  is  ppmdestfile.ppm. If it's multiple files, their file
names are
   ppmdestfile_1.ppm, ppmdestfile_2.ppm, etc.

   When you specify the -writeands option, the file  names  above
are modified to
   include  the	 string xor as in ppmdestfile_xor.ppm or ppmdest-
file_xor_1.ppm.

   winicontoppm can convert .ico images with 1, 4, 8, 24,  or  32
bits per pixel.
   Before  Netpbm  10.15 (April 2003), it could not handle 24 and
32.

OPTIONS

   -writeands
	  For  each  icon   written,   also   write   the   'and'
(transparancy) mask as a
	  separate  PBM	 file.	It's name is of the form ppmdest-
file_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, bmptopnm, ppm

AUTHOR

   Copyright (C) 2000, 2003 by Lee Benfield.
     _________________________________________________________________



Table Of Contents

     * NAME
     * SYNOPSIS
     * DESCRIPTION
     * OPTIONS
     * SEE ALSO
     * AUTHOR

UNIX/Linux commands referenced on this page:

1. convert
2. more
3. file
4. at
5. which
6. as
7. write
8. ppmtowinicon
9. bmptopnm