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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it! If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Winicontopam User Manual" 1 "29 August 2020" "netpbm documentation"
.SH NAME
winicontopam - convert a Microsoft Windows icon file into a Netpbm PAM file
.UN synopsis
.SH SYNOPSIS
\fBwinicontopam\fP
[\fB-image=\fP\fIindex\fP | \fB-allimages\fP]
[\fB-andmasks\fP]
[\fB-verbose\fP]
[\fIicon_file\fP]
.PP
All options can be abbreviated to their shortest unique prefix.
You may use two hyphens instead of one to designate an option. You
may use either white space or equals signs between an option name and
its value.
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBwinicontopam\fP reads a Microsoft Windows icon file and converts it to
one or more RGB_ALPHA Netpbm PAM images.
.PP
There are two kinds of transparency information a a Windows icon can have:
and mask and graded transparency map. The and mask is older and indicates for
each pixel whether it is fully opaque or fully transparent. The graded
transparency map can indicate translucent values too. The graded transparency
map is present in an icon that uses PNG encoding or uses BMP encoding with 32
bits per pixel.
.PP
The transparency plane in the PAM output of \fBwinicontopam\fP comes from
the graded transparency map if it exists and the and mask otherwise.
.PP
An icon may actually have both forms of transparency information. See
\fB-andmasks\fP.
.PP
The output goes to Standard Output.
.PP
The output is a multi-image PAM file. If you want a separate file for
each image, use
.BR "\fBpamsplit\fP" (1)\c
\&.
.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see
.UR index.html#commonoptions
Common Options
.UE
\&), \fBwinicontopam\fP recognizes the following
command line options:
.TP
\fB-allimages\fP
Convert all images in the input.
.sp
You may not specify this together with \fB-image\fP.
.sp
By default, \fBwinicontopam\fP converts only the one "best
quality" image (largest, then most bits per pixel).
.TP
\fB-image=\fP\fIindex\fP
Convert image number \fIindex\fP (starting with zero).
.sp
You may not specify this together with \fB-allimages\fP.
.sp
By default, \fBwinicontopam\fP converts the "best quality"
image (largest, then most bits per pixel).
.TP
\fB-andmasks\fP
If the image to be extracted contains both graded transparency data and an
AND mask, produce five-channel Netpbm PAM images with the AND mask as the
fifth plane. An image that formally has graded transparency data, but it
indicates nothing but opaque pixels is considered not to have graded
transparency data, so \fB-andmasks\fP would have no effect on it.
.TP
\fB-verbose\fP
Print more messages
.UN seealso
.SH SEE ALSO
.IP \(bu
.BR "\fBpamtowinicon\fP" (1)\c
\&
.IP \(bu
.BR "\fBwinicontoppm\fP" (1)\c
\&
.IP \(bu
.BR "\fBpamsplit\fP" (1)\c
\&
.IP \(bu
.BR "\fBpam\fP" (1)\c
\&
.IP \(bu
.BR "\fBwinicon\fP" (1)\c
\&
.PP
For information on the PNG format,
see
.UR http://schaik.com/png
http://schaik.com/png
.UE
\&.
.UN history
.SH HISTORY
.PP
\fBwinicontopam\fP was new in Netpbm 10.63 (June 2013). It obsoleted
\fBwinicontoppm\fP by providing more function and conforming better to Netpbm
conventions.
.UN author
.SH AUTHOR
.PP
Copyright (C) 2013 by Ludolf Holzheid.
.PP
Translated to Netpbm coding style by Bryan Henderson.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/winicontopam.html
.PP
|
