MIX_ResumeAllTracks(3)

📦
version 3.2.4 · 2 versions
, in fedora 44

💖 MIX_ResumeAllTracks(3) 💖

okay bestie, welcome to the SDL_mixer3 function era, this one lives in the SDL_mixer3 FUNCTIONS section and it's literally the un-pause button for your whole mixer 🫶

✨ NAME ✨

MIX_ResumeAllTracks — resume all currently-paused tracks. yes, ALL of them. no track left behind 💅

🌸 SYNOPSIS 🌸

#include <SDL3_mixer/SDL_mixer.h>

bool MIX_ResumeAllTracks(MIX_Mixer *mixer);

🦋 DESCRIPTION 🦋

okay so first things first, important lore: a paused track is not considered "stopped," which means its MIX_TrackStoppedCallback will not fire if it's paused. ngl that trips people up every time 😭

but here's the thing — while it's paused, that track isn't gonna change state by default, it won't generate audio, and it basically won't make progress in any way, shape, or form. it's just sitting there. main character on a break. until it gets resumed, that is ✨

and THAT'S where this function comes in. MIX_ResumeAllTracks makes all the tracks on the mixer you specify that are currently paused move to a playing state. every single one. at once. iconic behavior, no cap 👑

🎀 FUNCTION PARAMETERS 🎀

  • mixer — the mixer on which to resume all tracks. that's it, that's the whole vibe. hand it your mixer and it handles the rest 💖

⭐ RETURN VALUE ⭐

  • Returns true on success 🥳
  • Returns false on error 😭 — and when that happens, call SDL_GetError() for the deets, because it will tell you what went wrong fr fr

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. yes really. go wild. thread it from wherever you want, it's giving fully thread-safe 🌈

💜 AVAILABILITY 💜

This function has been available since SDL_mixer 3.0.0. so if you're on 3.0.0 or later, you're set, bestie ✨

👑 SEE ALSO 👑

iykyk — pause and resume are a matched set, go read the other two so you get the full picture 🍓

and that's the whole page!! written for SDL_mixer 3.2.4, darling, mwah 💅✨

📦 where this page comes from