目次 - SDL_mixer - API(機能別) - チャネル - Mix_ExpireChannel

Mix_ExpireChannel

指定のチャネルの停止までの時間を変更する

構文

int Mix_ExpireChannel(int channel, int ticks)

引数

channel停止までの時間を変更するチャネル
ticksチャネルの再生を停止するまでのミリ秒単位の時間. -1のとき取り消す

戻り値

停止までの時間を設定したチャネルの数を戻す.

詳細

チャネルはticksミリ秒後に停止する. ticksが-1ならば停止を取り消す.

これはMix_PlayChannelTimed()の第4引数に渡された値を上書きする.

channelを-1にすると全てのチャネルに停止時間を設定する.

停止したチャネルの設定されているエフェクトは全て解除され, Mix_ChannelFinished()で設定されたコールバックが呼ばれる.

この関数はticksで設定した時間ブロックされないので注意すること. チャンクの停止までの時間を設定して, ミキサーの後の管理のために時間を記録し, すぐに復帰する.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_ExpireChannel