Manual: ppmtowinicon

Ppmtowinicon User Manual(1)			   General Commands Manual			 Ppmtowinicon User Manual(1)

NAME
       ppmtowinicon - convert PPM image into a Windows .ico file

SYNOPSIS
       ppmtowinicon

       [-andpgms]

       [-output=output.ico]

       [ppmfile [andfile] ...]

DESCRIPTION
       This program is part of Netpbm(1).

       This program is essentially obsolete; The newer pamtowinicon is better.

       ppmtowinicon reads one or more PPM images as input and produces a Microsoft Windows .ico file as output.

       A  Windows  icon contains 1 or more images, at different resolutions and color depths.  When Windows wants to display
       the icon, it searches through the images to find the one that best matches the number of colors and resolution of the
       display.

       Microsoft recommends including at least the following formats in each icon.

       •      16 x 16 - 4 bpp

       •      32 x 32 - 4 bpp

       •      48 x 48 - 8 bpp

       If you don't specify any input files, input is from Standard Input.

       Output is to Standard Output unless you specify -output.

   Transparency
       If you specify the -andmask option, you get (partly) transparent icons.	In that case, your arguments  are  pairs  of
       file names, with the first file name being that of the image and the second file name being that of a standard Netpbm
       PGM transparency mask (see the pgm format specification(1)).

       In  a  .ico  file, there is no such thing as partial transparency (translucency).  Where the PGM mask says completely
       opaque, the icon will be opaque.	 Everywhere else, the icon will be transparent.	 Note that as with any	Netpbm	pro‐
       gram, you can use a PBM image for the transparency mask and ppmtowinicon will treat it like a PGM.

       The and mask is like a transparency mask, except for what it signifies in the "not opaque" areas.  In the usual case,
       the  foreground	image  is  black  in those areas, and in that case the areas are fully transparent -- the background
       shows through the icon.	But in general, a not opaque pixel signifies that the background and  foreground  should  be
       merged as follows: The intensities of the color components in the foreground and background are represented as binary
       numbers, then corresponding bits of the background and foreground intensities are exclusive-or'ed together.  So there
       is a sort of reverse video effect.

       If you don't want this special effect and instead want straightforward transparency, use the -truetransparent option.
       This  causes ppmtowinicon to make the base image black everywhere your transparency mask says transparent, regardless
       of what color your input image is at that location.

       If you don't specify -andmask, ppmtowinicon puts all-opaque and masks into the .ico file.

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

       -andpgms
	      Include transparency information in the icons.  See the transparency section .

       -output=output.ico
	      Name of output file.  By default, ppmtowinicon writes the icon to Standard Output.

       -truetransparent
	      Make  transparency  in the icon normal instead of the special reverse video effect.  See the transparency sec‐
	      tion .

SEE ALSO
       pamtowinicon(1), winicontoppm(1), ppm(1) pgm(1)

AUTHOR
       Copyright (C) 2000 by Lee Benfield.

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/ppmtowinicon.html

netpbm documentation					 01 May 2004				 Ppmtowinicon User Manual(1)