Provided by: netpbm_10.0-15ubuntu2_amd64 bug

NAME

       ppmtoxpm - convert a portable pixmap into an X11 pixmap

SYNOPSIS

       ppmtoxpm [-name=xpmname] [-rgb=rgb-textfile] [-alphamask=pgmfile] [ppmfile]

       Minimum unique abbrevations are acceptable.

DESCRIPTION

       Reads  a portable pixmap as input.  Produces X11 pixmap (version 3) as output which can be
       loaded directly by the XPM library.

       For example, to convert the file "dot" (found in /usr/include/X11/bitmaps),  from  xbm  to
       xpm one could specify

              xbmtopbm dot | ppmtoxpm -name dot

       or, with a rgb text file (in the local directory)

              xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt

OPTIONS

       -name=xpmname
              The  -name  option  allows you to specify the prefix string which is printed in the
              resulting XPM output.  If not specified, will  default  to  the  filename  (without
              extension)  of  the  <ppmfile>  argument.   If you do not specify -name or ppmfile,
              (i.e. your input is from Standad Input), the prefix string defaults to  the  string
              noname.

       rgb=rgb-textfile
              The  -rgb option allows you to specify an X11 rgb text file for the lookup of color
              name mnemonics.  This rgb text file is typically the  /usr/lib/X11/rgb.txt  of  the
              MIT  X11  distribution,  but  any  file  using  the  same format may be used.  When
              specified and a RGB value from the ppm input matches a RGB  value  from  the  <rgb-
              textfile>,  then  the  corresponding  color  name  mnemonic is printed in the XPM's
              colormap.  If you don't specify -rgb  or  if  the  RGB  values  don't  match,  then
              ppmtoxpm  produces  the  color  specifications in the #RGB, #RRGGBB, #RRRGGGBBB, or
              #RRRRGGGGBBBB hexadecimal format.

       -alphamask=pgmfile
              This option names a PGM file to use as an alpha (transparency) mask.  The file must
              contain  an  image  the  same  dimensions  as  the  input image.  ppmtoxpm marks as
              transparent any pixel whose position in the alpha mask image is at most half white.

              If you don't specify -alphamask, ppmtoxpm makes all pixels in the output opaque.

              ppmcolormask is one way to generate an alpha mask file.  You might also generate it
              by  extracting  transparency information from an XPM file with the -alphaout option
              to xpmtoppm.  There are similar options on other  Netpbm  converters  that  convert
              from formats that include transparency information too.

LIMITATIONS

       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

       ppmcolormask(1), xpmtoppm(1), ppm(5)
       XPM Manual by Arnaud Le Hors lehors@mirsa.inria.fr

AUTHOR

       Copyright (C) 1990 by Mark W. Snitily.

       Permission  to  use,  copy, modify, and distribute this software and its documentation for
       any purpose and without fee is hereby granted, provided that the  above  copyright  notice
       appear in all copies and that both that copyright notice and this permission notice appear
       in supporting documentation.  This software is provided "as is" without express or implied
       warranty.

       This  tool  was  developed  for  Schlumberger  Technologies,  ATE Division, and with their
       permission is being made available to the public  with  the  above  copyright  notice  and
       permission notice.

       Upgraded to XPM2 by
          Paul Breslaw, Mecasoft SA, Zurich, Switzerland (paul@mecazh.uu.ch)
          Thu Nov  8 16:01:17 1990

       Upgraded to XPM version 3 by
          Arnaud Le Hors (lehors@mirsa.inria.fr)
          Tue Apr 9 1991

                                          Tue Apr 9 1991                              ppmtoxpm(1)