XWD(1)             X Version 11 (Release 6.6)              XWD(1)


     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(1).

          -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.
                  Note that on systems with multiple visuals, this can
                  result in xwd failing with protocol errors in
                  XQueryColors, if the visual corresponding to the
                  first installed colormap is different from the
                  visual of the chosen window.

          -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), xpr(1), X(1)

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


     Page 2                                          (printed 7/20/06)