This is libambix 0.0.1
libambix is a library of C routines for reading and writing files following the "ambix" (AMBIsonics eXchange) conventions.
| Check | Health |
|---|---|
| Continuous Integration |  |
| Static Code Analysis |  |
| Test Coverage |  |
libambix is a library that reads and writes soundfiles following the "ambix" specificiation. Such files are:
CAF(Core Audio Format) files- with a special
UUID-chunk
Audio data as output (and accepted as input) by libambix will follow the following specification:
- sample format is either
PCM16,PCM24,float32(this one being best tested) andfloat64 - audio data is interleaved
- ambisonics channels are
- normalization :
SN3D - channel ordering :
ACN
- normalization :
It is planned to provide conversion matrices to present the audio data in other (common) formats namely
- Furse-Malham set (FuMa)
- other normalizations (N3D)
- other ordering (SID)
Get the source code (and releases) from https://git.iem.at/ambisonics/libambix
The source code is also mirrored to GitHub and (less often) to SourceForge
An up-to-date API Documentation can be found at http://iem-projects.github.io/ambix/apiref/
libambix/- all components of the libambix librarylibambix/src- the source code for library itself.libambix/ambix- public header files for the librarylibambix/tests- programs which link against libambix and test its functionality.utils/- utility programs using libambix
Currently libambix uses libsndfile to read the actual file. Due to some advanced functionality, you need at least libsndfile-1.0.26. The current version of libsndfile can be obtained from https://github.com/erikd/libsndfile
Wherever possible, you should use the packages supplied by your Linux distribution.
If you really do need to compile from source it should be as easy as:
$ ./configure
$ make
$ make install
if you want to compile the development version of libambix, you might need to run the following before any of the above:
$ ./autogen.sh
Compile as for Linux.
The default Windows compilers (Microsoft's Visual Studio) are nowhere near compliant with the 1999 ISO C Standard and hence not able to compile libambix.
Please use the libambix binaries available on the ambix web site.
Building on MacOSX should be the same as building it on any other Unix.
libambix was written by IOhannes m zmölnig at the Institute of Electronic Music and Acoustics (IEM), and the University of Music and Performing Arts (KUG), Graz, Austria The libambix home page is at :
http://git.iem.at/ambisonics/libambix