IMG_SaveAnimation(3)

💖 IMG_SaveAnimation(3) 💖

okay bestie, welcome to the SDL_image3 FUNCTIONS corner of the manual, where today's main character is IMG_SaveAnimation — the glow-up that takes your animation and writes it out to a file. no cap, it's giving "save my whole vibe to disk". ✨

---

🌸 NAME 🌸

IMG_SaveAnimation — save an animation to a file. literally just that. iconic behavior. 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3_image/SDL_image.h>

bool IMG_SaveAnimation(IMG_Animation *anim, const char *file);

like yes, that's the whole thing. two arguments, one bool, zero drama. 🦋

---

✨ DESCRIPTION ✨

So here's the tea: for formats that accept a quality, a default quality of 90 will be used. that's it, that's the paragraph. no quality knob on this function, she picks 90 for you and moves on. 😌

---

🧚 FUNCTION PARAMETERS 🧚

• anim — the animation to save. your lil baby. your pride and joy. hand her over. 🫶
• file — path on the filesystem containing an animated image. yes, a path on the filesystem, so give her somewhere real to land. 🏠

---

⭐ RETURN VALUE ⭐

Returns true on success or false on failure — and if it's a flop, bestie, please call SDL_GetError() for more information. don't just sit there guessing, the error message is right there waiting for you. 😭

---

🔥 AVAILABILITY 🔥

This function is available since SDL_image 3.4.0. so if you're on something older, that's a vibe check fail, sorry. 💀

---

💜 SEE ALSO 💜

the whole friend group, fr fr:

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

---

ok that's the page!! go save your animation and slay. 🌈👑

this has been your girl from SDL_image 3.4.8, signing off — manual page IMG_SaveAnimation(3), out. 💖✨🎀🦋