XWUD(1) X Version 11 (Release 6.6) XWUD(1)
NAME
xwud - image displayer for X
SYNOPSIS
xwud [-in file] [-noclick] [-geometry geom] [-display
display] [-new] [-std <maptype>] [-raw] [-vis <vis-type-or-
id>] [-scale] [-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 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 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.
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
Page 3 (printed 7/20/06)