Tk_ImageChanged(3)

✨ NAME ✨

okay so this is Tk_ImageChanged(3) from the Tk Library Procedures, and it is literally here to notify widgets that image needs to be redrawn 💅. That's the whole vibe, and it ate.

---

🦋 SYNOPSIS 🦋

#include <tk.h>

Tk_ImageChanged(model, x, y, width, height, imageWidth, imageHeight)

---

🎀 ARGUMENTS 🎀

• Tk_ImageModel model (in) — the token for the image, bestie. It's the token that was passed to the image's createProc when the image was created 🫶.
• int x (in) — X-coordinate of the upper-left corner of the region that needs redisplay, measured from the upper-left corner of the image.
• int y (in) — Y-coordinate of the upper-left corner of the region that needs redisplay, measured from the upper-left corner of the image.
• int width (in) — width of the region that needs to be redrawn, in pixels.
• int height (in) — height of the region that needs to be redrawn, in pixels.
• int imageWidth (in) — current width of the image, in pixels.
• int imageHeight (in) — current height of the image, in pixels.

---

💅 DESCRIPTION 💅

An image manager calls Tk_ImageChanged for an image whenever anything happens that requires the image to be redrawn. As a result of calling Tk_ImageChanged, any widgets using the image are notified so that they can redisplay themselves appropriately. The model argument identifies the image, and x, y, width, and height specify a rectangular region within the image that needs to be redrawn. imageWidth and imageHeight specify the image's (new) size ✨.

An image manager should call Tk_ImageChanged during its createProc to specify the image's initial size and to force redisplay if there are existing instances for the image. If any of the pixel values in the image should change later on, Tk_ImageChanged should be called again with x, y, width, and height values that cover all the pixels that changed. If the size of the image should change, then Tk_ImageChanged must be called to indicate the new size, even if no pixels need to be redisplayed.

lowkey important, bestie: if the size changes, you must call Tk_ImageChanged to indicate the new size — even if no pixels need to be redisplayed. no cap 💀.

---

🌈 SEE ALSO 🌈

• Tk_CreateImageType — the related page, go read it too 🫶.

---

⭐ KEYWORDS ⭐

• images
• redisplay
• image size changes

---

xoxo, source/version: Tk 4.0 · footer: Tk_ImageChanged(3) 🫶💖