1XWD(1)                      General Commands Manual                     XWD(1)
2
3
4

NAME

6       xwd - dump an image of an X window
7

SYNOPSIS

9       xwd  [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add value]
10       [-root | -id wdid | -name wdname ] [-icmap] [-screen] [-silent]  [-dis‐
11       play host:dpy] [-version]
12

DESCRIPTION

14       Xwd  is  an X Window System window dumping utility.  Xwd allows X users
15       to store window images in a specially formatted dump file.   This  file
16       can  then be read by various other X utilities for redisplay, printing,
17       editing, formatting, archiving, image processing, etc.  The target win‐
18       dow  is  selected  by  clicking the pointer in the desired window.  The
19       keyboard bell is rung once at the beginning of the dump and twice  when
20       the dump is completed.
21

OPTIONS

23       -debug  Enable debug mode.
24
25       -d, -display host:dpy
26               This  argument  allows you to specify the server to connect to;
27               see X(7).
28
29       -help   Print out the `Usage:' command syntax summary.
30
31       -nobdrs This argument specifies that the window dump should not include
32               the pixels that compose the X window border.  This is useful in
33               situations where you may wish to include the window contents in
34               a document as an illustration.
35
36       -out file
37               This  argument allows the user to explicitly specify the output
38               file on the command line.  The default is to output to standard
39               out.
40
41       -xy     This  option  applies  to  color displays only. It selects `XY'
42               format dumping instead of the default `Z' format.
43
44       -add value
45               This option specifies a signed  value  to  be  added  to  every
46               pixel.
47
48       -frame  This  option  indicates that the window manager frame should be
49               included when manually selecting a window.
50
51       -root   This option indicates that the root window should  be  selected
52               for  the  window  dump,  without requiring the user to select a
53               window with the pointer.
54
55       -id wdid
56               This option indicates that the window with  the  specified  re‐
57               source  id  should be selected for the window dump, without re‐
58               quiring the user to select a window with the pointer.
59
60       -name wdname
61               This option  indicates  that  the  window  with  the  specified
62               WM_NAME  property should be selected for the window dump, with‐
63               out requiring the user to select a window with the pointer.
64
65       -icmap  Normally the colormap of the chosen window is  used  to  obtain
66               RGB values.  This option forces the first installed colormap of
67               the screen to be used instead.
68
69       -screen This option indicates that the GetImage request used to  obtain
70               the  image  should  be done on the root window, rather than di‐
71               rectly on the specified window.  In this way,  you  can  obtain
72               pieces  of other windows that overlap the specified window, and
73               more importantly, you can capture menus or  other  popups  that
74               are independent windows but appear over the specified window.
75
76       -silent Operate  silently,  i.e.  don't ring any bells before and after
77               dumping the window.
78
79       -version
80               This option indicates that xwd should print its version  infor‐
81               mation and exit.
82

ENVIRONMENT

84       DISPLAY To get default host and display number.
85

FILES

87       XWDFile.h
88               X Window Dump File format definition file.
89

SEE ALSO

91       xwud(1), X(7)
92

AUTHORS

94       Tony Della Fera, Digital Equipment Corp., MIT Project Athena
95       William F. Wyatt, Smithsonian Astrophysical Observatory
96
97
98
99X Version 11                       xwd 1.0.8                            XWD(1)
Impressum