palmtopnm(1) - man - phpMan

palmtopnm(1)                           General Commands Manual                          palmtopnm(1)



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 hexadeci‐
              mal 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 differ‐
              ent  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.  How‐
       ever, 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)