gitea/SDL3_fork
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add code snipped to migrate from AudioCVT interface

Browse Source
This commit is contained in:
Sylvain
2023-01-22 21:51:40 +01:00
committed by Sylvain Becker
parent cb01b35c4e
commit b1f365374b
1 changed files with 24 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
docs/README-migration.md
View File

@@ -56,6 +56,30 @@ SDL_FreeWAV has been removed and calls can be replaced with SDL_free.
SDL_AudioCVT interface is removed, SDL_AudioStream can be used instead. SDL_AudioCVT interface is removed, SDL_AudioStream can be used instead.
Code that used to look like this:
```c
SDL_AudioCVT cvt;
SDL_BuildAudioCVT(&cvt, spec.format, spec.channels, spec.freq, spec.format, cvtchans, cvtfreq);
cvt.len = len;
cvt.buf = (Uint8 *) SDL_malloc(len * cvt.len_mult);
SDL_memcpy(cvt.buf, data, len);
SDL_ConvertAudio(&cvt);
do_something(cvt.buf, cvt.len_cvt);
```
should be changed to:
```c
SDL_AudioStream *stream = SDL_CreateAudioStream(spec.format, spec.channels, spec.freq, spec.format, cvtchans, cvtfreq);
int src_samplesize = (SDL_AUDIO_BITSIZE(spec.format) / 8) * spec.channels;
int src_len = len & ~(src_samplesize - 1); // need to be rounded to samplesize
SDL_PutAudioStreamData(stream, data, src_len);
SDL_FlushAudioStream(stream);
int dst_len = expected_dst_len & ~(dst_samplesize - 1); // need to be rounded to samplesize
Uint8 *dst_buf = (Uint8 *)SDL_malloc(dst_len);
int real_dst_len = SDL_GetAudioStreamData(stream, dst_buf, dst_len);
do_something(dst_buf, real_dst_len);
```
The following functions have been renamed: The following functions have been renamed:
* SDL_AudioStreamAvailable() => SDL_GetAudioStreamAvailable() * SDL_AudioStreamAvailable() => SDL_GetAudioStreamAvailable()
* SDL_AudioStreamClear() => SDL_ClearAudioStream() * SDL_AudioStreamClear() => SDL_ClearAudioStream()