IMG_LoadANIAnimation_IO(3)

💖 IMG_LoadANIAnimation_IO(3) 💖

okay bestie, welcome to the SDL_image3 FUNCTIONS corner of the manual, where we are talking about IMG_LoadANIAnimation_IO and yes it is exactly as niche and iconic as it sounds 💅

---

✨ NAME ✨

IMG_LoadANIAnimation_IO — load an ANI animation directly from an SDL_IOStream, no detours, no small talk 🎀

---

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

IMG_Animation* IMG_LoadANIAnimation_IO(SDL_IOStream *src);

---

🦋 DESCRIPTION 🦋

so here's the tea: if you already know you've definitely got an ANI image on your hands, you can just call this function and it will skip SDL_image's whole file format detection routine. no vibe check, no sniffing around, straight to the animation. main character energy fr fr ✨

but ngl, generally it's better to use the abstract interfaces instead. also worth knowing: there is only an SDL_IOStream interface available here. that's the whole menu, bestie 🍓

when you're done with the returned animation, the app should dispose of it with a call to IMG_FreeAnimation(). like, actually do it. don't just leave it lying around, that's not the vibe 🙈

---

🎀 FUNCTION PARAMETERS 🎀

• src — an SDL_IOStream from which data will be read. that's the source, the origin, the place the bytes come from 💖

---

⭐ RETURN VALUE ⭐

Returns a new IMG_Animation, or NULL on error. so if you get NULL, something went wrong and it's giving sad, not slay 😭

---

🌈 AVAILABILITY 🌈

This function is available since SDL_image 3.4.0. so if you're on something older, sorry babe, it's not there 🫶

---

👑 SEE ALSO 👑

• IMG_isANI(3)
• IMG_LoadAnimation(3)
• IMG_LoadAnimation_IO(3)
• IMG_LoadAnimationTyped_IO(3)
• IMG_LoadAPNGAnimation_IO(3)
• IMG_LoadAVIFAnimation_IO(3)
• IMG_LoadGIFAnimation_IO(3)
• IMG_LoadWEBPAnimation_IO(3)
• IMG_FreeAnimation(3)

---

and that's the whole page, bestie, you ate it 💅✨ this was brought to you by SDL_image, version SDL_image 3.4.8, and the letter A for ANI. go free your animations, mwah 🎀🦋💖