Updated: 26 January 2005
Table Of Contents
palmtopnm - convert a Palm Bitmap to a PNM image
This program is part of Netpbm.
palmtopnm reads a Palm Bitmap as input, from Standard Input or
palmfile and produces a PPM image as output.
Alternatively (when you specify -transparent),
palmtopnm writes the value of the transparent color in the Palm
Bitmap to Standard Output.
Palmtopnm can convert Palm Bitmaps with the following features.
This does not mean that it doesn't handle other features. These are just
the ones we found worth mentioning.
- Version 0
- Version 1
- Version 2
- Version 3 (new in Netpbm 10.27 (March 2005))
- Scanline compression
- RLE compression
- Packbits compression (new in Netpbm 10.27 (March 2005))
Display various interesting information about the input file and process.
If the Palm Bitmap has a transparent color set,
palmtopnm writes the value for that
color to Standard Output in the form #RRGGBB, where
RR, GG, and BB are two-digit hexadecimal numbers
indicating a value in the range 0 through 255. If no transparent color is set
in the Bitmap, palmtopnm writes nothing. palmtopnm does not
generate any output image when you specify -transparent.
- -rendition N
Palm Bitmaps may contain several different renditions of the same
image, with different depths. By default, palmtopnm operates
on the first rendition (rendition number 1) in the image. This
switch allows you to operate on a different rendition. The value must
be between 1 and the number of renditions in the image, inclusive.
This option causes palmtopnm to
write a histogram of colors in the input file to Standard Error.
You cannot generate a transparency mask if the Palm Bitmap has a
transparent color. However, you can still do this with
ppmcolormask with a Netpbm pipe similar to:
palmtopnm bitmap.palm |
ppmcolormask `palmtopnm -transparent bitmap.palm`
Before Netpbm 10.23 (July 2004), there was a -forceplain
option. But that had been redundant for a long time, since the Netpbm
common option -plain does the same thing.
This program was originally written as Tbmptopnm.c, by Ian Goldberg.
It was heavily modified by Bill Janssen to add color, compression, and
Copyright 1995-2001 by Ian Goldberg and Bill Janssen.
Table Of Contents