man-pages/man1/ppmtowinicon.1.html
2021-03-31 01:06:50 +01:00

120 lines
3.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of ppmtowinicon</TITLE>
</HEAD><BODY>
<H1>ppmtowinicon</H1>
Section: User Commands (1)<BR>Updated: 22 May 2000<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<P>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
ppmtowinicon - convert 1 or more portable pixmaps into a Windows .ico
file
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>ppmtowinicon</B>
[<I>-andpgms</I>]
[<I>-output&nbsp;output.ico</I>]
[<I>ppmfiles</I>...<I>]</I>
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads one or more portable pixmaps as input.
Produces a Microsoft Windows .ico file as output.
<P>
A Windows icon contains 1 or more images, at different resolutions
and color depths.
<P>
Microsoft recommends including at least the following formats in each
icon (size and bits-per-pixel):
<P>
16 x 16 - 4 bpp
<P>
32 x 32 - 4 bpp
<P>
48 x 48 - 8 bpp
<P>
Default I/O is STDIN/STDOUT.
<A NAME="ixAAC"></A>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-andpgms</B>
<DD>
If this option is given, every second file is read as an &quot;and mask&quot; to be
used by windows for transparency data for the previous image. (These are
set to fully opaque by default). The and mask is a PGM image, where any
pixel with maxval intensity means opaque and any other pixel means not
opaque. Note that as with all Netpbm programs, you may use a PBM file here
and it will be used as if it were the equivalent PGM.
<P>
The and mask is like an alpha mask, except for what it signifies in the
&quot;not opaque&quot; 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 forgeground and background
are represented as binary numbers, then corresponding bits of the
background and foreground intensities are exlusive-or'ed together. So there
is a sort of reverse video effect.
<P>
<DT id="2"><B>-output output.ico</B>
<DD>
File to write. By default, the icon is written to stdout.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+winicontoppm">winicontoppm</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A></B>(5)
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Copyright (C) 2000 by Lee Benfield.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="3"><A HREF="#lbAB">NAME</A><DD>
<DT id="4"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="5"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="6"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="7"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="8"><A HREF="#lbAG">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:25 GMT, March 31, 2021
</BODY>
</HTML>