apps/codecs/libcook/README.rockbox

   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 CONVERSION TO FIXED-POINT
  17
  18 A patch from ffmpeg's mailing list was used to convert the decoder to
  19 use fixed-point arithmetic. The patch was done by Ian Braithwaite, and
  20 discussed here :
  21
  22 http://thread.gmane.org/gmane.comp.video.ffmpeg.devel/46024
  23
  24 The patch is a bit dated (2007) so the modifications to cook.c had to
  25 be done manually.  The patch was also applied to cookdata.h and was
  26 used to create cookdata_fixpoint.h, cook_fixpoint.h and
  27 cook_fixp_mdct.h.
  28
  29 cook_fixp_mdct.h and parts from cookdata_fixpoint.h were dropped and
  30 rockbox's mdct library is now used in both the test program and the
  31 real codec.
  32
  33 Note : Only parts of the patch were committed to ffmpeg's repository.
  34
  35 TESTING
  36
  37 The test program should compile in any Unix-like environment using the
  38 command "make -f Makefile.test".
  39
  40 For ARM targets add -DCPU_ARM to CFLAGS in Makefile.test to make use of
  41 the asm ARM optimisations in rockbox's mdct library.
  42
  43 For Big-endian targets, change -D"ROCKBOX_LITTLE_ENDIAN=1"
  44 to -D"ROCKBOX_BIG_ENDIAN=1" in Makefile.test.
  45
  46 Running "./cooktest file.rm" will decode the audio data to a WAV file
  47 called "output.wav" in the current directory.