xwd(X)                          19 June 1992                          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 connect
                   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 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 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)