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

SDL_LoadWAV

WAVファイルを読み込む

ヘッダ

SDL3/SDL_audio.h

構文

bool SDL_LoadWAV(const char *path, SDL_AudioSpec *spec, Uint8 **audio_buf, Uint32 *audio_len);

引数

const char *pathオープンするWAVファイルのパス名
SDL_AudioSpec *spec成功した場合のWAVEファイルの詳細な形式の代入先へのポインタ
Uint8 **audio_bufこの関数が確保した領域のオーディオデータへのポインタの代入先へのポインタ
Uint32 *audio_lenオーディオデータのバイト数の代入先へのポインタ

戻り値

(bool) 成功のとき真を戻す. audio_bufには確保されたオーディオデータが書き込まれたバッファへのポインタが代入され, audio_lenにはオーディオバッファのバイト長が代入される.

この関数は .WAVファイルをオープンできない, 不明な形式が使用されている, または壊れているとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

この関数が戻したaudio_bufを使い終えたとき, SDL_free()を呼んで破棄する必要がある.

詳細

この関数は便利のための関数であり, 効果は以下と同様である:

SDL_LoadWAV_IO(SDL_IOFromFile(path, "rb"), true, spec, audio_buf, audio_len);

スレッドセーフ

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

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_LoadWAV - SDL Wiki