IMG_LoadXV_IO(3)

okay so bestie, you’ve landed on IMG_LoadXV_IO(3) — yes, that’s the page, and it lives in the SDL_image3 FUNCTIONS part of the manual. It’s giving “I already know this is a XV image, let me skip the lineup.” 💅

NAME 💖

IMG_LoadXV_IO — load a XV image directly. No extra format-detective arc, just the direct route. 🎀

SYNOPSIS 🎀

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadXV_IO(SDL_IOStream *src);

DESCRIPTION 🦋

So here’s the vibe: if you know — like, truly know in your soul — that you’ve definitely got a XV image, you can call this function. It will skip SDL_image’s file format detection routines entirely. ✨

ngl, the abstract interfaces are usually the better move. Also, heads up: there is only an SDL_IOStream interface available here. That’s the whole interface situation, no extra flavors. 🫶

FUNCTION PARAMETERS 🌸

• src — an SDL_IOStream to load image data from. That’s your data source, bestie. 🍓

RETURN VALUE ✨

You get an SDL surface back, or NULL on error. So if it’s NULL, something went sideways. 😭

AVAILABILITY 🔥

This function is available since SDL_image 3.0.0. Periodt. 👑

SEE ALSO 👑

• IMG_LoadAVIF_IO(3)
• IMG_LoadBMP_IO(3)
• IMG_LoadCUR_IO(3)
• IMG_LoadGIF_IO(3)
• IMG_LoadICO_IO(3)
• IMG_LoadJPG_IO(3)
• IMG_LoadJXL_IO(3)
• IMG_LoadLBM_IO(3)
• IMG_LoadPCX_IO(3)
• IMG_LoadPNG_IO(3)
• IMG_LoadPNM_IO(3)
• IMG_LoadQOI_IO(3)
• IMG_LoadSVG_IO(3)
• IMG_LoadTGA_IO(3)
• IMG_LoadTIF_IO(3)
• IMG_LoadWEBP_IO(3)
• IMG_LoadXCF_IO(3)
• IMG_LoadXPM_IO(3)

---

Catch you later, bestie — source/version check: SDL_image, version SDL_image 3.4.4. The footer didn’t give a date, so I’m not making one up. 💖🫶