XWD(1X11)               COMMAND REFERENCE               XWD(1X11)



NAME
     xwd - dump an image of an X window

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

     This is a supported client.

DESCRIPTION
     The program xwd is an X Window System window dumping
     utility.  It 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 user has the option of selecting the target window with
     the mouse (by clicking any mouse button in the desired
     window) or by specifying its window id on the command line
     with the -id option.  In addition, if it is easier, instead
     of specifying the window by its id number, the -name option
     may be used to specify which window is desired by name.

     There is also a special -root option to quickly obtain a
     full screen dump.

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

     -help          Print out the `Usage:' command syntax
                    summary.

     -id id         This option allows you to specify a target
                    window id on the command line rather than
                    using the mouse to select the target window.
                    This is very useful when the use of the mouse
                    might be impossible or interfere with the
                    application.

     -name name     This option allows you to specify that the
                    window named name is the target window on the
                    command line rather than using the mouse to
                    select the target window.

     -root          This option specifies that X's root window is
                    to be dumped, producing, in effect, a dump of



Printed 3/22/89                                                 1

XWD(1X11)               COMMAND REFERENCE               XWD(1X11)



                    the entire screen.  This is useful in
                    situations where the root window is
                    completely obscured, or for doing a screen
                    dump from a script.

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

ENVIRONMENT
     DISPLAY        To get default host and display number.

FILES
     XWDFile.h           X Window Dump File format definition
                         file.

SEE ALSO
     xwud(1x11), xpr(1x11), and X(1x11).

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



















Printed 3/22/89                                                 2

%%index%%
na:288,86;
sy:374,779;
de:1153,1161;
op:2314,1336;4010,1483;
fi:5493,166;
se:5659,382;
%%index%%000000000120