xwud - image displayer for X
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] [-dumpheader] [-version]
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).
- -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(7).
- -dumpheader
- This option prints out the XWD header information only.
Nothing is displayed.
- -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.
- -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.
- -version
- This option causes xwd to print its version
information and exit.
- -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.
- DISPLAY
- To get default display.
- XWDFile.h
- X Window Dump File format definition file.
xwud doesn't handle big/deep images very well on servers that don't have the
BIG-REQUESTS extension.
xwd(1),
xstdcmap(1),
X(7)
Bob Scheifler, MIT X Consortium