1Pamtowinicon User Manual(0)                        Pamtowinicon User Manual(0)
2
3
4

NAME

6       pamtowinicon  -  convert  Netpbm PAM images to a Microsoft Windows icon
7       file
8
9

SYNOPSIS

11       pamtowinicon  [-pngthreshold=threshold]  [-truetransparent]  [-verbose]
12       [pam_file]
13
14       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
19

DESCRIPTION

21       This program is part of Netpbm(1).
22
23       pamtowinicon reads an RGB_ALPHA Netpbm PAM file and converts  it  to  a
24       Microsoft Windows icon file.
25
26       The output goes to Standard Output.
27
28       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
32
33

OPTIONS

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
39
40
41       -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
46              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
49              The default value for threshold is 128.
50
51
52       -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
57
58       -verbose
59              Print more messages
60
61
62
63
64

IMAGES

66       pamtowinicon reads a (multi-image) Netpbm PAM file as input and outputs
67       an single Windows icon file containing those images.
68
69       The images in the icon file are in the same order as in the PAM input.
70
71
72
73   PAM Input
74       pamtowinicon  interprets the PAM images as follows, based on the number
75       of channels.
76
77
78       ────────────────────────────────────────────────────────────────────
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
87       The tuple types of the PAMs are irrelevant.
88
89
90
91   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
98       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
102       If no transparency data is present in  the  input  image,  pamtowinicon
103       assumes the whole image to be fully opaque.
104
105
106
107   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
112       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
115
116

SEE ALSO

118       ·
119
120              winicontopam(1)
121
122       ·
123
124              ppmtowinicon(1)
125
126       ·
127
128              pam(1)
129
130       ·
131
132              Windows Icons(1)
133
134
135       For  information  on  the   PNG   format,   see   http://schaik.com/png
136http://schaik.com/png⟩ .
137
138
139

HISTORY

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
145
146

AUTHOR

148       Copyright (C) 2013 by Ludolf Holzheid.
149
150       Translated to Netpbm coding style by Bryan Henderson.
151

DOCUMENT SOURCE

153       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
154       source.  The master documentation is at
155
156              http://netpbm.sourceforge.net/doc/pamtowinicon.html
157
158netpbm documentation             12 April 2013     Pamtowinicon User Manual(0)
Impressum