Debian Codegraph @

upstream/debian-unstable/man1/winicontopam.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 "Winicontopam User Manual" 1 "29 August 2020" "netpbm documentation"
7
8 .SH NAME
9
10 winicontopam - convert a Microsoft Windows icon file into a Netpbm PAM file
11
12
13 .UN synopsis
14 .SH SYNOPSIS
15
16 \fBwinicontopam\fP
17 [\fB-image=\fP\fIindex\fP | \fB-allimages\fP]
18 [\fB-andmasks\fP]
19 [\fB-verbose\fP]
20 [\fIicon_file\fP]
21 .PP
22 All options can be abbreviated to their shortest unique prefix.
23 You may use two hyphens instead of one to designate an option. You
24 may use either white space or equals signs between an option name and
25 its value.
26
27 .UN description
28 .SH DESCRIPTION
29 .PP
30 This program is part of
31 .BR "Netpbm" (1)\c
32 \&.
33 .PP
34 \fBwinicontopam\fP reads a Microsoft Windows icon file and converts it to
35 one or more RGB_ALPHA Netpbm PAM images.
36 .PP
37 There are two kinds of transparency information a a Windows icon can have:
38 and mask and graded transparency map. The and mask is older and indicates for
39 each pixel whether it is fully opaque or fully transparent. The graded
40 transparency map can indicate translucent values too. The graded transparency
41 map is present in an icon that uses PNG encoding or uses BMP encoding with 32
42 bits per pixel.
43 .PP
44 The transparency plane in the PAM output of \fBwinicontopam\fP comes from
45 the graded transparency map if it exists and the and mask otherwise.
46 .PP
47 An icon may actually have both forms of transparency information. See
48 \fB-andmasks\fP.
49 .PP
50 The output goes to Standard Output.
51 .PP
52 The output is a multi-image PAM file. If you want a separate file for
53 each image, use
54 .BR "\fBpamsplit\fP" (1)\c
55 \&.
56
57
58 .UN options
59 .SH OPTIONS
60 .PP
61 In addition to the options common to all programs based on libnetpbm
62 (most notably \fB-quiet\fP, see
63 .UR index.html#commonoptions
64 Common Options
65 .UE
66 \&), \fBwinicontopam\fP recognizes the following
67 command line options:
68
69
70
71 .TP
72 \fB-allimages\fP
73 Convert all images in the input.
74 .sp
75 You may not specify this together with \fB-image\fP.
76 .sp
77 By default, \fBwinicontopam\fP converts only the one "best
78 quality" image (largest, then most bits per pixel).
79
80 .TP
81 \fB-image=\fP\fIindex\fP
82 Convert image number \fIindex\fP (starting with zero).
83 .sp
84 You may not specify this together with \fB-allimages\fP.
85 .sp
86 By default, \fBwinicontopam\fP converts the "best quality"
87 image (largest, then most bits per pixel).
88
89 .TP
90 \fB-andmasks\fP
91 If the image to be extracted contains both graded transparency data and an
92 AND mask, produce five-channel Netpbm PAM images with the AND mask as the
93 fifth plane. An image that formally has graded transparency data, but it
94 indicates nothing but opaque pixels is considered not to have graded
95 transparency data, so \fB-andmasks\fP would have no effect on it.
96
97 .TP
98 \fB-verbose\fP
99 Print more messages
100
101
102
103
104 .UN seealso
105 .SH SEE ALSO
106
107
108 .IP \(bu
109 .BR "\fBpamtowinicon\fP" (1)\c
110 \&
111 .IP \(bu
112 .BR "\fBwinicontoppm\fP" (1)\c
113 \&
114 .IP \(bu
115 .BR "\fBpamsplit\fP" (1)\c
116 \&
117 .IP \(bu
118 .BR "\fBpam\fP" (1)\c
119 \&
120 .IP \(bu
121 .BR "\fBwinicon\fP" (1)\c
122 \&
123
124 .PP
125 For information on the PNG format,
126 see
127 .UR http://schaik.com/png
128 http://schaik.com/png
129 .UE
130 \&.
131
132
133 .UN history
134 .SH HISTORY
135 .PP
136 \fBwinicontopam\fP was new in Netpbm 10.63 (June 2013). It obsoleted
137 \fBwinicontoppm\fP by providing more function and conforming better to Netpbm
138 conventions.
139
140
141 .UN author
142 .SH AUTHOR
143 .PP
144 Copyright (C) 2013 by Ludolf Holzheid.
145 .PP
146 Translated to Netpbm coding style by Bryan Henderson.
147 .SH DOCUMENT SOURCE
148 This manual page was generated by the Netpbm tool 'makeman' from HTML
149 source. The master documentation is at
150 .IP
151 .B http://netpbm.sourceforge.net/doc/winicontopam.html
152 .PP