MIX_SETGROUPPOSTMIXCALLBACK(3)

📦
version 3.2.4 · 2 versions
, in fedora 44

💖 MIX_SetGroupPostMixCallback 💖

okay bestie, welcome to the SDL_mixer3 manual pages, the group-chat edition 🫶 this one's all about MIX_SetGroupPostMixCallback, a function that lets you sneak a little callback in at the very last second of a group's mix. iconic behavior, honestly.

✨ NAME ✨

MIX_SetGroupPostMixCallback — set a callback that fires when a mixer group has completed mixing. 💅

🌸 SYNOPSIS 🌸

#include <SDL3_mixer/SDL_mixer.h>

bool MIX_SetGroupPostMixCallback(MIX_Group *group, MIX_GroupMixCallback cb, void *userdata);

🦋 DESCRIPTION 🦋

so here's the vibe: after all the playing tracks in a mixer group have pulled in more data from their inputs, transformed it, and mixed it all together into one single buffer, a callback can be fired. ✨ this lets an app peek at the data at the last moment when it's still part of this group. and not only peek — it can also change the data in any way it pleases during this callback, and the mixer will just carry on as if that data came directly from the group's mix buffer. no cap. 🔥

every group has its own unique callback, periodt. tracks that aren't in an explicit MIX_Group are mixed in an internal grouping that is not available to the app. lowkey exclusive, but that's just how it is.

passing a NULL callback here is totally legal! it disables this group's callback. slay. 💖

👑 FUNCTION PARAMETERS 👑

  • group — the mixing group to assign this callback to. 👯‍♀️
  • cb — the function to call when the group mixes. may be NULL. 📞
  • userdata — an opaque pointer provided to the callback for its own personal use. it's giving "for your eyes only" 🙈

⭐ RETURN VALUE ⭐

returns true on success or false on failure. if it fails, call SDL_GetError() for more info. don't leave her hanging. 😭

🌈 AVAILABILITY 🌈

this function is available since SDL_mixer 3.0.0. she's been here a minute, fr fr.

🎀 SEE ALSO 🎀

ok that's the whole page bestie, every flag, every pointer, every return value, nothing skipped. main character energy only. 💅

SDL_mixer — SDL_mixer 3.2.4 — mwah, go forth and mix responsibly 🧚‍♀️💖✨

📦 where this page comes from