XWUD(1)                         X11 5.4R3.00                         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>] [-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).




Licensed material--property of copyright holder(s)                         1

XWUD(1)                         X11 5.4R3.00                         XWUD(1)


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





Licensed material--property of copyright holder(s)                         2

XWUD(1)                         X11 5.4R3.00                         XWUD(1)


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

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

WARNINGS
       xwud of a 24 bit xwd onto a 24 + 4 display takes a very long time.

COPYRIGHT
       Copyright 1988, Massachusetts Institute of Technology.
       See X(1) for a full statement of rights and permissions.

AUTHOR
       Bob Scheifler, MIT X Consortium









































Licensed material--property of copyright holder(s)                         3