NAME¶

MIX_SetPostMixCallback - Set a callback that fires when all mixing has completed.

SYNOPSIS¶

#include <SDL3_mixer/SDL_mixer.h>

bool MIX_SetPostMixCallback(MIX_Mixer *mixer, MIX_PostMixCallback cb, void *userdata);

DESCRIPTION¶

After all mixer groups have processed, their buffers are mixed together into a single buffer for the final output, at which point a callback can be fired. This lets an app view the data at the last moment before mixing completes. It can also change the data in any way it pleases during this callback, and the mixer will continue as if this data is the final output.

Each mixer has its own unique callback.

Passing a NULL callback here is legal; it disables this mixer's callback.

FUNCTION PARAMETERS¶

mixer

the mixer to assign this callback to.

cb

the function to call when the mixer mixes. May be NULL.

userdata

an opaque pointer provided to the callback for its own personal use.

RETURN VALUE¶

Returns true on success or false on failure; call SDL_GetError() for more information.

AVAILABILITY¶

This function is available since SDL_mixer 3.0.0.

SEE ALSO¶

MIX_PostMixCallback(3type)