palmtopnm

Updated: 15 December 2000
Table Of Contents  

NAME

palmtopnm - convert a Palm pixmap into a PNM image  

SYNOPSIS

palmtopnm [-verbose] [-rendition N] [-showhist]
[palmfile]
palmtopnm -transparent [-verbose] [palmfile]  

DESCRIPTION

palmtopnm reads a Palm pixmap 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 pixmap to Standard Output.  

OPTIONS

-verbose
Display various interesting information about the input file and process.
-transparent
If the Palm pixmap 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 pixmap, palmtopnm writes nothing. palmtopnm does not generate any output image when you specify -transparent.
-rendition N
Palm pixmaps may contain several different renditions of the same pixmap, with different depths. By default, palmtopnm 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.
-showhist
This option causes palmtopnm to write a histogram of colors in the input file to Standard Error.
 

SEE ALSO

pnmtopalm, pnm  

LIMITATIONS

An additional compression format, "packbits," has been added with PalmOS 4.0. This program does not handle it.

You currently cannot generate an alpha mask if the Palm pixmap has a transparent color. However, you can still do this with ppmcolormask with a Netpbm pipe similar to:

palmtopnm pixmap.palm | ppmcolormask `palmtopnm -transparent pixmap.palm`

HISTORY

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.  

AUTHORS

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.

Copyright 1995-2001 by Ian Goldberg and Bill Janssen.

 

Table Of Contents