NAME

       ppmtopat - convert a portable pixmap into a 2 dimensional
       CAM-8 pattern file and colormap file

SYNOPSIS

       ppmtopat [ppmfile] CAMfile

DESCRIPTION

       Reads a portable pixmap as input from a file or from stan-
       dard  input.   Produces  a CAM-8 pattern file and colormap
       file as output.  The suffix ".pat" is appended to the CAM-
       file  argument  and the resulting filename is used for the
       pattern file.  The colormap file is  likewise  saved  with
       the suffix ".map".

ARGUMENTS

       ppmfile
              name  to  save the ppm file as. If omitted ppmtopat
              reads from standard input.

       CAMfile
              base name of the CAM-8 colormap  file  and  pattern
              file

EXAMPLES

       Convert the file cheryl.ppm to a CAM-8 pattern file called
       sheryl.pat and save the associated colormap as sheryl.map:

              example% ppmtopat cheryl.ppm sheryl

BUGS

       Since  the  CAM-8 can only display 256 colors at once, the
       ppmfile cannot have more than 256 colors in  it  for  this
       program  to work.  This can be remedied by using ppmquant,
       but the extra color data will be lost.

SEE ALSO

       pattoppm(1), ppm(5), pnmflip(1), ppmquant(1)

AUTHOR

       Copyright (c) 1994 by Daniel R. Risacher,
       Portions Copyright (c) 1991 by Jef Poskanzer.