1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Winicontoppm User Manual</title></head>
<body>
<h1>winicontoppm</h1>
Updated: 23 March 2003
<br>
<a href="#index">Table Of Contents</a>
<h2>NAME</h2>
winicontoppm - convert a Windows .ico image into 1 or more PPM images
<h2 id="synopsis">SYNOPSIS</h2>
<b>winicontoppm</b>
[<b>-writeands</b>]
[<b>-allicons</b>|<b>-bestqual</b>]
[<b>-multippm</b>]
[<b>-verbose</b>]
[<i>iconfile</i>]
[<i>ppmdestfile</i>]
<h2 id="description">DESCRIPTION</h2>
<p>This program is part of <a href="index.html">Netpbm</a>.
<p>This program is essentially obsolete; The newer <b>winicontopam</b> is
better.
<p><b>winicontoppm</b> reads a Microsoft Windows .ico file and
converts it to one or more PPMs.
<p>A Windows icon contains one or more images, at different resolutions
and color depths. Each image has an 'and' mask, which contains transparency
data.
<p>By default, the output goes to Standard Output. If you specify
<i>ppmdestfile</i>, output goes into one or more files named as
follows. If it's just one file (i.e. you specify the <b>-multippm</b>
option or don't specify <b>-allicons</b>), the file name is
<i>ppmdestfile</i><b>.ppm</b>. If it's multiple files, their file
names are <i>ppmdestfile</i><b>_1.ppm</b>,
<i>ppmdestfile</i><b>_2.ppm</b>, etc. <p> When you specify the
<b>-writeands</b> option, the file names above are modified to include
the string <b>xor</b> as in <i>ppmdestfile</i><b>_xor.ppm</b> or
<i>ppmdestfile</i><b>_xor_1.ppm</b>.
<p><b>winicontoppm</b> 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.
<h2 id="options">OPTIONS</h2>
<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>winicontoppm</b> recognizes the following
command line options:
<dl compact>
<dt><b>-writeands</b>
<dd>For each icon written, also write the 'and' (transparency) mask as
a separate PBM file. It's name is of the form
<i>ppmdestfile</i><b>_and.pbm</b> or
<i>ppmdestfile</i><b>_and_1.pbm</b>.
<dt><b>-allicons</b>
<dd>Extract all images from the .ico file.
<p>If you specify neither this nor <b>-bestqual</b>, <b>winicontoppm</b>
extracts the first image.
<dt><b>-bestqual</b>
<dd>Extract only the best quality (largest, then highest bpp) image
from the .ico file.
<p>If you specify neither this nor <b>-allicons</b>, <b>winicontoppm</b>
extracts the first image.
<dt><b>-multippm</b>
<dd>Write all PPMs to a single file.
</dl>
<h2 id="seealso">SEE ALSO</h2>
<b><a href="winicontopam.html">winicontopam</a></b>,
<b><a href="pamtowinicon.html">pamtowinicon</a></b>,
<b><a href="bmptopnm.html">bmptopnm</a></b>,
<b><a href="ppm.html">ppm</a></b>
<h2 id="author">AUTHOR</h2>
Copyright (C) 2000, 2003 by Lee Benfield.
<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>
|
