Final doc updates for 4.0.6 release (GS).
[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, and OSS), Macintosh OS X (CoreAudio and JACK), and Windows (DirectSound and ASIO) operating systems.
2
3 By Gary P. Scavone, 2001-2009.
4
5 v4.0.6: (3 June 2009)
6 - bug fix in ALSA code to set period size to power of two (thanks to Joakim Karrstrom)
7 - bug fix in OS-X for OS < 10.5 ... need preprocessor definition around new variable type (thanks to Tristan Matthews)
8
9 v4.0.5: (2 February 2009)
10 - added support in CoreAudio for arbitrary stream channel configurations
11 - added getStreamSampleRate() function because the actual sample rate can sometimes vary slightly from the specified one (thanks to Theo Veenker)
12 - added new StreamOptions flag "RTAUDIO_SCHEDULE_REALTIME" and attribute "priority" to StreamOptions (thanks to Theo Veenker)
13 - replaced usleep(50000) in callbackEvent() by a wait on condition variable which gets signaled in startStream() (thanks to Theo Veenker)
14 - fix for Jack API when user callback function signals stop or abort calls
15 - fix to way stream state is changed to avoid infinite loop problem
16 - fix to int<->float conversion in convertBuffer() (thanks to Theo Veenker)
17 - bug fix in byteSwapBuffer() (thanks to Stefan Muller Arisona and Theo Veenker)
18 - fixed a few gcc 4.4 errors in OS-X
19 - fixed bug in rtaudio-config script
20 - revised configure script and Makefile structures
21 - 64-bit fixes in ALSA API (thanks to Stefan Muller Arisona)
22 - fixed ASIO sample rate selection bug (thanks to Sasha Zheligovsky)
23
24 v4.0.4: (24 January 2008)
25 - added functionality to allow getDeviceInfo() to work in ALSA for an open device (like ASIO)
26 - fixes in configure script
27 - fixed clearing of error message stream in error()
28 - fixed RtAudio::DeviceInfo description in "probing" documentation
29 - memory leak fixes in ALSA and OSS
30 - Jack in/out port flag fix
31 - Windows changes for thread priority and GLOBALFOCUS
32
33 v4.0.3: (7 December 2007)
34 - added support for MinGW compiler to configure script
35 - a few MinGW-related changes to RtAudio.cpp
36 - renamed test program probe.cpp to audioprobe.cpp
37 - moved various header files into single "include" directory and updated VC++ project files
38
39 v4.0.2: (21 August 2007)
40 - fix to RtError::WARNING typo in RtAudio.h (RtApiDummy)
41 - removed "+1"s in RtApiCore c++ append when getting device name
42
43 v4.0.1: (13 August 2007)
44 - fix to RtError::WARNING typo in RtAudio.cpp
45
46 v4.0.0: (7 August 2007)
47 - new support for non-interleaved user data
48 - additional input/output parameter specifications, including channel offset
49 - new support for dynamic connection of devices
50 - new support for stream time
51 - revised callback arguments, including separate input and output buffer arguments
52 - revised C++ exception handling
53 - revised OSS support for version 4.0
54 - discontinued support of blocking functionality
55 - discontinued support of SGI
56 - Windows DirectSound API bug fix
57 - NetBSD support (using OSS API) by Emmanuel Dreyfus
58 - changed default pthread scheduling priority to SCHED_RR when defined in the system
59 - new getCompiledApi() static function
60 - new getCurrentApi(), getStreamTime(), getStreamLatency(), and isStreamRunning() functions
61 - modified RtAudioDeviceInfo structure to distinguish default input and output devices
62
63 v3.0.3: (18 November 2005)
64 - UNICODE fix for Windows DirectSound API
65 - MinGW compiler fix for ASIO API
66
67 v3.0.2: (14 October 2005)
68 - modification of ALSA read/write order to fix duplex under/overruns
69 - added synchronization of input/output devices for ALSA duplex operation
70 - cleaned up and improved error reporting throughout
71 - bug fix in Windows DirectSound support for 8-bit audio
72 - bug fix in Windows DirectSound support during device capture query
73 - added ASIOOutputReady() call near end of callbackEvent to fix some driver behavior
74 - added #include <stdio.h> to RtAudio.cpp
75 - fixed bug in RtApiCore for duplex operation with different I/O devices
76 - improvements to DirectX pointer chasing (by Robin Davies)
77 - backdoor RtDsStatistics hook provides DirectX performance information (by Robin Davies)
78 - bug fix for non-power-of-two Asio granularity used by Edirol PCR-A30 (by Robin Davies)
79 - auto-call CoInitialize for DSOUND and ASIO platforms (by Robin Davies)
80
81 v3.0.1: (22 March 2004)
82 - bug fix in Windows DirectSound support for cards with output only
83
84 v3.0: (11 March 2004)
85 - added Linux Jack audio server support
86 - new multi-api support by subclassing all apis and making rtaudio a controller class
87 - added over/underload check to Mac OS X support
88 - new scheme for blocking functionality in callback-based apis (CoreAudio, ASIO, and JACK)
89 - removed multiple stream support (all stream indentifier arguments removed)
90 - various style and name changes to conform with standard C++ practice
91
92 v2.1.1: (24 October 2002)
93 - bug fix in duplex for Mac OS X and Windows ASIO code
94 - duplex example change in tutorial 
95
96 v2.1: (7 October 2002)
97 - added Mac OS X CoreAudio support
98 - added Windows ASIO support
99 - API change to getDeviceInfo(): device argument must be an integer between 1 - getDeviceCount().
100 - "configure" support added for unix systems
101 - adopted MIT-like license
102 - various internal structural changes and bug fixes
103
104 v2.01: (27 April 2002)
105 - Windows destructor bug fix when no devices available
106 - RtAudioError class renamed to RtError
107 - Preprocessor definitions changed slightly (i.e. __LINUX_OSS_ to __LINUX_OSS__) to conform with new Synthesis ToolKit distribution
108
109 v2.0: (22 January 2002)
110 - first release of new independent class
111