SDL_AudioSpec* SDL_LoadWAV(const char* file, SDL_AudioSpec* spec, Uint8** audio_buf, Uint32* audio_len)
| file | 読み込むファイルの名前 |
| spec | WAVEファイルの形式を代入するSDL_AudioSpec |
| audio_buf | 音声バッファ |
| audio_len | 音声バッファのバイト数 |
この関数は呼び出しに成功すると, 元のWAVEの音声データが設定されたSDL_AudioSpecを戻す. audio_bufには音声データが確保されたバッファへのポインタが, audio_lenには音声バッファのバイト長が代入される.
WAVEファイルを開けない, 不明な形式, または壊れている場合はNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.
アプリケーションが戻されたaudio_bufを使った後は, SDL_FreeWAV()を呼んで解放する必要がある.
SDL_AudioSpec wav_spec;
Uint32 wav_length;
Uint8 *wav_buffer;
/* WAVを読み込む */
if (SDL_LoadWAV("test.wav", &wav_spec, &wav_buffer, &wav_length) == NULL) {
fprintf(stderr, "test.wavを開けなかった: %s¥n", SDL_GetError());
} else {
/* ここでWAVを処理する. そして... */
SDL_FreeWAV(wav_buffer);
}
SDL_LoadWAV()はSDL_LoadWAV_RW()を呼び出すマクロである.
このマクロはSDL_LoadWAV_RW()をファイルI/O APIを使わずにファイル名を渡せるようにするために存在する.