目次 - SDL_mixer 3.0 - MIX_SetTrackGain

MIX_SetTrackGain

トラックのゲインを設定する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

bool MIX_SetTrackGain(MIX_Track *track, float gain);

引数

MIX_Track *track設定するトラック
floatgain新しいゲインの値

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

それぞれのトラックにはそれぞれのゲインがあり, トラックのボリュームを調整する. このトラックのサンプルは, このゲインの値で修正される. ゲインは0は無音で, 1.0fはミックスしたボリュームを変更しない. そして, 1.0fを超える場合はボリュームを増す. 負の数は不正な値である. ゲインの上限はないが, 音が非常に大きくなりうるので, 設定には注意すること.

トラックのゲインのデフォルトは1.0fである.

この値は後のミックスのためにいつでも変更できる.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_SetTrackGain