Winicontoppm User Manual(1) General Commands Manual Winicontoppm User Manual(1)
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(1).
This program is essentially obsolete; The newer winicontopam is better.
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 resolutions and
color depths. Each image has an 'and' mask, which contains transparency
data.
By default, the output goes to Standard Output. If you specify ppmdest-
file, 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 modi-
fied 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
In addition to the options common to all programs based on libnetpbm
(most notably -quiet, see ]8;;index.html#commonoptions\ Common Options]8;;\ ), winicontoppm recognizes the
following command line options:
-writeands
For each icon written, also write the 'and' (transparency) 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.
If you specify neither this nor -bestqual, winicontoppm extracts
the first image.
-bestqual
Extract only the best quality (largest, then highest bpp) image
from the .ico file.
If you specify neither this nor -allicons, winicontoppm extracts
the first image.
-multippm
Write all PPMs to a single file.
SEE ALSO
winicontopam(1), pamtowinicon(1), bmptopnm(1), ppm(1)
AUTHOR
Copyright (C) 2000, 2003 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/winicontoppm.html
netpbm documentation 23 March 2003 Winicontoppm User Manual(1)
Generated by dwww version 1.16 on Tue Dec 16 05:59:28 CET 2025.