File: README.md

package info (click to toggle)
libambix 0.1.1-1
  • links: PTS, VCS
  • area: main
  • in suites: buster, stretch
  • size: 4,720 kB
  • ctags: 974
  • sloc: ansic: 9,828; makefile: 416; sh: 174; python: 92
file content (107 lines) | stat: -rw-r--r-- 3,403 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
libambix - The AMBIsonics eXchange library
==========================================

This is libambix `0.0.1`

libambix is a library of C routines for reading and writing
files following the "ambix" (AMBIsonics eXchange) conventions.

# Status

| *Check*                | *Health*                                                            |
| :--------------------- | :------------------------------------------------------------------ |
| Continuous Integration | ![Travis-CI](https://api.travis-ci.org/umlaeute/pd-iemnet.svg)      |
| Static Code Analysis   | ![Coverity Scan](https://scan.coverity.com/projects/1736/badge.svg) |
| Test Coverage          | [![codecov](https://codecov.io/gh/iem-projects/ambix/branch/master/graph/badge.svg)](https://codecov.io/gh/iem-projects/ambix) |


# INTRODUCTION
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) and `float64`
- audio data is *interleaved*
- ambisonics channels are
	- normalization		: `SN3D`
	- channel ordering	: `ACN`

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*)

# Download

Get the source code (and releases) from
  https://git.iem.at/ambisonics/libambix

The source code is also mirrored to
 [GitHub](https://github.com/iem-projects/ambix/)
and (less often) to
 [SourceForge](https://sourceforge.net/p/iem/ambix/)

# API Documentation

An up-to-date API Documentation can be found at
  http://iem-projects.github.io/ambix/apiref/

# Directory layout
- `libambix/` - all components of the libambix library
- `libambix/src` - the source code for library itself.
- `libambix/ambix` - public header files for the library
- `libambix/tests` - programs which link against libambix and test its functionality.
- `utils/` - utility programs using libambix

# BUILDING from source

## DEPENDENCIES
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


## LINUX
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

## UNIX
Compile as for Linux.


## Win32/Win64
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.


## MacOSX
Building on MacOSX should be the same as building it on any other Unix.


# CONTACT

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