apps/codecs/demac/README

   1 demac - a decoder for Monkey's Audio files.
   2
   3 Introduction
   4
   5 demac is an implementation in portable ANSI C of a decoder for the
   6 Monkey's Audio lossless compression format.  It has the following
   7 features:
   8
   9   * Open source (GNU GPL)
  10   * Written in portable ANSI C
  11   * Designed for use on low memory and embedded devices.  All internal
  12     buffers are statically declared - the core library doesn't require
  13     malloc/free.  This has the disadvantage that the library isn't
  14     re-entrant.
  15
  16
  17 Compatibility
  18
  19
  20 libdemac is still in the early stages of development but has been
  21 relatively well tested with v3.99 files at all compression levels.
  22
  23 v3.97 files have received less testing - 16-bit files seem to work,
  24 but 24-bit files are causing problems in the range decoder.
  25
  26 Files earlier than v3.97 are not supported by libdemac, but support
  27 might be added in the future.
  28
  29
  30 Source Code
  31
  32 The source code in this directory is structured as follows:
  33
  34 demac/Makefile - Makefile for the standalone demac decoder
  35 demac/demac.c - Simple standalone test program to decoder an APE file to WAV
  36 demac/wavwrite.[ch] - Helper functions for demac.c
  37 demac/libdemac/Makefile - A Makefile for use in Rockbox
  38 demac/libdemac/*.[ch] - The main libdemac code
  39
  40
  41 Latest Version
  42
  43 The latest version of demac and libdemac can always be found in the
  44 "apps/codecs/demac/" directory in the Rockbox source.  You can check
  45 this out from svn with the command:
  46
  47 svn co svn://svn.rockbox.org/rockbox/trunk/apps/codecs/demac demac
  48
  49 Or browse the source code online here:
  50
  51 http://svn.rockbox.org/viewvc.cgi/trunk/apps/codecs/demac
  52
  53
  54
  55 Acknowledgements
  56
  57 Thanks to Matt. T. Ashland for writing Monkey's Audio.  His website
  58 can be found here: http://www.monkeysaudio.com
  59
  60
  61 Copyright and license
  62
  63
  64 libdemac is (C) 2007 Dave Chapman and is licensed under the GNU
  65 GPL. See the COPYING file in this directory.
  66
  67 The exception is the majority of rangecoding.h, which is (C) 1997,
  68 1998, 1999, 2000 Michael Schindler and is also licensed under the GPL.
  69 See that source file for full details.