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 bitmap.  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 compatible with the various PalmOS 3.x versions used in the  Handspring  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 compression scheme, and will be a
              version 2 bitmap.  RLE compression 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  option.   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)