目次 - SDL_mixer - API(機能別) - グループ - Mix_FadeOutGroup

Mix_FadeOutGroup

再生中の複数のチャネルをグループを指定して指定の時間フェードアウトさせて停止する

構文

int Mix_FadeOutGroup(int tag, int ms)

引数

tagチャネルグループのタグ
msフェードアウトのミリ秒単位の時間

戻り値

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

詳細

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

tagは複数のチャネルで構成されたチャネルグループを表す任意の数値である.

デフォルトタグは-1である.

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

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

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

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_FadeOutGroup