目次 - SDL_mixer 3.0 - MIX_CreateSineWaveAudio

MIX_CreateSineWaveAudio

サイン波を生成するMIX_Audioを生成する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

MIX_Audio * MIX_CreateSineWaveAudio(MIX_Mixer *mixer, int hz, float amplitude, Sint64 ms);

引数

MIX_Mixer *mixerオーディオデータを使用するミキサー. NULLも可
inthzサイン波のHz単位の周波数
floatamplitudeサイン波の0.0fから1.0fの振幅
Sint64ms生成するミリ秒単位の最大時間, または0未満のとき無限に生成する

戻り値

(MIX_Audio *) ミキサーで音声を生成できるオーディオオブジェクトを戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

これはテストやデバッグで単に何かを再生したい場合に便利である.

Hz単位の周波数(音声の高さ)と振幅(サイン波のボリューム. 1.0fが大きく, 0.0fが無音)を指定できる.

生成する音声の時間はミリ秒単位で指定できる. 0未満の値を指定すると無限の音声を生成する(MIX_Trackに割り付けるとサイン波が無限に再生される).

MIX_Audioオブジェクトは複数のミキサーで共有できる. mixer引数はこのオーディオを最も使うミキサーを示唆するもので, 最適化が適用される場合があるが, 必須ではなくミキサーとしてNULLを指定することもできる.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_CreateSineWaveAudio