XWUD(1)								      XWUD(1)



NAME
       xwud - image displayer for X

SYNOPSIS
       xwud  [-in file] [-noclick] [-geometry geom] [-display display] [-new]
       [-std ] [-raw] [-vis ] [-scale] [-help] [-rv]
       [-plane number] [-fg color] [-bg color] [-dumpheader]

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 dis-
	       played, this option can be used to specify the color  to	 dis-
	       play for the "0" bits in the image.


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


       -dumpheader
	       This option prints out the XWD header information only.	Noth-
	       ing is displayed.


       -fg color
	       If  a  bitmap  image  (or  a single plane of an image) is dis-
	       played, this option can be used to specify the color  to	 dis-
	       play 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	 dis-
	       plays will cause other windows to go technicolor).


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


       -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 get-
	       ting the image on the screen faster.


       -rv     If a bitmap image (or a single plane  of	 an  image)  is	 dis-
	       played,	this option forces the foreground and background col-
	       ors 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 speci-
	       fied Standard Colormap.	The property name is obtained by con-
	       verting the type to upper case, prepending "RGB_", and append-
	       ing "_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	 par-
	       ticular	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.

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), xstdcmap(1), X(7x)

AUTHOR
       Bob Scheifler, MIT X Consortium





								      XWUD(1)

UNIX/Linux commands referenced on this page:

1. users
2. display
3. dump
4. file
5. as
6. bitmap
7. play
8. size
9. at
10. which
11. id