man > xpmtoppm(1)

Xpmtoppm User Manual(1)                General Commands Manual               Xpmtoppm User Manual(1)

NAME
       xpmtoppm - convert an X11 pixmap to a PPM image


SYNOPSIS
       xpmtoppm

       [--alphaout={alpha-filename,-}] [-verbose]

       [xpmfile]


DESCRIPTION
       This program is part of Netpbm(1).

       xpbtoppm  reads  an X11 pixmap (XPM version 1 or 3) as input and produces a PPM image as out‐
       put.


OPTIONS
       In addition to the options common to all programs based on libnetpbm  (most  notably  -quiet,
       see  Common Options ), xpmtoppm recognizes the following command line options:



       --alphaout=alpha-filename
              xpmtoppm  creates  a  PBM file containing the transparency mask for the image.  If the
              input image doesn't contain transparency information, the alpha-filename file contains
              all white (opaque) transparency values.  If you  don't  specify  --alphaout,  xpmtoppm
              does  not generate a transparency file, and if the input image has transparency infor‐
              mation, xpmtoppm simply discards it.

              If you specify - as the filename, xpmtoppm writes the transparency output to  Standard
              Output and discards the image.

              See pamcomp(1) for one way to use the transparency output file.

              xpmtoppm  can't handle a line longer than 8K characters in the XPM input.  If an input
              line exceeds this limit, xpmtoppm quits with an error message to that effect.   Before
              Netpbm 10.30 (October 2005), the limit was 2K.


       --verbose
              xpmtoppm prints information about its processing on Standard Error.




LIMITATIONS
       xpmtoppm  recognizes  only a limited set of the features of XPM Version 3; i.e. it rejects as
       invalid many valid XPM images.

       The only place a comment block is valid is starting in Column 1 of the line immediately after
       "static char ...".

       In addition, ppmtoxpm properly recognizes any single-line comment that begins in Column 1  in
       the color table part of the file.

       There must be for every pixel a default colorname for a color type visual.

       Before Netpbm 10.58 (March 2012), zero bytes per pixel causes the program to fail with a mes‐
       sage about premature EOF on input.


SEE ALSO
       ppmtoxpm(1), pamcomp(1), ppm(1)


AUTHOR
       Copyright (C) 1991 by Jef Poskanzer.

       Upgraded to work with XPM version 3 by Arnaud Le Hors<lehors AT mirsa.fr>, Tue Apr 9 1991.

DOCUMENT SOURCE
       This  manual  page  was  generated by the Netpbm tool 'makeman' from HTML source.  The master
       documentation is at

              http://netpbm.sourceforge.net/doc/xpmtoppm.html

netpbm documentation                      31 December 2011                   Xpmtoppm User Manual(1)