Manual: xpmtoppm

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 output.

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
	      This option causes xpmtoppm to create 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)  trans‐
	      parency values.

	      If  you  don't  specify  --alphaout, xpmtoppm does not generate a transparency file, and xpmtoppm discards any
	      transparency information the input image contains.

	      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 many valid XPM images as in‐
       valid.

       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 message 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, 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)