xwd(1x) - f7

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] [-display display]
11

DESCRIPTION

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

OPTIONS

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

ENVIRONMENT

76       DISPLAY To get default host and display number.
77

FILES

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

AUTHORS

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