მინიაუდიო 0.11.22

24 თებერვალს, ერთ წელზე მეტი ხნის შემუშავების შემდეგ, გამოვიდა 0.11.22 კროსპტფორმული აუდიო გადაღებისა და დაკვრის ბიბლიოთეკა. მინიაუდიო, დაწერილი C-ში და განაწილებული საზოგადოებრივ დომენში.
miniaudio მუშაობს ყველა ძირითად დესკტოპზე და მობილურ პლატფორმაზე, მათ შორის Windows, macOS, Linux, BSD, iOS, Android და Web (Emscripten-ის საშუალებით) მესამე მხარის დამოკიდებულების გარეშე.
ბიბლიოთეკას აქვს მარტივი, მოქნილი და მოდულარული API ჩაშენებული დეკოდერებით (WAV, MP3 და FLAC), მოწინავე მიქსისა და ეფექტების დამუშავება (მათ შორის 3D), რესურსების მართვა, ფილტრები, მონაცემთა კონვერტაცია და მრავალი სხვა.

ძირითადი ცვლილებები:

• 0.12 ვერსიით დაწყებული, miniaudio გადავა .c/h ფაილების ცალკეულ წყვილზე, უარს იტყვის ერთი სათაურის ფაილზე. ამისთვის მოსამზადებლად საცავში დაემატა miniaudio.c ფაილი. ამ დროისთვის ის მხოლოდ miniaudio.h-ისა და MINIAUDIO_IMPLEMENTATION-ის გარშემოა. miniaudio.h-ში არაფერი შეცვლილა, თუმცა როცა 0.12 ვერსია გამოვა, კომპილაციისთვის მოგიწევთ გამოიყენოთ miniaudio.c. რეკომენდებულია მიგრაციის დაწყება MINIAUDIO_IMPLEMENTATION-დან miniaudio.c-ზე. თუ გსურთ გააგრძელოთ თქვენი პროექტის შექმნა, როგორც ერთი კომპილაციის ერთეული, შეგიძლიათ #include "miniaudio.c". ეს მეთოდი იქნება მხარდაჭერილი 0.12 ვერსიაში და მის შემდგომ.
• ფაილები miniaudio_libvorbis.h და miniaudio_libopus.h დამატებითი დირექტორიაში მოძველებულია. ისინი ახლა დაყოფილია ცალკეულ .c და .h ფაილებად დამატებითი/დეკოდერების დირექტორიაში. ძველი ფაილები ჯერ კიდევ არსებობს თავსებადობისთვის, მაგრამ თქვენ უნდა განაახლოთ ახალ ვერსიებზე. გადასვლა ტრივიალური უნდა იყოს.
• დამატებულია ვარიანტები MA_SOUND_FLAG_LOOPING და MA_RESOURCE_MANAGER_DATA_SOURCE_FLAG_LOOPING. მათი გამოყენება შესაძლებელია ბგერების და რესურსებზე ორიენტირებული მონაცემთა წყაროების ინიციალიზაციისთვის ნაგულისხმევად. ეს არის რეკომენდირებული გზა ძაფების მარყუჟის გასააქტიურებლად. isLooping კონფიგურაციის ვარიანტები ma_sound_config და ma_resource_manager_data_source_config მოძველებულია. თუ მათ იყენებთ, უნდა გადახვიდეთ ახალ ოფციებზე, წინააღმდეგ შემთხვევაში მიიღებთ კომპილერის შეცდომებს მომავალ ვერსიაზე განახლებისას.
• ma_rb_commit_read(), ma_rb_commit_write(), ma_pcm_rb_commit_read() და ma_pcm_rb_commit_write() აღარ ბრუნდებიან MA_AT_END. ამ ცვლილების მიზეზი არის ის, რომ არ არსებობს "დასრულების" კონცეფცია რგოლების ბუფერში, რამაც შედეგის კოდი გაურკვეველი გახადა. გარდა ამისა, ამ ფუნქციებს შეუძლიათ MA_SUCCESS-ის გარდა სხვა რამ დააბრუნონ, მაშინაც კი, თუ ოპერაცია წარმატებით დასრულდა, რამაც გამოიწვია დაბნეულობა. სწორი გზა იმის შესამოწმებლად, არის თუ არა ადგილი რგოლის ბუფერში, არის rb_acquire_read/write() ფუნქციებით დაბრუნებული კადრების მრიცხველის დათვალიერება.
• ma_pcm_rb მონაცემთა წყაროს იმპლემენტაცია შეიცვალა ისე, რომ გამომავალი ივსება დუმილით, თუ არ არის საკმარისი მონაცემები ბეჭდის ბუფერში მოთხოვნის შესასრულებლად. ეს ნიშნავს, რომ ma_data_source_read_pcm_frames() ma_pcm_rb-ისთვის აღარ უნდა დააბრუნოს თქვენ მიერ მოთხოვნილზე ნაკლები ფრეიმების რაოდენობა და, შესაბამისად, არასოდეს დააბრუნებს MA_AT_END, რაც აზრი არ აქვს ბეჭდის ბუფერს, რადგან მას არ აქვს დასასრულის კონცეფცია. ამ ცვლილებამ უნდა გააადვილოს ბეჭდის ბუფერის, როგორც მონაცემთა წყაროს გამოყენება ma_sound-ისთვის.
• მცირე ცვლილება განხორციელდა ma_calculate_buffer_size_in_milliseconds_from_frames() ფუნქციაში ისე, რომ იგი დააბრუნებს მნიშვნელობას, რომელიც დამრგვალებულია უახლოეს მთელ რიცხვამდე.
• თუ დეკოდერის ინიციალიზაცია ვერ მოხერხდა, შეცდომის პირველი კოდი დაბრუნდა, ვიდრე MA_NO_BACKEND შეცდომის მიუხედავად, როგორც ეს ადრე ხდებოდა.
• დამატებულია ma_device_id_equal() ფუნქცია მოწყობილობის ID-ების შედარებისთვის.
• MA_NO_RUNTIME_LINKING-ის მხარდაჭერა დაემატა AAudio backend-ს.
• დოკუმენტაცია განახლებულია.
• აღმოჩენილი შეცდომები გამოსწორებულია.

წყარო: linux.org.ru