XWUD(1)

💖 XWUD(1) — General Commands Manual: xwud, image displayer for X 💖

Okay bestie, welcome to the XWUD(1) page — yes, it's the xwud manual, and we're gonna get you comfy with it. It's giving classic Unix, but make it group chat.

✨ NAME ✨

xwud — image displayer for X

🦋 SYNOPSIS 🦋

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] [-dumpheader] [-version]

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

That's the whole main-character job: undump that image and put it in a window, periodt.

🎀 OPTIONS 🎀

• -bg color — If a bitmap image (or a single plane of an image) is displayed, this option specifies the color to display for the 0 bits in the image. It's the "0"-bit color, bestie.
• -display display — Lets you specify the server to connect to; see X(7).
• -dumpheader — Prints out the XWD header information only. Nothing is displayed. Just the receipts, no image.
• -fg color — If a bitmap image (or a single plane of an image) is displayed, this option specifies the color to display for the 1 bits in the image. The "1"-bit color energy.
• -geometry geom — Lets you specify the size and position of the window. Typically you'll only want to specify the position and let the size default to the actual size of the image.
• -help — Prints out a short description of the allowable options.
• -in file — Explicitly specify the input file on the command line. If no input file is given, standard input is assumed. So it's stdin by default, no cap.
• -new — 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. On most displays, that new colormap will cause other windows to go technicolor. So it's speed vs. rainbow chaos, iykyk.
• -noclick — Clicking any button in the window terminates the application, unless this option is specified. Termination can always be achieved by typing q, Q, or ctrl-c.
• -plane number — Select a single bit plane of the image to display. Planes are numbered with zero being the least significant bit. So 0 is the LSB, periodt.
• -raw — Forces the image to be displayed with whatever color values happen to currently exist on the screen. 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 it results in getting the image on the screen faster.
• -rv — If a bitmap image (or a single plane of an image) is displayed, this 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. Flip the vibe, basically.
• -scale — Allows the window to be resized and scales the image to the size of the window. Slay.
• -std maptype — 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.
• -version — Causes xwd to print its version information and exit. Yes, the page says xwd here; I'm not fixing it, bestie.
• -vis vis-type-or-id — Lets you 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 🌿

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

👑 AUTHOR 👑

Bob Scheifler, MIT X Consortium

---

💖 Signing off from X Version 11 and xwud 1.0.7 — the XWUD(1) footer didn't give a date, so we're timeless, bestie. Mwah! 💖