palmtopnm - convert a Palm pixmap into a portable anymap


SYNOPSIS

       palmtopnm  [-verbose]  [-rendition N] [-showhist] [-force­
       plain] [ pnmfile ]
       or
       palmtopnm -transparent [-verbose] [ pnmfile ]


DESCRIPTION

       Reads a Palm pixmap as input, from stdin or pnmfile.  Pro­
       duces  either  a  portable pixmap as output, or writes the
       value of the transparent color in the Palm pixmap to  std­
       out.


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 addi­
              tional output will be generated; no anymap will  be
              output.

       -rendition N
              Palm  pixmaps  may contain several different rendi­
              tions of the same pixmap,  with  different  depths.
              By  default, palmtopnm operates on the first rendi­
              tion (rendition number  1)  in  the  pixmap.   This
              switch  allows you to operate on a different rendi­
              tion.  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

       There  is  currently  no support for 16-bit colors used in
       the Handspring Visor series.  This should be  added  after
       Palm OS 4.0 is released.

       alpha-mask if the Palm pixmap  has  a  transparent  color.
       However, this can still be achieved with ppmcolormask by a
       netpbm pipe similar to:

         palmtopnm pixmap.palm | ppmcolormask `palmtopnm  -trans­
       parent pixmap.palm`


AUTHORS

       This program was originally written as Tbmptopnm.c, by Ian
       Goldberg.  It was heavily modified by Bill Janssen to  add
       support for color, compression, and transparency.
       Copyright 1995-2000 by Ian Goldberg and Bill Janssen.


Man(1) output converted with man2html