IMG_LoadGIFAnimation_IO(3)

✨ IMG_LoadGIFAnimation_IO ✨

okay bestie, welcome to the IMG_LoadGIFAnimation_IO(3) era of the SDL_image3 manual 💅 this one lives in the SDL_image3 FUNCTIONS section and it's literally the "i already know it's a GIF" speedrun 🎀

---

🌸 NAME 🌸

IMG_LoadGIFAnimation_IO — load a GIF animation directly, no detective work needed 🕵️‍♀️✨

---

🦋 SYNOPSIS 🦋

#include <SDL3_image/SDL_image.h>

IMG_Animation * IMG_LoadGIFAnimation_IO(SDL_IOStream *src);

that's the whole vibe: one include, one function, one SDL_IOStream *src 🫶

---

💖 DESCRIPTION 💖

so here's the tea ☕ — if you know you definitely have a GIF image, you can call this function, and it will skip SDL_image's file format detection routines. like, no sniffing around, no "hmm what format is this", it just goes straight in 😌✨

generally it's better to use the abstract interfaces, bestie — that's the main character move 👑 also, important detail: there is only an SDL_IOStream interface available here. no extra flavors, no secret menu, just the SDL_IOStream one 💅

---

🎀 FUNCTION PARAMETERS 🎀

• src — an SDL_IOStream that data will be read from 📥✨

---

🌈 RETURN VALUE 🌈

Returns a new IMG_Animation, or NULL on error 😭💔

like, check for NULL, bestie. fr fr. do not skip the vibe check 🙈

---

⭐ AVAILABILITY ⭐

this iconic function is available since SDL_image 3.0.0 👑

---

🍓 SEE ALSO 🍓

• IMG_isGIF(3)
• IMG_LoadAnimation(3)
• IMG_LoadAnimation_IO(3)
• IMG_LoadAnimationTyped_IO(3)
• IMG_LoadANIAnimation_IO(3)
• IMG_LoadAPNGAnimation_IO(3)
• IMG_LoadAVIFAnimation_IO(3)
• IMG_LoadWEBPAnimation_IO(3)
• IMG_FreeAnimation(3)

the whole friend group showed up 🫶💜

---

and that's the page, bestie 🧚‍♀️💖 this came from the SDL_image crew, version SDL_image 3.4.4, and it's serving IMG_LoadGIFAnimation_IO(3) realness — periodt 💅✨