Renamed RtError class to RtAudioError and embedded it in RtAudio.h.
[rtaudio-cdist.git] / doc / release.txt
1 RtAudio - a set of C++ classes that provide a common API for realtime audio input/output across Linux (native ALSA, JACK, PulseAudio, and OSS), Macintosh OS X (CoreAudio and JACK), and Windows (DirectSound and ASIO) operating systems.
2
3 By Gary P. Scavone, 2001-2014.
4
5 v4.1.0: (?? 2014)
6 - RtError class renamed RtAudioError and embedded in RtAudio.h (RtError.h deleted)
7
8 v4.0.12: (16 April 2013)
9 - new functionality to allow error reporting via a client-supplied function (thanks to Pavel Mogilevskiy)
10 - new function to return the version number
11 - updated RtAudio.cpp and ASIO files for UNICODE support (thanks to Renaud Schoonbroodt)
12 - updates to PulseAudio API support (thanks to Peter Meerwald and Tristan Matthews)
13 - updates for pkg-config support in configure script
14 - 24-bit format changed to true 24-bit format, not sub-bytes of 32-bits (thanks to Marc Britton)
15 - bug fixes to make sure stream status is closed if error during probeDeviceOpen
16 - updates / fixes to SCHED_RR code in ALSA (thanks to Marc Lindahl)
17 - various changes to avoid global variables (thanks to Martin Koegler)
18
19 v4.0.11: (14 June 2012)
20 - fixes for memory leaks in ALSA (thanks to Martin Koegler)
21 - PulseAudio API support added (thanks to Peter Meerwald and Tristan Matthews)
22 - bitwise format flag fixes in OS-X (Benjamin Schroeder and Stefan Arisona)
23 - changes to stopStream / drain flag to avoid hung state in ASIO, DS, OS-X, and Jack APIs (Rasmus Ekman and Carlos Luna)
24
25 v4.0.10: (30 August 2011)
26 - fix for compile bug in Windows DS (counting devices)
27 - update to configure and library Makefile
28
29 v4.0.9: (14 August 2011)
30 - fix for ASIO problem enumerating devices after opening duplex stream (Oliver Larkin)
31 - fix for OS-X problems setting sample rate and bits-per-sample
32 - updates for OS-X "Lion"
33 - updates for wide character support in Windows DS (UNICODE)
34 - fix for possible ALSA callback thread hang (thanks to Tristan Matthews)
35 - fix for DS getDeviceCount bug (vector erase problem)
36
37 v4.0.8: (12 April 2011)
38 - fix for MinGW4 problem enumerating and setting sample rates (iasiothiscallresolver, Dmitry Kostjuchenko)
39 - fix for OS-X problem handling device names in some languages (CFString conversion, Vincent BĂ©nony)
40 - small change to OS-X mutex lock location to avoid lockups
41 - correction to documentation regarding 24-bit data (should be lower 3 bytes, not upper 3 bytes)
42 - bug fix for error handling of warnings (Antoine Lefebvre)
43 - added option to use the ALSA "default" device (Tristan Matthews)
44 - removed use of mutexes in Windows
45 - fix for ASIO4ALL behavior when stopping/closing streams (Antoine Lefebvre)
46 - included python binding in "contrib" directory (beta, Antoine Lefebvre)
47
48 v4.0.7: (4 February 2010)
49 - revised Windows DS code and device enumeration to speed up device queries
50 - OS-X 10.6 updates for deprecated functions
51 - updates to Jack shutdown code to avoid lockup
52
53 v4.0.6: (3 June 2009)
54 - bug fix in ALSA code to set period size to power of two (thanks to Joakim Karrstrom)
55 - bug fix in OS-X for OS < 10.5 ... need preprocessor definition around new variable type (thanks to Tristan Matthews)
56
57 v4.0.5: (2 February 2009)
58 - added support in CoreAudio for arbitrary stream channel configurations
59 - added getStreamSampleRate() function because the actual sample rate can sometimes vary slightly from the specified one (thanks to Theo Veenker)
60 - added new StreamOptions flag "RTAUDIO_SCHEDULE_REALTIME" and attribute "priority" to StreamOptions (thanks to Theo Veenker)
61 - replaced usleep(50000) in callbackEvent() by a wait on condition variable which gets signaled in startStream() (thanks to Theo Veenker)
62 - fix for Jack API when user callback function signals stop or abort calls
63 - fix to way stream state is changed to avoid infinite loop problem
64 - fix to int<->float conversion in convertBuffer() (thanks to Theo Veenker)
65 - bug fix in byteSwapBuffer() (thanks to Stefan Muller Arisona and Theo Veenker)
66 - fixed a few gcc 4.4 errors in OS-X
67 - fixed bug in rtaudio-config script
68 - revised configure script and Makefile structures
69 - 64-bit fixes in ALSA API (thanks to Stefan Muller Arisona)
70 - fixed ASIO sample rate selection bug (thanks to Sasha Zheligovsky)
71
72 v4.0.4: (24 January 2008)
73 - added functionality to allow getDeviceInfo() to work in ALSA for an open device (like ASIO)
74 - fixes in configure script
75 - fixed clearing of error message stream in error()
76 - fixed RtAudio::DeviceInfo description in "probing" documentation
77 - memory leak fixes in ALSA and OSS
78 - Jack in/out port flag fix
79 - Windows changes for thread priority and GLOBALFOCUS
80
81 v4.0.3: (7 December 2007)
82 - added support for MinGW compiler to configure script
83 - a few MinGW-related changes to RtAudio.cpp
84 - renamed test program probe.cpp to audioprobe.cpp
85 - moved various header files into single "include" directory and updated VC++ project files
86
87 v4.0.2: (21 August 2007)
88 - fix to RtError::WARNING typo in RtAudio.h (RtApiDummy)
89 - removed "+1"s in RtApiCore c++ append when getting device name
90
91 v4.0.1: (13 August 2007)
92 - fix to RtError::WARNING typo in RtAudio.cpp
93
94 v4.0.0: (7 August 2007)
95 - new support for non-interleaved user data
96 - additional input/output parameter specifications, including channel offset
97 - new support for dynamic connection of devices
98 - new support for stream time
99 - revised callback arguments, including separate input and output buffer arguments
100 - revised C++ exception handling
101 - revised OSS support for version 4.0
102 - discontinued support of blocking functionality
103 - discontinued support of SGI
104 - Windows DirectSound API bug fix
105 - NetBSD support (using OSS API) by Emmanuel Dreyfus
106 - changed default pthread scheduling priority to SCHED_RR when defined in the system
107 - new getCompiledApi() static function
108 - new getCurrentApi(), getStreamTime(), getStreamLatency(), and isStreamRunning() functions
109 - modified RtAudioDeviceInfo structure to distinguish default input and output devices
110
111 v3.0.3: (18 November 2005)
112 - UNICODE fix for Windows DirectSound API
113 - MinGW compiler fix for ASIO API
114
115 v3.0.2: (14 October 2005)
116 - modification of ALSA read/write order to fix duplex under/overruns
117 - added synchronization of input/output devices for ALSA duplex operation
118 - cleaned up and improved error reporting throughout
119 - bug fix in Windows DirectSound support for 8-bit audio
120 - bug fix in Windows DirectSound support during device capture query
121 - added ASIOOutputReady() call near end of callbackEvent to fix some driver behavior
122 - added #include <stdio.h> to RtAudio.cpp
123 - fixed bug in RtApiCore for duplex operation with different I/O devices
124 - improvements to DirectX pointer chasing (by Robin Davies)
125 - backdoor RtDsStatistics hook provides DirectX performance information (by Robin Davies)
126 - bug fix for non-power-of-two Asio granularity used by Edirol PCR-A30 (by Robin Davies)
127 - auto-call CoInitialize for DSOUND and ASIO platforms (by Robin Davies)
128
129 v3.0.1: (22 March 2004)
130 - bug fix in Windows DirectSound support for cards with output only
131
132 v3.0: (11 March 2004)
133 - added Linux Jack audio server support
134 - new multi-api support by subclassing all apis and making rtaudio a controller class
135 - added over/underload check to Mac OS X support
136 - new scheme for blocking functionality in callback-based apis (CoreAudio, ASIO, and JACK)
137 - removed multiple stream support (all stream indentifier arguments removed)
138 - various style and name changes to conform with standard C++ practice
139
140 v2.1.1: (24 October 2002)
141 - bug fix in duplex for Mac OS X and Windows ASIO code
142 - duplex example change in tutorial 
143
144 v2.1: (7 October 2002)
145 - added Mac OS X CoreAudio support
146 - added Windows ASIO support
147 - API change to getDeviceInfo(): device argument must be an integer between 1 - getDeviceCount().
148 - "configure" support added for unix systems
149 - adopted MIT-like license
150 - various internal structural changes and bug fixes
151
152 v2.01: (27 April 2002)
153 - Windows destructor bug fix when no devices available
154 - RtAudioError class renamed to RtError
155 - Preprocessor definitions changed slightly (i.e. __LINUX_OSS_ to __LINUX_OSS__) to conform with new Synthesis ToolKit distribution
156
157 v2.0: (22 January 2002)
158 - first release of new independent class
159