aboutsummaryrefslogtreecommitdiff
path: root/readme.md
blob: 41ca58c77afe43fbbe44c5fa53383a19bfdd5715 (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
68
69
70
71
72
73
74
75
76
77

## PortAudio Binding for the Ada Programming Language

This is a thick binding of [PortAudio](https://www.portaudio.com/). So effort
has been made to get rid of all C-isms and C-specific types wherever possible.
In particular:

<ul>
  <li>Pa_Initialize and Pa_Terminate are now automatic</li>
  <li>All error codes have been converted to exceptions</li>
  <li>Void pointers are completely absent</li>
  <li>Standard error is suppressed in C during init, so no unexpected text
  output</li>
</ul>

The package hierarchy is as follows:

<ul>
  <li>Portaudio (Version information, exceptions, and a few common minor types)
    <ul>
      <li>Portaudio.Devices (Host_API and device related things)</li>
      <li>Portaudio.Streams (Streams, sample buffers, and callbacks)</li>
    </ul>
  </li>
</ul>

A few short example programs are available in the `example` subdirectory.



#### Dependencies

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

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



#### Building and Installation

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

`gprbuild portaudio.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 portaudio.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 Ada test/example programs were written by Jedidiah Barber.

All code of this binding and example programs is released into the public
domain. Consult `unlicense.txt` for further information.