IMG_GetClipboardImage(3)

💖 IMG_GetClipboardImage 💖

okay bestie, welcome to the SDL_image3 FUNCTIONS section of the manual, and today's main character is IMG_GetClipboardImage — she grabs whatever image is chillin' in the clipboard rn. no cap, that's the whole plot 🎀

---

✨ NAME ✨

IMG_GetClipboardImage — Get the image currently in the clipboard.

like, the clipboard. the one you just copied a picture into. yeah that one 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_GetClipboardImage(void);

she takes no arguments. zero. void. she simply is 🦋

---

💖 DESCRIPTION 💖

okay so here's the tea: when you're done with the surface she hands you, your app should dispose of it by calling SDL_DestroySurface().

fr fr, don't just leave it lying around — that's giving memory leak energy and we do not stan 🙈 clean up after yourself, bestie.

---

⭐ RETURN VALUE ⭐

she returns a new SDL_Surface, or NULL if no supported image is available.

so if you get NULL, it's not you, it's the clipboard — there was just nothing she could work with 😭

---

🌈 AVAILABILITY 🌈

this function is available since SDL_image 3.4.0. so if you're on something older... girl. upgrade. periodt 👑

---

okay that's the whole page, you ate it, I'm obsessed 🫶 go forth and paste images responsibly 💜

this has been your girl from SDL_image, version 3.4.8 — signing off, mwah 💋✨