diff options
author | Dave Chapman <dave@dchapman.com> | 2009-05-09 01:21:49 +0000 |
---|---|---|
committer | Dave Chapman <dave@dchapman.com> | 2009-05-09 01:21:49 +0000 |
commit | 67695617a13e9f37f17e3718b03046f6d748a9e1 (patch) | |
tree | 7e8a8b5fb8d4222e3286f3300bcf12ad439424b0 /apps/codecs/libcook/README.rockbox | |
parent | 69db01e72f2de91d35703919bfc9d0700df83e85 (diff) | |
download | rockbox-67695617a13e9f37f17e3718b03046f6d748a9e1.tar.gz rockbox-67695617a13e9f37f17e3718b03046f6d748a9e1.zip |
The first part of Mohamed Tarek's Google Summer of Code work to implement RealAudio support in Rockbox. This is a self-contained Cook decoder using the original ffmpeg (still floating point) decoder and a new RM parser started by me in 2008 and continued by MT over the past few months. This is the equivalent of libcook.patch1 from FS#10182, but with further cleaning by both MT and me to minimise the differences to the original ffmpeg files. See README.rockbox for more details.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@20883 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'apps/codecs/libcook/README.rockbox')
-rw-r--r-- | apps/codecs/libcook/README.rockbox | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/apps/codecs/libcook/README.rockbox b/apps/codecs/libcook/README.rockbox new file mode 100644 index 0000000000..9447b96be5 --- /dev/null +++ b/apps/codecs/libcook/README.rockbox | |||
@@ -0,0 +1,40 @@ | |||
1 | Library: libcook | ||
2 | Imported by : Mohamed Tarek | ||
3 | |||
4 | These files comprise a rm parser and a cook decoder based on the decoder | ||
5 | from ffmpeg. | ||
6 | |||
7 | LICENSING INFORMATION | ||
8 | |||
9 | ffmpeg is licensed under the Lesser GNU General Public License and the | ||
10 | file cook.c is Copyright 2003 Sascha Sommer and 2005 Benjamin Larsson. | ||
11 | |||
12 | IMPORT DETAILS | ||
13 | |||
14 | The decoder is based on ffmpeg-svn r18079. | ||
15 | |||
16 | The file libavcodec/cook.c was modified to remove all ffmpeg-specific | ||
17 | code and to use the current rm parser. | ||
18 | |||
19 | In initializing random_state in COOKContext, ffmpeg used a random_seed() | ||
20 | function that was weird in the way it gets the random number. So it was | ||
21 | decided to not use this function at all,and the value was initialized to 1, | ||
22 | because according to Benjamin Larsson random_seed() could just be | ||
23 | replaced by any value. | ||
24 | |||
25 | The current files contain lots of code which is either not needed by | ||
26 | the decoder or totally disabled (#if 0 .. #endif) to enable | ||
27 | compiling. This was during the isolation of the decoder from ffmpeg, | ||
28 | the intention was to take as few files as possible to be able to | ||
29 | compile cook.c and the related files outside ffmpeg. | ||
30 | |||
31 | The decoder still uses floating point and relies on dynamic allocations | ||
32 | in some parts of it. It's still not ready to be ported to rockbox. | ||
33 | |||
34 | TESTING | ||
35 | |||
36 | The test program should compile in any Unix-like environment using the | ||
37 | command "make -f Makefile.test". | ||
38 | |||
39 | Running "./cooktest file.rm" will decode the audio data to a WAV file | ||
40 | called "output.wav" in the current directory. | ||