xwd(1) - c7

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

ENVIRONMENT

77       DISPLAY To get default host and display number.
78

FILES

80       XWDFile.h
81               X Window Dump File format definition file.
82

AUTHORS

87       Tony Della Fera, Digital Equipment Corp., MIT Project Athena
88       William F. Wyatt, Smithsonian Astrophysical Observatory
89
90
91
92X Version 11                       xwd 1.0.6                            XWD(1)