XWD(1)                          X11 5.4R3.00                          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.


       -frame  This option indicates that the window manager frame should be
               included when manually selecting a window.


       -add value
               This option specifies an signed value to be added to every
               pixel.


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



Licensed material--property of copyright holder(s)                         1

XWD(1)                          X11 5.4R3.00                          XWD(1)


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

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















Licensed material--property of copyright holder(s)                         2