xwd(1) manual page
Table of Contents
xwd - dump an image of an X window
xwd [-debug] [-help] [-nobdrs]
[-out file] [-xy] [-frame] [-add value] [-root | -id id | -name name ] [-icmap] [-screen]
[-display display]
Xwd is an X Window System window dumping utility.
Xwd 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.
- -display display
- This argument allows you to specify
the server to connect to; see X(7)
- -help
- Print out the ‘Usage:’ command syntax
summary.
- -nobdrs
- 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.
- -out file
- This argument allows the user to explicitly
specify the output file on the command line. The default is to output to
standard out.
- -xy
- This option applies to color displays only. It selects ‘XY’
format dumping instead of the default ‘Z’ format.
- -add value
- This option specifies
an signed value to be added to every pixel.
- -frame
- This option indicates
that the window manager frame should be included when manually selecting
a window.
- -root
- 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.
- -id id
- 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.
- -name name
- 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.
- -icmap
- 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.
- -screen
- 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.
- DISPLAY
- To get default host
and display number.
If the dumped window is partially obscured by
another window then the obscured area has undefined content.
- XWDFile.h
- X Window Dump File format definition file.
xwud(1)
, xpr(1)
, X11(7)
Copyright 1988, Massachusetts Institute of Technology.
See X11(7)
for a full statement of rights and permissions.
Tony Della
Fera, Digital Equipment Corp., MIT Project Athena
William F. Wyatt, Smithsonian Astrophysical Observatory
Table of Contents