xwd(1X)                                                   xwd(1X)



NAME
     xwd - dumps an image of an X window

SYNOPSIS
     xwd [-debug] [-help] [-nobdrs] [-out file] [-xy]
     [-add value] [-frame] [-display display] [-root]
     [-id id] [-name name]

DESCRIPTION
     xwd allows you to store window images in a specially format-
     ted dump file.  This file can then be read by various other
     X commands for redisplaying, printing, editing, formatting,
     archiving, and image processing.

     You can select the target window by positioning the pointer
     in the desired window and pressing the mouse button (or LEFT
     or RIGHT ARROW key). You can also specify the target window
     on the command line.

     The xwd command rings the keyboard bell once at the begin-
     ning of the dump and twice when the dump is completed.

   Options
     The xwd command accepts these options:

     -add value
             Specifies a signed value to be added to every pixel.

     -display display
             Specifies the server to connect to. See X(1) for de-
             tails.

     -frame  Indicates that the window manager frame should be
             included when manually selecting a window.

     -help   Displays a summary of the command syntax.

     -id id  Specify a target window ID.  This option is useful
             in debugging X applications where the target window
             is not mapped to the screen or where the use of the
             mouse might be impossible or interfere with the ap-
             plication.

     -name name
             Specifies the window called name as the target win-
             dow.

     -nobdrs Specifies that the window dump should not include
             the pixels that compose the X window border.  This
             option is useful if you want to include the window
             contents in a document as an illustration.




November, 1990                                                  1

xwd(1X)                                                   xwd(1X)



     -out file
             Specifies the output file.  The default is to send
             the output to the standard output.

     -root   Specifies that the X background window is the target
             window.  This option is useful in situations where
             the background window is completely obscured.

     -xy     Selects XY format dumping instead of the default Z
             format.  This option applies only to color screens.

   Environment variables
     The xwd command uses this environment variable:

     DISPLAY Specifies the default host, display number, and
             screen.

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

     Authors: Tony Della Fera, Digital Equipment Corporation and
     MIT Project Athena, and William F. Wyatt, Smithsonian Astro-
     physical Observatory

FILES
     XWDFile.h
             Defines the file format for the X window dump file.

SEE ALSO
     X(1X), xdpr(1X), xpr(1X), xwud(1X)

     XCreateImage(3X), XPutImage(3X) in X11 Programmer's Refer-
     ence for A/UX





















2                                                  November, 1990