NAME

xwud − X window image displayer. 

SYNTAX

xwud [options]

DESCRIPTION

xwud is an X Window System window image undumping utility.  xwud allows X users to display a window image saved in a specially formatted dump file, such as one produced by xwd.  Chapter 8, Other Clients, describes how to use these clients. 

xwud allows you to specify the coordinates at which this image is displayed using the -geometry option.  By default, xwud displays the window image at the coordinates of the original window from which the dump was taken. 

OPTIONS

xwud accepts the following 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 [host]:server[.screen]
Allows you to specify the host, server, and screen to connect to. host is the hostname of the physical display, server specifies the server number, and screen specifies the screen number.  For example: % xwud -display your_node:0.1 specifies screen 1 on server 0 on the display named by your_node.  If the host is omitted, the local machine is assumed.  If the screen is omitted, the screen 0 is assumed; the server and colon (:) are necessary in all cases. 

-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 geometry
The xwud window is created with the specified size and location determined by the supplied geometry specification.  The -geometry option can be (and often is) abbreviated to -g, unless there is a conflicting option that begins with "g." The argument to the geometry option (geometry) is referred to as a "standard geometry string," and has the form widthxheight±xoff±yoff.  (This option is available for use with xwud as of Release 4.)  Typically, you will want to specify only the position and let the size default to the actual size of the image.

-helpPrints out a short description of the allowable options. 

-in file
Allows the user to specify the input file on the command line.  If no file is specified, standard input is assumed.

-newForces 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 application, unless this option is specified.  Termination can always be achieved by typing ’q’, ’Q’, or Control-c.

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

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

-rvIf 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 map_type
Causes the image to be displayed using the specified standard colormap.  The property name is obtained by converting the type to uppercase, prepending "RGB_", and appending "_MAP". Typical types are best, default, and grey.  See xstdcmap for one way of creating standard colormaps. 

-vis vis_type_or_ID
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 use the same class as the colormap of the root window.  Case is not significant in any of these strings. 

FILES

XWDFile.h
X Window Dump File format definition file.

SEE ALSO

X, xdpr, xpr, xstdcmap, xwd; Chapter 8, Other Clients. 

AUTHOR

Bob Scheifler, MIT X Consortium;