4.3BSD-UWisc/man/catn/xwd.n

XWD(1)              UNIX Programmer's Manual               XWD(1)



NAME
     xwd - X Window System, window image dumper.

SYNOPSIS
     xwd [ -debug ] [ -help ] [ -nobdrs ] [ -out _f_i_l_e ] [ -z ] [
     _h_o_s_t:_d_i_s_p_l_a_y ]

DESCRIPTION
     _X_w_d is an X Window System window image dumping utility.  _X_w_d
     allows X users to store window images in a specially for-
     mated window dump file.  This file can then  be  read  by
     various  other  X utilities for redisplay, printing, edit-
     ing, formatting, archiving, image processing etc..  The tar-
     get 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 completed.
     This is a preliminary version of what promises to be a very
     useful utility.  The  window dump file format is currently
     under development no guarantee of upward compatibility is
     made.

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

     -z      This argument specifies that the output file should
             be in  `Z'  pixmap format.    The   default  is
             `XY'  pixmap format.  `Z' format is only valid on
             color displays.

     _h_o_s_t:_d_i_s_p_l_a_y
             This  argument  allow  you  to  specify the host and
             display number on which to find the target window.
             For example `xwd orpheus:1' would specify that the
             target window is on display `1' on the machine
             `orpheus'.  By default, _x_w_d uses the host and
             display number stored in the environment variable
             DISPLAY, and therefore this argument is not normally
             specified.

ENVIRONMENT




Printed 12/6/86           27 July 1985                          1






XWD(1)              UNIX Programmer's Manual               XWD(1)



     DISPLAY To get default host and display number.

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

FUTURE PLANS
     If time ever presents itself...

     1.      Install complete color support.

     2.      Completely rework the `XWDFile' dump file format.

     3.      Completely rework the corresponding xwud window
             undumper program.

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

AUTHOR
     Copyright 1985, Massachusetts Institute of Technology.

     Tony Della Fera, Digital Equipment Corp., MIT Project Athena
































Printed 12/6/86           27 July 1985                          2