aboutsummaryrefslogtreecommitdiff
path: root/readme.md
blob: 7984a43a3b00c646c43cc634241565d09321f125 (plain)
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

## libao Binding for the Ada Programming Language

This a thick binding of [libao](https://xiph.org/ao/). So all the rough edges
of C have all been filed off. In particular:

<ul>
  <li>ao_initialize/ao_shutdown are now automatic</li>
  <li>ao_option/Option_List objects are deallocated when they go out of scope</li>
  <li>ao_device/Device objects are automatically closed upon program end</li>
  <li>All error codes have been converted to exceptions</li>
</ul>

A short example program is available in the `example` subdirectory.



#### Dependencies

Build time:
<ul>
  <li>gcc</li>
  <li>GNAT</li>
  <li>GPRbuild</li>
  <li>libao</li>
</ul>

Run time:
<ul>
  <li>libao</li>
</ul>



#### Building and Installation

This repository is written to use the GNAT Project Manager build tools. To
build, use the following command

`gprbuild aao.gpr`

There is a single build switch of `-Xbuild` which can have a value of `release`
(the default) or `debug`.

To install the binding, use

`gprinstall -p -m aao.gpr`

The other gpr file `example.gpr` can be used to build the short example
programs provided.

For further information on the build tools, consult the
[GPRbuild docs](https://docs.adacore.com/gprbuild-docs/html/gprbuild_ug.html).



#### Credits and Licensing

This binding and the short Ada example were written by Jedidiah Barber.

The short C example program was written by Stan Seibert.

All binding code and example programs are released into the public domain.
Consult `unlicense.txt` and the header of the C example program for further
information.