diff options
author | Dave Chapman <dave@dchapman.com> | 2007-06-05 16:58:29 +0000 |
---|---|---|
committer | Dave Chapman <dave@dchapman.com> | 2007-06-05 16:58:29 +0000 |
commit | 520274219a0745384cb9bc6df4d7ee7905090f5d (patch) | |
tree | 8d6f4536b6758d00e72a2a9457f892ce28a591bd /apps/codecs/demac/README | |
parent | 887b31c01aebb46c0fcc6910241a4a64d9e7991e (diff) | |
download | rockbox-520274219a0745384cb9bc6df4d7ee7905090f5d.tar.gz rockbox-520274219a0745384cb9bc6df4d7ee7905090f5d.zip |
Initial commit of Monkey's Audio (.ape/.mac) support. Note that Monkey's is an extremely CPU-intensive codec, and that the decoding speed is directly related to the compression level (-c1000, -c2000, -c3000, -c4000 or -c5000) used when encoding the file. Current performance is: -c1000 to -c3000 are realtime on a Gigabeat, -c1000 is realtime on Coldfire targets (H100, H300 and Cowon), and nothing is realtime on PortalPlayer targets (iPods, H10, Sansa). Hopefully this can be improved. More information at FS #7256.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@13562 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'apps/codecs/demac/README')
-rw-r--r-- | apps/codecs/demac/README | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/apps/codecs/demac/README b/apps/codecs/demac/README new file mode 100644 index 0000000000..2fcdd95edf --- /dev/null +++ b/apps/codecs/demac/README | |||
@@ -0,0 +1,69 @@ | |||
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. | ||