about summary refs log tree commit diff
path: root/xwdtopnm.html
blob: 3b28615df59c6f3e5538890408c7825426366664 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Xwdtopnm User Manual</TITLE></HEAD>
<BODY>
<H1>xwdtopnm</H1>
Updated: 21 October 2003
<BR>
<A HREF="#index">Table Of Contents</A>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
xwdtopnm - convert an X11 or X10 window dump file to a PNM image

<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>xwdtopnm</B>
[<b>-verbose</b>]
[<b>-headerdump</b>]
[<I>xwdfile</I>]

<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>xwdtopnm</b> reads an X11 or X10 window dump file as input and
produces a PNM image as output.  The type of the output image depends
on the input file - if it's black and white, the output is PBM.  If
it's grayscale, the output is PGM.  Otherwise, it's PPM.  The program
tells you which type it is writing.

<P>Using this program, you can convert anything you can display on an
X workstation's screen into a PNM image.  Just display whatever you're
interested in, run the <b>xwd</b> program to capture the contents of
the window, run it through <b>xwdtopnm</b>, and then use <b>pamcut</b>
to select the part you want.

<p>Note that a pseudocolor XWD image (typically what you get when you
make a dump of a pseudocolor X window) has maxval 65535, which means
the PNM file that <b>xwdtopnm</b> generates has maxval 65535.  Many
older image processing programs (that aren't part of the Netpbm
package and don't use the Netpbm programming library) don't know how
to handle a PNM image with maxval greater than 255 (because there are
two bytes instead of one for each sample in the image).  So you may
want to run the output of <b>xwdtopnm</b> through <b>pamdepth</b>
before feeding it to one of these old programs.

<A NAME="options">&nbsp;</A>
<H2>OPTIONS</H2>

<dl>
<dt><b>-verbose</b>
<dd>This option causes <b>xwdtopnm</b> to display handy information about the
input image and the conversion process

<dt><b>-headerdump</b>

<dd>This option causes <b>xwdtopnm</b> to display the contents of the
X11 header.  It has no effect when the input is X10.  This option was
new in Netpbm 10.26 (December 2004).

</dl>


<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>

<A HREF="pnmtoxwd.html">pnmtoxwd</A>,
<A HREF="pnm.html">pnm</A>,
<b>xwd</b> man page

<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>

Copyright (C) 1989, 1991 by Jef Poskanzer.

<HR>

<A NAME="index">&nbsp;</A>
<H2>Table Of Contents</H2>
<UL>
<LI><A HREF="#lbAB">NAME</A>
<LI><A HREF="#lbAC">SYNOPSIS</A>
<LI><A HREF="#lbAD">DESCRIPTION</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#lbAF">SEE ALSO</A>
<LI><A HREF="#lbAG">AUTHOR</A>
</UL>
</BODY>
</HTML>