1Xpmtoppm User Manual(0) Xpmtoppm User Manual(0)
2
3
4
6 xpmtoppm - convert an X11 pixmap to a PPM image
7
8
10 xpmtoppm
11
12 [--alphaout={alpha-filename,-}] [-verbose]
13
14 [xpmfile]
15
16
18 This program is part of Netpbm(1).
19
20 xpbtoppm reads an X11 pixmap (XPM version 1 or 3) as input and produces
21 a PPM image as output.
22
23
25 --alphaout=alpha-filename
26 xpmtoppm creates a PBM file containing the transparency mask for
27 the image. If the input image doesn't contain transparency
28 information, the alpha-filename file contains all white (opaque)
29 transparency values. If you don't specify --alphaout, xpmtoppm
30 does not generate a transparency file, and if the input image
31 has transparency information, xpmtoppm simply discards it.
32
33 If you specify - as the filename, xpmtoppm writes the trans‐
34 parency output to Standard Output and discards the image.
35
36 See pamcomp(1) for one way to use the transparency output file.
37
38 xpmtoppm can't handle a line longer than 8K characters in the
39 XPM input. If an input line exceeds this limit, xpmtoppm quits
40 with an error message to that effect. Before Netpbm 10.30
41 (October 2005), the limit was 2K.
42
43
44 --verbose
45 xpmtoppm prints information about its processing on Standard
46 Error.
47
48
49
50
52 xpmtoppm recognizes only a limited set of the features of XPM Version
53 3; i.e. it rejects as invalid many valid XPM images.
54
55 The only place a comment block is valid is starting in Column 1 of the
56 line immediately after "static char ...".
57
58 In addition, ppmtoxpm properly recognizes any single-line comment that
59 begins in Column 1 in the color table part of the file.
60
61 There must be for every pixel a default colorname for a color type vis‐
62 ual.
63
64 Before Netpbm 10.58 (March 2012), zero bytes per pixel causes the pro‐
65 gram to fail with a message about premature EOF on input.
66
67
69 ppmtoxpm(1), pamcomp(1), ppm(1)
70
71
73 Copyright (C) 1991 by Jef Poskanzer.
74
75 Upgraded to work with XPM version 3 by Arnaud Le
76 Hors<lehors@mirsa.inria.fr>, Tue Apr 9 1991.
77
79 This manual page was generated by the Netpbm tool 'makeman' from HTML
80 source. The master documentation is at
81
82 http://netpbm.sourceforge.net/doc/xpmtoppm.html
83
84netpbm documentation 31 December 2011 Xpmtoppm User Manual(0)