xwd(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>



XWD(1)							   XWD(1)



NAME

       xwd - dump an image of an X window


SYNOPSIS

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


DESCRIPTION

       Xwd  is	an  X  Window System window dumping utility.  Xwd
       allows X users to store window images in a specially  for
       matted  dump  file.  This file can then be read by various
       other X utilities for redisplay, printing,  editing,  for
       matting,	 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

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


       -out file
	       This  argument allows the user to explicitly spec
	       ify 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.




X Version 11		   Release 6.6				1





XWD(1)							   XWD(1)


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


FILES

       XWDFile.h
	       X Window Dump File format definition file.


SEE ALSO

       xwud(1), xpr(1), X(7)


AUTHORS

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






X Version 11		   Release 6.6				2