目次 - SDL_mixer 3.0 - MIX_SetPostMixCallback

MIX_SetPostMixCallback

全てのミキシングが完了したとき呼ばれるコールバックを設定する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

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

引数

MIX_Group *groupコールバックを割り付けるミキシンググループ
MIX_PostMixCallbackcbミキサーがミックスしたとき呼ばれる関数. NULLも可
void *userdata私的な利用のためにコールバックに渡される不透明ポインタ

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

ミキサーグループの処理の後, これらのバッファは1つのバッファにミックスされ最終的な出力となるが, この時点でコールバックが呼ばれる. これでアプリケーションはミキシングの完了の前の最後のデータを見ることができる. このコールバックでデータを編集することもでき, ミキサーはこのデータが最終的な出力であるかのように処理を続ける.

ミキサーにはそれぞれ別のコールバックを設定することができる.

コールバックにNULLを渡してもよい. これはグループのコールバックを無効にする.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_SetPostMixCallback