目次 - SDL_mixer 3.0 - MIX_CreateMixer

MIX_CreateMixer

オーディオデータをメモリバッファに生成するミキサーを生成する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

MIX_Mixer * MIX_CreateMixer(const SDL_AudioSpec *spec);

引数

const SDL_AudioSpec *specデバイスのオーディオ形式. NULLも可

戻り値

(MIX_Mixer *) オーディオデータを生成するミキサーを戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

通常求められるのはこの関数ではなくMIX_CreateMixerDevice()だろう. ここで生成されたミキサーはMIX_Generate()で使用して追加のデータを要求があれば即座に生成できる.

オーディオ形式は必ず指定する必要がある. これが出力の形式になる. NULLにはできない.

ミキサーを生成した後は, 通常は(MIX_LoadAudio()などで)オーディオデータを読み込み, (MIX_CreateTrack()で)トラックを生成し, そのトラックのオーディオデータを再生する.

ミキサーを使用し終えたならば, MIX_DestroyMixer()で破棄できる.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_CreateMixer