XWD(1)

✨ XWD(1) ✨

okay so bestie, lemme put you on to xwintoppm 💅 this is the manual page for it, and it's genuinely iconic.

---

🎀 NAME 🎀

xwintoppm — dump an image of an X window 🫶

---

🌸 SYNOPSIS 🌸

xwintoppm [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add
value] [-root | -id id | -name name ] [-icmap] [-screen] [-display
display]

---

💖 DESCRIPTION 💖

So Xwintoppm is an X Window System window dumping utility, periodt. It lets X users store window images in ppm(5) format — and then that file can be read by a whole bunch of other X utilities for redisplay, printing, editing, formatting, archiving, image processing, etc. the way it just slots into your whole workflow?? obsessed. 🔥

---

✨ OPTIONS ✨

• -display display — this argument lets you specify the server to connect to; see X(1).
• -help — prints out the `Usage:' command syntax summary. 🫶
• -nobdrs — this one says the window dump should not include the pixels that make up the X window border. super useful when you wanna drop the window contents into a document as an illustration. 🎀
• -out file — lets you explicitly specify the output file right there on the command line. the default is to output to standard out.
• -xy — this option applies to color displays only, just so you know. it selects XY format dumping instead of the default Z format. 💅
• -add value — specifies a signed value to be added to every pixel. yes, every single one.
• -frame — indicates that the window manager frame should be included when you're manually selecting a window. 🌈
• -root — indicates the root window should be selected for the window dump, so you don't have to make the user pick a window with the pointer. 👑
• -id id — indicates the window with the specified resource id should be selected for the window dump, without requiring the user to select a window with the pointer.
• -name name — indicates the window with the specified WM_NAME property should be selected for the window dump, again without requiring the user to pick a window with the pointer.
• -icmap — normally the colormap of the chosen window is used to obtain RGB values. this option forces the first installed colormap of the screen to be used instead. 🔥
• -screen — indicates that the GetImage request used to obtain the image should be done on the root window rather than directly on the specified window. that way you can grab pieces of other windows that overlap the specified window, and — more importantly — you can capture menus or other popups that are independent windows but appear over the specified window. this one lowkey eats. 😭
• -silent — operate silently, i.e. don't ring any bells before and after dumping the window. peace and quiet, bestie. 🙈

ngl, quick vibe check: the -silent option is listed here in OPTIONS but it doesn't show up in the SYNOPSIS up there. just saying. 👀

---

🦋 ENVIRONMENT 🦋

• DISPLAY — used to get the default host and display number.

---

💜 SEE ALSO 💜

xwd(1), xwud(1), xpr(1), X(1), ppm(5).

---

👑 ORIGINAL AUTHORS 👑

• Tony Della Fera, Digital Equipment Corp., MIT Project Athena
• William F. Wyatt, Smithsonian Astrophysical Observatory

Xwintoppm is an tiny modification to Xwd program which is distributed with X11 kit. (yes, "an tiny", we're keeping it exactly as written, no cap 💀)

---

⭐ MODIFICATIONS ⭐

• Jun-ichiro itojun Itoh, WIDE Project

---

okay that's the whole page, you ate that bestie 🫶 this was X Version 11, Release 6.3, and the page itself is dated XWD(1) — love that for us. mwah 💋✨