miniaudio 0.11.22

Den 24 februari, efter mer än ett års utveckling, släpptes version 0.11.22 av det plattformsoberoende biblioteket för ljudinspelning och uppspelning miniaudio, som är skriven i C och distribueras som offentlig egendom.
miniaudio fungerar på alla större skrivbords- och mobilplattformar, inklusive Windows, macOS, Linux, BSD, iOS, Android och Web (via Emscripten) utan externa beroenden.
Biblioteket har ett enkelt, flexibelt och modulärt API med inbyggda dekodrar (WAV, MP3 och FLAC), avancerad mixer och effektbehandling (inklusive 3D), resursstyrning, filter, datakonvertering och mycket mer.

Huvudsakliga förändringar:

• Från och med version 0.12 kommer miniaudio att gå över till separata .c/.h-filer och överge den enda header-filen. För att förbereda detta har en fil miniaudio.c lagts till i repo. För närvarande är detta bara en wrapper runt miniaudio.h och MINIAUDIO_IMPLEMENTATION. Inga ändringar har gjorts i miniaudio.h, men när version 0.12 släpps kommer miniaudio.c att behövas för kompilering. Det rekommenderas att börja övergången från att använda MINIAUDIO_IMPLEMENTATION till att använda miniaudio.c. Om du vill fortsätta kompilera ditt projekt som en enda kompilationsenhet kan du använda #include "miniaudio.c". Denna metod kommer att stödjas i version 0.12 och framåt.
• Filena miniaudio_libvorbis.h och miniaudio_libopus.h i mappen extras har förklarats som föråldrade. De har nu delats upp i separata .c och .h-filer i mappen extras/decoders. De gamla filerna finns fortfarande kvar för kompatibilitet, men du måste uppgradera till de nya versionerna. Övergången bör vara trivial.
• Alternativen MA_SOUND_FLAG_LOOPING och MA_RESOURCE_MANAGER_DATA_SOURCE_FLAG_LOOPING har lagts till. Dessa kan användas för att initiera ljud och resursstyrda datakällor för looping som standard. Detta är det rekommenderade sättet att aktivera looping för strömmar. Konfigurationsalternativen isLooping i ma_sound_config och ma_resource_manager_data_source_config har förklarats som föråldrade. Om du använder dem bör du uppgradera till de nya alternativen, annars kan du få kompilatorfel när du uppgraderar till framtida versioner.
• ma_rb_commit_read(), ma_rb_commit_write(), ma_pcm_rb_commit_read() och ma_pcm_rb_commit_write() returnerar inte längre MA_AT_END. Anledningen till denna ändring är att det inte finns något koncept av "slut" i ringbufret, vilket gjorde resultatkoden otydlig. Dessutom kan dessa funktioner returnera något annat än MA_SUCCESS, även om operationen slutfördes framgångsrikt, vilket skapade mer förvirring. Det korrekta sättet att kontrollera om det fortfarande finns utrymme i ringbufret är att titta på ramläknaren som returneras av funktionerna rb_acquire_read/write().
• Implementeringen av datakällan ma_pcm_rb har ändrats så att utsignalen fylls med tystnad om det inte finns tillräckligt med data i ringbufret för att utföra begäran. Detta innebär att ma_data_source_read_pcm_frames() för ma_pcm_rb inte längre ska returnera ett antal ramar som är mindre än vad du begärde, och därför kommer det aldrig att returnera MA_AT_END, vilket inte är meningsfullt för ringbufret eftersom det inte har något koncept av slut. Denna förändring bör förenkla användningen av ringbufret som datakälla för ma_sound avsevärt.
• Funktionen ma_calculate_buffer_size_in_milliseconds_from_frames() har fått en liten ändring som gör att den returnerar ett värde som avrundas till närmaste heltal.
• Vid misslyckad initialisering av avkodaren returneras nu den första stötta felkoden som hittas, istället för MA_NO_BACKEND oavsett vilken fel det rörde sig om, som tidigare.
• Funktionen ma_device_id_equal() har lagts till för att jämföra enhetsidentifierare.
• Stöd för MA_NO_RUNTIME_LINKING har lagts till i AAudio-backend.
• Dokumentationen har uppdaterats.
• Förekomna fel har åtgärdats.

Källa: linux.org.ru