Wiki Page Content

Differences between revisions 4 and 5
Revision 4 as of 2009-11-19 06:02:06
Size: 1792
Editor: Sam Lantinga
Comment: Converted comment to C comment form
Revision 5 as of 2009-11-19 06:04:28
Size: 1700
Editor: SheenaSmith
Comment: edit content
Deletions are marked like this. Additions are marked like this.
Line 32: Line 32:
/* To load a WAVE file you could use SDL_LoadWAV() or do this: */
SDL_LoadWAV_RW(SDL_RWFromFile("sample.wav", "rb"), 1, ...);
You can add your code example here


Use this function to load a WAVE from the data source, automatically freeing that source if freesrc is non-zero.


SDL_AudioSpec* SDL_LoadWAV_RW(SDL_RWops*     src,
                              int            freesrc,
                              SDL_AudioSpec* spec,
                              Uint8**        audio_buf,
                              Uint32*        audio_len)

Function Parameters


the data source for the wave file; see SDL_RWFromMem() for more info


non-zero to automatically free the data source


specifies the target audio format; see SDL_AudioSpec for more info


specifies the audio buffer


specifies the length of the audio buffer in bytes

Return Value

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.

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. Call SDL_GetError() for more information.

Code Examples

You can add your code example here


Currently raw and MS-ADPCM WAVE files are supported.

You need to free the audio buffer with SDL_FreeWAV() when you are done with it.

None: SDL_LoadWAV_RW (last edited 2018-10-30 02:25:29 by RyanGordon)

Please include your contact information if you'd like to receive a reply.