ppmtoxpm(1)                                           ppmtoxpm(1)


NAME
       ppmtoxpm - convert a portable pixmap into an X11 pixmap

SYNOPSIS
       ppmtoxpm [-name xpmname] [ppmfile]

DESCRIPTION
       Reads  a  portable  pixmap  as input.  Produces X11 pixmap
       (XPM) as output.

       If the program was compiled with an  rgb  database  speci-
       fied,  and  a  RGB  value from the ppm input matches a RGB
       value from the database, then the corresponding color name
       mnemonic  is  printed  in  the  XPM's colormap.  If no rgb
       database was compiled in,  or  if  the  RGB  values  don't
       match,  then  the  color  will  be  printed with the #RGB,
       #RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB hexadecimal  format.

OPTIONS
       -name  Allows  you  to  specify the prefix string which is
              printed in the resulting XPM output.  If not speci-
              fied,  will default to the filename (without exten-
              sion) of the ppmfile argument.   If  -name  is  not
              specified  and  no ppmfile is specified (i.e. piped
              input), the  prefix  string  will  default  to  the
              string "noname".

       All flags can be abbreviated to their shortest unique pre-
       fix.

EXAMPLE
       To    convert     the     file     "dot"     (found     in
       /usr/include/X11/bitmaps), from xbm to xpm one could spec-
       ify

              xbmtopbm dot | ppmtoxpm -name dot

BUGS
       An option to match the closest (rather than  exact)  color
       name  mnemonic  from  the  rgb  text  would be a desirable
       enhancement.

       Truncation of the least significant bits of  a  RGB  value
       may  result in nonexact matches when performing color name
       mnemonic lookups.

SEE ALSO
       xpmtoppm(1), ppm(5)

AUTHOR
       Copyright (C) 1990 by Mark W. Snitily.






                           26 June 1990                         1