xwud Command

Purpose

Retrieves and displays the dumped image of an Enhanced X-Windows window.

Syntax

xwud [ -in FileName ] [ -noclick ] [ -geometry Geometry ] [ -display Display ] [ -new ] [  -std MapType ] [ -raw ] [ -vis visual_type | visual_id ] [ -help ] [ -rv ] [ -plane Number ] [ -fg Color ] [ -bg Color ]

Description

The xwud command retrieves the dumped image of an Enhanced X-Windows window. It does so by displaying in a window an image saved in a specially formatted dump file previously produced by the xwd command. The dump file format is determined by the XWDFile.h file.

You can use flags to specify color display, window size and position, input field, and visual class or identification. You can also select a single bit plane of the image to display.

Flags

Item Description
-bg Color Specifies the color to display for the 0 (zero) bits in the image if a bitmap image (or a single plane of an image) is displayed.
-display Display Specifies the server to connect to; see the X command.
-fg Color Specifies the color to display for the 1 bits in the image if a bitmap image (or a single plane of an image) is displayed.
-geometry Geometry Specifies the size and position of the window. Typically, you will only specify the position and let the size default to the actual size of the image.
-help Prints a short description of the allowable options.
-in FileName Specifies the input file on the command line. If the input file is not specified, the standard input is assumed.
-new Creates a new color map for displaying the image. If the image characteristics match those of the display, this flag can display the image on the screen faster, but at the cost of using a new color map (which on most terminals causes other windows to go technicolor).
-noclick Prevents the application from ending when a button in the window is clicked. You can end the application by typing a q or Q character, or the Ctrl-C key sequence.
-plane Number Selects a single bit plane of the image to display. Planes are numbered, with 0 (zero) being the least significant bit. Use this flag to determine which plane to pass to the xpr command for printing.
-raw Displays the dumped image in whatever color values currently exist on the screen. This flag is 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. This results in getting the image on the screen faster.
-rv Swaps the foreground and background colors if a bitmap image (or a single plane of an image) displays. This flag is useful when displaying a bitmap image that has the color sense of pixel values 0 and 1 reversed from what they are on the display.
-std MapType Uses the specified Standard Colormap to display the image. You can obtain the map type by converting the type to uppercase letters, prepending RGB_ and appending _MAP. Typical map types are best, default, and gray. See the /usr/lpp/X11/Xamples/clients/xstdcmap for information about creating Standard Colormaps.
-vis visual_type | visual_id Specifies a particular visual type or visual id. The default picks the best one or you can specify default, which is the same class as the colormap of the root window.

You can specify a particular class: StaticGray, GrayScale, StaticColor, PseudoColor, DirectColor, TrueColor. Specify Match to use the same class as the source image.

Specify an exact visual id (specific to the server) as a hexadecimal number (prefixed with 0x) or as a decimal number. This string is not case sensitive.

Environment Variables

Item Description
DISPLAY Gets the default display.

Example

To retrieve a specific file from the dump window, enter:

xwud -in FileName