IMG_SaveANIAnimation_IO(3)

💖 IMG_SaveANIAnimation_IO(3) 💖

okay bestie, so this one lives in the SDL_image3 FUNCTIONS family, and it's literally the glow-up moment for your animations — we're saving an ANI animation straight into an SDL_IOStream. iykyk 🎀

---

✨ NAME ✨

IMG_SaveANIAnimation_IO — save an animation in ANI format to an SDL_IOStream. that's it, that's the vibe 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

bool IMG_SaveANIAnimation_IO(IMG_Animation *anim, SDL_IOStream *dst, bool closeio);

---

🦋 DESCRIPTION 🦋

so here's the tea, and it's important tea: if closeio is true, then dst is gonna get closed before returning — and not just when things go well. it happens whether this function succeeds or fails. no cap. so don't go touching dst after the call like it's still yours, because it is not. 🫶

---

💜 FUNCTION PARAMETERS 💜

• anim — the animation you wanna save. your lil masterpiece. your main character. ✨
• dst — an SDL_IOStream that data gets written to. lowkey this is the destination, the spot, the place where the bytes go. 💫
• closeio — true to close/free the SDL_IOStream before returning, false to leave it open. you're basically deciding if dst gets to go home after the party or stays out. 🙈

---

⭐ RETURN VALUE ⭐

returns true on success or false on failure 🎀 — and if it's giving failure energy, 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... bestie, respectfully, upgrade. 👑

---

🔥 SEE ALSO 🔥

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

like, the whole save-an-animation friend group. they all ate. 💖

---

okay that's the whole page, no crumbs left 💅 this was SDL_image 3.4.8, page dated SDL_image, and honestly? she slayed. go save some ANI animations bestie, you got this 🧚✨🍓