xwd(X)                        06 January 1993                         xwd(X)


 Name

    xwd - dump an image of an X window

 Syntax

    xwd [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-display dis-
    play]

 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, edit-
    ing, formatting, archiving, image processing, etc.  The target window is
    selected by clicking the mouse in the desired window.  The keyboard bell
    is rung once at the beginning of the dump and twice when the dump is com-
    pleted.

 Options


    -display display This argument allows you to specify the server to con-
                     nect to; see X(X).

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

    -out file        This argument allows the user to explicitly specify the
                     output file on the command line.  The default is to out-
                     put 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 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.


 Environment variables


    DISPLAY          To get default host and display number.


 Files


    XWDFile.h        X Window Dump File format definition file.


 See also

    xwud(X), xpr(X), X(X)