winicontopam(1)

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

NAME

6       winicontopam  - convert a Microsoft Windows icon file into a Netpbm PAM
7       file
8
9
10

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

HISTORY

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

AUTHOR

125       Copyright (C) 2013 by Ludolf Holzheid.
126
127       Translated to Netpbm coding style by Bryan Henderson.
128

DOCUMENT SOURCE

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)