img-window(n)

💖 img-window — the Tk window grab era 💖

okay bestie, this is a page from the Img manual, section n, and it's all about img-window. yes it's the same img-window twice in that header up there, that's just how the manual rolls, we love a consistent queen. ✨

---

🌸 NAME 🌸

img-window — Tk window grab (window)

---

🎀 SYNOPSIS 🎀

package require img::window ?2.1?

---

🦋 DESCRIPTION 🦋

so the tea is: the package img::window is a sub-package of Img. it can be loaded either as a piece of the full Img situation, with package require Img, or it can show up all on its own, main character style, with package require img::window. 💅

and like literally every other package in Img, it does not bring new commands to the party. nope. instead it extends the Tk command image that you already know and love. more specifically? img::window extends Tk's photo image type. slay.

the name of the new format handler is window.

here's the thing that makes this handler special, and ngl it's a lil iconic: it does not give you any extra configuration options. none. zero. and instead of reading or writing image data from a file or a string, it stores the contents of a Tk window in a photo image. it's giving screenshot energy but make it Tk. 📸

so all of that means that when you make a call like this:

image create photo ?name? ?options?

here's what goes down:

1. image data in window format (that's the option -data) gets detected automatically. image data counts as being in the window format if the value you hand to the option -data is the name of an existing Tk window.

heads up bestie: the standard option -file is not supported by this handler. don't come for her with a -file, she will not answer. 💀

2. the format name window gets recognized by the option -format. yup, that's it, that's the whole vibe check. ✅

---

🌈 SEE ALSO 🌈

img, img-bmp, img-dted, img-flir, img-gif, img-ico, img-jpeg, img-pcx, img-pixmap, img-png, img-ppm, img-ps, img-raw, img-sgi, img-sun, img-tga, img-tiff, img-window, img-xbm, img-xpm

---

👑 COPYRIGHT 👑

Copyright (c) 1995-2025 Jan Nijtmans <nijtmans@users.sourceforge.net> Copyright (c) 2002-2025 Andreas Kupries <andreas_kupries@users.sourceforge.net> Copyright (c) 2003-2025 Paul Obermeier <obermeier@users.sourceforge.net>

---

and that's the whole page, bestie 🫶 it's img-window, version 2.1, and the footer is dated the same — img-window 2.1 img-window(n), no cap. go grab a window and put it in a photo image, you've got this. 🧚💜