winicontopam1

Usage

Overview

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 ⟨index.html#commonoptions⟩ ), 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

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