1Xpmtoppm User Manual(0)                                Xpmtoppm User Manual(0)
2
3
4

NAME

6       xpmtoppm - convert an X11 pixmap to a PPM image
7
8

SYNOPSIS

10       xpmtoppm
11
12       [--alphaout={alpha-filename,-}] [-verbose]
13
14       [xpmfile]
15
16

DESCRIPTION

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

OPTIONS

25       In addition to the options common to all programs  based  on  libnetpbm
26       (most notably -quiet, see
27        Common  Options  ⟨index.html#commonoptions⟩ ), xpmtoppm recognizes the
28       following command line options:
29
30
31
32       --alphaout=alpha-filename
33              xpmtoppm creates a PBM file containing the transparency mask for
34              the  image.   If  the  input  image doesn't contain transparency
35              information, the alpha-filename file contains all white (opaque)
36              transparency  values.  If you don't specify --alphaout, xpmtoppm
37              does not generate a transparency file, and if  the  input  image
38              has transparency information, xpmtoppm simply discards it.
39
40              If  you  specify  -  as the filename, xpmtoppm writes the trans‐
41              parency output to Standard Output and discards the image.
42
43              See pamcomp(1) for one way to use the transparency output file.
44
45              xpmtoppm can't handle a line longer than 8K  characters  in  the
46              XPM  input.  If an input line exceeds this limit, xpmtoppm quits
47              with an error message  to  that  effect.   Before  Netpbm  10.30
48              (October 2005), the limit was 2K.
49
50
51       --verbose
52              xpmtoppm  prints  information  about  its processing on Standard
53              Error.
54
55
56
57

LIMITATIONS

59       xpmtoppm recognizes only a limited set of the features of  XPM  Version
60       3; i.e. it rejects as invalid many valid XPM images.
61
62       The  only place a comment block is valid is starting in Column 1 of the
63       line immediately after "static char ...".
64
65       In addition, ppmtoxpm properly recognizes any single-line comment  that
66       begins in Column 1 in the color table part of the file.
67
68       There must be for every pixel a default colorname for a color type vis‐
69       ual.
70
71       Before Netpbm 10.58 (March 2012), zero bytes per pixel causes the  pro‐
72       gram to fail with a message about premature EOF on input.
73
74

SEE ALSO

76       ppmtoxpm(1), pamcomp(1), ppm(1)
77
78

AUTHOR

80       Copyright (C) 1991 by Jef Poskanzer.
81
82       Upgraded    to    work    with    XPM    version   3   by   Arnaud   Le
83       Hors<lehors@mirsa.inria.fr>, Tue Apr 9 1991.
84

DOCUMENT SOURCE

86       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
87       source.  The master documentation is at
88
89              http://netpbm.sourceforge.net/doc/xpmtoppm.html
90
91netpbm documentation           31 December 2011        Xpmtoppm User Manual(0)
Impressum