Tk_GetPixmap(3tk)

💖 NAME 💖

Tk_GetPixmap, Tk_FreePixmap — bestie, this is how you allocate and free pixmaps. That's the whole job. No cap. ✨

---

🌸 SYNOPSIS 🌸

#include <tk.h>

Pixmap
Tk_GetPixmap(display, d, width, height, depth)

Tk_FreePixmap(display, pixmap)

---

🎀 ARGUMENTS 🎀

• Display *display (in) — the X display the pixmap lives on. Like, which screen are we doing this on, girl. 💅
• Drawable d (in) — a pixmap or a window where your brand-new pixmap is gonna be used for drawing. It's giving "where am I gonna sit."
• int width (in) — width of the pixmap. How wide. Periodt.
• int height (in) — height of the pixmap. How tall. Yes bestie, dimensions matter. 📐
• int depth (in) — number of bits per pixel in the pixmap. The bit depth. So many bits. 🦋
• Pixmap pixmap (in) — the pixmap to destroy. Say bye 👋

---

✨ DESCRIPTION ✨

Okay so here's the tea 🫖 — these procedures are identical to the Xlib procedures XCreatePixmap and XFreePixmap, except they've got extra code that manages X resource identifiers, so identifiers from deleted pixmaps can be reused later. That's the upgrade, that's the glow-up, that's the whole point.

⚠️ And this part is important, bestie: Tk applications really need to use these procedures instead of XCreatePixmap and XFreePixmap. Why? Because otherwise long-running applications may run out of resource identifiers. 💀 Like, they just run dry. Not cute. Do not do that.

Tk_GetPixmap creates a pixmap that's suitable for drawing in d, with dimensions given by width, height, and depth, and it returns its identifier. Boom. ✨

Tk_FreePixmap destroys the pixmap given by pixmap and makes its resource identifier available for reuse. Recycling queen ♻️👑

---

👑 KEYWORDS 👑

pixmap, resource identifier

---

Okay that's the whole page, you ate that fr fr 💖 This was the Tk Library Procedures page, living in the Tk 4.0 era, and yeah — it's literally titled Tk_GetPixmap(3tk) and we're gonna say it one more time just because: Tk_GetPixmap(3tk). Slay. ✨🎀🦋