目次 - SDL_mixer 3.0 - MIX_GetTrackFrequencyRatio

MIX_GetTrackFrequencyRatio

トラックの周波数倍率を得る

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

float MIX_GetTrackFrequencyRatio(MIX_Track *track);

引数

MIX_Track *track周波数倍率を問い合わせるトラック

戻り値

(float) 現在の周波数倍率を戻す. 失敗のとき0.0fを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

周波数倍率はオーディオデータが消費されたとき調整のために使用される. この値を変更するとトラックのオーディオの速さとピッチが変化する. 値が1.0fよりも大きいとき, 音は速く高くなる. 1.0fより小さいとき, 音が遅く低くなる. 1.0fは通常の速さである.

ミキサーのマスター周波数倍率のデフォルトは1.0fである.

様々な理由のエラー(MIX_Init()が呼ばれていない, トラックがNULLなど)の場合, この関数は0.0fを戻す. これは有効な値ではないため, エラーであることがわかる.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_GetTrackFrequencyRatio