File: //usr/share/doc/netpbm-10.35.58/userguide/xwdtopnm.html
<!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"> </A>
<H2>NAME</H2>
xwdtopnm - convert an X11 or X10 window dump file to a PNM image
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>xwdtopnm</B>
[<b>-verbose</b>]
[<b>-headerdump</b>]
[<I>xwdfile</I>]
<A NAME="lbAD"> </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"> </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"> </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"> </A>
<H2>AUTHOR</H2>
Copyright (C) 1989, 1991 by Jef Poskanzer.
<HR>
<A NAME="index"> </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>