DragonFly On-Line Manual Pages

Search: Section:  

XWD(1)                 DragonFly General Commands Manual                XWD(1)


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

X Version 11                      Release 6.3                           XWD(1)

Search: Section: