SDL_SURFACEHASALTERNATEIMAGES(3)

✨ SDL_SurfaceHasAlternateImages ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual 💖 this one's a little cutie from <SDL3/SDL_surface.h> and it's about to answer one very specific question for you.

---

🌸 NAME 🌸

SDL_SurfaceHasAlternateImages — returns whether a surface has alternate versions available, fr fr.

Like... does this surface have a lil wardrobe of other versions hanging in the back? That's the vibe check this function runs. 👑

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_surface.h>

bool SDL_SurfaceHasAlternateImages(SDL_Surface *surface);

look at her. one line. no drama. iconic. ✨

---

🎀 FUNCTION PARAMETERS 🎀

• surface — the SDL_Surface structure you want to query. yes queen, this is the thing you're asking about. 💅

---

💖 RETURN VALUE 💖

Returns true if alternate versions are available, or false otherwise. that's it. that's the whole answer. no hidden lore, no surprises, just a bool doing its best. 🫶

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. no cap! go off, spawn all the threads you want, this one's not gonna snitch on you. 🌈

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on something older, sorry bestie, she wasn't born yet 😭

---

👑 SEE ALSO 👑

• SDL_AddSurfaceAlternateImage(3) — go add some alternate images, treat your surface 🍓
• SDL_RemoveSurfaceAlternateImages(3) — ok now clear them all out, declutter era 💀
• SDL_GetSurfaceImages(3) — actually get the images instead of just asking if they exist, main character move 🔥

---

lowkey remember: this function only tells you whether alternates exist. it does not hand them over. that's a different function's job, iykyk. 🙈

---

and that's the whole page, bestie!! 💜 brought to you by Simple Directmedia Layer, version SDL 3.4.18. now go forth and query your surfaces, you absolute legend 🎀✨🦋