Debian Codegraph @

upstream/debian-unstable/man1/winicontoppm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Winicontoppm User Manual" 1 "23 March 2003" "netpbm documentation"
7
8 .SH NAME
9 winicontoppm - convert a Windows .ico image into 1 or more PPM images
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBwinicontoppm\fP
15 [\fB-writeands\fP]
16 [\fB-allicons\fP|\fB-bestqual\fP]
17 [\fB-multippm\fP]
18 [\fB-verbose\fP]
19 [\fIiconfile\fP]
20 [\fIppmdestfile\fP]
21
22 .UN description
23 .SH DESCRIPTION
24 .PP
25 This program is part of
26 .BR "Netpbm" (1)\c
27 \&.
28 .PP
29 This program is essentially obsolete; The newer \fBwinicontopam\fP is
30 better.
31 .PP
32 \fBwinicontoppm\fP reads a Microsoft Windows .ico file and
33 converts it to one or more PPMs.
34 .PP
35 A Windows icon contains one or more images, at different resolutions
36 and color depths. Each image has an 'and' mask, which contains transparency
37 data.
38 .PP
39 By default, the output goes to Standard Output. If you specify
40 \fIppmdestfile\fP, output goes into one or more files named as
41 follows. If it's just one file (i.e. you specify the \fB-multippm\fP
42 option or don't specify \fB-allicons\fP), the file name is
43 \fIppmdestfile\fP\fB.ppm\fP. If it's multiple files, their file
44 names are \fIppmdestfile\fP\fB_1.ppm\fP,
45 \fIppmdestfile\fP\fB_2.ppm\fP, etc.
46 .PP
47 When you specify the
48 \fB-writeands\fP option, the file names above are modified to include
49 the string \fBxor\fP as in \fIppmdestfile\fP\fB_xor.ppm\fP or
50 \fIppmdestfile\fP\fB_xor_1.ppm\fP.
51 .PP
52 \fBwinicontoppm\fP can convert .ico images with 1, 4, 8, 24, or
53 32 bits per pixel. Before Netpbm 10.15 (April 2003), it could not handle
54 24 and 32.
55
56 .UN options
57 .SH OPTIONS
58 .PP
59 In addition to the options common to all programs based on libnetpbm
60 (most notably \fB-quiet\fP, see
61 .UR index.html#commonoptions
62 Common Options
63 .UE
64 \&), \fBwinicontoppm\fP recognizes the following
65 command line options:
66
67
68 .TP
69 \fB-writeands\fP
70 For each icon written, also write the 'and' (transparency) mask as
71 a separate PBM file. It's name is of the form
72 \fIppmdestfile\fP\fB_and.pbm\fP or
73 \fIppmdestfile\fP\fB_and_1.pbm\fP.
74
75 .TP
76 \fB-allicons\fP
77 Extract all images from the .ico file.
78 .sp
79 If you specify neither this nor \fB-bestqual\fP, \fBwinicontoppm\fP
80 extracts the first image.
81
82 .TP
83 \fB-bestqual\fP
84 Extract only the best quality (largest, then highest bpp) image
85 from the .ico file.
86 .sp
87 If you specify neither this nor \fB-allicons\fP, \fBwinicontoppm\fP
88 extracts the first image.
89
90 .TP
91 \fB-multippm\fP
92 Write all PPMs to a single file.
93
94
95
96 .UN seealso
97 .SH SEE ALSO
98 .BR "winicontopam" (1)\c
99 \&,
100 .BR "pamtowinicon" (1)\c
101 \&,
102 .BR "bmptopnm" (1)\c
103 \&,
104 .BR "ppm" (1)\c
105 \&
106
107 .UN author
108 .SH AUTHOR
109
110 Copyright (C) 2000, 2003 by Lee Benfield.
111 .SH DOCUMENT SOURCE
112 This manual page was generated by the Netpbm tool 'makeman' from HTML
113 source. The master documentation is at
114 .IP
115 .B http://netpbm.sourceforge.net/doc/winicontoppm.html
116 .PP