You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

186 lines
9.2KB

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