NAME

       xwd - dump an image of an X window

SYNOPSIS

       xwd [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add value] [-root | -id wdid | -name wdname ]
       [-icmap] [-screen] [-silent] [-display host:dpy] [-version]

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

       -debug  Enable debug mode.

       -d, -display host:dpy
               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 a 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 wdid
               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 wdname
               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.

       -version
               This option indicates that xwd should print its version information and exit.

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

X Version 11                                        xwd 1.0.9                                             XWD(1)