xwd

NAME

xwd - dump an image of an X window

SYNOPSIS

xwd [-add value] [-debug] [-display display]
	[-frame] [-help] [-icmap] [-nobdrs]
	[-out file] [-root | -id id | -name name]
	[-screen] [-xy]

DESCRIPTION

The xwd(1) utility is an X Window System window dumping utility. The xwd(1) utility 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, and so on. 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

-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.
-display display
This argument allows you to specify the server to connect to; see X(5).
-id id
This option indicates that the window with the specified resource identifier (id) should be selected for the window dump, without requiring the user to select a window with the pointer.
-icmap
Usually, the colormap of the chosen window is used to obtain red-green-blue (RGB) values. This option forces the first installed colormap of the screen to be used instead.
-help
Print out the 'Usage:' command syntax summary.
-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.
-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 want 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.
-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.
-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.
-xy
This option applies to color displays only. It selects 'XY' format dumping instead of the default 'Z' format.

ENVIRONMENT VARIABLES

DISPLAY
Contains default host and display number.

FILES

XWDFile.h
X Window Dump File format definition file.

COPYRIGHT

Copyright 1988, Massachusetts Institute of Technology.

See X(5) for a full statement of rights and permissions.

AUTHORS

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

SEE ALSO

lp(1)

xwud(1)

X(5)