PortAudio Binding for the Ada Programming Language
==================================================


Overview
--------

This is a thick binding, so effort has been made to get rid of all C-isms and
C-specific types wherever possible. In particular:

 * Pa_Initialize and Pa_Terminate are now automatic
 * All error codes have been converted to exceptions
 * Void pointers are completely absent
 * Standard error is suppressed in C, so no unexpected text output

The package hierarchy is as follows:

 * Portaudio: Version information, exceptions, and a few common minor types
   * Portaudio.Devices: Host_API and device related things
   * Portaudio.Streams: Streams. sample buffers, and callbacks

A few short example programs are available in /example/.


Dependencies
------------

An Ada 2012 compiler and standard library (build)
A C compiler and standard library (build)
gprbuild (build)
PortAudio (run)


Build Instructions
------------------

Ensure that all dependencies are installed, including any developer or header
packages for PortAudio. Then the following commands will build and install the
binding:

    gprbuild portadao.gpr
    gprinstall -p -m portadao.gpr

The other gpr file, example.gpr, can be used to build the few short example and
test programs provided.


Further Information
-------------------

C API of PortAudio:
http://files.portaudio.com/docs/v19-doxydocs/portaudio_8h.html


Credits and Legal
-----------------

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.