| 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> |