The RtAudio Home Page
4.0.6
RtAudio is a set of C++ classes that provide a common API (Application Programming Interface) for realtime audio input/output across Linux, Macintosh OS-X and Windows (DirectSound and ASIO) operating systems.
RtAudio significantly simplifies the process of interacting with computer audio hardware. It was designed with the following objectives:
-
object-oriented C++ design
-
simple, common API across all supported platforms
-
only one source and two header files for easy inclusion in programming projects
-
allow simultaneous multi-api support
-
support dynamic connection of devices
-
provide extensive audio device parameter control
-
allow audio device capability probing
-
automatic internal conversion for data format, channel number compensation, (de)interleaving, and byte-swapping
RtAudio incorporates the concept of audio streams, which represent audio output (playback) and/or input (recording). Available audio devices and their capabilities can be enumerated and then specified when opening a stream. Where applicable, multiple API support can be compiled and a particular API specified when creating an RtAudio instance. See the API Notes section for information specific to each of the supported audio APIs.
RtAudio V4 represents a significant rewrite of the code and includes a number of API and functionality changes from previous versions. A partial list of the changes includes:
- new support for non-interleaved user data
- additional input/output parameter specifications, including channel offset
- new support for dynamic connection of devices
- new support for stream time
- revised callback arguments, including separate input and output buffer arguments
- revised C++ exception handling
- updated support for OSS version 4.0
- discontinued support of blocking functionality
- discontinued support of SGI
Devices are now re-enumerated every time the RtAudio::getDeviceCount(), RtAudio::getDeviceInfo(), and RtAudio::openStream() functions are called. This allows for the proper identification of hot-pluggable (USB, Firewire, ...) devices that are connected after an RtAudio instance is created.
Latest Release (3 June 2009):
Version 4.0.6
- Error Handling
- Probing Device Capabilities
- Device Settings
- Playback
- Recording
- Duplex Mode
- Using Simultaneous Multiple APIs
- Debugging & Compiling
- API Notes
- Acknowledgements
- License
- Bug Tracker
- Possible Updates
- RtAudio at SourceForge