int SDL_ConvertAudio(SDL_AudioCVT* cvt)

Zwraca 0, jeśli konwersja zakończyła się sukcesem lub ujemny kod błędu przy niepowodzeniu
; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

// Zmień 1024 ramek sampli stereo przy 48000 Hz z float32 na int16.
SDL_AudioCVT cvt;
SDL_BuildAudioCVT(&cvt, AUDIO_F32, 2, 48000, AUDIO_S16, 2, 48000);
SDL_assert(cvt.needed);  // to zawsze jest potrzebne.
cvt.len = 1024 * 2 * 4;  // 1024 ramek stereo float32.
cvt.buf = (Uint8 *) SDL_malloc(cvt.len * cvt.len_mult);
// wczytaj swoje dane float32 tutaj do cvt.buf.
SDL_ConvertAudio(&cvt);
// cvt.buf zawiera teraz cvt.len_cvt bajtów skonwertowanych danych.

Funkcja ta wykonuje rzeczywistą konwersję danych dźwiękowych po wywołaniu przez aplikację SDL_BuildAudioCVT() w celu przygotowania danych o konwersji, a następnie wypełnieniu szczegółów dotyczących bufora.

Gdy aplikacja zainicjuje strukturę cvt za pomocą SDL_BuildAudioCVT(), przydzieli bufor dźwiękowy i wypełni go danymi dźwiękowymi w formacie źródłowym, funkcja ta skonwertuje zawartość tego bufora w miejscu (tzn. bez dodatkowej pamięci) na pożądany format.

Konwersja danych może przebiegać przez kilka obiegów, a każdy z nich może chwilowo powiększać rozmiar danych. Na przykład, SDL może poszerzać dane 16-bitowe na 32-bitowe przed dokonaniem ponownego próbkowania na niższej częstotliwości, zmniejszając rozmiar danych po chwilowym jego zwiększeniu. Ponieważ dostarczony bufor będzie zarówno źródłem jak i przeznaczeniem, co jest niezbędne przy konwersji w miejscu, aplikacja musi przydzielić bufor o wystarczająco dużym rozmiarze dla największego przebiegu konwersji. Gdy funkcja SDL_BuildAudioCVT() wróci, aplikacja powinna ustawić pole len struktury cvt na rozmiar w bajtach danych źródłowych i przydzielić bufor o długości len * len_mult bajtów dla pola buf.

Dane źródłowe powinny zostać skopiowane do tego bufora przed wywołaniem SDL_ConvertAudio(). Po powrocie z sukcesem bufor ten będzie zawierał skonwertowany dźwięk, a pole len_cvt struktury cvt będzie zawierało rozmiar skonwertowanych danych w bajtach. Po powrocie z funkcji wszystkie bajty w buforze poza pozycją len_cvt są nieokreślone.

SDL_BuildAudioCVT