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

Mix_FadeOutChannel

指定の時間フェードアウトしてチャネルを停止する

構文

int Mix_FadeOutChannel(int which, int ms)

引数

whichフェードアウトさせるチャネル
msフェードアウトのミリ秒単位の時間

戻り値

フェードアウトが設定されたチャネルの数を戻す.

詳細

チャネルは通常のボリュームからmsミリ秒の時間で徐々に無音になる. 時間が経過した後はチャネルは停止する.

停止したチャネルからは登録されたエフェクトは解除され, Mix_ChannelFinished()で登録したコールバックが呼ばれる.

フェード中のチャネルは, その最中にMix_Volume()が呼ばれても, ボリュームが徐々に変化する. (言い換えると, フェード中のチャネルにはMix_Volume()を呼んでも無意味である.)

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

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_FadeOutChannel