目次 - SDL_mixer - API(機能別) - 音楽 - Mix_FadeOutMusic

Mix_FadeOutMusic

指定の時間フェードアウトさせた後に音楽ストリームを停止させる

構文

int Mix_FadeOutMusic(int ms)

引数

msフェードアウトのミリ秒単位の時間

戻り値

フェードアウトが始められたとき0以外, そうでないとき0を戻す. 音楽が再生中でない場合, この関数は0を戻す.

詳細

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

停止した後はMix_HookMusicFinished()で登録したコールバックが呼ばれる.

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

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

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_FadeOutMusic