palmtopnm

 

---

 palmtopnm(1)                                         palmtopnm(1)
 
 
 
NAME
        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.
 
        There  is currently no support for direct generation of an
        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.
 
 
 
                          15 December 2000            palmtopnm(1)

---