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

150 lines
3.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of palmtopnm</TITLE>
</HEAD><BODY>
<H1>palmtopnm</H1>
Section: User Commands (1)<BR>Updated: 15 December 2000<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
palmtopnm - convert a Palm pixmap into a portable anymap
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>palmtopnm</B>
[<B>-verbose</B>]
[<B>-rendition</B>
<I>N</I>]
[<B>-showhist</B>]
<BR>
[<B>-forceplain</B>]
[<I>pnmfile</I>]
<BR>
<B>palmtopnm</B>
<B>-transparent </B>
[<B>-verbose</B>]
[<I>pnmfile</I>]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads a Palm pixmap as input, from stdin or
<I>pnmfile</I>.
Produces either a portable pixmap as output, or writes the value of
the transparent color in the Palm pixmap to stdout.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-verbose</B>
<DD>
Display various interesting information about the input file and process.
<DT id="2"><B>-transparent</B>
<DD>
If the Palm pixmap has a transparent color set, the RGB value for that
color will be written to stdout as in the form #RRGGBB, where
RR, GG, and BB are two-digit hexadecimal numbers
indicating a value between 0 and 255. If no transparent color is set
in the bitmap, nothing will be output. No additional output will be
generated; no anymap will be output.
<DT id="3"><B>-rendition N</B>
<DD>
Palm pixmaps may contain several different renditions of the same
pixmap, with different depths. By default,
<B>palmtopnm </B>
operates on the first rendition (rendition number 1) in the pixmap.
This switch allows you to operate on a different rendition. The value
must be between 1 and the number of renditions in the pixmap,
inclusive.
<DT id="4"><B>-showhist</B>
<DD>
Writes a histogram of colors in the input file to stderr.
<DT id="5"><B>-forceplain</B>
<DD>
Force the output anymap to be in ASCII 'plain' netpbm format.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+pnmtopalm">pnmtopalm</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A>(5)</B>
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>BUGS</H2>
An additional compression format, &quot;packbits,&quot; has been added with
PalmOS 4.0. This package should be updated to handle it.
<P>
You currently cannot generate an alpha mask if the Palm pixmap has a
transparent color. However, you can still do this with
<B>ppmcolormask</B>
with a Netpbm pipe similar to:
<P>
<B>palmtopnm pixmap.palm | ppmcolormask `palmtopnm -transparent pixmap.palm`</B>
<P>
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHORS</H2>
This program was originally written as Tbmptopnm.c, by Ian Goldberg.
It was heavily modified by Bill Janssen to add color, compression, and
transparency function.
<BR>
Copyright 1995-2001 by Ian Goldberg and Bill Janssen.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
<DT id="7"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="8"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="9"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="10"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="11"><A HREF="#lbAG">BUGS</A><DD>
<DT id="12"><A HREF="#lbAH">AUTHORS</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:21 GMT, March 31, 2021
</BODY>
</HTML>