Manual Pages for UNIX Operating System command usage for man xwud

User Commands                                             XWUD(1)



NAME
     xwud - image displayer for X

SYNOPSIS
     /usr/bin/xwud  [-in  file]   [-noclick]   [-geometry   geom]
     [-display  display]  [-new]  [-std  ]  [-raw] [-vis
     ] [-scale]  [-help]  [-rv]  [-plane  number]
     [-fg color] [-bg color] [-dumpheader]

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 con-
             nect to; see X(5).

     -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 posi-
             tion 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



X Version 11         Last change: xwud 1.0.2                    1






User Commands                                             XWUD(1)



             cause other windows to go technicolor).

     -noclick
             Clicking any button in the window will terminate the
             application,  unless this option is specified.  Ter-
             mination 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 get-
             ting 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 Color-
             maps.

     -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",  "Pseu-
             doColor", "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 speci-
             fied, meaning to use the same class as the  colormap



X Version 11         Last change: xwud 1.0.2                    2






User Commands                                             XWUD(1)



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

AUTHOR
     Bob Scheifler, MIT X Consortium




ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/x11-window-dump         |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|





















X Version 11         Last change: xwud 1.0.2                    3