NAME

       xwintoppm - dump an image of an X window

SYNOPSIS

       xwintoppm  [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add value] [-root | -id
       id | -name name ] [-icmap] [-screen] [-display display]

DESCRIPTION

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

OPTIONS

       -display display
               This argument allows you to specify the server to connect to; see X(1).

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

       -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 window, rather than directly on the specified  window.   In  this
               way, you can obtain pieces of other windows that overlap the specified window, and
               more importantly, you can capture menus  or  other  popups  that  are  independent
               windows but appear over the specified 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.

SEE ALSO

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

ORIGINAL AUTHORS

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

       Xwintoppm is an tiny modification to Xwd program which is distributed with X11 kit.

MODIFICATIONS

       Jun-ichiro itojun Itoh, WIDE Project