pnmtopalm

pnmtopalm(1)                General Commands Manual               pnmtopalm(1)

NAME
       pnmtopalm - convert a portable anymap into a Palm pixmap

SYNOPSIS
       pnmtopalm [-verbose] [-depth N] [-maxdepth N] [-colormap] [-transparent
       color] [-offset]
       [-rle-compression|-scanline-compression] [pnmfile]

DESCRIPTION
       Reads a PNM image as input, from stdin or  pnmfile.   Produces  a  Palm
       pixmap as output.

       Palm  pixmap  files are either greyscale files 1, 2, or 4 bits wide, or
       color files 8 bits wide, so pnmtopalm automatically  scales  colors  to
       have  an  appropriate  maxval, unless you specify a depth or max depth.
       Input files must have an appropriate number and set of colors  for  the
       selected  output constraints.  This often means that you should run the
       PNM image through ppmquant before you pass  it  to  pnmtopalm.   Netpbm
       comes  with  several  colormap files you can use with ppmquant for this
       purpose.  They are palmgray2.map (4 shades of gray for a depth  of  2),
       palmgray4.map  (16 shades of gray for a depth of 4), and palmcolor8.map
       (232 colors in default Palm colormap).

OPTIONS
       -verbose
              Display the format of the output file.

       -depth N
              Produce a file of depth N, where N must be either 1, 2, 4, 8, or
              16.  Any depth greater than 1 will produce a version 1 or 2 bit-
              map.  Because the default Palm 8-bit colormap is not  grayscale,
              if  the  input  is  a grayscale or monochrome pixmap, the output
              will never be more than 4 bits deep, regardless of the specified
              depth.   Note  that  8-bit  color  works only in PalmOS 3.5 (and
              higher), and 16-bit direct color works only in PalmOS  4.0  (and
              higher).   However,  the 16-bit direct color format is also com-
              patible with the various PalmOS 3.x versions used in  the  Hand-
              spring Visor, so these images may also work in that device.

       -maxdepth N
              Produce  a  file  of  minimal depth, but in any case less than N
              bits wide.  If you specify 16-bit, the  output  will  always  be
              16-bit direct color.

       -offset
              Fill in the nextDepthOffset field in the file header, to provide
              for multiple renditions of the pixmap in the same file.

       -colormap
              Build a custom colormap and include it in the output file.  This
              is  not recommended by Palm, for efficiency reasons.  Otherwise,
              pnmtopalm uses the default Palm colormap for color output.

       -transparent color
              Marks one particular color as fully transparent.  The format  to
              specify   the   color   is  either  (when  for  example  orange)
              "1.0,0.5,0.0", where the values are floats between zero and one,
              or with the syntax "#RGB", "#RRGGBB" or "#RRRRGGGGBBBB" where R,
              G and B are hexadecimal numbers.  This  also  makes  the  output
              bitmap  a  version 2 bitmap.  Transparency works only on Palm OS
              3.5 and higher.

       -rle-compression
              Specifies that the output Palm bitmap will use the Palm RLE com-
              pression  scheme,  and will be a version 2 bitmap.  RLE compres-
              sion works only with Palm OS 3.5 and higher.

       -scanline-compression
              Specifies that the output Palm bitmap will use the Palm scanline
              compression  scheme,  and  will be a version 2 bitmap.  Scanline
              compression works only in Palm OS 2.0 and higher.

SEE ALSO
       palmtopnm(1), ppmquant(1), pnm(5)

NOTES
       An additional compression format, packbits, was added with PalmOS  4.0.
       This package should be updated to be able to generate that.

       Palm  pixmaps  may  contains multiple renditions of the same pixmap, in
       different depths.  To construct  an  N-multiple-rendition  Palm  pixmap
       with  pnmtopalm,  first  construct  renditions  1 through N-1 using the
       -offset option, then construct the Nth pixmap without the  -offset  op-
       tion.   Then concatenate the individual renditions together in a single
       file using cat.

AUTHORS
       This program was originally written as ppmtoTbmp.c, by Ian Goldberg and
       George  Caswell.   It  was completely re-written by Bill Janssen to add
       color, compression, and transparency function.
       Copyright 1995-2001 by Ian Goldberg, George Caswell, and Bill Janssen.

                                7 December 2000                   pnmtopalm(1)