MIX_SETTRACKSTOPPEDCALLBACK(3)

💖 MIX_SetTrackStoppedCallback(3) 💖

okay bestie, so this one lives in the SDL_mixer3 manual, in the FUNCTIONS section, and it's literally the "hey, that track just stopped!!" notification system. it's giving doorbell energy. 🔔

---

✨ NAME ✨

MIX_SetTrackStoppedCallback — set a callback that fires when a MIX_Track is stopped.

---

🌸 SYNOPSIS 🌸

#include <SDL3_mixer/SDL_mixer.h>

bool MIX_SetTrackStoppedCallback(MIX_Track *track, MIX_TrackStoppedCallback cb, void *userdata);

---

🦋 DESCRIPTION 🦋

so when a track finishes playing — either because it ran out of data to mix (and all the loops were completed too, no sneaky leftover loops), or because your app straight up stopped it — it fires the callback you set right here. iconic behavior honestly.

every track has its own unique callback, no sharing, no borrowing, each track gets its own lil personal one 🎀

passing a NULL callback here? totally legal bestie. it just disables this track's callback. ghosted. 💅

now listen — pausing a track will not fire the callback. and it also won't fire on a playing track that's being destroyed. so don't go waiting for a ping in either of those situations, it's not coming.

it is legal to adjust the track from inside there, including changing its input and restarting it. and if you do that because it ran out of data mid-mixing, the mixer will start mixing the new track state in its current run without any gap in the audio. seamless. no little silence hiccup. lowkey gorgeous. 😭✨

---

👑 FUNCTION PARAMETERS 👑

• track — the track we're assigning this callback to. the main character of this operation.
• cb — the function to call when the track stops. may be NULL.
• userdata — an opaque pointer handed off to the callback for its own personal use. it's the lil goodie bag, we don't look inside. 🙈

---

⭐ RETURN VALUE ⭐

returns true on success or false on failure — and if it fails, call SDL_GetError() for more info. fr fr, always go check the error.

---

🌈 AVAILABILITY 🌈

this function has been available since SDL-mixer 3.0.0. it's been doing its thing for a minute.

---

💜 SEE ALSO 💜

• MIX_TrackStoppedCallback(3type)

---

k that's the whole page bestie, go set some callbacks and slay 🫶✨

SDL_mixer — SDL_mixer 3.2.4 — signing off 💖 mwah, no cap, this manual page ate and left no crumbs 👑