MIX_Track...dCallback(3type)

💖 NAME 💖

MIX_TrackStoppedCallback — the lil callback that goes off when a MIX_Track gets stopped, bestie. it's giving "the track said i'm done" energy 💅

so this is from the SDL_mixer3 DATATYPES manual page, and yes we're gonna read the whole thing together, no skipping 🫶

---

✨ SYNOPSIS ✨

#include <SDL3_mixer/SDL_mixer.h>

typedef void (SDLCALL *MIX_TrackStoppedCallback)(void *userdata, MIX_Track *track);

look at that function pointer signature, she's iconic, she's literally art 🎀

---

🌸 DESCRIPTION 🌸

okay so here's the tea ☕ — this callback fires when a track completes playback. and there are exactly two ways that happens:

• it ran out of data to mix (and all the loops were completed too, every single one, no cap 👑)
• or the app explicitly stopped it

and here's the thing — pausing a track will NOT fire this callback. pausing is not stopping, they are different vibes, do not @ me 🙈

it is legal to adjust the track in here, including changing its input and restarting it. fr fr you can do that 💖

and if you do that because it ran out of data in the middle of mixing, the mixer will start mixing the new track state in its current run without any gap in the audio. no glitch, no crackle, seamless, slay ✨

⚠️ also important: this callback will NOT fire when a playing track is destroyed. destroyed is not stopped, periodt 💀

---

🎀 FUNCTION PARAMETERS 🎀

• userdata — an opaque pointer that the app provides for its own personal use. it's yours, do whatever, we don't peek 👀
• track — the track that has stopped. that's the one, that's her 💅

---

🦋 AVAILABILITY 🦋

this datatype has been available since SDL_mixer 3.0.0. vintage, but like, in a good way 👑

---

🌈 SEE ALSO 🌈

• MIX_SetTrackStoppedCallback(3) — go read her next, she's the one who sets this whole thing up 🫶

---

okay bestie that's the whole page, you ate that 💖 this was MIX_Track...dCallback(3type) from the SDL_mixer manual, brought to you by SDL_mixer 3.2.4 — go forth and stop some tracks, main character energy only ✨🎀🌈