230 lines
5.5 KiB
HTML
230 lines
5.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pnmtopalm</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pnmtopalm</H1>
|
|
Section: User Commands (1)<BR>Updated: 7 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"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pnmtopalm - convert a portable anymap into a Palm pixmap
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pnmtopalm</B>
|
|
|
|
[<B>-verbose</B>]
|
|
|
|
[<B>-depth</B>
|
|
|
|
<I>N</I>]
|
|
|
|
[<B>-maxdepth</B>
|
|
|
|
<I>N</I>]
|
|
|
|
[<B>-colormap</B>]
|
|
|
|
[<B>-transparent</B>
|
|
|
|
<I>color</I>]
|
|
|
|
[<B>-offset</B>]
|
|
|
|
<BR>
|
|
|
|
[<B>-rle-compression</B>|<B>-scanline-compression</B>]
|
|
|
|
[<I>pnmfile</I>]
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Reads a PNM image as input, from stdin or
|
|
<I>pnmfile</I>.
|
|
|
|
Produces a Palm pixmap as output.
|
|
<A NAME="ixAAC"></A>
|
|
<P>
|
|
|
|
Palm pixmap files are either greyscale files 1, 2, or 4 bits wide, or
|
|
color files 8 bits wide, so
|
|
<B>pnmtopalm </B>
|
|
|
|
automatically scales colors to have an appropriate maxval, unless you
|
|
specify a depth or max depth. Input files must have an appropriate
|
|
number and set of colors for the selected output constraints. This
|
|
often means that you should run the PNM image through
|
|
<B>ppmquant</B>
|
|
|
|
before you pass it to
|
|
<B>pnmtopalm</B>.
|
|
|
|
Netpbm comes with several colormap files you can use with
|
|
<B>ppmquant</B>
|
|
|
|
for this purpose. They are
|
|
<B>palmgray2.map </B>
|
|
|
|
(4 shades of gray for a depth of 2),
|
|
<B>palmgray4.map </B>
|
|
|
|
(16 shades of gray for a depth of 4), and
|
|
<B>palmcolor8.map </B>
|
|
|
|
(232 colors in default Palm colormap).
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-verbose</B>
|
|
|
|
<DD>
|
|
Display the format of the output file.
|
|
<DT id="2"><B>-depth </B><I>N</I>
|
|
|
|
<DD>
|
|
Produce a file of depth
|
|
<I>N</I>,
|
|
|
|
where
|
|
<I>N </I>
|
|
|
|
must be either 1, 2, 4, 8, or 16. Any depth greater than 1 will
|
|
produce a version 1 or 2 bitmap. Because the default Palm 8-bit
|
|
colormap is not grayscale, if the input is a grayscale or monochrome
|
|
pixmap, the output will never be more than 4 bits deep, regardless of
|
|
the specified depth. Note that 8-bit color works only in PalmOS 3.5
|
|
(and higher), and 16-bit direct color works only in PalmOS 4.0 (and
|
|
higher). However, the 16-bit direct color format is also compatible
|
|
with the various PalmOS 3.x versions used in the Handspring Visor, so
|
|
these images may also work in that device.
|
|
<DT id="3"><B>-maxdepth </B><I>N</I>
|
|
|
|
<DD>
|
|
Produce a file of minimal depth, but in any case less than
|
|
<I>N </I>
|
|
|
|
bits wide. If you specify 16-bit, the output will always be 16-bit
|
|
direct color.
|
|
<DT id="4"><B>-offset</B>
|
|
|
|
<DD>
|
|
Fill in the
|
|
<B>nextDepthOffset </B>
|
|
|
|
field in the file header, to provide for multiple renditions of the
|
|
pixmap in the same file.
|
|
<DT id="5"><B>-colormap</B>
|
|
|
|
<DD>
|
|
Build a custom colormap and include it in the output file. This is
|
|
not recommended by Palm, for efficiency reasons. Otherwise,
|
|
<B>pnmtopalm </B>
|
|
|
|
uses the default Palm colormap for color output.
|
|
<DT id="6"><B>-transparent </B><I>color</I>
|
|
|
|
<DD>
|
|
Marks
|
|
<I>one</I>
|
|
|
|
particular color as fully transparent. The format to specify the
|
|
color is either (when for example orange) "1.0,0.5,0.0", where the
|
|
values are floats between zero and one, or with the syntax "#RGB",
|
|
"#RRGGBB" or "#RRRRGGGGBBBB" where R, G and B are hexadecimal numbers.
|
|
This also makes the output bitmap a version 2 bitmap. Transparency
|
|
works only on Palm OS 3.5 and higher.
|
|
<DT id="7"><B>-rle-compression</B>
|
|
|
|
<DD>
|
|
Specifies that the output Palm bitmap will use the Palm RLE
|
|
compression scheme, and will be a version 2 bitmap. RLE compression
|
|
works only with Palm OS 3.5 and higher.
|
|
<DT id="8"><B>-scanline-compression</B>
|
|
|
|
<DD>
|
|
Specifies that the output Palm bitmap will use the Palm scanline
|
|
compression scheme, and will be a version 2 bitmap. Scanline
|
|
compression works only in Palm OS 2.0 and higher.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+palmtopnm">palmtopnm</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ppmquant">ppmquant</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A></B>(5)
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
An additional compression format,
|
|
<B>packbits</B>,
|
|
|
|
was added with PalmOS 4.0. This package should be updated to
|
|
be able to generate that.
|
|
<P>
|
|
Palm pixmaps may contains multiple renditions of the same pixmap, in
|
|
different depths. To construct an N-multiple-rendition Palm pixmap
|
|
with
|
|
<B>pnmtopalm</B>,
|
|
|
|
first construct renditions 1 through N-1 using the
|
|
<B>-offset</B>
|
|
|
|
option, then construct the Nth pixmap without the
|
|
<B>-offset </B>
|
|
|
|
option. Then concatenate the individual renditions together in a
|
|
single file using
|
|
<B>cat</B>.
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
This program was originally written as ppmtoTbmp.c, by Ian Goldberg
|
|
and George Caswell. It was completely re-written by Bill Janssen to
|
|
add color, compression, and transparency function.
|
|
<BR>
|
|
|
|
Copyright 1995-2001 by Ian Goldberg, George Caswell, and Bill Janssen.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="13"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="14"><A HREF="#lbAG">NOTES</A><DD>
|
|
<DT id="15"><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:24 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|