SDL_LoadBMP(3)

💖 SDL_LoadBMP(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_LoadBMP — the one that loads a BMP image from a file. no cap. 🎀

---

🌸 NAME 🌸

SDL_LoadBMP — load a BMP image from a file, periodt. 🦋

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_surface.h>

SDL_Surface * SDL_LoadBMP(const char *file);

look at her. so simple. so iconic. 💅

---

🫶 DESCRIPTION 🫶

She gives you a brand-new surface loaded up from your BMP file, and she is literally handing it to you like a lil gift. 🎁

IMPORTANT BESTIE: the new surface should be freed with SDL_DestroySurface(). not doing so will result in a memory leak. that's not a vibe, that's a slow-motion tragedy. 😭 clean up after yourself, queen.

---

👑 FUNCTION PARAMETERS 👑

• file — the BMP file to load. that's it. that's the whole job. she just wants the file, bestie. 💜

---

🌈 RETURN VALUE 🌈

Returns a pointer to a new SDL_Surface structure — slay ✨ — or NULL on failure. if you get NULL, do not panic, just call SDL_GetError() for more information. she'll tell you what went wrong. 🫶

---

💀 THREAD SAFETY 💀

It is safe to call this function from any thread. yes, ANY. go wild. multithreaded icon behavior. 🔥

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on something older... bestie. we need to talk. 🙈

---

🦋 SEE ALSO 🦋

• SDL_DestroySurface(3) — the one you MUST call, remember? 💅
• SDL_LoadBMP_IO(3)
• SDL_SaveBMP(3)

---

and that's the whole page, bestie!! 🍓 this lil slice of documentation came to you courtesy of Simple Directmedia Layer, version SDL 3.4.18, dated SDL_LoadBMP(3) — mwah, go free your surfaces. 💖✨🎀