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

Mix_FadeInMusic

新しい音楽オブジェクトをフェードインしながら再生する

構文

int Mix_FadeInMusic(Mix_Music *music, int loops, int ms)

引数

music新しく再生する音楽オブジェクト
loopsチャンクを再生する回数. -1のとき無限にループする
msフェードインのミリ秒単位の時間

戻り値

成功のとき0, エラーのとき-1を戻す.

詳細

この関数はMix_PlayMusic()と同じように新しい音楽を再生するが, 無音から通常のボリュームまで指定のミリ秒時間でフェードインしながら再生する.

既に音楽が再生中の場合は, その音楽は中断され新しい音楽と置き換えられる.

loopsが0より大きい場合, その回数だけ再生する. loopsが-1の場合, 「無限」(65000回)に再生する.

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

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_FadeInMusic