SDL_REMOVESURFACEALTERNATEIMAGES(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 NAME 💖

SDL_RemoveSurfaceAlternateImages — bestie, this one clears out every single alternate version of a surface. like, all of them. gone. 💅

✨ SYNOPSIS ✨

#include <SDL3/SDL_surface.h>

void SDL_RemoveSurfaceAlternateImages(SDL_Surface *surface);

🦋 DESCRIPTION 🦋

okay so picture this: your surface has a whole lil entourage of alternate versions hanging around. this function removes a reference from all the alternative versions, and if that was the last reference to any of them? yeah, those get destroyed. no cap. 🫶

it's giving "clean up your contacts list" energy fr fr.

🎀 FUNCTION PARAMETERS 🎀

  • surface — the SDL_Surface structure you wanna update. that's the one, bestie. 💖

🌈 THREAD SAFETY 🌈

you can call this from different threads — as long as each thread is working with a different surface. so like, everyone gets their own, no fighting, we don't do that here. 💅

⭐ AVAILABILITY ⭐

this one's been around since SDL 3.2.0. so if you're on anything older... not me being the bearer of bad news 😭

👑 SEE ALSO 👑

okay that's the whole page, you ate that 💅 this lil manual moment comes to you from Simple Directmedia Layer, living its SDL 3.4.18 era — mwah, go forth and remove those alternates, queen 🎀✨💖

📦 where this page comes from