summary refs log tree commit diff
path: root/winicontoppm.html
blob: a35b406a045641872b720e7ca1d3dd01403544a6 (plain) (blame)
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 transparancy
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' (transparancy) 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>