目次 - SDL_mixer 3.0 - MIX_GetTrackRemaining

MIX_GetTrackRemaining

トラックのミックスされる残りサンプルフレーム数を得る

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

Sint64 MIX_GetTrackRemaining(MIX_Track *track);

引数

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

戻り値

(Sint64) トラックのミックスされる残りのサンプルフレームを戻す. 不明のとき-1を戻す.

詳細

トラックが再生中または一時停止中でトラックの長さがわかっている場合, この関数はミックスがどれだけ残っているかを戻す. トラックが再生中の場合, 後でこの関数を呼ぶと値が変化している.

残りオーディオデータはデコードされたオーディオデータのサンプルフレーム単位で, 時間ではないため完全なミキシングの位置を得ることができる. 時間単位が必要な場合は, MIX_TrackFramesToMS()で変換してミリ秒を得ることができる.

この関数はフェードイン・アウトやループを考慮せず, トラックの現在のミキシング位置とトラックの長さのみを考慮する.

トラックの長さが不明またはtrackがNULLの場合, この関数は-1を戻す. 停止中の場合は0を戻す,

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_GetTrackRemaining