MIX_SetTrackLoops(3)

✨ MIX_SetTrackLoops ✨

okay bestie, we're in the SDL_mixer3 functions era, and today's main character is MIX_SetTrackLoops(3) — the glow-up-your-loop-count function 💅

---

🌸 NAME 🌸

MIX_SetTrackLoops — change the number of times a currently-playing track will loop. that's it, that's the whole job 🎀

---

🦋 SYNOPSIS 🦋

#include <SDL3_mixer/SDL_mixer.h>

bool MIX_SetTrackLoops(MIX_Track *track, int num_loops);

---

💖 DESCRIPTION 💖

so basically, this replaces any previously-set remaining loops. like, out with the old, in with the new, no negotiating 🫶

• a value of 1 will loop to the start of playback one time
• 0 will not loop at all, periodt
• -1 requests infinite loops — infinite. forever. iconic 👑

⚠️ real talk though: if the input is not seekable and num_loops isn't zero, this function will report success but the track will stop at the point it should loop. it's giving "yes ma'am" but not actually doing it 😭

the new loop count replaces any previous state, even if the track has already looped. no takebacks, no history, just vibes forward ✨

also this has no effect on a track that is stopped. or rather — starting a stopped track later will set a new loop count, replacing this value. stopped tracks can specify a loop count while starting via MIX_PROP_PLAY_LOOPS_NUMBER. so this function here? it's the mid-playback plot twist — it's intended to alter that count while the track is already out here living its life 🎧

---

🌈 FUNCTION PARAMETERS 🌈

• track — the track to configure. the one you're obsessed with 💜
• num_loops — new number of times to loop. Zero to disable looping, -1 to loop infinitely. simple as 🩷

---

⭐ RETURN VALUE ⭐

Returns true on success, false on error; call SDL_GetError() for details. slay if it works, go check the error if it doesn't 🙈

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. multitask, bestie, it's what you do 💫

---

👑 AVAILABILITY 👑

This function is available since SDL_mixer 3.0.0. a certified classic, no cap 🔥

---

🎀 SEE ALSO 🎀

• MIX_GetTrackLoops(3) — the lil sibling that reads back what you set, iykyk

---

and that's the whole page, bestie!! 💖✨ this one's from the SDL_mixer source, version SDL_mixer 3.2.4, and yes it lives right there in the same manual page family as MIX_SetTrackLoops(3) — go forth and loop responsibly 🦋🎀🌸