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] [-dumpheader] [-version]

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

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(7)

AUTHOR

       Bob Scheifler, MIT X Consortium