xwintoppm - dump an image of an X window

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

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.

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

DISPLAY

To get default host and display number.

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

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.

Jun-ichiro itojun Itoh, WIDE Project