IMG_SaveAVIFAnimation_IO(3)

💖 IMG_SaveAVIFAnimation_IO 💖

okay bestie, sit down, hydrate, and let me tell you about IMG_SaveAVIFAnimation_IO from the SDL_image3 functions. it's a manual page (section 3, library functions, iykyk) and it does exactly one iconic thing: it saves your animation as an AVIF, straight into an SDL_IOStream. no cap. 🎀

---

✨ NAME ✨

IMG_SaveAVIFAnimation_IO — bestie. this saves an animation in AVIF format to an SDL_IOStream. that's the whole job. she's focused, she's employed, she slays. 💅

---

✨ SYNOPSIS ✨

#include <SDL3_image/SDL_image.h>

bool IMG_SaveAVIFAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio, int quality);

look at her. four little arguments. so demure, so mindful. 🦋

---

✨ DESCRIPTION ✨

so here's the tea, and it's actually kind of important: if closeio is true, then dst will be closed before returning — and I mean whether this function succeeds or not. success? closed. failure? still closed. she does not play about closing. 🫶

---

✨ FUNCTION PARAMETERS ✨

• anim — the animation you wanna save. your little baby. your masterpiece. 🌸
• dst — an SDL_IOStream from which data will be written to. yes, the wording is a lil quirky but that's the manual talking, and we respect her. ✨
• closeio — true to close/free the SDL_IOStream before returning, false to leave it open. it's giving "am I your problem after this or not". 💀
• quality — the desired quality, ranging between 0 (lowest) and 100 (highest). pick your vibe: 100 for main character energy, 0 for... a choice. 👑

---

✨ RETURN VALUE ✨

returns true on success or false on failure. and if it fails, do NOT just sit there guessing — call SDL_GetError() for more information. she will tell you what went wrong, fr fr. 😭

---

✨ AVAILABILITY ✨

this function is available since SDL_image 3.4.0. so if you're on something older, no AVIF animation for you, bestie. sorry. 🙈

---

✨ SEE ALSO ✨

the whole friend group, all linked up:

• IMG_SaveAnimation(3)
• IMG_SaveAnimationTyped_IO(3)
• IMG_SaveANIAnimation_IO(3)
• IMG_SaveAPNGAnimation_IO(3)
• IMG_SaveGIFAnimation_IO(3)
• IMG_SaveWEBPAnimation_IO(3)

---

and that's the page!! mwah 💋 this lil beauty lives in the SDL_image manual, version 3.4.8 — so go forth, save your animations, close your IOStreams responsibly, and remember: quality 100 or nothing. periodt. 💖✨🎀🦋🌸💅🫶