1Winicontopam User Manual(0) Winicontopam User Manual(0)
2
3
4
6 winicontopam - convert a Microsoft Windows icon file into a Netpbm PAM
7 file
8
9
10
12 winicontopam [-image=index | -allimages] [-andmasks] [-verbose]
13 [icon_file]
14
15 All options can be abbreviated to their shortest unique prefix. You
16 may use two hyphens instead of one to designate an option. You may use
17 either white space or equals signs between an option name and its
18 value.
19
20
22 This program is part of Netpbm(1).
23
24 winicontopam reads a Microsoft Windows icon file and converts it to one
25 or more RGB_ALPHA Netpbm PAM images.
26
27 There are two kinds of transparency information a a Windows icon can
28 have: and mask and graded transparency map. The and mask is older and
29 indicates for each pixel whether it is fully opaque or fully transpar‐
30 ent. The graded transparency map can indicate translucent values too.
31 The graded transparency map is present in an icon that uses PNG encod‐
32 ing or uses BMP encoding with 32 bits per pixel.
33
34 The transparency plane in the PAM output of winicontopam comes from
35 the graded transparency map if it exists and the and mask otherwise.
36
37 An icon may actually have both forms of transparency information. See
38 -andmasks.
39
40 The output goes to Standard Output.
41
42 The output is a multi-image PAM file. If you want a separate file for
43 each image, use pamsplit(1).
44
45
46
48 In addition to the options common to all programs based on libnetpbm
49 (most notably -quiet, see
50 Common Options ⟨index.html#commonoptions⟩ ), winicontopam recognizes
51 the following command line options:
52
53
54
55
56 -allimages
57 Convert all images in the input.
58
59 You may not specify this together with -image.
60
61 By default, winicontopam converts only the one "best quality"
62 image (largest, then most bits per pixel).
63
64
65 -image=index
66 Convert image number index (starting with zero).
67
68 You may not specify this together with -allimages.
69
70 By default, winicontopam converts the "best quality" image
71 (largest, then most bits per pixel).
72
73
74 -andmasks
75 If the image to be extracted contains both graded transparency
76 data and an AND mask, produce five-channel Netpbm PAM images
77 with the AND mask as the fifth plane. An image that formally
78 has graded transparency data, but it indicates nothing but
79 opaque pixels is considered not to have graded transparency
80 data, so -andmasks would have no effect on it.
81
82
83 -verbose
84 Print more messages
85
86
87
88
89
91 ·
92
93 pamtowinicon(1)
94
95 ·
96
97 winicontoppm(1)
98
99 ·
100
101 pamsplit(1)
102
103 ·
104
105 pam(1)
106
107 ·
108
109 winicon(1)
110
111
112 For information on the PNG format, see http://schaik.com/png
113 ⟨http://schaik.com/png⟩ .
114
115
116
118 winicontopam was new in Netpbm 10.63 (June 2013). It obsoleted wini‐
119 contoppm by providing more function and conforming better to Netpbm
120 conventions.
121
122
123
125 Copyright (C) 2013 by Ludolf Holzheid.
126
127 Translated to Netpbm coding style by Bryan Henderson.
128
130 This manual page was generated by the Netpbm tool 'makeman' from HTML
131 source. The master documentation is at
132
133 http://netpbm.sourceforge.net/doc/winicontopam.html
134
135netpbm documentation 29 August 2020 Winicontopam User Manual(0)