#pragma section-numbers off
#pragma disable-camelcase

= SDL_MixAudio =
This function is a legacy means of mixing audio. New programs might want to use [[SDL_MixAudioFormat]]() instead.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
void SDL_MixAudio(Uint8*       dst,
                  const Uint8* src,
                  Uint32       len,
                  int          volume)
}}}

== Function Parameters ==
||'''dst'''||the destination for the mixed audio||
||'''src'''||the source audio buffer to be mixed||
||'''len'''||the length of the audio buffer in bytes||
||'''volume'''||ranges from 0 - 128, and should be set to SDL_MIX_MAXVOLUME for full audio volume||

== Code Examples ==
{{{#!highlight cpp
void MyAudioCallback(void *udata, Uint8 *stream, int len)
{
    extern const Uint8 *mixData;
    SDL_memset(stream, 0, len);  // make sure this is silence.
    // mix our audio against the silence, at 50% volume.
    SDL_MixAudio(stream, mixData, len, SDL_MIX_MAXVOLUME / 2);
}
}}}

== Remarks ==

This function is equivalent to calling

{{{#!highlight cpp
SDL_MixAudioFormat(dst, src, format, len, volume);
}}}

where '''format''' is the obtained format of the audio device from the legacy [[SDL_OpenAudio]]() function.

== Related Functions ==
 .[[SDL_MixAudioFormat]]

----
[[CategoryAPI]], [[CategoryAudio]]