IMG_SaveAPNGAnimation_IO(3)

💖 IMG_SaveAPNGAnimation_IO 💖

okay bestie, welcome to the SDL_image3 FUNCTIONS section of the manual, and today's main character is IMG_SaveAPNGAnimation_IO — the one that takes your lil animation and yeets it out as an APNG, straight into an SDL_IOStream. no cap. 🦋

---

✨ NAME ✨

IMG_SaveAPNGAnimation_IO — save an animation in APNG format to an SDL_IOStream.

🌸 SYNOPSIS 🌸

#include <SDL3_image/SDL_image.h>

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

🎀 DESCRIPTION 🎀

so here's the tea, bestie: if closeio is true, then dst gets closed before returning — and that happens whether this function succeeds or not. like, it's closing that stream no matter what. iconic commitment to closure, honestly. 💅

🫶 FUNCTION PARAMETERS 🫶

• anim — the animation you wanna save. your lil masterpiece. your baby. 💖
• dst — an SDL_IOStream that data will be written to. (yes the docs say "from which data will be written to" — we don't question the ancestors, we just pass the stream, okay? 🥴)
• closeio — true to close/free the SDL_IOStream before returning, false to leave it open. pick your fighter. ✨

⭐ RETURN VALUE ⭐

Returns true on success or false on failure. and if it fails? call SDL_GetError() for more info, bestie, it'll tell you what went wrong. no guessing games. 😭

🌈 AVAILABILITY 🌈

This function is available since SDL_image 3.4.0. so if you're on something older, sorry babes, it's giving nonexistent. 💀

👑 SEE ALSO 👑

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

---

and that's the whole page, bestie!! 🧚 this lil slice of wisdom comes to you from SDL_image, version 3.4.8, living its best life in the SDL_image manual. go forth and save those animations. slay. 💜🌸✨