| This README covers the Ogg Vorbis 'Tremor' integer playback codec |
| source as of date 2002 09 02, version 1.0.0. |
| |
| ****** |
| |
| The C source in this package will build on any ANSI C compiler and |
| function completely and properly on any platform. The included build |
| system assumes GNU build system and make tools (m4, automake, |
| autoconf, libtool and gmake). GCC is not required, although GCC is |
| the most tested compiler. To build using GNU tools, type in the |
| source directory: |
| |
| ./autogen.sh |
| make |
| |
| Currently, the source implements playback in pure C on all platforms |
| except ARM, where a [currently] small amount of assembly (see |
| asm_arm.h) is used to implement 64 bit math operations and fast LSP |
| computation. If building on ARM without the benefit of GNU build |
| system tools, be sure that '_ARM_ASSEM_' is #defined by the build |
| system if this assembly is desired, else the resulting library will |
| use whatever 64 bit math builtins the compiler implements. |
| |
| No math library is required by this source. No floating point |
| operations are used at any point in either setup or decode. This |
| decoder library will properly decode any past, current or future |
| Vorbis I file or stream. |
| |
| ******** |
| |
| The build system produces a static and [when supported by the OS] |
| dynamic library named 'libvorbisidec'. This library exposes an API |
| nearly identical to the BSD reference library's 'libvorbisfile', |
| including all the features familiar to users of vorbisfile. This API |
| is similar enough that the proper header file to include is named |
| 'ivorbisfile.h' [included in the source build directory]. Lower level |
| libvorbis-style headers and structures are in 'ivorbiscodec.h' |
| [included in the source build directory]. A simple example program, |
| ivorbisfile_example.c, can be built with 'make example'. |
| |
| ******** |
| |
| Detailed Tremor API Documentation begins at doc/index.html |
| |
| Monty |
| xiph.org |