img-pixmap(n)

💖 img-pixmap — bestie edition 💖

okay so this is the manual page for img-pixmap from the Img manual, and it's literally about the Pixmap image type (yes, pixmap, that's the whole vibe). sit down, grab a strawberry 🍓, we're doing this.

---

✨ NAME ✨

img-pixmap — it's the Pixmap image type, aka pixmap. that's it, that's the name, slay.

---

✨ SYNOPSIS ✨

package require img::pixmap ?2.1?

image create pixmap ?name? ?options?

imageName option ?arg arg ...?

imageName cget option

imageName configure ?option? ?value option value ...?

---

✨ DESCRIPTION ✨

so img::pixmap is a sub-package of Img. you can load it as part of the whole complete Img support situation by doing package require Img, or you can be independent and load it all on its own with package require img::pixmap. main character energy either way 👑

like every single package in Img, it does not give you new commands. nope. instead it extends the Tk command image that you already know and love. no cap.

but here's the plot twist 🫢 — in contrast to all the other sub-packages, this one does not extend Tk's photo image type. instead it hands you a completely new image type, sitting on the exact same level as photo and bitmap. it's giving peer, not derivative. 💅

---

🎀 CREATING PIXMAPS 🎀

like all images (fr fr, all of them), pixmaps get created using the image create command.

image create pixmap ?name? ?options?

pixmaps support the following options, and yes we're going through every single one:

• -data string — Available since version 1.2.4. this one specifies the contents of the source pixmap as a string. the string has to adhere to X11 pixmap format (like, the kind generated by the pixmap program). and important: if you specify both -data and -file, then -data takes precedence. so -data wins, periodt.
• -file name — Available since version 1.2.4. name gives the name of a file whose contents define the source pixmap. the file must adhere to X11 pixmap format (e.g., as generated by the pixmap program). same energy as above, just from a file instead of a string. 🦋

---

👑 IMAGE COMMAND 👑

when a pixmap image gets created, Tk also creates a brand new command whose name is the same as the image. yes bestie, same name. this command is what you use to invoke various operations on the image, and it has this general form:

imageName option ?arg arg ...?

the option and the args determine exactly what the command does. the following commands are possible for pixmap images:

imageName cget option

returns the current value of the configuration option given by option. and option may have any of the values that image create pixmap accepts. simple, clean, iconic. ✨

imageName configure ?option? ?value option value ...?

query or modify the configuration options for the image. let's break this down because there's a lot going on here 👇

• if no option is specified, it returns a list describing all of the available options for imageName (see Tk_ConfigureInfo for the info on the format of this list).
• if option is specified with no value, then the command returns a list describing that one named option (this list will be identical to the corresponding sublist of the value returned when no option is specified).
• if one or more option-value pairs are specified, then the command modifies the given option(s) to have the given value(s). in this case the command returns an empty string. that's it. nothing. bye.

and again: option may have any of the values accepted by the image create pixmap command. 💜

---

🌈 SEE ALSO 🌈

go read these too, bestie, they're all part of the family:

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 💜

these absolute legends made it happen:

• 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, you ate that 🍽️💅 this was img-pixmap version 2.1, from the img-pixmap(n) manual in the Img docs. go forth and make pixmaps, bestie 🦋🌸💖