Manual Pages for UNIX Operating System command usage for man xwd

User Commands                                              XWD(1)



NAME
     xwd - dump an image of an X window

SYNOPSIS
     /usr/bin/xwd [-debug] [-help] [-nobdrs]  [-out  file]  [-xy]
     [-frame]  [-add  value]  [-root  |  -id id | -name name ] [-
     icmap] [-screen] [-silent] [-display display]

DESCRIPTION
     Xwd is an X  Window  System  window  dumping  utility.   Xwd
     allows X users to store window images in a specially format-
     ted dump file.  This file can then be read by various  other
     X  utilities  for  redisplay, printing, editing, formatting,
     archiving, image processing,  etc.   The  target  window  is
     selected by clicking the pointer in the desired window.  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(5).

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

     -root   This option indicates that the root window should be
             selected  for the window dump, without requiring the
             user to select a window with the pointer.





X Version 11         Last change: xwd 1.0.3                     1






User Commands                                              XWD(1)



     -id id  This option  indicates  that  the  window  with  the
             specified  resource  id  should  be selected for the
             window dump, without requiring the user to select  a
             window with the pointer.

     -name name
             This option  indicates  that  the  window  with  the
             specified  WM_NAME  property  should be selected for
             the window  dump,  without  requiring  the  user  to
             select a window with the pointer.

     -icmap  Normally the colormap of the chosen window  is  used
             to  obtain RGB values.  This option forces the first
             installed colormap of the screen to be used instead.

     -screen This option indicates that the GetImage request used
             to  obtain the image should be done on the root win-
             dow, rather than directly on the  specified  window.
             In  this way, you can obtain pieces of other windows
             that overlap the specified window, and  more  impor-
             tantly,  you  can capture menus or other popups that
             are independent windows but appear over  the  speci-
             fied window.

     -silent Operate silently, i.e. don't ring any  bells  before
             and after dumping the window.

ENVIRONMENT
     DISPLAY To get default host and display number.

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

SEE ALSO
     xwud(1), X(5)

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


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










X Version 11         Last change: xwd 1.0.3                     2






User Commands                                              XWD(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/x11-window-dump         |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
















































X Version 11         Last change: xwd 1.0.3                     3