<HTML>
<HEAD>
<TITLE> xwud - image displayer for X </TITLE>
</HEAD>
<BODY>
<PRE>



XWUD(1)							  XWUD(1)


NAME
       xwud - image displayer for X

SYNOPSIS
       xwud [-in file] [-noclick] [-geometry geom] [-display dis_
       play] [-new] [-std &lt;maptype&gt;] [-raw]  [-vis  &lt;vis-type-or-
       id&gt;] [-help] [-rv] [-plane number] [-fg color] [-bg color]

DESCRIPTION
       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
       -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 characteris
	       tics happen to match those of  the  display,  this
	       can get the image on the screen faster, but at the



X Version 11		   Release 6.1				1





XWUD(1)							  XWUD(1)


	       cost of using a new colormap (which on  most  dis
	       plays will cause other windows to go technicolor).


       -noclick
	       Clicking any button in the window  will	terminate
	       the  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.


       -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  speci
	       fied:  "StaticGray",  "GrayScale",  "StaticColor",
	       "PseudoColor", "DirectColor", or "TrueColor".   Or
	       "Match"	can  be	 specified,  meaning use the same
	       class as	 the  source  image.   Alternatively,  an



X Version 11		   Release 6.1				2





XWUD(1)							  XWUD(1)


	       exact  visual  id  (specific to the server) can be
	       specified, either as a  hexadecimal  number  (pre
	       fixed 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.

ENVIRONMENT
       DISPLAY To get default display.

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

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

SEE ALSO
       xwd(1), xpr(1), xstdcmap(1), X(1)

AUTHOR
       Bob Scheifler, MIT X Consortium


































X Version 11		   Release 6.1				3


</PRE>
</BODY>
</HTML>
