IMG_LoadCUR_IO(3)

πŸ’… NAME πŸ’…

IMG_LoadCUR_IO(3) β€” bestie, this is the SDL_image3 FUNCTIONS page for loading a CUR image directly. No format-detection scavenger hunt, just the direct route. ✨


✨ SYNOPSIS ✨

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadCUR_IO(SDL_IOStream *src);

πŸ¦‹ DESCRIPTION πŸ¦‹

Okay so picture this: you know you definitely have a CUR image. Like, no doubt in your group chat. Then you can call this function, and it will skip SDL_image's file format detection routines entirely. πŸ’…

Generally it's better to use the abstract interfaces β€” that's the vibe β€” and also, there is only an SDL_IOStream interface available here. So yeah, this one is the SDL_IOStream door, periodt.


πŸŽ€ FUNCTION PARAMETERS πŸŽ€

Here's the one input, and she's iconic:

  • src β€” an SDL_IOStream to load image data from.

πŸ’– RETURN VALUE πŸ’–

Returns SDL surface, or NULL on error. So if it's giving NULL, that's the error signal β€” not a vibe, but useful. 😭


🌈 AVAILABILITY 🌈

This function is available since SDL_image 3.0.0. πŸŽ€


πŸ‘‘ SEE ALSO πŸ‘‘

Go show these other direct-loading besties some love:


Over and out from SDL_image and SDL_image 3.4.4, bestie β€” that's the source/version from the footer. The footer didn't give me a date, so consider this your undated-but-iconic sign-off. πŸ’–πŸ«ΆπŸŒ™

πŸ“¦ where this page comes from