IMG_LoadAVIFAnimation_IO(3)

💖 IMG_LoadAVIFAnimation_IO 💖

okay bestie, so this one lives in the SDL_image3 FUNCTIONS squad, and it's literally the "I already KNOW what this file is" button. Let's get into it 🦋

---

✨ NAME ✨

IMG_LoadAVIFAnimation_IO — load an AVIF animation directly from an SDL_IOStream. no detours, no guessing, just vibes ✨

---

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

IMG_Animation* IMG_LoadAVIFAnimation_IO(SDL_IOStream *src);

---

🎀 DESCRIPTION 🎀

so like. if you know — like, you are 100% certain, no cap — that you definitely have an AVIF animation, you can call this function and it will skip SDL_image's file format detection routines entirely. it's giving "I don't need the vibe check, I already know who you are" 💅

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

and when you're done with the returned animation? the app should dispose of it with a call to IMG_FreeAnimation(). don't be a litterbug, bestie, free your animation 😭✨

---

🧚 FUNCTION PARAMETERS 🧚

• src — an SDL_IOStream that data will be read from. that's the source of the whole situation 💜

---

⭐ RETURN VALUE ⭐

returns a new IMG_Animation, or NULL on error. so if you get NULL... yeah. something went wrong. 💀

---

👑 AVAILABILITY 👑

this function is available since SDL_image 3.4.0. periodt 💅

---

🌈 SEE ALSO 🌈

• IMG_isAVIF(3)
• IMG_LoadAnimation(3)
• IMG_LoadAnimation_IO(3)
• IMG_LoadAnimationTyped_IO(3)
• IMG_LoadANIAnimation_IO(3)
• IMG_LoadAPNGAnimation_IO(3)
• IMG_LoadGIFAnimation_IO(3)
• IMG_LoadWEBPAnimation_IO(3)
• IMG_FreeAnimation(3)

---

and that's the whole page, bestie 🥰 this one came to you courtesy of SDL_image, version SDL_image 3.4.8 — go forth and load your AVIF animations, you absolute icon, iykyk 💖✨🎀🦋