目次 - SDL_mixer 3.0 - MIX_SetGroupPostMixCallback

MIX_SetGroupPostMixCallback

グループのミックスが完了したとき呼ばれるコールバックを設定する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

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

引数

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

戻り値

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

詳細

ミキシンググループ内の全てのトラックは, 入力からデータをプルし, 変換し, 1つのバッファにミックスされた後でコールバックが呼ばれる. これでアプリケーションはまだグループの一部であるデータを使用できる. このコールバックでデータを編集することもでき, ミキサーは編集されたデータがグループのミックスされたバッファから直接来たかのように処理を続ける.

グループにはそれぞれ別のコールバックを設定することができる. 特定のMIX_Groupに属さないトラックは, アプリケーションは使用できない内部のグループでミックスされる.

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

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_SetGroupPostMixCallback