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



     NAME    [Toc]    [Back]
	  xwud - image displayer for X

     SYNOPSIS    [Toc]    [Back]
	  xwud [-in file] [-noclick] [-geometry	geom] [-display
	  display] [-new] [-std	<maptype>] [-raw] [-vis	<vis-type-orid>]
 [-scale]	[-help]	[-rv] [-plane number] [-fg color] [-bg
	  color]

     DESCRIPTION    [Toc]    [Back]
	  Xwud is an X Window System image undumping utility.  Xwud
	  allows X users to display in a window	an image saved in a
	  specially formatted dump file, such as produced by xwd(1).

     OPTIONS    [Toc]    [Back]
	  -bg color
		  If a bitmap image (or	a single plane of an image) is
		  displayed, this option can be	used to	specify	the
		  color	to display for the "0" bits in the image.

	  -display display
		  This option allows you to specify the	server to
		  connect to; see X(1).

	  -fg color
		  If a bitmap image (or	a single plane of an image) is
		  displayed, this option can be	used to	specify	the
		  color	to display for the "1" bits in the image.

	  -geometry geom
		  This option allows you to specify the	size and
		  position of the window.  Typically you will only
		  want to specify the position,	and let	the size
		  default to the actual	size of	the image.

	  -help	  Print	out a short description	of the allowable
		  options.

	  -in file
		  This option allows the user to explicitly specify
		  the input file on the	command	line.  If no input
		  file is given, the standard input is assumed.

	  -new	  This option forces creation of a new colormap	for
		  displaying the image.	 If the	image characteristics
		  happen to match those	of the display,	this can get
		  the image on the screen faster, but at the cost of
		  using	a new colormap (which on most displays will
		  cause	other windows to go technicolor).

	  -noclick
		  Clicking any button in the window will terminate the



     Page 1					     (printed 10/9/01)






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



		  application, unless this option is specified.
		  Termination can always be achieved by	typing 'q',
		  'Q', or ctrl-c.

	  -plane number
		  You can select a single bit plane of the image to
		  display with this option.  Planes are	numbered with
		  zero being the least significant bit.	 This option
		  can be used to figure	out which plane	to pass	to
		  xpr(1) for printing.

	  -raw	  This option forces the image to be displayed with
		  whatever color values	happen to currently exist on
		  the screen.  This option is mostly useful when
		  undumping an image back onto the same	screen that
		  the image originally came from, while	the original
		  windows are still on the screen, and results in
		  getting the image on the screen faster.

	  -rv	  If a bitmap image (or	a single plane of an image) is
		  displayed, this option forces	the foreground and
		  background colors to be swapped.  This may be	needed
		  when displaying a bitmap image which has the color
		  sense	of pixel values	"0" and	"1" reversed from what
		  they are on your display.

	  -scale  Allow	the window to be resized, and scale the	image
		  to the size of the window.

	  -std maptype
		  This option causes the image to be displayed using
		  the specified	Standard Colormap.  The	property name
		  is obtained by converting the	type to	upper case,
		  prepending "RGB_", and appending "_MAP".  Typical
		  types	are "best", "default", and "gray".  See
		  xstdcmap(1) for one way of creating Standard
		  Colormaps.

	  -vis vis-type-or-id
		  This option allows you to specify a particular
		  visual or visual class.  The default is to pick the
		  "best" one.  A particular class can be specified:
		  "StaticGray",	"GrayScale", "StaticColor",
		  "PseudoColor", "DirectColor",	or "TrueColor".	 Or
		  "Match" can be specified, meaning use	the same class
		  as the source	image.	Alternatively, an exact	visual
		  id (specific to the server) can be specified,	either
		  as a hexadecimal number (prefixed with "0x") or as a
		  decimal number.  Finally, "default" can be
		  specified, meaning to	use the	same class as the
		  colormap of the root window.	Case is	not
		  significant in any of	these strings.



     Page 2					     (printed 10/9/01)






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



     ENVIRONMENT    [Toc]    [Back]
	  DISPLAY To get default display.

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

     BUGS    [Toc]    [Back]
	  xwud doesn't handle big/deep images very well	on servers
	  that don't have the BIG-REQUESTS extension.

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

     AUTHOR    [Toc]    [Back]
	  Bob Scheifler, MIT X Consortium







































     Page 3					     (printed 10/9/01)