目次 - SDL 3.0 API(機能別) - 再生と録音 - SDL_GetAudioDeviceGain

SDL_GetAudioDeviceGain

オーディオデバイスのゲインを得る

ヘッダ

SDL3/SDL_audio.h

構文

float SDL_GetAudioDeviceGain(SDL_AudioDeviceID devid);

引数

SDL_AudioDeviceIDdevid調査するオーディオデバイス

戻り値

(float) デバイスのゲインを戻す. 失敗のとき-1.0fを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

デバイスのゲインはボリュームのことで, 値が大きいほど出力が大きく, 0は無音である.

オーディオデバイスのゲインのデフォルトは1.0f(出力を変更しない)である.

物理デバイスのゲインは変更できず, 論理デバイスのみ可能である. この関数は物理デバイスに対して常に-1.0fを戻す.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_GetAudioDeviceGain - SDL Wiki