目次 - SDL_mixer 3.0 - MIX_GetTrackPlaybackPosition

MIX_GetTrackPlaybackPosition

再生中のトラックの現在の入力位置を得る

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

Sint64 MIX_GetTrackPlaybackPosition(MIX_Track *track);

引数

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

戻り値

(Sint64) トラックの現在のサンプルフレーム位置を戻す. エラーのとき-1を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

(MIX_GetTrack3DPosition()と混同しないこと. これはトラックの3D空間内の位置で, オーディオデータの再生位置ではない.)

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

停止または一時停止されたトラックの場合は停止中の位置を戻す. 再生中のトラックは再生中の位置を戻す. これは時間が経過すると変化する.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_GetTrackPlaybackPosition