NAME

       palmtopnm - convert a Palm pixmap into a portable anymap

SYNOPSIS

       palmtopnm [-verbose] [-rendition N] [-showhist]
       [-forceplain] [pnmfile]
       palmtopnm -transparent [-verbose] [pnmfile]

DESCRIPTION

       Reads a Palm pixmap as input, from stdin or pnmfile.  Produces either a portable pixmap as
       output, or writes the value of the transparent color in the Palm pixmap to stdout.

OPTIONS

       -verbose
              Display various interesting information about the input file and process.

       -transparent
              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.

       -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
              Writes a histogram of colors in the input file to stderr.

       -forceplain
              Force the output anymap to be in ASCII 'plain' netpbm format.

SEE ALSO

       pnmtopalm(1), pnm(5)

BUGS

       An additional compression format, "packbits,"  has  been  added  with  PalmOS  4.0.   This
       package should be updated to 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`

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.

                                         15 December 2000                            palmtopnm(1)