man-pages/man1/xwd.1.html
2021-03-31 01:06:50 +01:00

227 lines
5.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of XWD</TITLE>
</HEAD><BODY>
<H1>XWD</H1>
Section: User Commands (1)<BR>Updated: xwd 1.0.7<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
xwd - dump an image of an X window
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>xwd</B>
[-debug] [-help] [-nobdrs] [-out <I>file</I>] [-xy] [-frame] [-add <I>value</I>]
[-root | -id <I>id</I> | -name <I>name</I> ] [-icmap] [-screen] [-silent]
[-display <I>display</I>] [-version]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
<I>Xwd</I>
is an X Window System window dumping utility.
<I>Xwd</I>
allows X users to store window images in a specially formatted dump
file. This file can then be read by various other X utilities for
redisplay, printing, editing, formatting, archiving, image processing, etc.
The target window is selected by clicking the pointer in the desired window.
The keyboard bell is rung once at the beginning of the dump and twice when
the dump is completed.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<P>
<DL COMPACT>
<DT id="1"><B>-display </B><I>display</I>
<DD>
This argument allows you to specify the server to connect to; see <I><A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)</I>.
</DL>
<P>
<DL COMPACT>
<DT id="2"><B>-help</B>
<DD>
Print out the `Usage:' command syntax summary.
</DL>
<P>
<DL COMPACT>
<DT id="3"><B>-nobdrs</B>
<DD>
This argument specifies that the window dump should not include the
pixels that compose the X window border. This is useful in situations
where you may wish to include the window contents in a document
as an illustration.
</DL>
<P>
<DL COMPACT>
<DT id="4"><B>-out </B><I>file</I>
<DD>
This argument allows the user to explicitly specify the output
file on the command line. The default is to output to standard out.
</DL>
<P>
<DL COMPACT>
<DT id="5"><B>-xy</B>
<DD>
This option applies to color displays only. It selects `XY' format dumping
instead of the default `Z' format.
</DL>
<P>
<DL COMPACT>
<DT id="6"><B>-add </B><I>value</I>
<DD>
This option specifies a signed value to be added to every pixel.
</DL>
<P>
<DL COMPACT>
<DT id="7"><B>-frame</B>
<DD>
This option indicates that the window manager frame should be included when
manually selecting a window.
</DL>
<P>
<DL COMPACT>
<DT id="8"><B>-root</B>
<DD>
This option indicates that the root window should be selected for the
window dump, without requiring the user to select a window with the pointer.
</DL>
<P>
<DL COMPACT>
<DT id="9"><B>-id </B><I>id</I>
<DD>
This option indicates that the window with the specified resource id
should be selected for the window dump, without requiring the user to
select a window with the pointer.
</DL>
<P>
<DL COMPACT>
<DT id="10"><B>-name </B><I>name</I>
<DD>
This option indicates that the window with the specified WM_NAME property
should be selected for the window dump, without requiring the user to
select a window with the pointer.
</DL>
<P>
<DL COMPACT>
<DT id="11"><B>-icmap</B>
<DD>
Normally the colormap of the chosen window is used to obtain RGB values.
This option forces the first installed colormap of the screen to be used
instead.
</DL>
<P>
<DL COMPACT>
<DT id="12"><B>-screen</B>
<DD>
This option indicates that the GetImage request used to obtain the image
should be done on the root window, rather than directly on the specified
window. In this way, you can obtain pieces of other windows that overlap
the specified window, and more importantly, you can capture menus or other
popups that are independent windows but appear over the specified window.
</DL>
<P>
<DL COMPACT>
<DT id="13"><B>-silent</B>
<DD>
Operate silently, i.e. don't ring any bells before and after dumping
the window.
</DL>
<P>
<DL COMPACT>
<DT id="14"><B>-version</B>
<DD>
This option indicates that
<I>xwd</I>
should print its version information and exit.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<P>
<DL COMPACT>
<DT id="15"><B>DISPLAY</B>
<DD>
To get default host and display number.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>FILES</H2>
<P>
<DL COMPACT>
<DT id="16"><B>XWDFile.h</B>
<DD>
X Window Dump File format definition file.
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+xwud">xwud</A>(1), <A HREF="/cgi-bin/man/man2html?7+X">X</A>(7)
<A NAME="lbAI">&nbsp;</A>
<H2>AUTHORS</H2>
Tony Della Fera, Digital Equipment Corp., MIT Project Athena
<BR>
William F. Wyatt, Smithsonian Astrophysical Observatory
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="17"><A HREF="#lbAB">NAME</A><DD>
<DT id="18"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="19"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="20"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="21"><A HREF="#lbAF">ENVIRONMENT</A><DD>
<DT id="22"><A HREF="#lbAG">FILES</A><DD>
<DT id="23"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="24"><A HREF="#lbAI">AUTHORS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:31 GMT, March 31, 2021
</BODY>
</HTML>