IMG_LoadGIF_IO(3)

okay bestie, welcome to IMG_LoadGIF_IO(3), straight outta the SDL_image3 FUNCTIONS part of the manual ✨

🎀 NAME 🎀

IMG_LoadGIF_IO — load a GIF image directly, no detours, no drama 💅

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

SDL_Surface * IMG_LoadGIF_IO(SDL_IOStream *src);

💖 DESCRIPTION 💖

So if you already know you definitely have a GIF image, you can call this function, and it will skip SDL_image's file format detection routines. It's like walking into the club and already knowing your name's on the list, iykyk ✨

Generally it's better to use the abstract interfaces, bestie — that's the recommended vibe. Also, heads up: there is only an SDL_IOStream interface available here. That's the one 🎀

🦋 FUNCTION PARAMETERS 🦋

• src — an SDL_IOStream to load image data from. That's where the GIF bytes come from 💜

⭐ RETURN VALUE ⭐

Returns SDL surface, or NULL on error. So if it hands you NULL, that's the error signal, no cap 😭

👑 AVAILABILITY 👑

This function is available since SDL_image 3.0.0. Periodt 👑

🌈 SEE ALSO 🌈

Your other format-specific besties are right here:

• IMG_LoadAVIF_IO(3)
• IMG_LoadBMP_IO(3)
• IMG_LoadCUR_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)
• IMG_LoadXV_IO(3)

---

okay that's the whole page, bestie 🫶 footer tea: source/version is SDL_image 3.4.4, and the page is IMG_LoadGIF_IO(3). No date was printed in the original footer, so I'm not inventing one 💜