.TH ppmtowinicon 1 "22 May 2000"
.IX ppmtowinicon
.SH NAME
ppmtowinicon \- convert 1 or more portable pixmaps into a Windows .ico 
file
.SH SYNOPSIS
.B ppmtowinicon
.RI [ \-andppms ]
.RI [ \-output\ output.ico ]
.RI [ ppmfiles ... ]
.SH 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.
.PP
16 x 16 - 4 bpp
.PP
32 x 32 - 4 bpp
.PP
48 x 48 - 8 bpp
.PP
Default I/O is STDIN/STDOUT.
.IX WINICON
.SH OPTIONS
.TP
.B \-andppms
If this option is given, every other file is read as a bitmask to be used by windows
for transparancy data for the previous image.  (These are set to blank by default.)
.TP
.B \-output output.ico
File to write.  By default, the icon is written to stdout.
.SH "SEE ALSO"
winicontoppm(1),
ppm(5)
.SH AUTHOR
Copyright (C) 2000 by Lee Benfield.
.\" Permission to use, copy, modify, and distribute this software and
.\" its documentation for any purpose and without fee is hereby granted,
.\" provided that the above copyright notice appear in all copies and
.\" that both that copyright notice and this permission notice appear in
.\" supporting documentation.  This software is provided "as is" without
.\" express or implied warranty.