xwud(1X)                                                 xwud(1X)



NAME
     xwud - displays an image

SYNOPSIS
     xwud [-in file] [-noclick] [-geometry geometry]
     [-display display] [-new] [-std map-type] [-raw]
     [-vis visual-type-or-id] [-help] [-rv] [-plane number]
     [-fg color] [-bg color]

DESCRIPTION
     xwud displays in a window an image saved in a specially for-
     matted dump file, such as produced by xwd(1X).

   Options
     The xwud command accepts these options:

     -bg color
             Specifies the color of 0 bits when displaying a bit-
             map image or a single plane of an image.

     -display display
             Specifies the server to connect to.  See X(1X) for
             details.

     -fg color
             Specifies the color of 1 bits when displaying a bit-
             map image or a single plane of an image.

     -geometry geometry
             Specifies the size and position of the window.  Typ-
             ically, you only specify the position and let the
             size default to the actual size of the image. See
             X(1X) for details.

     -help   Displays a summary of the command syntax.

     -in file
             Specifies the input file. The default is to use the
             standard input.

     -new    Forces creation of a new colormap for displaying the
             image.  If the image characteristics happen to match
             those of the display, this option can get the image
             on the screen faster, but at the cost of using a new
             colormap, which on most displays causes other win-
             dows to flash or change color.

     -noclick
             Specifies that pressing the mouse button (or the
             LEFT or RIGHT ARROW key) while the pointer is in the
             window will not terminate the application. If you
             use this option, you can terminate xwud by pressing



November, 1990                                                  1

xwud(1X)                                                 xwud(1X)



             the Q key or CONTROL-C.

     -plane number
             Specifies a single bit plane of the image to
             display.  Planes are numbered with 0 being the least
             significant bit.  You can use this option to figure
             out which plane to pass to xpr(1X) for printing.

     -raw    Forces the image to be displayed with whatever color
             values happen to currently exist on the screen.
             This option is useful when restoring an image onto
             the same screen that the image originally came from
             while the original windows are still on the screen.
             This option gets the image on the screen faster.

     -rv     Forces the foreground and background colors to be
             swapped when a bitmap image or a single plane of an
             image is displayed. You may need this option when
             displaying a bitmap image that 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 map-type to upper case, prepending RGB_,
             and appending _MAP.  Possible map-type values are
             best, default, and gray.  See xstdcmap(1X) for one
             way of creating standard colormaps.

     -vis visual-type-or-id
             Specifies a particular visual or visual class.  The
             default is best.  You can specify a particular
             class:
             StaticGray, GrayScale, StaticColor, PseudoColor,
             DirectColor, or TrueColor.  You can also specify
             Match to cause xwud to use the same class as the
             source image. Alternately, you can specify an exact
             visual ID (specific to the server), either as a hex-
             adecimal number (prefixed with 0x) or as a decimal
             number.  Finally, you can specify default, which
             causes xwud to use the same class as the colormap of
             the root window.  Case is not significant in any of
             these strings.

   Environment variables
     The xwud command uses this environment variable:

     DISPLAY Specifies the default host, display number, and
             screen.





2                                                  November, 1990

xwud(1X)                                                 xwud(1X)



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

     Author: Bob Scheifler, MIT X Consortium

FILES
     XWDFile.h
             Defines a file format for the X window dump file.

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











































November, 1990                                                  3