XWUD(1)                        X Version 11                         XWUD(1)
                                 Release 6.3



 NAME    [Toc]    [Back]
      xwud - image displayer for X

 SYNOPSIS    [Toc]    [Back]
      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]

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      -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).

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




 Hewlett-Packard Company            - 1 -             HP-UX 11.23 March 2003






 XWUD(1)                        X Version 11                         XWUD(1)
                                 Release 6.3



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

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

      -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    [Toc]    [Back]
      DISPLAY To get default display.

 FILES    [Toc]    [Back]
      XWDFile.h
              X Window Dump File format definition file.





 Hewlett-Packard Company            - 2 -             HP-UX 11.23 March 2003






 XWUD(1)                        X Version 11                         XWUD(1)
                                 Release 6.3



 BUGS    [Toc]    [Back]
      xwud doesn't handle big/deep images very well on servers that don't
      have the BIG-REQUESTS extension.

 SEE ALSO    [Toc]    [Back]
      xwd(1), xpr(1), xstdcmap(1), X(1)

 AUTHOR    [Toc]    [Back]
      Bob Scheifler, MIT X Consortium


 Hewlett-Packard Company            - 3 -             HP-UX 11.23 March 2003