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

NAME

6       xwintoppm - dump an image of an X window
7

SYNOPSIS

9       xwintoppm  [-debug]  [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add
10       value] [-root | -id id | -name name ] [-icmap] [-screen] [-display dis‐
11       play]
12

DESCRIPTION

14       Xwintoppm  is  an  X  Window  System window dumping utility.  Xwintoppm
15       allows X users to store window images in ppm(5) format.  This file  can
16       then  be  read  by  various  other X utilities for redisplay, printing,
17       editing, formatting, archiving, image processing, etc.
18

OPTIONS

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

ENVIRONMENT

74       DISPLAY To get default host and display number.
75

SEE ALSO

77       xwd(1), xwud(1), xpr(1), X(1), ppm(5).
78

ORIGINAL AUTHORS

80       Tony Della Fera, Digital Equipment Corp., MIT Project Athena
81       William F. Wyatt, Smithsonian Astrophysical Observatory
82
83       Xwintoppm  is  an tiny modification to Xwd program which is distributed
84       with X11 kit.
85

MODIFICATIONS

87       Jun-ichiro itojun Itoh, WIDE Project
88
89
90
91X Version 11                      Release 6.3                           XWD(1)