STANNIX Community


Manual: xwd

XWD(1)						   General Commands Manual					      XWD(1)

NAME
       xwd - dump an image of an X window

SYNOPSIS
       xwd  [-debug]  [-help]  [-nobdrs] [-out file] [-xy] [-frame] [-add value] [-root | -id wdid | -name wdname ] [-icmap]
       [-screen] [-silent] [-display host:dpy] [-version]

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

OPTIONS
       -debug  Enable debug mode.

       -d, -display host:dpy
	       This argument allows you to specify the server to connect to; see X(7).

       -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 illustra‐
	       tion.

       -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 a 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 wdid
	       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 wdname
	       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 in‐
	       stalled 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 over‐
	       lap  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.

       -version
	       This option indicates that xwd should print its version information and exit.

ENVIRONMENT
       DISPLAY To get default host and display number.

FILES
       XWDFile.h
	       X Window Dump File format definition file.

SEE ALSO
       xwud(1), X(7)

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

X Version 11						  xwd 1.0.9						      XWD(1)