NAME

       winicontopam - convert a Microsoft Windows icon file into a Netpbm PAM file

SYNOPSIS

       winicontopam [-image=index | -allimages] [-andmasks] [-verbose] [icon_file]

       All  options  can be abbreviated to their shortest unique prefix.  You may use two hyphens instead of one
       to designate an option.  You may use either white space or equals signs between an option  name  and  its
       value.

DESCRIPTION

       This program is part of Netpbm(1).

       winicontopam  reads  a  Microsoft  Windows  icon file and converts it to one or more RGB_ALPHA Netpbm PAM
       images.

       There are two kinds of transparency  information  a  a  Windows  icon  can  have:  and  mask  and  graded
       transparency map.  The and mask is older and indicates for each pixel whether it is fully opaque or fully
       transparent.   The  graded transparency map can indicate translucent values too.  The graded transparency
       map is present in an icon that uses PNG encoding or uses BMP encoding with 32 bits per pixel.

       The transparency plane in the PAM output of winicontopam comes from
         the graded transparency map if it exists and the and mask otherwise.

       An icon may actually have both forms of transparency information.  See -andmasks.

       The output goes to Standard Output.

       The output is a multi-image PAM file.  If you want a separate file for each image, use pamsplit(1).

OPTIONS

       In addition to the options common to all programs based on libnetpbm (most notably  -quiet,  see   Common
       Options ), winicontopam recognizes the following command line options:

       -allimages
              Convert all images in the input.

              You may not specify this together with -image.

              By  default,  winicontopam converts only the one "best quality" image (largest, then most bits per
              pixel).

       -image=index
              Convert image number index (starting with zero).

              You may not specify this together with -allimages.

              By default, winicontopam converts the "best quality" image (largest, then most bits per pixel).

       -andmasks
              If the image to be extracted contains both graded transparency data and an AND mask, produce five-
              channel Netpbm PAM images with the AND mask as the fifth plane.  An image that formally has graded
              transparency data, but it indicates nothing but opaque pixels is considered  not  to  have  graded
              transparency data, so -andmasks would have no effect on it.

       -verbose
              Print more messages

SEE ALSO

       •      pamtowinicon(1)

       •      winicontoppm(1)

       •      pamsplit(1)

       •      pam(1)

       •      winicon(1)

       For information on the PNG format, see http://schaik.com/png .

HISTORY

       winicontopam  was  new in Netpbm 10.63 (June 2013).  It obsoleted winicontoppm by providing more function
       and conforming better to Netpbm conventions.

AUTHOR

       Copyright (C) 2013 by Ludolf Holzheid.

       Translated to Netpbm coding style by Bryan Henderson.

DOCUMENT SOURCE

       This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The  master  documentation
       is at

              http://netpbm.sourceforge.net/doc/winicontopam.html

netpbm documentation                             29 August 2020                      Winicontopam User Manual(1)