.TL
Winicontoppm User Manual
.SH 1
winicontoppm
.LP
Updated: 23 March 2003
.br
Table Of Contents
.SH 2
NAME
.LP
winicontoppm - convert a Windows .ico image into 1 or more PPM images
.SH 2
SYNOPSIS
.LP
\fBwinicontoppm\fR
[\fB-writeands\fR]
[\fB-allicons\fR|\fB-bestqual\fR]
[\fB-multippm\fR]
[\fB-verbose\fR]
[\fIiconfile\fR]
[\fIppmdestfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBwinicontoppm\fR reads a Microsoft Windows .ico file and
converts it to one or more PPMs.
.LP
A Windows icon contains one or more images, at different resolutions
and color depths.  Each image has an 'and' mask, which contains transparancy
data. 
.LP
By default, the output goes to Standard Output.  If you specify
\fIppmdestfile\fR, output goes into one or more files named as
follows.  If it's just one file (i.e. you specify the \fB-multippm\fR
option or don't specify \fB-allicons\fR), the file name is
\fIppmdestfile\fR\fB.ppm\fR.  If it's multiple files, their file
names are \fIppmdestfile\fR\fB_1.ppm\fR,
\fIppmdestfile\fR\fB_2.ppm\fR, etc.  
.LP
 When you specify the
\fB-writeands\fR option, the file names above are modified to include
the string \fBxor\fR as in \fIppmdestfile\fR\fB_xor.ppm\fR or
\fIppmdestfile\fR\fB_xor_1.ppm\fR.
.LP
\fBwinicontoppm\fR 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.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-writeands\fR"
For each icon written, also write the 'and' (transparancy) mask as
a separate PBM file.  It's name is of the form
\fIppmdestfile\fR\fB_and.pbm\fR or
\fIppmdestfile\fR\fB_and_1.pbm\fR.
.IP "\fB-allicons\fR"
Extract all images from the .ico file.
.IP "\fB-bestqual\fR"
Extract only the best quality (largest, then highest bpp) image
from the .ico file.
.IP "\fB-multippm\fR"
Write all PPMs to a single file.
.RE
.SH 2
SEE ALSO
.LP
\fBppmtowinicon\fR,
\fBbmptopnm\fR,
\fBppm\fR
.SH 2
AUTHOR
.LP
Copyright (C) 2000, 2003 by Lee Benfield.
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP