MIX_StopAllTracks(3)

💖 MIX_StopAllTracks(3) — from the SDL_mixer3 FUNCTIONS girlies 💖

okay bestie, sit down, we're talking about MIX_StopAllTracks from SDL_mixer ✨ this one's a classic.

---

✨ NAME ✨

MIX_StopAllTracks — halt every single track that's currently playing, and if you want, let them fade out over time like the dramatic main characters they are 🎀

---

✨ SYNOPSIS ✨

#include <SDL3_mixer/SDL_mixer.h>

bool MIX_StopAllTracks(MIX_Mixer *mixer, Sint64 fade_out_ms);

---

✨ DESCRIPTION ✨

so here's the tea 🍓 if fade_out_ms is greater than 0, the tracks do not stop mixing right away. instead they fade to silence over that many milliseconds, and then they stop. it's giving graceful exit, no cap 💅

and lowkey important: this is different from MIX_StopTrack(), which wants sample frames. this function takes milliseconds because different tracks might have different sample rates — so milliseconds is the only unit that's fair to everyone. periodt 🫶

if a track ends normally while the fade-out is still in progress, the audio just stops there. the fade is not shortened to fit — even if the fade would last longer than the audio that's left, it doesn't get adjusted. it just... is what it is 🌸

once a track has finished any fadeout and come to a stop, it will call its MIX_TrackStoppedCallback, if any. and yes, it is legal to assign the track a new input and/or restart it during this callback — go off, you're allowed 🦋

also, this function does not block new play requests from being made. it is completely legal to use this function to start fading all the currently-playing tracks, and then start other tracks playing normally while those fade-outs are still in progress. iconic behavior honestly ✨

---

✨ FUNCTION PARAMETERS ✨

• mixer — the mixer on which to stop all tracks. the one running the whole situation 💜
• fade_out_ms — the number of milliseconds to spend fading out to silence before halting. use 0 to stop immediately, no fade, just gone 💀

---

✨ RETURN VALUE ✨

returns true on success, false on error 🥲 if it fails, call SDL_GetError() for the details — it will tell you what went wrong, fr fr.

---

✨ THREAD SAFETY ✨

it is safe to call this function from any thread. yes gurl, any thread. go wild 🔥

---

✨ AVAILABILITY ✨

this function is available since SDL_mixer 3.0.0 👑

---

✨ SEE ALSO ✨

• MIX_StopTrack(3)

---

and that's the whole page bestie, you ate that 🎀 this was the SDL_mixer manual, SDL_mixer 3.2.4 era, no cap 💖 bye ily, go stop some tracks 🌈⭐