NAME

       xwd - dump an image of an X window

SYNOPSIS

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

DESCRIPTION

       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.

OPTIONS

       -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.

       -silent Operate silently, i.e. don't ring any bells before and after dumping the window.

ENVIRONMENT

       DISPLAY To get default host and display number.

FILES

       XWDFile.h
               X Window Dump File format definition file.

SEE ALSO

       xwud(1), X(7)

AUTHORS

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