XWD(1)                      X Version 11(Release 5)                      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.





10/89                                                                    Page 1

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


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

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)

COPYRIGHT
      Copyright 1988, Massachusetts Institute of Technology.
      See X(1) for a full statement of rights and permissions.

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





















Page 2                                                                    10/89