NAME

xwd − place window images in a dump file. 

SYNTAX

xwd [options]

DESCRIPTION

xwd stores window images in a specially formatted window 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. 

OPTIONS

xwd accepts the following options:

-add value
Specifies a signed value to be added to every pixel.

-display [host]:server[.screen]
Allows you to specify the host, server, and screen to connect to. host is the hostname of the physical display, server is the server number, and screen is the screen number.  For example, xwd -display your_node:0.1 & specifies screen 1 on server 0 on the display named by your_node.  Either or both of the host and screen elements to the display specification can be omitted.  If host is omitted, the local display is assumed.  If screen is omitted, screen 0 is assumed (and the period is unnecessary).  The colon and (display) server are necessary in all cases. 

-frame
Indicates that the window manager frame should be included when manually selecting a window.

-helpPrints out the ’Usage:’ command syntax summary. 

-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.  (Available as of Release 5.)

-id window_id
Allows you to specify the window using its window_id (resource ID), rather than by selecting it with the pointer. 

-name name
Allows you to specify the window using its name (stored in the WM_NAME property), rather than by selecting it with the pointer. 

-nobdrs
Specifies that the window dump should not include the pixels that compose the X window border.  This is useful when the window contents are to be included in a document as an illustration.

-out file
Allows you to specify the output file on the command line.  The default outputs to the standard output (stdout). 

-rootMakes a dump of the entire root window; the user is not required to select a window with the pointer. 

-screen
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.  (Available as of Release 5.) 

-xyApplies to color displays only. The -xy option selects ‘XY’ pixmap format dumping instead of the default ‘Z’ pixmap format. 

FILES

XWDFile.h
X Window Dump File format definition file.

SEE ALSO

X, xdpr, xpr, xwud. 

AUTHOR

Tony Della Fera, Digital Equipment Corp., MIT Project Athena;
William F. Wyatt, Smithsonian Astrophysical Observatory.