1Pamtowinicon User Manual(0) Pamtowinicon User Manual(0)
2
6 pamtowinicon - convert Netpbm PAM images to a Microsoft Windows icon
7 file
8
11 pamtowinicon [-pngthreshold=threshold] [-truetransparent] [-verbose]
12 [pam_file]
13 All options can be abbreviated to their shortest unique prefix. You
15 may use two hyphens instead of one to designate an option. You may use
16 either white space or equals signs between an option name and its
17 value.
18
21 This program is part of Netpbm(1).
22 pamtowinicon reads an RGB_ALPHA Netpbm PAM file and converts it to a
24 Microsoft Windows icon file.
25 The output goes to Standard Output.
27 The input is a multi-image PAM file; each image becomes an icon in the
29 output file. If you have input images in multiple files, you can sim‐
30 ply combine them with cat and pass the result to pamtowinicon.
31
35 In addition to the options common to all programs based on libnetpbm
36 (most notably -quiet, see Common Options ⟨index.html#commonoptions⟩ ),
37 pamtowinicon recognizes the following command line options:
38 -pngthreshold=threshold
42 pamtowinicon encodes images with resolutions above or equal
43 threshold by threshold as PNG by running pnmtopng(1). Other
44 images it encodes using the more traditional BMP format.
45 When the program uses PNG encoding for a 5-channel PAM with sep‐
47 arate AND mask (see below), it discards the AND mask.
48 The default value for threshold is 128.
50 -truetransparent
53 Make all pixels outside the opaque area black, avoiding inver‐
54 sion and other effects on the background of the image (see Win‐
55 dows Icons(1)).
56 -verbose
59 Print more messages
60
66 pamtowinicon reads a (multi-image) Netpbm PAM file as input and outputs
67 an single Windows icon file containing those images.
68 The images in the icon file are in the same order as in the PAM input.
70 PAM Input
74 pamtowinicon interprets the PAM images as follows, based on the number
75 of channels.
76 ────────────────────────────────────────────────────────────────────
79 channels image
80 1 fully opaque grayscale image
81 2 grayscale image with transparency channel
82 3 fully opaque color image
83 4 color image with transparency channel
84 5 color image with transparency channel and additional AND
85 mask
86 The tuple types of the PAMs are irrelevant.
88 AND Mask
92 The so-called "AND mask" is a special feature of Microsoft Windows
93 icons. It is required for all BMP encoded images. At the first sight,
94 the AND mask is a 1-bit transparency channel, but it is also used for
95 e.g. shading the icon while dragging. See Windows Icons(1) for
96 details.
97 If there is no explicit AND mask, but transparency data in the input
99 image, pamtowinicon sets the AND mask to opaque where the sample in the
100 transparency channel is below maxval, and to transparent elsewhere.
101 If no transparency data is present in the input image, pamtowinicon
103 assumes the whole image to be fully opaque.
104 BMP Output
108 When BMP encoding an image, pamtowinicon tries to use the most compact
109 BI_RGB format allowed for icon images with a color depth of eight bits
110 per channel.
111 pamtowinicon generates neither 16-bit BI_RGB nor BI_BITFIELDS BMP
113 encoded images, even if the maxval of the input PAM is not 255.
114
118 ·
119 winicontopam(1)
121 ·
123 ppmtowinicon(1)
125 ·
127 pam(1)
129 ·
131 Windows Icons(1)
133 For information on the PNG format, see http://schaik.com/png
136 ⟨http://schaik.com/png⟩ .
137
141 pamtowinicon was new in Netpbm 10.63 (June 2013). It obsoleted ppm‐
142 towinicon by providing more function and conforming better to Netpbm
143 conventions.
144
148 Copyright (C) 2013 by Ludolf Holzheid.
149 Translated to Netpbm coding style by Bryan Henderson.
151
153 This manual page was generated by the Netpbm tool 'makeman' from HTML
154 source. The master documentation is at
155 http://netpbm.sourceforge.net/doc/pamtowinicon.html
157netpbm documentation 12 April 2013 Pamtowinicon User Manual(0)