IMG_LoadLBM_IO(3)

📦
version 3.4.4 · 8 versions
, in ubuntu stonking

💅 IMG_LoadLBM_IO(3) — aka the "yes bestie I already know it's an LBM" loader

okay so real talk, this one lives in the SDL_image3 FUNCTIONS crew, and it's your shortcut for when you are one hundred percent certain about your file format. no detectives needed 🕵️‍♀️

✨ SYNOPSIS ✨

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadLBM_IO(SDL_IOStream *src);

literally just one call, one argument, and it hands you back a surface. slay.

🦋 DESCRIPTION 🦋

so here's the vibe: if you know you definitely have a LBM image — like, no doubt in your heart, no second-guessing — you can call this function and it will skip SDL_image's file format detection routines entirely. it's giving "I already checked, thanks" ✋

generally it's better to use the abstract interfaces though, ngl. and heads up: there is only an SDL_IOStream interface available here — that's the whole menu, no other flavors. 🎀

🌸 FUNCTION PARAMETERS 🌸

  • src — an SDL_IOStream to load image data from. this is your snack source, your data faucet, your main character input. 💖

⭐ RETURN VALUE ⭐

returns an SDL_Surface, or NULL on error. so like... check it, bestie. don't just rawdog the pointer and hope for the best 😭

👑 AVAILABILITY 👑

this function is available since SDL_image 3.0.0. so if you're on anything older, sorry babe, it's not gonna be there. 🫶

🌈 SEE ALSO 🌈

the whole squad of format-specific loaders, all together, all iconic:

💀 quick reminder before you go: this skips detection. if you don't actually have an LBM, that's on you, not on the function. no cap.

and that's the whole page, bestie! brought to you by SDL_image version SDL_image 3.4.4 — go forth and load your LBM files with confidence 💅✨🎀

📦 where this page comes from