SYNOPSIS

       #include "SDL.h"

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

DESCRIPTION

       SDL_LoadWAV This function loads a WAVE file into memory.

       If this function succeeds, it returns the given  SDL_AudioSpec,  filled
       with  the  audio  data format of the wave data, and sets audio_buf to a
       malloc'd buffer containing the audio data, and sets  audio_len  to  the
       length  of  that  audio  buffer,  in  bytes. You need to free the audio
       buffer with SDL_FreeWAV when you are done with it.

       This function returns NULL and sets the SDL error message if  the  wave
       file cannot be opened, uses an unknown data format, or is corrupt. Cur-
       rently raw, MS-ADPCM and IMA-ADPCM WAVE files are supported.

EXAMPLE

       SDL_AudioSpec wav_spec;
       Uint32 wav_length;
       Uint8 *wav_buffer;

       /* Load the WAV */
       if( SDL_LoadWAV("test.wav", &wav_spec, &wav_buffer, &wav_length) == NULL ){
         fprintf(stderr, "Could not open test.wav: %s
       ", SDL_GetError());
         exit(-1);
       }
       .
       .
       .
       /* Do stuff with the WAV */
       .
       .
       /* Free It */
       SDL_FreeWAV(wav_buffer);

SEE ALSO

       SDL_AudioSpec, SDL_OpenAudio, SDL_FreeWAV



SDL                         Tue 11 Sep 2001, 22:58              SDL_LoadWAV(3)