Tk_DeleteImage(3)

✨ Tk_DeleteImage(3) ✨

okay bestie, welcome to the Tk Library Procedures corner of the manual — this one's short and sweet and honestly kind of iconic for how chill it is 🎀

---

💅 NAME 💅

Tk_DeleteImage — destroy an image. that's it. that's the whole vibe. poof, gone, bye 👋

---

🦋 SYNOPSIS 🦋

#include <tk.h>

Tk_DeleteImage(interp, name)

---

🌸 ARGUMENTS 🌸

• Tcl_Interp *interp (in) — the interpreter the image was created for. like, the context, the setting, the whole environment the image belongs to 🫶
• const char *name (in) — the name of the image. just the name, nothing else, keep it simple ✨

---

🔥 DESCRIPTION 🔥

so Tk_DeleteImage deletes the image that interp and name point at — if there is one. and ngl, the "if there is one" is doing a lot of heavy lifting there, we'll get to that.

all instances of that image will redisplay as empty regions. so yeah, everything that was showing it is now just showing... nothing. blank. a void. it's giving minimalism 💀

and if the given image doesn't exist? the procedure literally has no effect. no error, no drama, no meltdown — it just quietly does nothing and moves on with its life, which honestly is main character energy 😌

no cap, this is a very peaceful function. it doesn't yell at you for passing a name that isn't there. it just minds its business 💖

---

👑 KEYWORDS 👑

delete image, image manager

---

and that's the whole page, bestie — short, efficient, and lowkey perfect 🎀 big love to Tk, this page is from version 4.0 of the Tk manual, dated right there in the footer next to Tk_DeleteImage(3). go forth and delete those images, you absolute icon 🌈💜