Debian Codegraph @

userguide/winicontoppm.html

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