xwud(X)                       06 January 1993                        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(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 stan-
              dard 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 applica-
              tion, 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(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 ori-
              ginal 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 speci-
              fied Standard Colormap.  The property name is obtained by con-
              verting 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'', ``Sta-
              ticColor'', ``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 variables


    DISPLAY   To get default display.

 Files


    XWDFile.h X Window Dump File format definition file.

 See also

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