Provided by: x11-apps_7.3+3_i386 bug

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] [-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