Wiki > Main > StandaloneAudioLibrary (compare)
Difference: StandaloneAudioLibrary (r3 vs. r2)
This project is part of the Google Summer of Code 2011 project.
My project is to separate out Rockbox's codecs, metadata parsing, and DSP code into a separate library. I'll add an automated testing suite, make the library usable by other embedded software, and perform some other improvements. My project will make codec development easier, and hopefully external projects will use and make contributions to the library.
The library will include the decoders, encoders, metadata parsers, and DSP code (resampling, equalization, and timestretching). When the first steps are done, it will be possible to build the library on Linux. I'll make a simple demo program that can play music and use all the features of the library.
This stage will focus on the minimal changes needed to get the demo program working, in preparation for the next steps.
There will The library currently has various dependencies on other Rockbox code, especially headers. These need to be a fixed removed so set of functions that must be implemented by external users need not build the library's user, similar whole of Rockbox in order to use the way codecs currently interact with the rest library. This is complicated by embedded devices' need for efficiency, which means it's best to avoid layers of Rockbox through wrapper functions.
I plan to remove dependencies on Rockbox by having a user‐provided header file (
This will be my project's most direct benefit to Rockbox. I plan to write a Python driver that will decode each test file and do an exact comparison against known correct output. For new test files, where there's no known output, I'll use fuzzy comparisons (e.g. PSNR) against other libraries and tools. The driver will also check the results of seeking, and test the other library features.
It may be possible to test platform-dependent assembly code with qemu or another emulator. I'm also interested in checking coverage and using other techniques, like Valgrind.
The initial focus will be on getting the library working, not on a nice API. In order to appeal to software other than Rockbox, I'll change the API to make it cleaner and more flexible. I'll examine other codec software (both proprietary and open), talk to interested projects (if any), and make a big list of features the ideal library would have. This includes anything from documentation (essential) to reading lyrics files (feature creep). We can then figure out which items are feasible and important enough to implement this summer.
If there's still time left, further work may include performance optimization and bughunting.
I have written a [[http://www.rockbox.org/mail/archive/rockbox-dev-archive-2011-06/0067.shtml][codec test program]] that can play files with SDL, convert them to WAV, and apply some DSP effects. This program will become the basis for the test suite. I've already found one bug (FS#12164) with this program and Valgrind.
The library includes the decoders, encoders, metadata parsers, and DSP code (resampling, equalization, and timestretching). The library has its own makefile, which can be used either by a normal Rockbox build or by a separate application such as the test program. However, building it separately is very complicated, requiring many #defines and makefile rulescleaning this up is the next step. The code is not yet available.
Other changes not related to codecs: FS#12121.
-- SeanBartell - 25 May 2011
r5 - 21 Jul 2011 - 06:02:38 - SeanBartellRevision r3 - 28 Jun 2011 - 05:01 - SeanBartell
Revision r2 - 03 Jun 2011 - 04:19 - SeanBartell
Copyright © by the contributing authors.