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

Mix_FadeInMusicPos

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

構文

int Mix_FadeInMusicPos(Mix_Music *music, int loops, int ms, double position)

引数

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

戻り値

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

詳細

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

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

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

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

この関数は音声データを指定の位置から再生する. 開始位置を秒単位で指定すると, 先頭からではなくその位置からフェードインしながら再生が始まる.

位置を0.0として音楽を先頭から再生することもできる. (代わりに単にMix_FadeInMusic()を呼んでもよい.)

ミリ秒から変換するには1000.0で割ること.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_FadeInMusicPos