目次 - SDL_mixer 3.0 - MIX_GetTrackFadeFrames

MIX_GetTrackFadeFrames

トラックがフェード中かを得る

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

Sint64 MIX_GetTrackFadeFrames(MIX_Track *track);

引数

MIX_Track *track問い合わせるトラック

戻り値

(Sint64) 0未満のときトラックはフェードアウト中, 0を超える値のときフェードイン中, 0のときそれ以外.

詳細

この関数はトラックが停止中でないとき(一時停止中または再生中)チェックを行い, フェードインまたはフェードアウトならば, 残りのフレーム数を戻す.

フェードアウトならば, 負の数を戻す. フェードインならば, 正の数を戻す. フェード中でなければ, この関数は0を戻す.

様々な理由のエラー(MIX_Init()が呼ばれていない, トラックがNULLなど)の場合, この関数は0を戻すが, エラーとフェード中でないことを判別する方法はない.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL_image 3.0.0以降

SDL Wikiへのリンク

SDL3_mixer/MIX_GetTrackFadeFrames