XWD(1)		X Version 11 (Release 6.4)		XWD(1)



     NAME    [Toc]    [Back]
	  xwd -	dump an	image of an X window

     SYNOPSIS    [Toc]    [Back]
	  xwd [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame]
	  [-add	value] [-root |	-id id | -name name ] [-icmap] [-
	  screen] [-display display]

     DESCRIPTION    [Toc]    [Back]
	  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    [Toc]    [Back]
	  -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



     Page 1					     (printed 10/9/01)






     XWD(1)		X Version 11 (Release 6.4)		XWD(1)



		  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.
		  Note that on systems with multiple visuals, this can
		  result in xwd	failing	with protocol errors in
		  XQueryColors,	if the visual corresponding to the
		  first	installed colormap is different	from the
		  visual of the	chosen window.

	  -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    [Toc]    [Back]
	  DISPLAY To get default host and display number.

     FILES    [Toc]    [Back]
	  XWDFile.h
		  X Window Dump	File format definition file.

     SEE ALSO    [Toc]    [Back]
	  xwud(1), xpr(1), X(1)

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











     Page 2					     (printed 10/9/01)