xwud(X)                         19 June 1992                         xwud(X)


 Name

    xwud - image displayer for X

 Syntax

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

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


    -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 sig-
            nificant bit.  This option can be used to figure out which plane
            to pass to xpr(X) 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".


    -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, mean-
            ing 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.

 See also

    xwd(X), xpr(X), X(X)