目次 - SDL_mixer 3.0 - MIX_SetTrackStoppedCallback

MIX_SetTrackStoppedCallback

トラックが停止したとき呼ばれるコールバックを設定する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

bool MIX_SetTrackStoppedCallback(MIX_Track *track, MIX_TrackStoppedCallback cb, void *userdata);

引数

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

戻り値

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

詳細

ミックスするデータが尽きた(そしてループも完了した), またはアプリケーションが明示的に停止させたことでトラックの再生が完了した場合, このコールバックが呼ばれる.

トラックにはそれぞれ別の変換後コールバックを設定することができる.

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

トラックの一時停止や再生中のトラックの破棄ではコールバックは呼ばれない.

トラックに入力の変更や再開を含む操作を行ってもよい. これがミキシングの途中でデータが尽きたため行われた場合, ミキサーは新しいトラックの状態のミキシングを音声を途切れさせることなく開始する.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_SetTrackStoppedCallback