MIX_CreateGroup(3)

📦
version 3.2.4 · 2 versions
, in fedora 44

✨ MIX_CreateGroup — the group chat creator ✨

okay bestie, so we're in SDL_mixer 3.2.4's function reference and this one is MIX_CreateGroup(3). it's giving main character energy for your audio pipeline, fr fr. let's get into it 💖

🌸 NAME 🌸

MIX_CreateGroup — make a brand new mixing group. that's it, that's the whole job 💅

🌈 SYNOPSIS 🌈

#include <SDL3_mixer/SDL_mixer.h>

MIX_Group * MIX_CreateGroup(MIX_Mixer *mixer);

💖 DESCRIPTION 💖

so here's the tea 🍓: every track gets assigned to a mixing group. and if you never assign it anywhere? it just lowkey lives in the mixer's own internal default group. no drama, no cap.

the way that this works is: all the tracks inside one group get mixed together, and then your app can peek at that mixed data before it gets blended with all the other groups to make the final output. it's giving layers on layers on layers. iconic ✨

ngl this is a genuinely useful feature, but it's also completely optional — like, you can ignore mixing groups entirely and still have the full SDL_mixer experience. no FOMO required 🫶

so after you create a group, you gotta assign tracks to it using MIX_SetTrackGroup(). then when you wanna actually see the group's mixed data, hit up MIX_SetGroupPostMixCallback(). that's the whole vibe check right there 🔥

when you're done with a group, you can destroy it with MIX_DestroyGroup(). and heads up: if you destroy the mixer itself, it takes all its still-existing mixing groups down with it. everything must go, periodt 💀

🎀 FUNCTION PARAMETERS 🎀

  • mixer — the mixer where you want this new mixing group to be born. that's your canvas bestie 🦋

⭐ RETURN VALUE ⭐

returns a freshly-created mixing group 🎉 …or NULL if something went wrong 😭. in that case, call SDL_GetError() to find out what happened. she's not gonna tell you on her own, you gotta ask.

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. yes bestie, ANY thread. go wild, go feral, she's built for it 👑

🌸 AVAILABILITY 🌸

this function has been available since SDL_mixer 3.0.0 — an OG, a legend, we stan 🌈

👑 SEE ALSO 👑

these three are the rest of the girl group, go read them too 💜

okay that's the whole page!! thanks for coming to my TED talk 🎤✨ this little guide ships with SDL_mixer 3.2.4 — mwah, love u, go mix something cute 💖🎀🦋

📦 where this page comes from