SDL_DestroySurface(3)

💖 SDL_DestroySurface — the manual page, bestie edition 💖

okay so this is a page from the SDL3 FUNCTIONS manual, and today's main character is SDL_DestroySurface. she's the cleanup crew. the girl who takes out the trash after the party. and honestly? we're obsessed. 🎀

---

✨ NAME ✨

SDL_DestroySurface — free a surface. that's it, that's the whole job. girlboss behaviour. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_surface.h>

void SDL_DestroySurface(SDL_Surface *surface);

look at her. no return value, no drama, no notes. she just does it. 👑

---

🦋 DESCRIPTION 🦋

so you've got a surface, you're done with it, and now you need to let it go. this is the function that does that. closure, literally. 💖

and here's the part that lowkey slays: it is safe to pass NULL to this function. no crash, no panic, no "bestie why would you do that". she just handles it. so chill. so unbothered. ✨

---

🎀 FUNCTION PARAMETERS 🎀

• surface — the SDL_Surface to free. hand her the surface, she handles the rest. 🫶

---

🔥 THREAD SAFETY 🔥

No other thread should be using the surface when it is freed.

fr fr, this one matters. if some other thread is still touching that surface while you're freeing it, that's a vibe check you will NOT pass. make sure everybody's done with it first, then let it go. 💀🚫

---

🌈 AVAILABILITY 🌈

this function has been available since SDL 3.2.0. so if you're on 3.2.0 or later, she's there for you. iconic since day one. ⭐

---

💜 SEE ALSO 💜

• SDL_CreateSurface(3) — where the surface came from, the origin story 🧚
• SDL_CreateSurfaceFrom(3) — the other way to make one 🍓

---

and that's the whole page, no cap. go forth and free your surfaces responsibly. 🌸

Simple Directmedia Layer — SDL 3.4.18 — mwah, love you, bye bestie 💋💖 SDL_DestroySurface(3)