1. NAME

winicontoppm - convert a Windows .ico file into 1 or more portable pixmap files

2. SYNOPSIS

winicontoppm [ -writeands ] [ -allicons|-bestqual ] [ -multippm ] [ -verbose ] [ iconfile ] [ ppmdestfile ]

3. DESCRIPTION

Reads a Microsoft Windows .ico file, converts it to one or more ppms. A Windows icon contains 1 or more images, at different resolutions and color depths. Each image has an 'and' mask, which contains transparancy data. By default, the output goes to Standard Output. If you specify ppmdestfile , output goes into one or more files named as follows. If it's just one file (i.e. you specify the

-multippm option or don't specify

R -allicons ), the file specification is .IB ppmdestfile .ppm \fR. If it's multiple files, their file specifications are .IB ppmdestfile "_1.ppm" \fR, .IB ppmdestfile "_2.ppm" \fR, etc. When you specify the

-writeands option, the filenames above are modified to include the string

xor as in .IB ppmdestfile _xor.ppm or .IB ppmdestfile _xor_1.ppm \fR.

winicontoppm can convert images with 1, 4, 8, 24 or 32 bits per pixel (bpp).

4. OPTIONS

-writeands

    For each icon written, also write the 'and' (transparancy) mask as a seperate PBM file. It's name is of the form .IB ppmdestfile _and.pbm or .IB ppmdestfile _and_1.pbm \fR.

-allicons

    Extract all images from the .ico file.

-bestqual

    Extract only the best quality (largest, then highest bpp) image from the .ico file.

-multippm

    Write all ppms to a single file.

5. SEE ALSO

R ppmtowinicon (1),

R ppm (5)

6. AUTHOR

Copyright (C) 2000, 2003 by Lee Benfield.