rockbox/lib/rbcodec/codecs/libwavpack
Sean Bartell cadb3627fc Add rbcodecplatform.h and rbcodecconfig.h.
librbcodec users must provide these two files when the library is built.
rbcodecconfig.h provides configuration #defines and basic types, and
will be included by public librbcodec headers, so it must not conflict
with the user's code. rbcodecplatform.h provides various OS functions,
and will only be included by source files and private headers. This
system is intended to provide maximum flexibility for use on embedded
systems, where no operating system headers are included. Unix systems
can just copy rbcodecconfig-example.h and rbcodecplatform-unix.h with
minimal changes.

Change-Id: I350a2274d173da391fd1ca00c4202e9760d91def
Reviewed-on: http://gerrit.rockbox.org/143
Reviewed-by: Nils Wallménius <nils@rockbox.org>
Tested-by: Nils Wallménius <nils@rockbox.org>
2012-05-03 14:49:35 +02:00
..
arm.S Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
arml.S Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
bits.c Add rbcodecplatform.h and rbcodecconfig.h. 2012-05-03 14:49:35 +02:00
coldfire.S Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
float.c Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
libwavpack.make Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
LICENSE Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
make.bat Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
metadata.c Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
pack.c Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
README Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
README.rockbox Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
SOURCES Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
unpack.c Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
wavpack.h Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
words.c Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00
wputils.c Add codecs to librbcodec. 2012-04-25 22:13:20 +02:00

////////////////////////////////////////////////////////////////////////////
//                           **** WAVPACK ****                            //
//                  Hybrid Lossless Wavefile Compressor                   //
//              Copyright (c) 1998 - 2004 Conifer Software.               //
//                          All Rights Reserved.                          //
//      Distributed under the BSD Software License (see license.txt)      //
////////////////////////////////////////////////////////////////////////////

This package contains a tiny version of the WavPack 4.0 decoder that might
be used in a "resource limited" CPU environment or form the basis for a
hardware decoding implementation. It is packaged with a demo command-line
program that accepts a WavPack audio file on stdin and outputs a RIFF wav
file to stdout. The program is standard C, and a win32 executable is
included which was compiled under MS Visual C++ 6.0 using this command:

cl /O1 /DWIN32 wvfilter.c wputils.c unpack.c float.c metadata.c words.c bits.c

WavPack data is read with a stream reading callback. No direct seeking is
provided for, but it is possible to start decoding anywhere in a WavPack
stream. In this case, WavPack will be able to provide the sample-accurate
position when it synchs with the data and begins decoding.

For demonstration purposes this uses a single static copy of the
WavpackContext structure, so obviously it cannot be used for more than one
file at a time. Also, this decoder will not handle "correction" files, plays
only the first two channels of multi-channel files, and is limited in
resolution in some large integer or floating point files (but always
provides at least 24 bits of resolution). It also will not accept WavPack
files from before version 4.0.

To make this code viable on the greatest number of hardware platforms, the
following are true:

   speed is about 4x realtime on an AMD K6 300 MHz
      ("high" mode 16/44 stereo; normal mode is about twice that fast)

   no floating-point math required; just 32b * 32b = 32b int multiply

   large data areas are static and less than 4K total
   executable code and tables are less than 32K
   no malloc / free usage

To maintain compatibility on various platforms, the following conventions
are used:

   a "short" must be 16-bits
   a "long" must be 32-bits
   an "int" must be at least 16-bits, but may be larger
   a "char" must default to signed


Questions or comments should be directed to david@wavpack.com