@@ -21,7 +21,7 @@ endif | |||
ifeq ($(CARLA_RTAUDIO_SUPPORT),true) | |||
BUILD_CXX_FLAGS += -DHAVE_GETTIMEOFDAY | |||
BUILD_CXX_FLAGS += -Irtaudio-4.0.11 -Irtaudio-4.0.11/include -Irtmidi-2.0.1 | |||
BUILD_CXX_FLAGS += -Irtaudio-4.0.12 -Irtaudio-4.0.12/include -Irtmidi-2.0.1 | |||
ifeq ($(DEBUG),true) | |||
BUILD_CXX_FLAGS += -D__RTAUDIO_DEBUG__ -D__RTMIDI_DEBUG__ | |||
endif | |||
@@ -62,15 +62,15 @@ OBJS = \ | |||
ifeq ($(CARLA_RTAUDIO_SUPPORT),true) | |||
OBJS += \ | |||
rtaudio-4.0.11/RtAudio.cpp.o \ | |||
rtaudio-4.0.12/RtAudio.cpp.o \ | |||
rtmidi-2.0.1/RtMidi.cpp.o | |||
ifeq ($(WIN32),true) | |||
OBJS += \ | |||
rtaudio-4.0.11/include/asio.cpp.o \ | |||
rtaudio-4.0.11/include/asiodrivers.cpp.o \ | |||
rtaudio-4.0.11/include/asiolist.cpp.o \ | |||
rtaudio-4.0.11/include/iasiothiscallresolver.cpp.o | |||
rtaudio-4.0.12/include/asio.cpp.o \ | |||
rtaudio-4.0.12/include/asiodrivers.cpp.o \ | |||
rtaudio-4.0.12/include/asiolist.cpp.o \ | |||
rtaudio-4.0.12/include/iasiothiscallresolver.cpp.o | |||
endif | |||
endif | |||
@@ -1,148 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtAudio.h File Reference</h1><code>#include <string></code><br/> | |||
<code>#include <vector></code><br/> | |||
<code>#include "RtError.h"</code><br/> | |||
<code>#include <sstream></code><br/> | |||
<p><a href="RtAudio_8h_source.html">Go to the source code of this file.</a></p> | |||
<table border="0" cellpadding="0" cellspacing="0"> | |||
<tr><td colspan="2"><h2>Classes</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html">RtAudio</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Realtime audio i/o C++ classes. <a href="classRtAudio.html#_details">More...</a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The public device information structure for returning queried values. <a href="structRtAudio_1_1DeviceInfo.html#_details">More...</a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying input or ouput stream parameters. <a href="structRtAudio_1_1StreamParameters.html#_details">More...</a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying stream options. <a href="structRtAudio_1_1StreamOptions.html#_details">More...</a><br/></td></tr> | |||
<tr><td colspan="2"><h2>Typedefs</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">typedef unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> data format type. <a href="#aafca92882d25915560018873221e44b8"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">typedef unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream option flags. <a href="#a2c0f59b200dcec4d4e760f9166b29c41"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">typedef unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream status (over- or underflow) flags. <a href="#a80e306d363583da3b0a1b65d9b57c806"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a> )(void *outputBuffer, void *inputBuffer, unsigned int nFrames, double streamTime, <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a> status, void *userData)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> callback function prototype. <a href="#a112c7b7e25a974977f6fc094cef1a31f"></a><br/></td></tr> | |||
</table> | |||
<hr/><a name="_details"></a><h2>Detailed Description</h2> | |||
<hr/><h2>Typedef Documentation</h2> | |||
<a class="anchor" id="aafca92882d25915560018873221e44b8"></a><!-- doxytag: member="RtAudio.h::RtAudioFormat" ref="aafca92882d25915560018873221e44b8" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef unsigned long <a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> data format type. </p> | |||
<p>Support for signed integers and floats. Audio data fed to/from an <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream is assumed to ALWAYS be in host byte order. The internal routines will automatically take care of any necessary byte-swapping between the host format and the soundcard. Thus, endian-ness is not a concern in the following format definitions. Note that 24-bit data is expected to be encapsulated in a 32-bit format.</p> | |||
<ul> | |||
<li><em>RTAUDIO_SINT8:</em> 8-bit signed integer.</li> | |||
<li><em>RTAUDIO_SINT16:</em> 16-bit signed integer.</li> | |||
<li><em>RTAUDIO_SINT24:</em> Lower 3 bytes of 32-bit signed integer.</li> | |||
<li><em>RTAUDIO_SINT32:</em> 32-bit signed integer.</li> | |||
<li><em>RTAUDIO_FLOAT32:</em> Normalized between plus/minus 1.0.</li> | |||
<li><em>RTAUDIO_FLOAT64:</em> Normalized between plus/minus 1.0. </li> | |||
</ul> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a2c0f59b200dcec4d4e760f9166b29c41"></a><!-- doxytag: member="RtAudio.h::RtAudioStreamFlags" ref="a2c0f59b200dcec4d4e760f9166b29c41" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef unsigned long <a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream option flags. </p> | |||
<p>The following flags can be OR'ed together to allow a client to make changes to the default stream behavior:</p> | |||
<ul> | |||
<li><em>RTAUDIO_NONINTERLEAVED:</em> Use non-interleaved buffers (default = interleaved).</li> | |||
<li><em>RTAUDIO_MINIMIZE_LATENCY:</em> Attempt to set stream parameters for lowest possible latency.</li> | |||
<li><em>RTAUDIO_HOG_DEVICE:</em> Attempt grab device for exclusive use.</li> | |||
<li><em>RTAUDIO_ALSA_USE_DEFAULT:</em> Use the "default" PCM device (ALSA only).</li> | |||
</ul> | |||
<p>By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> streams pass and receive audio data from the client in an interleaved format. By passing the RTAUDIO_NONINTERLEAVED flag to the openStream() function, audio data will instead be presented in non-interleaved buffers. In this case, each buffer argument in the RtAudioCallback function will point to a single array of data, with <code>nFrames</code> samples for each channel concatenated back-to-back. For example, the first sample of data for the second channel would be located at index <code>nFrames</code> (assuming the <code>buffer</code> pointer was recast to the correct data type for the stream).</p> | |||
<p>Certain audio APIs offer a number of parameters that influence the I/O latency of a stream. By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to set these parameters internally for robust (glitch-free) performance (though some APIs, like Windows Direct Sound, make this difficult). By passing the RTAUDIO_MINIMIZE_LATENCY flag to the openStream() function, internal stream settings will be influenced in an attempt to minimize stream latency, though possibly at the expense of stream performance.</p> | |||
<p>If the RTAUDIO_HOG_DEVICE flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to open the input and/or output stream device(s) for exclusive use. Note that this is not possible with all supported audio APIs.</p> | |||
<p>If the RTAUDIO_SCHEDULE_REALTIME flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to select realtime scheduling (round-robin) for the callback thread.</p> | |||
<p>If the RTAUDIO_ALSA_USE_DEFAULT flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to open the "default" PCM device when using the ALSA API. Note that this will override any specified input or output device id. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a80e306d363583da3b0a1b65d9b57c806"></a><!-- doxytag: member="RtAudio.h::RtAudioStreamStatus" ref="a80e306d363583da3b0a1b65d9b57c806" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef unsigned long <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream status (over- or underflow) flags. </p> | |||
<p>Notification of a stream over- or underflow is indicated by a non-zero stream <code>status</code> argument in the RtAudioCallback function. The stream status can be one of the following two options, depending on whether the stream is open for output and/or input:</p> | |||
<ul> | |||
<li><em>RTAUDIO_INPUT_OVERFLOW:</em> Input data was discarded because of an overflow condition at the driver.</li> | |||
<li><em>RTAUDIO_OUTPUT_UNDERFLOW:</em> The output buffer ran low, likely producing a break in the output sound. </li> | |||
</ul> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a112c7b7e25a974977f6fc094cef1a31f"></a><!-- doxytag: member="RtAudio.h::RtAudioCallback" ref="a112c7b7e25a974977f6fc094cef1a31f" args=")(void *outputBuffer, void *inputBuffer, unsigned int nFrames, double streamTime, RtAudioStreamStatus status, void *userData)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef int(* <a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a>)(void *outputBuffer, void *inputBuffer, unsigned int nFrames, double streamTime, <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a> status, void *userData)</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> callback function prototype. </p> | |||
<p>All <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> clients must create a function of type RtAudioCallback to read and/or write data from/to the audio stream. When the underlying audio system is ready for new input or output data, this function will be invoked.</p> | |||
<dl><dt><b>Parameters:</b></dt><dd> | |||
<table border="0" cellspacing="2" cellpadding="0"> | |||
<tr><td valign="top"></td><td valign="top"><em>outputBuffer</em> </td><td>For output (or duplex) streams, the client should write <code>nFrames</code> of audio sample frames into this buffer. This argument should be recast to the datatype specified when the stream was opened. For input-only streams, this argument will be NULL.</td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>inputBuffer</em> </td><td>For input (or duplex) streams, this buffer will hold <code>nFrames</code> of input audio sample frames. This argument should be recast to the datatype specified when the stream was opened. For output-only streams, this argument will be NULL.</td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>nFrames</em> </td><td>The number of sample frames of input or output data in the buffers. The actual buffer size in bytes is dependent on the data type and number of channels in use.</td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>streamTime</em> </td><td>The number of seconds that have elapsed since the stream was started.</td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>If non-zero, this argument indicates a data overflow or underflow condition for the stream. The particular condition can be determined by comparison with the RtAudioStreamStatus flags.</td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>userData</em> </td><td>A pointer to optional data provided by the client when opening the stream (default = NULL).</td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
<p>To continue normal stream operation, the RtAudioCallback function should return a value of zero. To stop the stream and drain the output buffer, the function should return a value of one. To abort the stream immediately, the client should return a value of two. </p> | |||
</div> | |||
</div> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,677 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<h1>RtAudio.h</h1><a href="RtAudio_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/************************************************************************/</span> | |||
<a name="l00039"></a>00039 <span class="comment">/************************************************************************/</span> | |||
<a name="l00040"></a>00040 | |||
<a name="l00045"></a>00045 <span class="comment">// RtAudio: Version 4.0.11</span> | |||
<a name="l00046"></a>00046 | |||
<a name="l00047"></a>00047 <span class="preprocessor">#ifndef __RTAUDIO_H</span> | |||
<a name="l00048"></a>00048 <span class="preprocessor"></span><span class="preprocessor">#define __RTAUDIO_H</span> | |||
<a name="l00049"></a>00049 <span class="preprocessor"></span> | |||
<a name="l00050"></a>00050 <span class="preprocessor">#include <string></span> | |||
<a name="l00051"></a>00051 <span class="preprocessor">#include <vector></span> | |||
<a name="l00052"></a>00052 <span class="preprocessor">#include "RtError.h"</span> | |||
<a name="l00053"></a>00053 | |||
<a name="l00072"></a><a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">00072</a> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a>; | |||
<a name="l00073"></a>00073 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT8 = 0x1; <span class="comment">// 8-bit signed integer.</span> | |||
<a name="l00074"></a>00074 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT16 = 0x2; <span class="comment">// 16-bit signed integer.</span> | |||
<a name="l00075"></a>00075 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT24 = 0x4; <span class="comment">// Lower 3 bytes of 32-bit signed integer.</span> | |||
<a name="l00076"></a>00076 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT32 = 0x8; <span class="comment">// 32-bit signed integer.</span> | |||
<a name="l00077"></a>00077 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_FLOAT32 = 0x10; <span class="comment">// Normalized between plus/minus 1.0.</span> | |||
<a name="l00078"></a>00078 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_FLOAT64 = 0x20; <span class="comment">// Normalized between plus/minus 1.0.</span> | |||
<a name="l00079"></a>00079 | |||
<a name="l00122"></a><a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">00122</a> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a>; | |||
<a name="l00123"></a>00123 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_NONINTERLEAVED = 0x1; <span class="comment">// Use non-interleaved buffers (default = interleaved).</span> | |||
<a name="l00124"></a>00124 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_MINIMIZE_LATENCY = 0x2; <span class="comment">// Attempt to set stream parameters for lowest possible latency.</span> | |||
<a name="l00125"></a>00125 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_HOG_DEVICE = 0x4; <span class="comment">// Attempt grab device and prevent use by others.</span> | |||
<a name="l00126"></a>00126 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_SCHEDULE_REALTIME = 0x8; <span class="comment">// Try to select realtime scheduling for callback thread.</span> | |||
<a name="l00127"></a>00127 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_ALSA_USE_DEFAULT = 0x10; <span class="comment">// Use the "default" PCM device (ALSA only).</span> | |||
<a name="l00128"></a>00128 | |||
<a name="l00140"></a><a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">00140</a> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a>; | |||
<a name="l00141"></a>00141 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> RTAUDIO_INPUT_OVERFLOW = 0x1; <span class="comment">// Input data was discarded because of an overflow condition at the driver.</span> | |||
<a name="l00142"></a>00142 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> RTAUDIO_OUTPUT_UNDERFLOW = 0x2; <span class="comment">// The output buffer ran low, likely causing a gap in the output sound.</span> | |||
<a name="l00143"></a>00143 | |||
<a name="l00145"></a>00145 | |||
<a name="l00183"></a><a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">00183</a> <span class="keyword">typedef</span> int (*<a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f" title="RtAudio callback function prototype.">RtAudioCallback</a>)( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, | |||
<a name="l00184"></a>00184 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nFrames, | |||
<a name="l00185"></a>00185 <span class="keywordtype">double</span> streamTime, | |||
<a name="l00186"></a>00186 <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, | |||
<a name="l00187"></a>00187 <span class="keywordtype">void</span> *userData ); | |||
<a name="l00188"></a>00188 | |||
<a name="l00189"></a>00189 | |||
<a name="l00190"></a>00190 <span class="comment">// **************************************************************** //</span> | |||
<a name="l00191"></a>00191 <span class="comment">//</span> | |||
<a name="l00192"></a>00192 <span class="comment">// RtAudio class declaration.</span> | |||
<a name="l00193"></a>00193 <span class="comment">//</span> | |||
<a name="l00194"></a>00194 <span class="comment">// RtAudio is a "controller" used to select an available audio i/o</span> | |||
<a name="l00195"></a>00195 <span class="comment">// interface. It presents a common API for the user to call but all</span> | |||
<a name="l00196"></a>00196 <span class="comment">// functionality is implemented by the class RtApi and its</span> | |||
<a name="l00197"></a>00197 <span class="comment">// subclasses. RtAudio creates an instance of an RtApi subclass</span> | |||
<a name="l00198"></a>00198 <span class="comment">// based on the user's API choice. If no choice is made, RtAudio</span> | |||
<a name="l00199"></a>00199 <span class="comment">// attempts to make a "logical" API selection.</span> | |||
<a name="l00200"></a>00200 <span class="comment">//</span> | |||
<a name="l00201"></a>00201 <span class="comment">// **************************************************************** //</span> | |||
<a name="l00202"></a>00202 | |||
<a name="l00203"></a>00203 <span class="keyword">class </span>RtApi; | |||
<a name="l00204"></a>00204 | |||
<a name="l00205"></a><a class="code" href="classRtAudio.html">00205</a> <span class="keyword">class </span><a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> | |||
<a name="l00206"></a>00206 { | |||
<a name="l00207"></a>00207 <span class="keyword">public</span>: | |||
<a name="l00208"></a>00208 | |||
<a name="l00210"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">00210</a> <span class="keyword">enum</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">Api</a> { | |||
<a name="l00211"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">00211</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a>, | |||
<a name="l00212"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">00212</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">LINUX_ALSA</a>, | |||
<a name="l00213"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">00213</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">LINUX_PULSE</a>, | |||
<a name="l00214"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">00214</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">LINUX_OSS</a>, | |||
<a name="l00215"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">00215</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">UNIX_JACK</a>, | |||
<a name="l00216"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">00216</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">MACOSX_CORE</a>, | |||
<a name="l00217"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">00217</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">WINDOWS_ASIO</a>, | |||
<a name="l00218"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">00218</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">WINDOWS_DS</a>, | |||
<a name="l00219"></a><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">00219</a> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RTAUDIO_DUMMY</a> | |||
<a name="l00220"></a>00220 }; | |||
<a name="l00221"></a>00221 | |||
<a name="l00223"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html">00223</a> <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">DeviceInfo</a> { | |||
<a name="l00224"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">00224</a> <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a>; | |||
<a name="l00225"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">00225</a> std::string <a class="code" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a>; | |||
<a name="l00226"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">00226</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a>; | |||
<a name="l00227"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">00227</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a>; | |||
<a name="l00228"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">00228</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a>; | |||
<a name="l00229"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">00229</a> <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a>; | |||
<a name="l00230"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">00230</a> <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a>; | |||
<a name="l00231"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">00231</a> std::vector<unsigned int> <a class="code" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a>; | |||
<a name="l00232"></a><a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">00232</a> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a>; | |||
<a name="l00234"></a>00234 <span class="comment">// Default constructor.</span> | |||
<a name="l00235"></a>00235 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">DeviceInfo</a>() | |||
<a name="l00236"></a>00236 :<a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a>(false), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a>(0), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a>(0), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a>(0), | |||
<a name="l00237"></a>00237 <a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a>(false), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a>(false), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a>(0) {} | |||
<a name="l00238"></a>00238 }; | |||
<a name="l00239"></a>00239 | |||
<a name="l00241"></a><a class="code" href="structRtAudio_1_1StreamParameters.html">00241</a> <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">StreamParameters</a> { | |||
<a name="l00242"></a><a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">00242</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a>; | |||
<a name="l00243"></a><a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">00243</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a>; | |||
<a name="l00244"></a><a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">00244</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a>; | |||
<a name="l00246"></a>00246 <span class="comment">// Default constructor.</span> | |||
<a name="l00247"></a>00247 <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">StreamParameters</a>() | |||
<a name="l00248"></a>00248 : <a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a>(0), <a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a>(0), <a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a>(0) {} | |||
<a name="l00249"></a>00249 }; | |||
<a name="l00250"></a>00250 | |||
<a name="l00252"></a>00252 | |||
<a name="l00308"></a><a class="code" href="structRtAudio_1_1StreamOptions.html">00308</a> <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">StreamOptions</a> { | |||
<a name="l00309"></a><a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">00309</a> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> <a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a>; | |||
<a name="l00310"></a><a class="code" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">00310</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a>; | |||
<a name="l00311"></a><a class="code" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">00311</a> std::string <a class="code" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">streamName</a>; | |||
<a name="l00312"></a><a class="code" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">00312</a> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a>; | |||
<a name="l00314"></a>00314 <span class="comment">// Default constructor.</span> | |||
<a name="l00315"></a>00315 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">StreamOptions</a>() | |||
<a name="l00316"></a>00316 : <a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a>(0), <a class="code" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a>(0), <a class="code" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a>(0) {} | |||
<a name="l00317"></a>00317 }; | |||
<a name="l00318"></a>00318 | |||
<a name="l00320"></a>00320 | |||
<a name="l00325"></a>00325 <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26" title="A static function to determine the available compiled audio APIs.">getCompiledApi</a>( std::vector<RtAudio::Api> &apis ) <span class="keywordflow">throw</span>(); | |||
<a name="l00326"></a>00326 | |||
<a name="l00328"></a>00328 | |||
<a name="l00336"></a>00336 <a class="code" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9" title="The class constructor.">RtAudio</a>( <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> api=<a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a> ) throw(); | |||
<a name="l00337"></a>00337 | |||
<a name="l00339"></a>00339 | |||
<a name="l00343"></a>00343 ~<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>() throw(); | |||
<a name="l00344"></a>00344 | |||
<a name="l00346"></a>00346 <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::<a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) throw(); | |||
<a name="l00347"></a>00347 | |||
<a name="l00349"></a>00349 | |||
<a name="l00354"></a>00354 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> ) throw(); | |||
<a name="l00355"></a>00355 | |||
<a name="l00357"></a>00357 | |||
<a name="l00367"></a>00367 <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::DeviceInfo <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00368"></a>00368 | |||
<a name="l00370"></a>00370 | |||
<a name="l00377"></a>00377 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>( <span class="keywordtype">void</span> ) throw(); | |||
<a name="l00378"></a>00378 | |||
<a name="l00380"></a>00380 | |||
<a name="l00387"></a>00387 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>( <span class="keywordtype">void</span> ) throw(); | |||
<a name="l00388"></a>00388 | |||
<a name="l00390"></a>00390 | |||
<a name="l00427"></a>00427 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream</a>( <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::StreamParameters *outputParameters, | |||
<a name="l00428"></a>00428 <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::StreamParameters *inputParameters, | |||
<a name="l00429"></a>00429 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00430"></a>00430 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferFrames, <a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f" title="RtAudio callback function prototype.">RtAudioCallback</a> callback, | |||
<a name="l00431"></a>00431 <span class="keywordtype">void</span> *userData = NULL, <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::StreamOptions *options = NULL ); | |||
<a name="l00432"></a>00432 | |||
<a name="l00434"></a>00434 | |||
<a name="l00438"></a>00438 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> ) throw(); | |||
<a name="l00439"></a>00439 | |||
<a name="l00441"></a>00441 | |||
<a name="l00447"></a>00447 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00448"></a>00448 | |||
<a name="l00450"></a>00450 | |||
<a name="l00456"></a>00456 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00457"></a>00457 | |||
<a name="l00459"></a>00459 | |||
<a name="l00465"></a>00465 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00466"></a>00466 | |||
<a name="l00468"></a>00468 <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>( <span class="keywordtype">void</span> ) const throw(); | |||
<a name="l00469"></a>00469 | |||
<a name="l00471"></a>00471 <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea" title="Returns true if the stream is running and false if it is stopped or not open.">isStreamRunning</a>( <span class="keywordtype">void</span> ) const throw(); | |||
<a name="l00472"></a>00472 | |||
<a name="l00474"></a>00474 | |||
<a name="l00477"></a>00477 <span class="keywordtype">double</span> <a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca" title="Returns the number of elapsed seconds since the stream was started.">getStreamTime</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00478"></a>00478 | |||
<a name="l00480"></a>00480 | |||
<a name="l00488"></a>00488 <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00489"></a>00489 | |||
<a name="l00491"></a>00491 | |||
<a name="l00496"></a>00496 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5" title="Returns actual sample rate in use by the stream.">getStreamSampleRate</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00497"></a>00497 | |||
<a name="l00499"></a>00499 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">showWarnings</a>( <span class="keywordtype">bool</span> value = true ) throw(); | |||
<a name="l00500"></a>00500 | |||
<a name="l00501"></a>00501 protected: | |||
<a name="l00502"></a>00502 | |||
<a name="l00503"></a>00503 <span class="keywordtype">void</span> openRtApi( <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::<a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">Api</a> api ); | |||
<a name="l00504"></a>00504 RtApi *rtapi_; | |||
<a name="l00505"></a>00505 }; | |||
<a name="l00506"></a>00506 | |||
<a name="l00507"></a>00507 <span class="comment">// Operating system dependent thread functionality.</span> | |||
<a name="l00508"></a>00508 <span class="preprocessor">#if defined(__WINDOWS_DS__) || defined(__WINDOWS_ASIO__)</span> | |||
<a name="l00509"></a>00509 <span class="preprocessor"></span><span class="preprocessor"> #include <windows.h></span> | |||
<a name="l00510"></a>00510 <span class="preprocessor"> #include <process.h></span> | |||
<a name="l00511"></a>00511 | |||
<a name="l00512"></a>00512 <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> ThreadHandle; | |||
<a name="l00513"></a>00513 <span class="keyword">typedef</span> CRITICAL_SECTION StreamMutex; | |||
<a name="l00514"></a>00514 | |||
<a name="l00515"></a>00515 <span class="preprocessor">#elif defined(__LINUX_ALSA__) || defined(__LINUX_PULSE__) || defined(__UNIX_JACK__) || defined(__LINUX_OSS__) || defined(__MACOSX_CORE__)</span> | |||
<a name="l00516"></a>00516 <span class="preprocessor"></span> <span class="comment">// Using pthread library for various flavors of unix.</span> | |||
<a name="l00517"></a>00517 <span class="preprocessor"> #include <pthread.h></span> | |||
<a name="l00518"></a>00518 | |||
<a name="l00519"></a>00519 <span class="keyword">typedef</span> pthread_t ThreadHandle; | |||
<a name="l00520"></a>00520 <span class="keyword">typedef</span> pthread_mutex_t StreamMutex; | |||
<a name="l00521"></a>00521 | |||
<a name="l00522"></a>00522 <span class="preprocessor">#else // Setup for "dummy" behavior</span> | |||
<a name="l00523"></a>00523 <span class="preprocessor"></span> | |||
<a name="l00524"></a>00524 <span class="preprocessor"> #define __RTAUDIO_DUMMY__</span> | |||
<a name="l00525"></a>00525 <span class="preprocessor"></span> <span class="keyword">typedef</span> <span class="keywordtype">int</span> ThreadHandle; | |||
<a name="l00526"></a>00526 <span class="keyword">typedef</span> <span class="keywordtype">int</span> StreamMutex; | |||
<a name="l00527"></a>00527 | |||
<a name="l00528"></a>00528 <span class="preprocessor">#endif</span> | |||
<a name="l00529"></a>00529 <span class="preprocessor"></span> | |||
<a name="l00530"></a>00530 <span class="comment">// This global structure type is used to pass callback information</span> | |||
<a name="l00531"></a>00531 <span class="comment">// between the private RtAudio stream structure and global callback</span> | |||
<a name="l00532"></a>00532 <span class="comment">// handling functions.</span> | |||
<a name="l00533"></a>00533 <span class="keyword">struct </span>CallbackInfo { | |||
<a name="l00534"></a>00534 <span class="keywordtype">void</span> *object; <span class="comment">// Used as a "this" pointer.</span> | |||
<a name="l00535"></a>00535 ThreadHandle thread; | |||
<a name="l00536"></a>00536 <span class="keywordtype">void</span> *callback; | |||
<a name="l00537"></a>00537 <span class="keywordtype">void</span> *userData; | |||
<a name="l00538"></a>00538 <span class="keywordtype">void</span> *apiInfo; <span class="comment">// void pointer for API specific callback information</span> | |||
<a name="l00539"></a>00539 <span class="keywordtype">bool</span> isRunning; | |||
<a name="l00540"></a>00540 | |||
<a name="l00541"></a>00541 <span class="comment">// Default constructor.</span> | |||
<a name="l00542"></a>00542 CallbackInfo() | |||
<a name="l00543"></a>00543 :object(0), callback(0), userData(0), apiInfo(0), isRunning(false) {} | |||
<a name="l00544"></a>00544 }; | |||
<a name="l00545"></a>00545 | |||
<a name="l00546"></a>00546 <span class="comment">// **************************************************************** //</span> | |||
<a name="l00547"></a>00547 <span class="comment">//</span> | |||
<a name="l00548"></a>00548 <span class="comment">// RtApi class declaration.</span> | |||
<a name="l00549"></a>00549 <span class="comment">//</span> | |||
<a name="l00550"></a>00550 <span class="comment">// Subclasses of RtApi contain all API- and OS-specific code necessary</span> | |||
<a name="l00551"></a>00551 <span class="comment">// to fully implement the RtAudio API.</span> | |||
<a name="l00552"></a>00552 <span class="comment">//</span> | |||
<a name="l00553"></a>00553 <span class="comment">// Note that RtApi is an abstract base class and cannot be</span> | |||
<a name="l00554"></a>00554 <span class="comment">// explicitly instantiated. The class RtAudio will create an</span> | |||
<a name="l00555"></a>00555 <span class="comment">// instance of an RtApi subclass (RtApiOss, RtApiAlsa,</span> | |||
<a name="l00556"></a>00556 <span class="comment">// RtApiJack, RtApiCore, RtApiDs, or RtApiAsio).</span> | |||
<a name="l00557"></a>00557 <span class="comment">//</span> | |||
<a name="l00558"></a>00558 <span class="comment">// **************************************************************** //</span> | |||
<a name="l00559"></a>00559 | |||
<a name="l00560"></a>00560 <span class="preprocessor">#if defined( HAVE_GETTIMEOFDAY )</span> | |||
<a name="l00561"></a>00561 <span class="preprocessor"></span><span class="preprocessor"> #include <sys/time.h></span> | |||
<a name="l00562"></a>00562 <span class="preprocessor">#endif</span> | |||
<a name="l00563"></a>00563 <span class="preprocessor"></span> | |||
<a name="l00564"></a>00564 <span class="preprocessor">#include <sstream></span> | |||
<a name="l00565"></a>00565 | |||
<a name="l00566"></a>00566 <span class="keyword">class </span>RtApi | |||
<a name="l00567"></a>00567 { | |||
<a name="l00568"></a>00568 <span class="keyword">public</span>: | |||
<a name="l00569"></a>00569 | |||
<a name="l00570"></a>00570 RtApi(); | |||
<a name="l00571"></a>00571 <span class="keyword">virtual</span> ~RtApi(); | |||
<a name="l00572"></a>00572 <span class="keyword">virtual</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) = 0; | |||
<a name="l00573"></a>00573 <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> ) = 0; | |||
<a name="l00574"></a>00574 <span class="keyword">virtual</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ) = 0; | |||
<a name="l00575"></a>00575 <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00576"></a>00576 <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00577"></a>00577 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream</a>( <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> *outputParameters, | |||
<a name="l00578"></a>00578 <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> *inputParameters, | |||
<a name="l00579"></a>00579 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00580"></a>00580 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferFrames, <a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f" title="RtAudio callback function prototype.">RtAudioCallback</a> callback, | |||
<a name="l00581"></a>00581 <span class="keywordtype">void</span> *userData, <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00582"></a>00582 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00583"></a>00583 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> ) = 0; | |||
<a name="l00584"></a>00584 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> ) = 0; | |||
<a name="l00585"></a>00585 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> ) = 0; | |||
<a name="l00586"></a>00586 <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00587"></a>00587 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5" title="Returns actual sample rate in use by the stream.">getStreamSampleRate</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00588"></a>00588 <span class="keyword">virtual</span> <span class="keywordtype">double</span> <a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca" title="Returns the number of elapsed seconds since the stream was started.">getStreamTime</a>( <span class="keywordtype">void</span> ); | |||
<a name="l00589"></a>00589 <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>( <span class="keywordtype">void</span> )<span class="keyword"> const </span>{ <span class="keywordflow">return</span> stream_.state != STREAM_CLOSED; }; | |||
<a name="l00590"></a>00590 <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea" title="Returns true if the stream is running and false if it is stopped or not open.">isStreamRunning</a>( <span class="keywordtype">void</span> )<span class="keyword"> const </span>{ <span class="keywordflow">return</span> stream_.state == STREAM_RUNNING; }; | |||
<a name="l00591"></a>00591 <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">showWarnings</a>( <span class="keywordtype">bool</span> value ) { showWarnings_ = value; }; | |||
<a name="l00592"></a>00592 | |||
<a name="l00593"></a>00593 | |||
<a name="l00594"></a>00594 <span class="keyword">protected</span>: | |||
<a name="l00595"></a>00595 | |||
<a name="l00596"></a>00596 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> MAX_SAMPLE_RATES; | |||
<a name="l00597"></a>00597 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> SAMPLE_RATES[]; | |||
<a name="l00598"></a>00598 | |||
<a name="l00599"></a>00599 <span class="keyword">enum</span> { FAILURE, SUCCESS }; | |||
<a name="l00600"></a>00600 | |||
<a name="l00601"></a>00601 <span class="keyword">enum</span> StreamState { | |||
<a name="l00602"></a>00602 STREAM_STOPPED, | |||
<a name="l00603"></a>00603 STREAM_STOPPING, | |||
<a name="l00604"></a>00604 STREAM_RUNNING, | |||
<a name="l00605"></a>00605 STREAM_CLOSED = -50 | |||
<a name="l00606"></a>00606 }; | |||
<a name="l00607"></a>00607 | |||
<a name="l00608"></a>00608 <span class="keyword">enum</span> StreamMode { | |||
<a name="l00609"></a>00609 OUTPUT, | |||
<a name="l00610"></a>00610 INPUT, | |||
<a name="l00611"></a>00611 DUPLEX, | |||
<a name="l00612"></a>00612 UNINITIALIZED = -75 | |||
<a name="l00613"></a>00613 }; | |||
<a name="l00614"></a>00614 | |||
<a name="l00615"></a>00615 <span class="comment">// A protected structure used for buffer conversion.</span> | |||
<a name="l00616"></a>00616 <span class="keyword">struct </span>ConvertInfo { | |||
<a name="l00617"></a>00617 <span class="keywordtype">int</span> channels; | |||
<a name="l00618"></a>00618 <span class="keywordtype">int</span> inJump, outJump; | |||
<a name="l00619"></a>00619 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> inFormat, outFormat; | |||
<a name="l00620"></a>00620 std::vector<int> inOffset; | |||
<a name="l00621"></a>00621 std::vector<int> outOffset; | |||
<a name="l00622"></a>00622 }; | |||
<a name="l00623"></a>00623 | |||
<a name="l00624"></a>00624 <span class="comment">// A protected structure for audio streams.</span> | |||
<a name="l00625"></a>00625 <span class="keyword">struct </span>RtApiStream { | |||
<a name="l00626"></a>00626 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00627"></a>00627 <span class="keywordtype">void</span> *apiHandle; <span class="comment">// void pointer for API specific stream handle information</span> | |||
<a name="l00628"></a>00628 StreamMode mode; <span class="comment">// OUTPUT, INPUT, or DUPLEX.</span> | |||
<a name="l00629"></a>00629 StreamState state; <span class="comment">// STOPPED, RUNNING, or CLOSED</span> | |||
<a name="l00630"></a>00630 <span class="keywordtype">char</span> *userBuffer[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00631"></a>00631 <span class="keywordtype">char</span> *deviceBuffer; | |||
<a name="l00632"></a>00632 <span class="keywordtype">bool</span> doConvertBuffer[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00633"></a>00633 <span class="keywordtype">bool</span> userInterleaved; | |||
<a name="l00634"></a>00634 <span class="keywordtype">bool</span> deviceInterleaved[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00635"></a>00635 <span class="keywordtype">bool</span> doByteSwap[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00636"></a>00636 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate; | |||
<a name="l00637"></a>00637 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferSize; | |||
<a name="l00638"></a>00638 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBuffers; | |||
<a name="l00639"></a>00639 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nUserChannels[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00640"></a>00640 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nDeviceChannels[2]; <span class="comment">// Playback and record channels, respectively.</span> | |||
<a name="l00641"></a>00641 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channelOffset[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00642"></a>00642 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> latency[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00643"></a>00643 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> userFormat; | |||
<a name="l00644"></a>00644 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> deviceFormat[2]; <span class="comment">// Playback and record, respectively.</span> | |||
<a name="l00645"></a>00645 StreamMutex mutex; | |||
<a name="l00646"></a>00646 CallbackInfo callbackInfo; | |||
<a name="l00647"></a>00647 ConvertInfo convertInfo[2]; | |||
<a name="l00648"></a>00648 <span class="keywordtype">double</span> streamTime; <span class="comment">// Number of elapsed seconds since the stream started.</span> | |||
<a name="l00649"></a>00649 | |||
<a name="l00650"></a>00650 <span class="preprocessor">#if defined(HAVE_GETTIMEOFDAY)</span> | |||
<a name="l00651"></a>00651 <span class="preprocessor"></span> <span class="keyword">struct </span>timeval lastTickTimestamp; | |||
<a name="l00652"></a>00652 <span class="preprocessor">#endif</span> | |||
<a name="l00653"></a>00653 <span class="preprocessor"></span> | |||
<a name="l00654"></a>00654 RtApiStream() | |||
<a name="l00655"></a>00655 :apiHandle(0), deviceBuffer(0) { device[0] = 11111; device[1] = 11111; } | |||
<a name="l00656"></a>00656 }; | |||
<a name="l00657"></a>00657 | |||
<a name="l00658"></a>00658 <span class="keyword">typedef</span> <span class="keywordtype">signed</span> <span class="keywordtype">short</span> Int16; | |||
<a name="l00659"></a>00659 <span class="keyword">typedef</span> <span class="keywordtype">signed</span> <span class="keywordtype">int</span> Int32; | |||
<a name="l00660"></a>00660 <span class="keyword">typedef</span> <span class="keywordtype">float</span> Float32; | |||
<a name="l00661"></a>00661 <span class="keyword">typedef</span> <span class="keywordtype">double</span> Float64; | |||
<a name="l00662"></a>00662 | |||
<a name="l00663"></a>00663 std::ostringstream errorStream_; | |||
<a name="l00664"></a>00664 std::string errorText_; | |||
<a name="l00665"></a>00665 <span class="keywordtype">bool</span> showWarnings_; | |||
<a name="l00666"></a>00666 RtApiStream stream_; | |||
<a name="l00667"></a>00667 | |||
<a name="l00675"></a>00675 <span class="keyword">virtual</span> <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00676"></a>00676 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00677"></a>00677 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00678"></a>00678 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00679"></a>00679 | |||
<a name="l00681"></a>00681 <span class="keywordtype">void</span> tickStreamTime( <span class="keywordtype">void</span> ); | |||
<a name="l00682"></a>00682 | |||
<a name="l00684"></a>00684 <span class="keywordtype">void</span> clearStreamInfo(); | |||
<a name="l00685"></a>00685 | |||
<a name="l00690"></a>00690 <span class="keywordtype">void</span> verifyStream( <span class="keywordtype">void</span> ); | |||
<a name="l00691"></a>00691 | |||
<a name="l00693"></a>00693 <span class="keywordtype">void</span> error( <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">RtError::Type</a> type ); | |||
<a name="l00694"></a>00694 | |||
<a name="l00699"></a>00699 <span class="keywordtype">void</span> convertBuffer( <span class="keywordtype">char</span> *outBuffer, <span class="keywordtype">char</span> *inBuffer, ConvertInfo &info ); | |||
<a name="l00700"></a>00700 | |||
<a name="l00702"></a>00702 <span class="keywordtype">void</span> byteSwapBuffer( <span class="keywordtype">char</span> *buffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> samples, <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format ); | |||
<a name="l00703"></a>00703 | |||
<a name="l00705"></a>00705 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> formatBytes( <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format ); | |||
<a name="l00706"></a>00706 | |||
<a name="l00708"></a>00708 <span class="keywordtype">void</span> setConvertInfo( StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel ); | |||
<a name="l00709"></a>00709 }; | |||
<a name="l00710"></a>00710 | |||
<a name="l00711"></a>00711 <span class="comment">// **************************************************************** //</span> | |||
<a name="l00712"></a>00712 <span class="comment">//</span> | |||
<a name="l00713"></a>00713 <span class="comment">// Inline RtAudio definitions.</span> | |||
<a name="l00714"></a>00714 <span class="comment">//</span> | |||
<a name="l00715"></a>00715 <span class="comment">// **************************************************************** //</span> | |||
<a name="l00716"></a>00716 | |||
<a name="l00717"></a><a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246">00717</a> <span class="keyword">inline</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">RtAudio :: getCurrentApi</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getCurrentApi(); } | |||
<a name="l00718"></a><a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a">00718</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">RtAudio :: getDeviceCount</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getDeviceCount(); } | |||
<a name="l00719"></a><a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8">00719</a> <span class="keyword">inline</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">RtAudio :: getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ) { <span class="keywordflow">return</span> rtapi_->getDeviceInfo( device ); } | |||
<a name="l00720"></a><a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce">00720</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">RtAudio :: getDefaultInputDevice</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getDefaultInputDevice(); } | |||
<a name="l00721"></a><a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc">00721</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">RtAudio :: getDefaultOutputDevice</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getDefaultOutputDevice(); } | |||
<a name="l00722"></a><a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a">00722</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">RtAudio :: closeStream</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->closeStream(); } | |||
<a name="l00723"></a><a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80">00723</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">RtAudio :: startStream</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->startStream(); } | |||
<a name="l00724"></a><a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd">00724</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio :: stopStream</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->stopStream(); } | |||
<a name="l00725"></a><a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">00725</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">RtAudio :: abortStream</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->abortStream(); } | |||
<a name="l00726"></a><a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f">00726</a> <span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">RtAudio :: isStreamOpen</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> rtapi_->isStreamOpen(); } | |||
<a name="l00727"></a><a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea">00727</a> <span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea" title="Returns true if the stream is running and false if it is stopped or not open.">RtAudio :: isStreamRunning</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> rtapi_->isStreamRunning(); } | |||
<a name="l00728"></a><a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3">00728</a> <span class="keyword">inline</span> <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">RtAudio :: getStreamLatency</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->getStreamLatency(); } | |||
<a name="l00729"></a><a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5">00729</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5" title="Returns actual sample rate in use by the stream.">RtAudio :: getStreamSampleRate</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->getStreamSampleRate(); }; | |||
<a name="l00730"></a><a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca">00730</a> <span class="keyword">inline</span> <span class="keywordtype">double</span> <a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca" title="Returns the number of elapsed seconds since the stream was started.">RtAudio :: getStreamTime</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->getStreamTime(); } | |||
<a name="l00731"></a><a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77">00731</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">RtAudio :: showWarnings</a>( <span class="keywordtype">bool</span> value ) <span class="keywordflow">throw</span>() { rtapi_->showWarnings( value ); } | |||
<a name="l00732"></a>00732 | |||
<a name="l00733"></a>00733 <span class="comment">// RtApi Subclass prototypes.</span> | |||
<a name="l00734"></a>00734 | |||
<a name="l00735"></a>00735 <span class="preprocessor">#if defined(__MACOSX_CORE__)</span> | |||
<a name="l00736"></a>00736 <span class="preprocessor"></span> | |||
<a name="l00737"></a>00737 <span class="preprocessor">#include <CoreAudio/AudioHardware.h></span> | |||
<a name="l00738"></a>00738 | |||
<a name="l00739"></a>00739 <span class="keyword">class </span>RtApiCore: <span class="keyword">public</span> RtApi | |||
<a name="l00740"></a>00740 { | |||
<a name="l00741"></a>00741 <span class="keyword">public</span>: | |||
<a name="l00742"></a>00742 | |||
<a name="l00743"></a>00743 RtApiCore(); | |||
<a name="l00744"></a>00744 ~RtApiCore(); | |||
<a name="l00745"></a>00745 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">RtAudio::MACOSX_CORE</a>; }; | |||
<a name="l00746"></a>00746 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00747"></a>00747 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00748"></a>00748 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDefaultOutputDevice( <span class="keywordtype">void</span> ); | |||
<a name="l00749"></a>00749 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDefaultInputDevice( <span class="keywordtype">void</span> ); | |||
<a name="l00750"></a>00750 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00751"></a>00751 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00752"></a>00752 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00753"></a>00753 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00754"></a>00754 <span class="keywordtype">long</span> getStreamLatency( <span class="keywordtype">void</span> ); | |||
<a name="l00755"></a>00755 | |||
<a name="l00756"></a>00756 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00757"></a>00757 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00758"></a>00758 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00759"></a>00759 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00760"></a>00760 <span class="keywordtype">bool</span> callbackEvent( AudioDeviceID deviceId, | |||
<a name="l00761"></a>00761 <span class="keyword">const</span> AudioBufferList *inBufferList, | |||
<a name="l00762"></a>00762 <span class="keyword">const</span> AudioBufferList *outBufferList ); | |||
<a name="l00763"></a>00763 | |||
<a name="l00764"></a>00764 <span class="keyword">private</span>: | |||
<a name="l00765"></a>00765 | |||
<a name="l00766"></a>00766 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00767"></a>00767 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00768"></a>00768 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00769"></a>00769 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00770"></a>00770 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* getErrorCode( OSStatus code ); | |||
<a name="l00771"></a>00771 }; | |||
<a name="l00772"></a>00772 | |||
<a name="l00773"></a>00773 <span class="preprocessor">#endif</span> | |||
<a name="l00774"></a>00774 <span class="preprocessor"></span> | |||
<a name="l00775"></a>00775 <span class="preprocessor">#if defined(__UNIX_JACK__)</span> | |||
<a name="l00776"></a>00776 <span class="preprocessor"></span> | |||
<a name="l00777"></a>00777 <span class="keyword">class </span>RtApiJack: <span class="keyword">public</span> RtApi | |||
<a name="l00778"></a>00778 { | |||
<a name="l00779"></a>00779 <span class="keyword">public</span>: | |||
<a name="l00780"></a>00780 | |||
<a name="l00781"></a>00781 RtApiJack(); | |||
<a name="l00782"></a>00782 ~RtApiJack(); | |||
<a name="l00783"></a>00783 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">RtAudio::UNIX_JACK</a>; }; | |||
<a name="l00784"></a>00784 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00785"></a>00785 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00786"></a>00786 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00787"></a>00787 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00788"></a>00788 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00789"></a>00789 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00790"></a>00790 <span class="keywordtype">long</span> getStreamLatency( <span class="keywordtype">void</span> ); | |||
<a name="l00791"></a>00791 | |||
<a name="l00792"></a>00792 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00793"></a>00793 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00794"></a>00794 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00795"></a>00795 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00796"></a>00796 <span class="keywordtype">bool</span> callbackEvent( <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> nframes ); | |||
<a name="l00797"></a>00797 | |||
<a name="l00798"></a>00798 <span class="keyword">private</span>: | |||
<a name="l00799"></a>00799 | |||
<a name="l00800"></a>00800 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00801"></a>00801 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00802"></a>00802 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00803"></a>00803 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00804"></a>00804 }; | |||
<a name="l00805"></a>00805 | |||
<a name="l00806"></a>00806 <span class="preprocessor">#endif</span> | |||
<a name="l00807"></a>00807 <span class="preprocessor"></span> | |||
<a name="l00808"></a>00808 <span class="preprocessor">#if defined(__WINDOWS_ASIO__)</span> | |||
<a name="l00809"></a>00809 <span class="preprocessor"></span> | |||
<a name="l00810"></a>00810 <span class="keyword">class </span>RtApiAsio: <span class="keyword">public</span> RtApi | |||
<a name="l00811"></a>00811 { | |||
<a name="l00812"></a>00812 <span class="keyword">public</span>: | |||
<a name="l00813"></a>00813 | |||
<a name="l00814"></a>00814 RtApiAsio(); | |||
<a name="l00815"></a>00815 ~RtApiAsio(); | |||
<a name="l00816"></a>00816 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">RtAudio::WINDOWS_ASIO</a>; }; | |||
<a name="l00817"></a>00817 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00818"></a>00818 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00819"></a>00819 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00820"></a>00820 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00821"></a>00821 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00822"></a>00822 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00823"></a>00823 <span class="keywordtype">long</span> getStreamLatency( <span class="keywordtype">void</span> ); | |||
<a name="l00824"></a>00824 | |||
<a name="l00825"></a>00825 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00826"></a>00826 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00827"></a>00827 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00828"></a>00828 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00829"></a>00829 <span class="keywordtype">bool</span> callbackEvent( <span class="keywordtype">long</span> bufferIndex ); | |||
<a name="l00830"></a>00830 | |||
<a name="l00831"></a>00831 <span class="keyword">private</span>: | |||
<a name="l00832"></a>00832 | |||
<a name="l00833"></a>00833 std::vector<RtAudio::DeviceInfo> devices_; | |||
<a name="l00834"></a>00834 <span class="keywordtype">void</span> saveDeviceInfo( <span class="keywordtype">void</span> ); | |||
<a name="l00835"></a>00835 <span class="keywordtype">bool</span> coInitialized_; | |||
<a name="l00836"></a>00836 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00837"></a>00837 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00838"></a>00838 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00839"></a>00839 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00840"></a>00840 }; | |||
<a name="l00841"></a>00841 | |||
<a name="l00842"></a>00842 <span class="preprocessor">#endif</span> | |||
<a name="l00843"></a>00843 <span class="preprocessor"></span> | |||
<a name="l00844"></a>00844 <span class="preprocessor">#if defined(__WINDOWS_DS__)</span> | |||
<a name="l00845"></a>00845 <span class="preprocessor"></span> | |||
<a name="l00846"></a>00846 <span class="keyword">class </span>RtApiDs: <span class="keyword">public</span> RtApi | |||
<a name="l00847"></a>00847 { | |||
<a name="l00848"></a>00848 <span class="keyword">public</span>: | |||
<a name="l00849"></a>00849 | |||
<a name="l00850"></a>00850 RtApiDs(); | |||
<a name="l00851"></a>00851 ~RtApiDs(); | |||
<a name="l00852"></a>00852 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">RtAudio::WINDOWS_DS</a>; }; | |||
<a name="l00853"></a>00853 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00854"></a>00854 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDefaultOutputDevice( <span class="keywordtype">void</span> ); | |||
<a name="l00855"></a>00855 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDefaultInputDevice( <span class="keywordtype">void</span> ); | |||
<a name="l00856"></a>00856 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00857"></a>00857 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00858"></a>00858 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00859"></a>00859 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00860"></a>00860 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00861"></a>00861 <span class="keywordtype">long</span> getStreamLatency( <span class="keywordtype">void</span> ); | |||
<a name="l00862"></a>00862 | |||
<a name="l00863"></a>00863 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00864"></a>00864 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00865"></a>00865 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00866"></a>00866 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00867"></a>00867 <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> ); | |||
<a name="l00868"></a>00868 | |||
<a name="l00869"></a>00869 <span class="keyword">private</span>: | |||
<a name="l00870"></a>00870 | |||
<a name="l00871"></a>00871 <span class="keywordtype">bool</span> coInitialized_; | |||
<a name="l00872"></a>00872 <span class="keywordtype">bool</span> buffersRolling; | |||
<a name="l00873"></a>00873 <span class="keywordtype">long</span> duplexPrerollBytes; | |||
<a name="l00874"></a>00874 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00875"></a>00875 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00876"></a>00876 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00877"></a>00877 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00878"></a>00878 }; | |||
<a name="l00879"></a>00879 | |||
<a name="l00880"></a>00880 <span class="preprocessor">#endif</span> | |||
<a name="l00881"></a>00881 <span class="preprocessor"></span> | |||
<a name="l00882"></a>00882 <span class="preprocessor">#if defined(__LINUX_ALSA__)</span> | |||
<a name="l00883"></a>00883 <span class="preprocessor"></span> | |||
<a name="l00884"></a>00884 <span class="keyword">class </span>RtApiAlsa: <span class="keyword">public</span> RtApi | |||
<a name="l00885"></a>00885 { | |||
<a name="l00886"></a>00886 <span class="keyword">public</span>: | |||
<a name="l00887"></a>00887 | |||
<a name="l00888"></a>00888 RtApiAlsa(); | |||
<a name="l00889"></a>00889 ~RtApiAlsa(); | |||
<a name="l00890"></a>00890 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi() { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">RtAudio::LINUX_ALSA</a>; }; | |||
<a name="l00891"></a>00891 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00892"></a>00892 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00893"></a>00893 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00894"></a>00894 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00895"></a>00895 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00896"></a>00896 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00897"></a>00897 | |||
<a name="l00898"></a>00898 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00899"></a>00899 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00900"></a>00900 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00901"></a>00901 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00902"></a>00902 <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> ); | |||
<a name="l00903"></a>00903 | |||
<a name="l00904"></a>00904 <span class="keyword">private</span>: | |||
<a name="l00905"></a>00905 | |||
<a name="l00906"></a>00906 std::vector<RtAudio::DeviceInfo> devices_; | |||
<a name="l00907"></a>00907 <span class="keywordtype">void</span> saveDeviceInfo( <span class="keywordtype">void</span> ); | |||
<a name="l00908"></a>00908 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00909"></a>00909 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00910"></a>00910 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00911"></a>00911 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00912"></a>00912 }; | |||
<a name="l00913"></a>00913 | |||
<a name="l00914"></a>00914 <span class="preprocessor">#endif</span> | |||
<a name="l00915"></a>00915 <span class="preprocessor"></span> | |||
<a name="l00916"></a>00916 <span class="preprocessor">#if defined(__LINUX_PULSE__)</span> | |||
<a name="l00917"></a>00917 <span class="preprocessor"></span> | |||
<a name="l00918"></a>00918 <span class="keyword">class </span>RtApiPulse: <span class="keyword">public</span> RtApi | |||
<a name="l00919"></a>00919 { | |||
<a name="l00920"></a>00920 <span class="keyword">public</span>: | |||
<a name="l00921"></a>00921 ~RtApiPulse(); | |||
<a name="l00922"></a>00922 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi() { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">RtAudio::LINUX_PULSE</a>; }; | |||
<a name="l00923"></a>00923 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00924"></a>00924 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00925"></a>00925 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00926"></a>00926 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00927"></a>00927 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00928"></a>00928 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00929"></a>00929 | |||
<a name="l00930"></a>00930 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00931"></a>00931 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00932"></a>00932 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00933"></a>00933 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00934"></a>00934 <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> ); | |||
<a name="l00935"></a>00935 | |||
<a name="l00936"></a>00936 <span class="keyword">private</span>: | |||
<a name="l00937"></a>00937 | |||
<a name="l00938"></a>00938 std::vector<RtAudio::DeviceInfo> devices_; | |||
<a name="l00939"></a>00939 <span class="keywordtype">void</span> saveDeviceInfo( <span class="keywordtype">void</span> ); | |||
<a name="l00940"></a>00940 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00941"></a>00941 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00942"></a>00942 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00943"></a>00943 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00944"></a>00944 }; | |||
<a name="l00945"></a>00945 | |||
<a name="l00946"></a>00946 <span class="preprocessor">#endif</span> | |||
<a name="l00947"></a>00947 <span class="preprocessor"></span> | |||
<a name="l00948"></a>00948 | |||
<a name="l00949"></a>00949 <span class="preprocessor">#if defined(__LINUX_OSS__)</span> | |||
<a name="l00950"></a>00950 <span class="preprocessor"></span> | |||
<a name="l00951"></a>00951 <span class="keyword">class </span>RtApiOss: <span class="keyword">public</span> RtApi | |||
<a name="l00952"></a>00952 { | |||
<a name="l00953"></a>00953 <span class="keyword">public</span>: | |||
<a name="l00954"></a>00954 | |||
<a name="l00955"></a>00955 RtApiOss(); | |||
<a name="l00956"></a>00956 ~RtApiOss(); | |||
<a name="l00957"></a>00957 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi() { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">RtAudio::LINUX_OSS</a>; }; | |||
<a name="l00958"></a>00958 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ); | |||
<a name="l00959"></a>00959 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ); | |||
<a name="l00960"></a>00960 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ); | |||
<a name="l00961"></a>00961 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ); | |||
<a name="l00962"></a>00962 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ); | |||
<a name="l00963"></a>00963 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ); | |||
<a name="l00964"></a>00964 | |||
<a name="l00965"></a>00965 <span class="comment">// This function is intended for internal use only. It must be</span> | |||
<a name="l00966"></a>00966 <span class="comment">// public because it is called by the internal callback handler,</span> | |||
<a name="l00967"></a>00967 <span class="comment">// which is not a member of RtAudio. External use of this function</span> | |||
<a name="l00968"></a>00968 <span class="comment">// will most likely produce highly undesireable results!</span> | |||
<a name="l00969"></a>00969 <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> ); | |||
<a name="l00970"></a>00970 | |||
<a name="l00971"></a>00971 <span class="keyword">private</span>: | |||
<a name="l00972"></a>00972 | |||
<a name="l00973"></a>00973 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00974"></a>00974 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l00975"></a>00975 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l00976"></a>00976 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ); | |||
<a name="l00977"></a>00977 }; | |||
<a name="l00978"></a>00978 | |||
<a name="l00979"></a>00979 <span class="preprocessor">#endif</span> | |||
<a name="l00980"></a>00980 <span class="preprocessor"></span> | |||
<a name="l00981"></a>00981 <span class="preprocessor">#if defined(__RTAUDIO_DUMMY__)</span> | |||
<a name="l00982"></a>00982 <span class="preprocessor"></span> | |||
<a name="l00983"></a>00983 <span class="keyword">class </span>RtApiDummy: <span class="keyword">public</span> RtApi | |||
<a name="l00984"></a>00984 { | |||
<a name="l00985"></a>00985 <span class="keyword">public</span>: | |||
<a name="l00986"></a>00986 | |||
<a name="l00987"></a>00987 RtApiDummy() { errorText_ = <span class="stringliteral">"RtApiDummy: This class provides no functionality."</span>; error( <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">RtError::WARNING</a> ); }; | |||
<a name="l00988"></a>00988 <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> getCurrentApi( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RtAudio::RTAUDIO_DUMMY</a>; }; | |||
<a name="l00989"></a>00989 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> getDeviceCount( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> 0; }; | |||
<a name="l00990"></a>00990 <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> getDeviceInfo( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ) { <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> info; <span class="keywordflow">return</span> info; }; | |||
<a name="l00991"></a>00991 <span class="keywordtype">void</span> closeStream( <span class="keywordtype">void</span> ) {}; | |||
<a name="l00992"></a>00992 <span class="keywordtype">void</span> startStream( <span class="keywordtype">void</span> ) {}; | |||
<a name="l00993"></a>00993 <span class="keywordtype">void</span> stopStream( <span class="keywordtype">void</span> ) {}; | |||
<a name="l00994"></a>00994 <span class="keywordtype">void</span> abortStream( <span class="keywordtype">void</span> ) {}; | |||
<a name="l00995"></a>00995 | |||
<a name="l00996"></a>00996 <span class="keyword">private</span>: | |||
<a name="l00997"></a>00997 | |||
<a name="l00998"></a>00998 <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, | |||
<a name="l00999"></a>00999 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate, | |||
<a name="l01000"></a>01000 <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize, | |||
<a name="l01001"></a>01001 <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options ) { <span class="keywordflow">return</span> <span class="keyword">false</span>; }; | |||
<a name="l01002"></a>01002 }; | |||
<a name="l01003"></a>01003 | |||
<a name="l01004"></a>01004 <span class="preprocessor">#endif</span> | |||
<a name="l01005"></a>01005 <span class="preprocessor"></span> | |||
<a name="l01006"></a>01006 <span class="preprocessor">#endif</span> | |||
<a name="l01007"></a>01007 <span class="preprocessor"></span> | |||
<a name="l01008"></a>01008 <span class="comment">// Indentation settings for Vim and Emacs</span> | |||
<a name="l01009"></a>01009 <span class="comment">//</span> | |||
<a name="l01010"></a>01010 <span class="comment">// Local Variables:</span> | |||
<a name="l01011"></a>01011 <span class="comment">// c-basic-offset: 2</span> | |||
<a name="l01012"></a>01012 <span class="comment">// indent-tabs-mode: nil</span> | |||
<a name="l01013"></a>01013 <span class="comment">// End:</span> | |||
<a name="l01014"></a>01014 <span class="comment">//</span> | |||
<a name="l01015"></a>01015 <span class="comment">// vim: et sts=2 sw=2</span> | |||
</pre></div></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,65 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<h1>RtError.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/************************************************************************/</span> | |||
<a name="l00010"></a>00010 <span class="comment">/************************************************************************/</span> | |||
<a name="l00011"></a>00011 | |||
<a name="l00012"></a>00012 <span class="preprocessor">#ifndef RTERROR_H</span> | |||
<a name="l00013"></a>00013 <span class="preprocessor"></span><span class="preprocessor">#define RTERROR_H</span> | |||
<a name="l00014"></a>00014 <span class="preprocessor"></span> | |||
<a name="l00015"></a>00015 <span class="preprocessor">#include <exception></span> | |||
<a name="l00016"></a>00016 <span class="preprocessor">#include <iostream></span> | |||
<a name="l00017"></a>00017 <span class="preprocessor">#include <string></span> | |||
<a name="l00018"></a>00018 | |||
<a name="l00019"></a><a class="code" href="classRtError.html">00019</a> <span class="keyword">class </span><a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a> : <span class="keyword">public</span> std::exception | |||
<a name="l00020"></a>00020 { | |||
<a name="l00021"></a>00021 <span class="keyword">public</span>: | |||
<a name="l00023"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">00023</a> <span class="keyword">enum</span> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a> { | |||
<a name="l00024"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">00024</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">WARNING</a>, | |||
<a name="l00025"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">00025</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">DEBUG_WARNING</a>, | |||
<a name="l00026"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">00026</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">UNSPECIFIED</a>, | |||
<a name="l00027"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">00027</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">NO_DEVICES_FOUND</a>, | |||
<a name="l00028"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">00028</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">INVALID_DEVICE</a>, | |||
<a name="l00029"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">00029</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">MEMORY_ERROR</a>, | |||
<a name="l00030"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">00030</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">INVALID_PARAMETER</a>, | |||
<a name="l00031"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">00031</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">INVALID_USE</a>, | |||
<a name="l00032"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">00032</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">DRIVER_ERROR</a>, | |||
<a name="l00033"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">00033</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">SYSTEM_ERROR</a>, | |||
<a name="l00034"></a><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">00034</a> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">THREAD_ERROR</a> | |||
<a name="l00035"></a>00035 }; | |||
<a name="l00036"></a>00036 | |||
<a name="l00038"></a><a class="code" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37">00038</a> <a class="code" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37" title="The constructor.">RtError</a>( <span class="keyword">const</span> std::string& message, <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a> type = <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">RtError::UNSPECIFIED</a> ) throw() : message_(message), type_(type) {} | |||
<a name="l00039"></a>00039 | |||
<a name="l00041"></a><a class="code" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">00041</a> <span class="keyword">virtual</span> <a class="code" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c" title="The destructor.">~RtError</a>( <span class="keywordtype">void</span> ) throw() {} | |||
<a name="l00042"></a>00042 | |||
<a name="l00044"></a><a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">00044</a> <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { std::cerr << <span class="charliteral">'\n'</span> << message_ << <span class="stringliteral">"\n\n"</span>; } | |||
<a name="l00045"></a>00045 | |||
<a name="l00047"></a><a class="code" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">00047</a> <span class="keyword">virtual</span> <span class="keyword">const</span> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a>& <a class="code" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7" title="Returns the thrown error message type.">getType</a>(<span class="keywordtype">void</span>) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> type_; } | |||
<a name="l00048"></a>00048 | |||
<a name="l00050"></a><a class="code" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50">00050</a> <span class="keyword">virtual</span> <span class="keyword">const</span> std::string& <a class="code" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50" title="Returns the thrown error message string.">getMessage</a>(<span class="keywordtype">void</span>) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> message_; } | |||
<a name="l00051"></a>00051 | |||
<a name="l00053"></a><a class="code" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d">00053</a> <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d" title="Returns the thrown error message as a c-style string.">what</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> message_.c_str(); } | |||
<a name="l00054"></a>00054 | |||
<a name="l00055"></a>00055 <span class="keyword">protected</span>: | |||
<a name="l00056"></a>00056 std::string message_; | |||
<a name="l00057"></a>00057 <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a> type_; | |||
<a name="l00058"></a>00058 }; | |||
<a name="l00059"></a>00059 | |||
<a name="l00060"></a>00060 <span class="preprocessor">#endif</span> | |||
</pre></div></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,28 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>Class List</h1>Here are the classes, structs, unions and interfaces with brief descriptions:<table> | |||
<tr><td class="indexkey"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="indexvalue">The public device information structure for returning queried values </td></tr> | |||
<tr><td class="indexkey"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="indexvalue">Realtime audio i/o C++ classes </td></tr> | |||
<tr><td class="indexkey"><a class="el" href="classRtError.html">RtError</a></td><td class="indexvalue">Exception handling class for <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> & RtMidi </td></tr> | |||
<tr><td class="indexkey"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td class="indexvalue">The structure for specifying stream options </td></tr> | |||
<tr><td class="indexkey"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a></td><td class="indexvalue">The structure for specifying input or ouput stream parameters </td></tr> | |||
</table> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,51 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtAudio Member List</h1>This is the complete list of members for <a class="el" href="classRtAudio.html">RtAudio</a>, including all inherited members.<table> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">abortStream</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">Api</a> enum name</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a">closeStream</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26">getCompiledApi</a>(std::vector< RtAudio::Api > &apis)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [static]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246">getCurrentApi</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce">getDefaultInputDevice</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc">getDefaultOutputDevice</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a">getDeviceCount</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8">getDeviceInfo</a>(unsigned int device)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3">getStreamLatency</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5">getStreamSampleRate</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca">getStreamTime</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f">isStreamOpen</a>(void) const </td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea">isStreamRunning</a>(void) const </td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">LINUX_ALSA</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">LINUX_OSS</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">LINUX_PULSE</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">MACOSX_CORE</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8">openStream</a>(RtAudio::StreamParameters *outputParameters, RtAudio::StreamParameters *inputParameters, RtAudioFormat format, unsigned int sampleRate, unsigned int *bufferFrames, RtAudioCallback callback, void *userData=NULL, RtAudio::StreamOptions *options=NULL)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9">RtAudio</a>(RtAudio::Api api=UNSPECIFIED)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RTAUDIO_DUMMY</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77">showWarnings</a>(bool value=true)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80">startStream</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd">stopStream</a>(void)</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">UNIX_JACK</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">WINDOWS_ASIO</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">WINDOWS_DS</a> enum value</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtAudio.html#aa8a9716fd64680657ef69c9465442a2f">~RtAudio</a>()</td><td><a class="el" href="classRtAudio.html">RtAudio</a></td><td></td></tr> | |||
</table></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,534 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtAudio Class Reference</h1><!-- doxytag: class="RtAudio" --> | |||
<p>Realtime audio i/o C++ classes. | |||
<a href="#_details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtAudio_8h_source.html">RtAudio.h</a>></code></p> | |||
<p><a href="classRtAudio-members.html">List of all members.</a></p> | |||
<table border="0" cellpadding="0" cellspacing="0"> | |||
<tr><td colspan="2"><h2>Classes</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html">DeviceInfo</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The public device information structure for returning queried values. <a href="structRtAudio_1_1DeviceInfo.html#_details">More...</a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html">StreamOptions</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying stream options. <a href="structRtAudio_1_1StreamOptions.html#_details">More...</a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html">StreamParameters</a></td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying input or ouput stream parameters. <a href="structRtAudio_1_1StreamParameters.html#_details">More...</a><br/></td></tr> | |||
<tr><td colspan="2"><h2>Public Types</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">Api</a> { <br/> | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">LINUX_ALSA</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">LINUX_PULSE</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">LINUX_OSS</a>, | |||
<br/> | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">UNIX_JACK</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">MACOSX_CORE</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">WINDOWS_ASIO</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">WINDOWS_DS</a>, | |||
<br/> | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RTAUDIO_DUMMY</a> | |||
<br/> | |||
}</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Audio API specifier arguments. </p> | |||
<a href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">More...</a><br/></td></tr> | |||
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9">RtAudio</a> (<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> api=UNSPECIFIED) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The class constructor. <a href="#afd0bfa26deae9804e18faff59d0273d9"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#aa8a9716fd64680657ef69c9465442a2f">~RtAudio</a> () throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <a href="#aa8a9716fd64680657ef69c9465442a2f"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a83687634795792b2c47e4ae1cf8a5246"></a><!-- doxytag: member="RtAudio::getCurrentApi" ref="a83687634795792b2c47e4ae1cf8a5246" args="(void)" --> | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246">getCurrentApi</a> (void) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the audio API specifier for the current instance of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a">getDeviceCount</a> (void) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A public function that queries for the number of audio devices available. <a href="#a747ce2d73803641bbb66d6e78092aa1a"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8">getDeviceInfo</a> (unsigned int device)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return an <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure for a specified device number. <a href="#a02d7ff44ad1d7eae22283a052f3dfda8"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc">getDefaultOutputDevice</a> (void) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A function that returns the index of the default output device. <a href="#a3a3f3dbe13ea696b521e49cdaaa357bc"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce">getDefaultInputDevice</a> (void) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A function that returns the index of the default input device. <a href="#aad8b94edd3cd379ee300b125750ac6ce"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8">openStream</a> (<a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> *outputParameters, <a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> *inputParameters, <a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> format, unsigned int sampleRate, unsigned int *bufferFrames, <a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a> callback, void *userData=NULL, <a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a> *options=NULL)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A public function for opening a stream with the specified parameters. <a href="#afacc99740fa4c5606fb35467cdea6da8"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a">closeStream</a> (void) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A function that closes a stream and frees any associated stream memory. <a href="#a90d599002ad32cf250a4cb866f2cc93a"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80">startStream</a> (void)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A function that starts a stream. <a href="#aec017a89629ccef66a90b60be22a2f80"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd">stopStream</a> (void)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Stop a stream, allowing any samples remaining in the output queue to be played. <a href="#af4c241ff86936ecc8108f0d9dfe3efdd"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">abortStream</a> (void)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Stop a stream, discarding any samples remaining in the input/output queue. <a href="#ad0586b47cd6bb9591a80b4052815991f"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3863e45ff81dbe97176de0ee7545917f"></a><!-- doxytag: member="RtAudio::isStreamOpen" ref="a3863e45ff81dbe97176de0ee7545917f" args="(void) const " --> | |||
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f">isStreamOpen</a> (void) const throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if a stream is open and false if not. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a84cc8d9b7ab9bc5f37bcf48430ec5aea"></a><!-- doxytag: member="RtAudio::isStreamRunning" ref="a84cc8d9b7ab9bc5f37bcf48430ec5aea" args="(void) const " --> | |||
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea">isStreamRunning</a> (void) const throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the stream is running and false if it is stopped or not open. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca">getStreamTime</a> (void)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of elapsed seconds since the stream was started. <a href="#a344e59a62353c5791db4621b985cb2ca"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3">getStreamLatency</a> (void)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the internal stream latency in sample frames. <a href="#a843c989d9f501c71bc2f2c5ca18df9f3"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5">getStreamSampleRate</a> (void)</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns actual sample rate in use by the stream. <a href="#a28214b8b05d60b45c24ee6fae7b2a0b5"></a><br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af0752ee51cce3dd90a3bd009f9fdbe77"></a><!-- doxytag: member="RtAudio::showWarnings" ref="af0752ee51cce3dd90a3bd009f9fdbe77" args="(bool value=true)" --> | |||
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77">showWarnings</a> (bool value=true) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Specify whether warning messages should be printed to stderr. <br/></td></tr> | |||
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26">getCompiledApi</a> (std::vector< <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> > &apis) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">A static function to determine the available compiled audio APIs. <a href="#ae266ffad2ef428d0b2c6c262d391ce26"></a><br/></td></tr> | |||
</table> | |||
<hr/><a name="_details"></a><h2>Detailed Description</h2> | |||
<p>Realtime audio i/o C++ classes. </p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> provides a common API (Application Programming Interface) 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.</p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> WWW site: <a href="http://www.music.mcgill.ca/~gary/rtaudio/">http://www.music.mcgill.ca/~gary/rtaudio/</a></p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>: realtime audio i/o C++ classes Copyright (c) 2001-2012 Gary P. Scavone</p> | |||
<p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p> | |||
<p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p> | |||
<p>Any person wishing to distribute modifications to the Software is asked to send the modifications to the original developer so that they can be incorporated into the canonical version. This is, however, not a binding provision of this license.</p> | |||
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. </p> | |||
<hr/><h2>Member Enumeration Documentation</h2> | |||
<a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849"></a><!-- doxytag: member="RtAudio::Api" ref="ac9b6f625da88249d08a8409a9db0d849" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">enum <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Audio API specifier arguments. </p> | |||
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0"> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae"></a><!-- doxytag: member="UNSPECIFIED" ref="ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae" args="" -->UNSPECIFIED</em> </td><td> | |||
<p>Search for a working compiled API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8"></a><!-- doxytag: member="LINUX_ALSA" ref="ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8" args="" -->LINUX_ALSA</em> </td><td> | |||
<p>The Advanced Linux Sound Architecture API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77"></a><!-- doxytag: member="LINUX_PULSE" ref="ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77" args="" -->LINUX_PULSE</em> </td><td> | |||
<p>The Linux PulseAudio API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82"></a><!-- doxytag: member="LINUX_OSS" ref="ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82" args="" -->LINUX_OSS</em> </td><td> | |||
<p>The Linux Open Sound System API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105"></a><!-- doxytag: member="UNIX_JACK" ref="ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105" args="" -->UNIX_JACK</em> </td><td> | |||
<p>The Jack Low-Latency Audio Server API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d"></a><!-- doxytag: member="MACOSX_CORE" ref="ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d" args="" -->MACOSX_CORE</em> </td><td> | |||
<p>Macintosh OS-X Core Audio API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469"></a><!-- doxytag: member="WINDOWS_ASIO" ref="ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469" args="" -->WINDOWS_ASIO</em> </td><td> | |||
<p>The Steinberg Audio Stream I/O API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931"></a><!-- doxytag: member="WINDOWS_DS" ref="ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931" args="" -->WINDOWS_DS</em> </td><td> | |||
<p>The Microsoft Direct Sound API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1"></a><!-- doxytag: member="RTAUDIO_DUMMY" ref="ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1" args="" -->RTAUDIO_DUMMY</em> </td><td> | |||
<p>A compilable but non-functional API. </p> | |||
</td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
<hr/><h2>Constructor & Destructor Documentation</h2> | |||
<a class="anchor" id="afd0bfa26deae9804e18faff59d0273d9"></a><!-- doxytag: member="RtAudio::RtAudio" ref="afd0bfa26deae9804e18faff59d0273d9" args="(RtAudio::Api api=UNSPECIFIED)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">RtAudio::RtAudio </td> | |||
<td>(</td> | |||
<td class="paramtype"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> </td> | |||
<td class="paramname"> <em>api</em> = <code>UNSPECIFIED</code></td> | |||
<td> ) </td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>The class constructor. </p> | |||
<p>The constructor performs minor initialization tasks. No exceptions can be thrown.</p> | |||
<p>If no API argument is specified and multiple API support has been compiled, the default order of use is JACK, ALSA, OSS (Linux systems) and ASIO, DS (Windows systems). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="aa8a9716fd64680657ef69c9465442a2f"></a><!-- doxytag: member="RtAudio::~RtAudio" ref="aa8a9716fd64680657ef69c9465442a2f" args="()" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">RtAudio::~RtAudio </td> | |||
<td>(</td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>The destructor. </p> | |||
<p>If a stream is running or open, it will be stopped and closed automatically. </p> | |||
</div> | |||
</div> | |||
<hr/><h2>Member Function Documentation</h2> | |||
<a class="anchor" id="ae266ffad2ef428d0b2c6c262d391ce26"></a><!-- doxytag: member="RtAudio::getCompiledApi" ref="ae266ffad2ef428d0b2c6c262d391ce26" args="(std::vector< RtAudio::Api > &apis)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">static void RtAudio::getCompiledApi </td> | |||
<td>(</td> | |||
<td class="paramtype">std::vector< <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> > & </td> | |||
<td class="paramname"> <em>apis</em></td> | |||
<td> ) </td> | |||
<td> throw ()<code> [static]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A static function to determine the available compiled audio APIs. </p> | |||
<p>The values returned in the std::vector can be compared against the enumerated list values. Note that there can be more than one API compiled for certain operating systems. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a747ce2d73803641bbb66d6e78092aa1a"></a><!-- doxytag: member="RtAudio::getDeviceCount" ref="a747ce2d73803641bbb66d6e78092aa1a" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getDeviceCount </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td> throw ()<code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A public function that queries for the number of audio devices available. </p> | |||
<p>This function performs a system query of available devices each time it is called, thus supporting devices connected <em>after</em> instantiation. If a system error occurs during processing, a warning will be issued. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a02d7ff44ad1d7eae22283a052f3dfda8"></a><!-- doxytag: member="RtAudio::getDeviceInfo" ref="a02d7ff44ad1d7eae22283a052f3dfda8" args="(unsigned int device)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a> RtAudio::getDeviceInfo </td> | |||
<td>(</td> | |||
<td class="paramtype">unsigned int </td> | |||
<td class="paramname"> <em>device</em></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Return an <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure for a specified device number. </p> | |||
<p>Any device integer between 0 and <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1 is valid. If an invalid argument is provided, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. If a device is busy or otherwise unavailable, the structure member "probed" will have a value of "false" and all other members are undefined. If the specified device is the current default input or output device, the corresponding "isDefault" member will have a value of "true". </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a3a3f3dbe13ea696b521e49cdaaa357bc"></a><!-- doxytag: member="RtAudio::getDefaultOutputDevice" ref="a3a3f3dbe13ea696b521e49cdaaa357bc" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getDefaultOutputDevice </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td> throw ()<code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A function that returns the index of the default output device. </p> | |||
<p>If the underlying audio API does not provide a "default | |||
device", or if no devices are available, the return value will be 0. Note that this is a valid device identifier and it is the client's responsibility to verify that a device is available before attempting to open a stream. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="aad8b94edd3cd379ee300b125750ac6ce"></a><!-- doxytag: member="RtAudio::getDefaultInputDevice" ref="aad8b94edd3cd379ee300b125750ac6ce" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getDefaultInputDevice </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td> throw ()<code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A function that returns the index of the default input device. </p> | |||
<p>If the underlying audio API does not provide a "default | |||
device", or if no devices are available, the return value will be 0. Note that this is a valid device identifier and it is the client's responsibility to verify that a device is available before attempting to open a stream. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="afacc99740fa4c5606fb35467cdea6da8"></a><!-- doxytag: member="RtAudio::openStream" ref="afacc99740fa4c5606fb35467cdea6da8" args="(RtAudio::StreamParameters *outputParameters, RtAudio::StreamParameters *inputParameters, RtAudioFormat format, unsigned int sampleRate, unsigned int *bufferFrames, RtAudioCallback callback, void *userData=NULL, RtAudio::StreamOptions *options=NULL)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::openStream </td> | |||
<td>(</td> | |||
<td class="paramtype"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> * </td> | |||
<td class="paramname"> <em>outputParameters</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> * </td> | |||
<td class="paramname"> <em>inputParameters</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> </td> | |||
<td class="paramname"> <em>format</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype">unsigned int </td> | |||
<td class="paramname"> <em>sampleRate</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype">unsigned int * </td> | |||
<td class="paramname"> <em>bufferFrames</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a> </td> | |||
<td class="paramname"> <em>callback</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype">void * </td> | |||
<td class="paramname"> <em>userData</em> = <code>NULL</code>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a> * </td> | |||
<td class="paramname"> <em>options</em> = <code>NULL</code></td><td> </td> | |||
</tr> | |||
<tr> | |||
<td></td> | |||
<td>)</td> | |||
<td></td><td></td><td></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A public function for opening a stream with the specified parameters. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if a stream cannot be opened with the specified parameters or an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if any invalid device ID or channel number parameters are specified.</p> | |||
<dl><dt><b>Parameters:</b></dt><dd> | |||
<table border="0" cellspacing="2" cellpadding="0"> | |||
<tr><td valign="top"></td><td valign="top"><em>outputParameters</em> </td><td>Specifies output stream parameters to use when opening a stream, including a device ID, number of channels, and starting channel number. For input-only streams, this argument should be NULL. The device ID is an index value between 0 and <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1. </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>inputParameters</em> </td><td>Specifies input stream parameters to use when opening a stream, including a device ID, number of channels, and starting channel number. For output-only streams, this argument should be NULL. The device ID is an index value between 0 and <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1. </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>format</em> </td><td>An RtAudioFormat specifying the desired sample data format. </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>sampleRate</em> </td><td>The desired sample rate (sample frames per second). </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>*bufferFrames</em> </td><td>A pointer to a value indicating the desired internal buffer size in sample frames. The actual value used by the device is returned via the same pointer. A value of zero can be specified, in which case the lowest allowable value is determined. </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>callback</em> </td><td>A client-defined function that will be invoked when input data is available and/or output data is needed. </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>userData</em> </td><td>An optional pointer to data that can be accessed from within the callback function. </td></tr> | |||
<tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>An optional pointer to a structure containing various global stream options, including a list of OR'ed RtAudioStreamFlags and a suggested number of stream buffers that can be used to control stream latency. More buffers typically result in more robust performance, though at a cost of greater latency. If a value of zero is specified, a system-specific median value is chosen. If the RTAUDIO_MINIMIZE_LATENCY flag bit is set, the lowest allowable value is used. The actual value used is returned via the structure argument. The parameter is API dependent. </td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a90d599002ad32cf250a4cb866f2cc93a"></a><!-- doxytag: member="RtAudio::closeStream" ref="a90d599002ad32cf250a4cb866f2cc93a" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::closeStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td> throw ()<code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A function that closes a stream and frees any associated stream memory. </p> | |||
<p>If a stream is not open, this function issues a warning and returns (no exception is thrown). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="aec017a89629ccef66a90b60be22a2f80"></a><!-- doxytag: member="RtAudio::startStream" ref="aec017a89629ccef66a90b60be22a2f80" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::startStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>A function that starts a stream. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if a stream is not open. A warning is issued if the stream is already running. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="af4c241ff86936ecc8108f0d9dfe3efdd"></a><!-- doxytag: member="RtAudio::stopStream" ref="af4c241ff86936ecc8108f0d9dfe3efdd" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::stopStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Stop a stream, allowing any samples remaining in the output queue to be played. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if a stream is not open. A warning is issued if the stream is already stopped. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="ad0586b47cd6bb9591a80b4052815991f"></a><!-- doxytag: member="RtAudio::abortStream" ref="ad0586b47cd6bb9591a80b4052815991f" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::abortStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Stop a stream, discarding any samples remaining in the input/output queue. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if a stream is not open. A warning is issued if the stream is already stopped. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a344e59a62353c5791db4621b985cb2ca"></a><!-- doxytag: member="RtAudio::getStreamTime" ref="a344e59a62353c5791db4621b985cb2ca" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">double RtAudio::getStreamTime </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Returns the number of elapsed seconds since the stream was started. </p> | |||
<p>If a stream is not open, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a843c989d9f501c71bc2f2c5ca18df9f3"></a><!-- doxytag: member="RtAudio::getStreamLatency" ref="a843c989d9f501c71bc2f2c5ca18df9f3" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">long RtAudio::getStreamLatency </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Returns the internal stream latency in sample frames. </p> | |||
<p>The stream latency refers to delay in audio input and/or output caused by internal buffering by the audio system and/or hardware. For duplex streams, the returned value will represent the sum of the input and output latencies. If a stream is not open, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. If the API does not report latency, the return value will be zero. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a28214b8b05d60b45c24ee6fae7b2a0b5"></a><!-- doxytag: member="RtAudio::getStreamSampleRate" ref="a28214b8b05d60b45c24ee6fae7b2a0b5" args="(void)" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getStreamSampleRate </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td> | |||
<td> ) </td> | |||
<td><code> [inline]</code></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Returns actual sample rate in use by the stream. </p> | |||
<p>On some systems, the sample rate used may be slightly different than that specified in the stream parameters. If a stream is not open, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. </p> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this class was generated from the following file:<ul> | |||
<li><a class="el" href="RtAudio_8h_source.html">RtAudio.h</a></li> | |||
</ul> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,40 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtError Member List</h1>This is the complete list of members for <a class="el" href="classRtError.html">RtError</a>, including all inherited members.<table> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">DEBUG_WARNING</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">DRIVER_ERROR</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50">getMessage</a>(void) const </td><td><a class="el" href="classRtError.html">RtError</a></td><td><code> [inline, virtual]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">getType</a>(void) const </td><td><a class="el" href="classRtError.html">RtError</a></td><td><code> [inline, virtual]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">INVALID_DEVICE</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">INVALID_PARAMETER</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">INVALID_USE</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">MEMORY_ERROR</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">NO_DEVICES_FOUND</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">printMessage</a>(void) const </td><td><a class="el" href="classRtError.html">RtError</a></td><td><code> [inline, virtual]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37">RtError</a>(const std::string &message, Type type=RtError::UNSPECIFIED)</td><td><a class="el" href="classRtError.html">RtError</a></td><td><code> [inline]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">SYSTEM_ERROR</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">THREAD_ERROR</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> enum name</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">UNSPECIFIED</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">WARNING</a> enum value</td><td><a class="el" href="classRtError.html">RtError</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d">what</a>(void) const </td><td><a class="el" href="classRtError.html">RtError</a></td><td><code> [inline, virtual]</code></td></tr> | |||
<tr class="memlist"><td><a class="el" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">~RtError</a>(void)</td><td><a class="el" href="classRtError.html">RtError</a></td><td><code> [inline, virtual]</code></td></tr> | |||
</table></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,127 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtError Class Reference</h1><!-- doxytag: class="RtError" --> | |||
<p>Exception handling class for <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> & RtMidi. | |||
<a href="#_details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtError_8h_source.html">RtError.h</a>></code></p> | |||
<p><a href="classRtError-members.html">List of all members.</a></p> | |||
<table border="0" cellpadding="0" cellspacing="0"> | |||
<tr><td colspan="2"><h2>Public Types</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> { <br/> | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">WARNING</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">DEBUG_WARNING</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">UNSPECIFIED</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">NO_DEVICES_FOUND</a>, | |||
<br/> | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">INVALID_DEVICE</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">MEMORY_ERROR</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">INVALID_PARAMETER</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">INVALID_USE</a>, | |||
<br/> | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">DRIVER_ERROR</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">SYSTEM_ERROR</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">THREAD_ERROR</a> | |||
<br/> | |||
}</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Defined <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> types. </p> | |||
<a href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">More...</a><br/></td></tr> | |||
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa479a305ccbe56be0fd9137b9b405a37"></a><!-- doxytag: member="RtError::RtError" ref="aa479a305ccbe56be0fd9137b9b405a37" args="(const std::string &message, Type type=RtError::UNSPECIFIED)" --> | |||
</td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37">RtError</a> (const std::string &message, <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> type=RtError::UNSPECIFIED) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The constructor. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6793e03386e7e69ffafb65a296dfa48c"></a><!-- doxytag: member="RtError::~RtError" ref="a6793e03386e7e69ffafb65a296dfa48c" args="(void)" --> | |||
virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">~RtError</a> (void) throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a251dcdac396c998c91706dd2dd3b8bfc"></a><!-- doxytag: member="RtError::printMessage" ref="a251dcdac396c998c91706dd2dd3b8bfc" args="(void) const " --> | |||
virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">printMessage</a> (void) const throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Prints thrown error message to stderr. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3e316dc9b9b41fe2f64cabf34beb4fe7"></a><!-- doxytag: member="RtError::getType" ref="a3e316dc9b9b41fe2f64cabf34beb4fe7" args="(void) const " --> | |||
virtual const <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">getType</a> (void) const throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the thrown error message type. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afd067ba6b46edd37f989cad02cd70b50"></a><!-- doxytag: member="RtError::getMessage" ref="afd067ba6b46edd37f989cad02cd70b50" args="(void) const " --> | |||
virtual const std::string & </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50">getMessage</a> (void) const throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the thrown error message string. <br/></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aeb843b7a7785d66061c61ebfc29e7e9d"></a><!-- doxytag: member="RtError::what" ref="aeb843b7a7785d66061c61ebfc29e7e9d" args="(void) const " --> | |||
virtual const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d">what</a> (void) const throw ()</td></tr> | |||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the thrown error message as a c-style string. <br/></td></tr> | |||
</table> | |||
<hr/><a name="_details"></a><h2>Detailed Description</h2> | |||
<p>Exception handling class for <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> & RtMidi. </p> | |||
<p>The <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> class is quite simple but it does allow errors to be "caught" by <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">RtError::Type</a>. See the <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> and RtMidi documentation to know which methods can throw an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>. </p> | |||
<hr/><h2>Member Enumeration Documentation</h2> | |||
<a class="anchor" id="ab04667aae01bffc354a9ac6bda6903ac"></a><!-- doxytag: member="RtError::Type" ref="ab04667aae01bffc354a9ac6bda6903ac" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">enum <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">RtError::Type</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Defined <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> types. </p> | |||
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0"> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398"></a><!-- doxytag: member="WARNING" ref="ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398" args="" -->WARNING</em> </td><td> | |||
<p>A non-critical error. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba"></a><!-- doxytag: member="DEBUG_WARNING" ref="ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba" args="" -->DEBUG_WARNING</em> </td><td> | |||
<p>A non-critical error which might be useful for debugging. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6"></a><!-- doxytag: member="UNSPECIFIED" ref="ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6" args="" -->UNSPECIFIED</em> </td><td> | |||
<p>The default, unspecified error type. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82"></a><!-- doxytag: member="NO_DEVICES_FOUND" ref="ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82" args="" -->NO_DEVICES_FOUND</em> </td><td> | |||
<p>No devices found on system. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1"></a><!-- doxytag: member="INVALID_DEVICE" ref="ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1" args="" -->INVALID_DEVICE</em> </td><td> | |||
<p>An invalid device ID was specified. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e"></a><!-- doxytag: member="MEMORY_ERROR" ref="ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e" args="" -->MEMORY_ERROR</em> </td><td> | |||
<p>An error occured during memory allocation. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6"></a><!-- doxytag: member="INVALID_PARAMETER" ref="ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6" args="" -->INVALID_PARAMETER</em> </td><td> | |||
<p>An invalid parameter was specified to a function. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc"></a><!-- doxytag: member="INVALID_USE" ref="ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc" args="" -->INVALID_USE</em> </td><td> | |||
<p>The function was called incorrectly. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b"></a><!-- doxytag: member="DRIVER_ERROR" ref="ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b" args="" -->DRIVER_ERROR</em> </td><td> | |||
<p>A system driver error occured. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b"></a><!-- doxytag: member="SYSTEM_ERROR" ref="ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b" args="" -->SYSTEM_ERROR</em> </td><td> | |||
<p>A system error occured. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6"></a><!-- doxytag: member="THREAD_ERROR" ref="ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6" args="" -->THREAD_ERROR</em> </td><td> | |||
<p>A thread error occured. </p> | |||
</td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this class was generated from the following file:<ul> | |||
<li><a class="el" href="RtError_8h_source.html">RtError.h</a></li> | |||
</ul> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,27 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>Class Index</h1><div class="qindex"><a class="qindex" href="#letter_D">D</a> | <a class="qindex" href="#letter_R">R</a> | <a class="qindex" href="#letter_S">S</a></div> | |||
<table align="center" width="95%" border="0" cellspacing="0" cellpadding="0"> | |||
<tr><td><a name="letter_D"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah"> D </div></td></tr></table> | |||
</td><td><a name="letter_R"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah"> R </div></td></tr></table> | |||
</td><td><a class="el" href="classRtError.html">RtError</a> </td><td><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a> </td><td><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> </td></tr><tr><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a> </td><td><a class="el" href="classRtAudio.html">RtAudio</a> </td><td><a name="letter_S"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah"> S </div></td></tr></table> | |||
</td></tr></table><div class="qindex"><a class="qindex" href="#letter_D">D</a> | <a class="qindex" href="#letter_R">R</a> | <a class="qindex" href="#letter_S">S</a></div> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,532 +0,0 @@ | |||
/* The standard CSS for doxygen */ | |||
body, table, div, p, dl { | |||
font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif; | |||
font-size: 12px; | |||
} | |||
/* @group Heading Levels */ | |||
h1 { | |||
text-align: center; | |||
font-size: 150%; | |||
} | |||
h2 { | |||
font-size: 120%; | |||
} | |||
h3 { | |||
font-size: 100%; | |||
} | |||
dt { | |||
font-weight: bold; | |||
} | |||
div.multicol { | |||
-moz-column-gap: 1em; | |||
-webkit-column-gap: 1em; | |||
-moz-column-count: 3; | |||
-webkit-column-count: 3; | |||
} | |||
p.startli, p.startdd, p.starttd { | |||
margin-top: 2px; | |||
} | |||
p.endli { | |||
margin-bottom: 0px; | |||
} | |||
p.enddd { | |||
margin-bottom: 4px; | |||
} | |||
p.endtd { | |||
margin-bottom: 2px; | |||
} | |||
/* @end */ | |||
caption { | |||
font-weight: bold; | |||
} | |||
span.legend { | |||
font-size: 70%; | |||
text-align: center; | |||
} | |||
h3.version { | |||
font-size: 90%; | |||
text-align: center; | |||
} | |||
div.qindex, div.navtab{ | |||
background-color: #e8eef2; | |||
border: 1px solid #84b0c7; | |||
text-align: center; | |||
margin: 2px; | |||
padding: 2px; | |||
} | |||
div.qindex, div.navpath { | |||
width: 100%; | |||
line-height: 140%; | |||
} | |||
div.navtab { | |||
margin-right: 15px; | |||
} | |||
/* @group Link Styling */ | |||
a { | |||
color: #153788; | |||
font-weight: normal; | |||
text-decoration: none; | |||
} | |||
.contents a:visited { | |||
color: #1b77c5; | |||
} | |||
a:hover { | |||
text-decoration: underline; | |||
} | |||
a.qindex { | |||
font-weight: bold; | |||
} | |||
a.qindexHL { | |||
font-weight: bold; | |||
background-color: #6666cc; | |||
color: #ffffff; | |||
border: 1px double #9295C2; | |||
} | |||
.contents a.qindexHL:visited { | |||
color: #ffffff; | |||
} | |||
a.el { | |||
font-weight: bold; | |||
} | |||
a.elRef { | |||
} | |||
a.code { | |||
color: #3030f0; | |||
} | |||
a.codeRef { | |||
color: #3030f0; | |||
} | |||
/* @end */ | |||
dl.el { | |||
margin-left: -1cm; | |||
} | |||
.fragment { | |||
font-family: monospace, fixed; | |||
font-size: 105%; | |||
} | |||
pre.fragment { | |||
border: 1px solid #CCCCCC; | |||
background-color: #f5f5f5; | |||
padding: 4px 6px; | |||
margin: 4px 8px 4px 2px; | |||
overflow: auto; | |||
word-wrap: break-word; | |||
font-size: 9pt; | |||
line-height: 125%; | |||
} | |||
div.ah { | |||
background-color: black; | |||
font-weight: bold; | |||
color: #ffffff; | |||
margin-bottom: 3px; | |||
margin-top: 3px | |||
} | |||
div.groupHeader { | |||
margin-left: 16px; | |||
margin-top: 12px; | |||
margin-bottom: 6px; | |||
font-weight: bold; | |||
} | |||
div.groupText { | |||
margin-left: 16px; | |||
font-style: italic; | |||
} | |||
body { | |||
background: white; | |||
color: black; | |||
margin-right: 20px; | |||
margin-left: 20px; | |||
} | |||
td.indexkey { | |||
background-color: #e8eef2; | |||
font-weight: bold; | |||
border: 1px solid #CCCCCC; | |||
margin: 2px 0px 2px 0; | |||
padding: 2px 10px; | |||
} | |||
td.indexvalue { | |||
background-color: #e8eef2; | |||
border: 1px solid #CCCCCC; | |||
padding: 2px 10px; | |||
margin: 2px 0px; | |||
} | |||
tr.memlist { | |||
background-color: #f0f0f0; | |||
} | |||
p.formulaDsp { | |||
text-align: center; | |||
} | |||
img.formulaDsp { | |||
} | |||
img.formulaInl { | |||
vertical-align: middle; | |||
} | |||
div.center { | |||
text-align: center; | |||
margin-top: 0px; | |||
margin-bottom: 0px; | |||
padding: 0px; | |||
} | |||
div.center img { | |||
border: 0px; | |||
} | |||
img.footer { | |||
border: 0px; | |||
vertical-align: middle; | |||
} | |||
/* @group Code Colorization */ | |||
span.keyword { | |||
color: #008000 | |||
} | |||
span.keywordtype { | |||
color: #604020 | |||
} | |||
span.keywordflow { | |||
color: #e08000 | |||
} | |||
span.comment { | |||
color: #800000 | |||
} | |||
span.preprocessor { | |||
color: #806020 | |||
} | |||
span.stringliteral { | |||
color: #002080 | |||
} | |||
span.charliteral { | |||
color: #008080 | |||
} | |||
span.vhdldigit { | |||
color: #ff00ff | |||
} | |||
span.vhdlchar { | |||
color: #000000 | |||
} | |||
span.vhdlkeyword { | |||
color: #700070 | |||
} | |||
span.vhdllogic { | |||
color: #ff0000 | |||
} | |||
/* @end */ | |||
.search { | |||
color: #003399; | |||
font-weight: bold; | |||
} | |||
form.search { | |||
margin-bottom: 0px; | |||
margin-top: 0px; | |||
} | |||
input.search { | |||
font-size: 75%; | |||
color: #000080; | |||
font-weight: normal; | |||
background-color: #e8eef2; | |||
} | |||
td.tiny { | |||
font-size: 75%; | |||
} | |||
.dirtab { | |||
padding: 4px; | |||
border-collapse: collapse; | |||
border: 1px solid #84b0c7; | |||
} | |||
th.dirtab { | |||
background: #e8eef2; | |||
font-weight: bold; | |||
} | |||
hr { | |||
height: 0; | |||
border: none; | |||
border-top: 1px solid #666; | |||
} | |||
/* @group Member Descriptions */ | |||
.mdescLeft, .mdescRight, | |||
.memItemLeft, .memItemRight, | |||
.memTemplItemLeft, .memTemplItemRight, .memTemplParams { | |||
background-color: #FAFAFA; | |||
border: none; | |||
margin: 4px; | |||
padding: 1px 0 0 8px; | |||
} | |||
.mdescLeft, .mdescRight { | |||
padding: 0px 8px 4px 8px; | |||
color: #555; | |||
} | |||
.memItemLeft, .memItemRight, .memTemplParams { | |||
border-top: 1px solid #ccc; | |||
} | |||
.memItemLeft, .memTemplItemLeft { | |||
white-space: nowrap; | |||
} | |||
.memTemplParams { | |||
color: #606060; | |||
white-space: nowrap; | |||
} | |||
/* @end */ | |||
/* @group Member Details */ | |||
/* Styles for detailed member documentation */ | |||
.memtemplate { | |||
font-size: 80%; | |||
color: #606060; | |||
font-weight: normal; | |||
margin-left: 3px; | |||
} | |||
.memnav { | |||
background-color: #e8eef2; | |||
border: 1px solid #84b0c7; | |||
text-align: center; | |||
margin: 2px; | |||
margin-right: 15px; | |||
padding: 2px; | |||
} | |||
.memitem { | |||
padding: 0; | |||
margin-bottom: 10px; | |||
} | |||
.memname { | |||
white-space: nowrap; | |||
font-weight: bold; | |||
} | |||
.memproto, .memdoc { | |||
border: 1px solid #84b0c7; | |||
} | |||
.memproto { | |||
padding: 0; | |||
background-color: #d5e1e8; | |||
font-weight: bold; | |||
-webkit-border-top-left-radius: 8px; | |||
-webkit-border-top-right-radius: 8px; | |||
-webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); | |||
-moz-border-radius-topleft: 8px; | |||
-moz-border-radius-topright: 8px; | |||
-moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px; | |||
} | |||
.memdoc { | |||
padding: 2px 5px; | |||
background-color: #eef3f5; | |||
border-top-width: 0; | |||
-webkit-border-bottom-left-radius: 8px; | |||
-webkit-border-bottom-right-radius: 8px; | |||
-webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); | |||
-moz-border-radius-bottomleft: 8px; | |||
-moz-border-radius-bottomright: 8px; | |||
-moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px; | |||
} | |||
.paramkey { | |||
text-align: right; | |||
} | |||
.paramtype { | |||
white-space: nowrap; | |||
} | |||
.paramname { | |||
color: #602020; | |||
white-space: nowrap; | |||
} | |||
.paramname em { | |||
font-style: normal; | |||
} | |||
/* @end */ | |||
/* @group Directory (tree) */ | |||
/* for the tree view */ | |||
.ftvtree { | |||
font-family: sans-serif; | |||
margin: 0.5em; | |||
} | |||
/* these are for tree view when used as main index */ | |||
.directory { | |||
font-size: 9pt; | |||
font-weight: bold; | |||
} | |||
.directory h3 { | |||
margin: 0px; | |||
margin-top: 1em; | |||
font-size: 11pt; | |||
} | |||
/* | |||
The following two styles can be used to replace the root node title | |||
with an image of your choice. Simply uncomment the next two styles, | |||
specify the name of your image and be sure to set 'height' to the | |||
proper pixel height of your image. | |||
*/ | |||
/* | |||
.directory h3.swap { | |||
height: 61px; | |||
background-repeat: no-repeat; | |||
background-image: url("yourimage.gif"); | |||
} | |||
.directory h3.swap span { | |||
display: none; | |||
} | |||
*/ | |||
.directory > h3 { | |||
margin-top: 0; | |||
} | |||
.directory p { | |||
margin: 0px; | |||
white-space: nowrap; | |||
} | |||
.directory div { | |||
display: none; | |||
margin: 0px; | |||
} | |||
.directory img { | |||
vertical-align: -30%; | |||
} | |||
/* these are for tree view when not used as main index */ | |||
.directory-alt { | |||
font-size: 100%; | |||
font-weight: bold; | |||
} | |||
.directory-alt h3 { | |||
margin: 0px; | |||
margin-top: 1em; | |||
font-size: 11pt; | |||
} | |||
.directory-alt > h3 { | |||
margin-top: 0; | |||
} | |||
.directory-alt p { | |||
margin: 0px; | |||
white-space: nowrap; | |||
} | |||
.directory-alt div { | |||
display: none; | |||
margin: 0px; | |||
} | |||
.directory-alt img { | |||
vertical-align: -30%; | |||
} | |||
/* @end */ | |||
address { | |||
font-style: normal; | |||
color: #333; | |||
} | |||
table.doxtable { | |||
border-collapse:collapse; | |||
} | |||
table.doxtable td, table.doxtable th { | |||
border: 1px solid #153788; | |||
padding: 3px 7px 2px; | |||
} | |||
table.doxtable th { | |||
background-color: #254798; | |||
color: #FFFFFF; | |||
font-size: 110%; | |||
padding-bottom: 4px; | |||
padding-top: 5px; | |||
text-align:left; | |||
} | |||
@@ -1,90 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="duplex">Duplex Mode </a></h1><p>Finally, it is easy to use <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for simultaneous audio input/output, or duplex operation. In this example, we simply pass the input data back to the output.</p> | |||
<div class="fragment"><pre class="fragment"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span> | |||
<span class="preprocessor">#include <iostream></span> | |||
<span class="preprocessor">#include <cstdlib></span> | |||
<span class="preprocessor">#include <cstring></span> | |||
<span class="comment">// Pass-through function.</span> | |||
<span class="keywordtype">int</span> inout( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBufferFrames, | |||
<span class="keywordtype">double</span> streamTime, <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, <span class="keywordtype">void</span> *data ) | |||
{ | |||
<span class="comment">// Since the number of input and output channels is equal, we can do</span> | |||
<span class="comment">// a simple buffer copy operation here.</span> | |||
<span class="keywordflow">if</span> ( status ) std::cout << <span class="stringliteral">"Stream over/underflow detected."</span> << std::endl; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *bytes = (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *) data; | |||
memcpy( outputBuffer, inputBuffer, *bytes ); | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
<span class="keywordtype">int</span> main() | |||
{ | |||
<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> adac; | |||
<span class="keywordflow">if</span> ( adac.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() < 1 ) { | |||
std::cout << <span class="stringliteral">"\nNo audio devices found!\n"</span>; | |||
exit( 0 ); | |||
} | |||
<span class="comment">// Set the same number of channels for both input and output.</span> | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferBytes, bufferFrames = 512; | |||
<a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> iParams, oParams; | |||
iParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = 0; <span class="comment">// first available device</span> | |||
iParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2; | |||
oParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = 0; <span class="comment">// first available device</span> | |||
oParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2; | |||
<span class="keywordflow">try</span> { | |||
adac.<a class="code" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream</a>( &oParams, &iParams, RTAUDIO_SINT32, 44100, &bufferFrames, &inout, (<span class="keywordtype">void</span> *)&bufferBytes ); | |||
} | |||
<span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e ) { | |||
e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>(); | |||
exit( 0 ); | |||
} | |||
bufferBytes = bufferFrames * 2 * 4; | |||
<span class="keywordflow">try</span> { | |||
adac.<a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>(); | |||
<span class="keywordtype">char</span> input; | |||
std::cout << <span class="stringliteral">"\nRunning ... press <enter> to quit.\n"</span>; | |||
std::cin.get(input); | |||
<span class="comment">// Stop the stream.</span> | |||
adac.<a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>(); | |||
} | |||
<span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e ) { | |||
e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>(); | |||
<span class="keywordflow">goto</span> cleanup; | |||
} | |||
cleanup: | |||
<span class="keywordflow">if</span> ( adac.<a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>() ) adac.<a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>(); | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
</pre></div><p>In this example, audio recorded by the stream input will be played out during the next round of audio processing.</p> | |||
<p>Note that a duplex stream can make use of two different devices (except when using the Linux Jack and Windows ASIO APIs). However, this may cause timing problems due to possible device clock variations, unless a common external "sync" is provided. </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,24 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="errors">Error Handling </a></h1><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> makes restrained use of C++ exceptions. That is, exceptions are thrown only when system errors occur that prevent further class operation or when the user makes invalid function calls. In other cases, a warning message may be displayed and an appropriate value is returned. For example, if a system error occurs when processing the <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">RtAudio::getDeviceCount()</a> function, the return value is zero. In such a case, the user cannot expect to make use of most other <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> functions because no devices are available (and thus a stream cannot be opened). A client can call the function <a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">RtAudio::showWarnings()</a> with a boolean argument to enable or disable the printing of warning messages to <code>stderr</code>. By default, warning messages are displayed. There is a protected <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> method, error(), that can be modified to globally control how these messages are handled and reported. </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,25 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>File List</h1>Here is a list of all documented files with brief descriptions:<table> | |||
<tr><td class="indexkey"><a class="el" href="RtAudio_8h.html">RtAudio.h</a> <a href="RtAudio_8h_source.html">[code]</a></td><td class="indexvalue"></td></tr> | |||
<tr><td class="indexkey"><b>RtError.h</b> <a href="RtError_8h_source.html">[code]</a></td><td class="indexvalue"></td></tr> | |||
</table> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,25 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="multi">Using Simultaneous Multiple APIs </a></h1><p>Because support for each audio API is encapsulated in a specific RtApi subclass, it is possible to compile and instantiate multiple API-specific subclasses on a given operating system. For example, one can compile both the RtApiDs and RtApiAsio classes on Windows operating systems by providing the appropriate preprocessor definitions, include files, and libraries for each. In a run-time situation, one might first attempt to determine whether any ASIO device drivers exist. This can be done by specifying the api argument <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">RtAudio::WINDOWS_ASIO</a> when attempting to create an instance of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>. If no available devices are found, then an instance of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> with the api argument <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">RtAudio::WINDOWS_DS</a> can be created. Alternately, if no api argument is specified, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will first look for an ASIO instance and then a DirectSound instance (on Linux systems, the default API search order is Jack, Alsa, and finally OSS). In theory, it should also be possible to have separate instances of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> open at the same time with different underlying audio API support, though this has not been tested. It is difficult to know how well different audio APIs can simultaneously coexist on a given operating system. In particular, it is unlikely that the same device could be simultaneously controlled with two different audio APIs.</p> | |||
<p>The static function <a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26" title="A static function to determine the available compiled audio APIs.">RtAudio::getCompiledApi()</a> is provided to determine the available compiled API support. The function <a class="el" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">RtAudio::getCurrentApi()</a> indicates the API selected for a given <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> instance. </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,45 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>Related Pages</h1>Here is a list of all related documentation pages:<ul> | |||
<li><a class="el" href="acknowledge.html">Acknowledgements</a> | |||
</li> | |||
<li><a class="el" href="apinotes.html">API Notes</a> | |||
</li> | |||
<li><a class="el" href="compiling.html">Debugging & Compiling</a> | |||
</li> | |||
<li><a class="el" href="duplex.html">Duplex Mode</a> | |||
</li> | |||
<li><a class="el" href="errors.html">Error Handling</a> | |||
</li> | |||
<li><a class="el" href="license.html">License</a> | |||
</li> | |||
<li><a class="el" href="multi.html">Using Simultaneous Multiple APIs</a> | |||
</li> | |||
<li><a class="el" href="playback.html">Playback</a> | |||
</li> | |||
<li><a class="el" href="probe.html">Probing Device Capabilities</a> | |||
</li> | |||
<li><a class="el" href="recording.html">Recording</a> | |||
</li> | |||
<li><a class="el" href="settings.html">Device Settings</a> | |||
</li> | |||
</ul> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,96 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="playback">Playback </a></h1><p>In this example, we provide a complete program that demonstrates the use of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for audio playback. Our program produces a two-channel sawtooth waveform for output.</p> | |||
<div class="fragment"><pre class="fragment"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span> | |||
<span class="preprocessor">#include <iostream></span> | |||
<span class="preprocessor">#include <cstdlib></span> | |||
<span class="comment">// Two-channel sawtooth wave generator.</span> | |||
<span class="keywordtype">int</span> saw( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBufferFrames, | |||
<span class="keywordtype">double</span> streamTime, <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, <span class="keywordtype">void</span> *userData ) | |||
{ | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i, j; | |||
<span class="keywordtype">double</span> *buffer = (<span class="keywordtype">double</span> *) outputBuffer; | |||
<span class="keywordtype">double</span> *lastValues = (<span class="keywordtype">double</span> *) userData; | |||
<span class="keywordflow">if</span> ( status ) | |||
std::cout << <span class="stringliteral">"Stream underflow detected!"</span> << std::endl; | |||
<span class="comment">// Write interleaved audio data.</span> | |||
<span class="keywordflow">for</span> ( i=0; i<nBufferFrames; i++ ) { | |||
<span class="keywordflow">for</span> ( j=0; j<2; j++ ) { | |||
*buffer++ = lastValues[j]; | |||
lastValues[j] += 0.005 * (j+1+(j*0.1)); | |||
<span class="keywordflow">if</span> ( lastValues[j] >= 1.0 ) lastValues[j] -= 2.0; | |||
} | |||
} | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
<span class="keywordtype">int</span> main() | |||
{ | |||
<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> dac; | |||
<span class="keywordflow">if</span> ( dac.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() < 1 ) { | |||
std::cout << <span class="stringliteral">"\nNo audio devices found!\n"</span>; | |||
exit( 0 ); | |||
} | |||
<a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> parameters; | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = dac.<a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>(); | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2; | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a> = 0; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate = 44100; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferFrames = 256; <span class="comment">// 256 sample frames</span> | |||
<span class="keywordtype">double</span> data[2]; | |||
<span class="keywordflow">try</span> { | |||
dac.<a class="code" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream</a>( &parameters, NULL, RTAUDIO_FLOAT64, | |||
sampleRate, &bufferFrames, &saw, (<span class="keywordtype">void</span> *)&data ); | |||
dac.<a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>(); | |||
} | |||
<span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e ) { | |||
e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>(); | |||
exit( 0 ); | |||
} | |||
<span class="keywordtype">char</span> input; | |||
std::cout << <span class="stringliteral">"\nPlaying ... press <enter> to quit.\n"</span>; | |||
std::cin.get( input ); | |||
<span class="keywordflow">try</span> { | |||
<span class="comment">// Stop the stream</span> | |||
dac.<a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>(); | |||
} | |||
<span class="keywordflow">catch</span> (<a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e) { | |||
e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>(); | |||
} | |||
<span class="keywordflow">if</span> ( dac.<a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>() ) dac.<a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>(); | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
</pre></div><p>We open the stream in exactly the same way as the previous example (except with a data format change) and specify the address of our callback function <em>"saw()"</em>. The callback function will automatically be invoked when the underlying audio system needs data for output. Note that the callback function is called only when the stream is "running" (between calls to the <a class="el" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">RtAudio::startStream()</a> and <a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio::stopStream()</a> functions). We can also pass a pointer value to the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function that is made available in the callback function. In this way, it is possible to gain access to arbitrary data created in our <em>main()</em> function from within the globally defined callback function.</p> | |||
<p>In this example, we stop the stream with an explicit call to <a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio::stopStream()</a>. It is also possible to stop a stream by returning a non-zero value from the callback function. A return value of 1 will cause the stream to finish draining its internal buffers and then halt (equivalent to calling the <a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio::stopStream()</a> function). A return value of 2 will cause the stream to stop immediately (equivalent to calling the <a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">RtAudio::abortStream()</a> function). </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,74 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="probe">Probing Device Capabilities </a></h1><p>A programmer may wish to query the available audio device capabilities before deciding which to use. The following example outlines how this can be done.</p> | |||
<div class="fragment"><pre class="fragment"><span class="comment">// audioprobe.cpp</span> | |||
<span class="preprocessor">#include <iostream></span> | |||
<span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span> | |||
<span class="keywordtype">int</span> main() | |||
{ | |||
<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> audio; | |||
<span class="comment">// Determine the number of devices available</span> | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> devices = audio.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>(); | |||
<span class="comment">// Scan through devices for various capabilities</span> | |||
<a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> info; | |||
<span class="keywordflow">for</span> ( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i=0; i<=devices; i++ ) { | |||
info = audio.<a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( i ); | |||
<span class="keywordflow">if</span> ( info.<a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a> == <span class="keyword">true</span> ) { | |||
<span class="comment">// Print, for example, the maximum number of output channels for each device</span> | |||
std::cout << <span class="stringliteral">"device = "</span> << i; | |||
std::cout << <span class="stringliteral">": maximum output channels = "</span> << info.<a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a> << <span class="stringliteral">"\n"</span>; | |||
} | |||
} | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
</pre></div><p>The <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure is defined in <a class="el" href="RtAudio_8h.html">RtAudio.h</a> and provides a variety of information useful in assessing the capabilities of a device:</p> | |||
<div class="fragment"><pre class="fragment"> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> { | |||
<span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a>; <span class="comment">// true if the device capabilities were successfully probed.</span> | |||
std::string <a class="code" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a>; <span class="comment">// Character string device identifier.</span> | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a>; <span class="comment">// Maximum output channels supported by device.</span> | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a>; <span class="comment">// Maximum input channels supported by device.</span> | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a>; <span class="comment">// Maximum simultaneous input/output channels supported by device.</span> | |||
<span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a>; <span class="comment">// true if this is the default output device.</span> | |||
<span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a>; <span class="comment">// true if this is the default input device.</span> | |||
std::vector<unsigned int> <a class="code" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a>; <span class="comment">// Supported sample rates.</span> | |||
<a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a>; <span class="comment">// Bit mask of supported data formats.</span> | |||
}; | |||
</pre></div><p>The following data formats are defined and fully supported by <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>:</p> | |||
<div class="fragment"><pre class="fragment"> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a>; | |||
<span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT8; <span class="comment">// Signed 8-bit integer</span> | |||
<span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT16; <span class="comment">// Signed 16-bit integer</span> | |||
<span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT24; <span class="comment">// Signed 24-bit integer (lower 3 bytes of 32-bit signed integer.)</span> | |||
<span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT32; <span class="comment">// Signed 32-bit integer</span> | |||
<span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_FLOAT32; <span class="comment">// 32-bit float normalized between +/- 1.0</span> | |||
<span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_FLOAT64; <span class="comment">// 64-bit double normalized between +/- 1.0</span> | |||
</pre></div><p>The <code>nativeFormats</code> member of the <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure is a bit mask of the above formats which are natively supported by the device. However, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will automatically provide format conversion if a particular format is not natively supported. When the <code>probed</code> member of the <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure is false, the remaining structure members are undefined and the device is probably unusable.</p> | |||
<p>Some audio devices may require a minimum channel value greater than one. <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will provide automatic channel number compensation when the number of channels set by the user is less than that required by the device. Channel compensation is <em>NOT</em> possible when the number of channels set by the user is greater than that supported by the device.</p> | |||
<p>It should be noted that the capabilities reported by a device driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. For this reason, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> does not rely on the queried values when attempting to open a stream. </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,82 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="recording">Recording </a></h1><p>Using <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for audio input is almost identical to the way it is used for playback. Here's the blocking playback example rewritten for recording:</p> | |||
<div class="fragment"><pre class="fragment"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span> | |||
<span class="preprocessor">#include <iostream></span> | |||
<span class="preprocessor">#include <cstdlib></span> | |||
<span class="preprocessor">#include <cstring></span> | |||
<span class="keywordtype">int</span> record( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBufferFrames, | |||
<span class="keywordtype">double</span> streamTime, <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, <span class="keywordtype">void</span> *userData ) | |||
{ | |||
<span class="keywordflow">if</span> ( status ) | |||
std::cout << <span class="stringliteral">"Stream overflow detected!"</span> << std::endl; | |||
<span class="comment">// Do something with the data in the "inputBuffer" buffer.</span> | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
<span class="keywordtype">int</span> main() | |||
{ | |||
<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> adc; | |||
<span class="keywordflow">if</span> ( adc.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() < 1 ) { | |||
std::cout << <span class="stringliteral">"\nNo audio devices found!\n"</span>; | |||
exit( 0 ); | |||
} | |||
<a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> parameters; | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = adc.<a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>(); | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2; | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a> = 0; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate = 44100; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferFrames = 256; <span class="comment">// 256 sample frames</span> | |||
<span class="keywordflow">try</span> { | |||
adc.<a class="code" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream</a>( NULL, &parameters, RTAUDIO_SINT16, | |||
sampleRate, &bufferFrames, &record ); | |||
adc.<a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>(); | |||
} | |||
<span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e ) { | |||
e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>(); | |||
exit( 0 ); | |||
} | |||
<span class="keywordtype">char</span> input; | |||
std::cout << <span class="stringliteral">"\nRecording ... press <enter> to quit.\n"</span>; | |||
std::cin.get( input ); | |||
<span class="keywordflow">try</span> { | |||
<span class="comment">// Stop the stream</span> | |||
adc.<a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>(); | |||
} | |||
<span class="keywordflow">catch</span> (<a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e) { | |||
e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>(); | |||
} | |||
<span class="keywordflow">if</span> ( adc.<a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>() ) adc.<a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>(); | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
</pre></div><p>In this example, we pass the address of the stream parameter structure as the second argument of the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function and pass a NULL value for the output stream parameters. In this example, the <em>record()</em> callback function performs no specific operations. </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,57 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="settings">Device Settings </a></h1><p>The next step in using <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> is to open a stream with particular device and parameter settings.</p> | |||
<div class="fragment"><pre class="fragment"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span> | |||
<span class="keywordtype">int</span> main() | |||
{ | |||
<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> dac; | |||
<span class="keywordflow">if</span> ( dac.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() == 0 ) exit( 0 ); | |||
<a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> parameters; | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = dac.<a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>(); | |||
parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate = 44100; | |||
<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferFrames = 256; <span class="comment">// 256 sample frames</span> | |||
<a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> options; | |||
options.<a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a> = RTAUDIO_NONINTERLEAVED; | |||
<span class="keywordflow">try</span> { | |||
dac.<a class="code" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream</a>( &parameters, NULL, RTAUDIO_FLOAT32, | |||
sampleRate, &bufferFrames, &myCallback, NULL, &options ); | |||
} | |||
<span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio &amp; RtMidi.">RtError</a>& e ) { | |||
std::cout << <span class="charliteral">'\n'</span> << e.<a class="code" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50" title="Returns the thrown error message string.">getMessage</a>() << <span class="charliteral">'\n'</span> << std::endl; | |||
exit( 0 ); | |||
} | |||
<span class="keywordflow">return</span> 0; | |||
} | |||
</pre></div><p>The <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function attempts to open a stream with a specified set of parameter values. In the above example, we attempt to open a two channel playback stream using the default output device, 32-bit floating point data, a sample rate of 44100 Hz, and a frame rate of 256 sample frames per output buffer. If the user specifies an invalid parameter value (such as a device id greater than or equal to the number of enumerated devices), an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> is thrown of type = INVALID_USE. If a system error occurs or the device does not support the specified parameter values, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> of type = SYSTEM_ERROR is thrown. In either case, a descriptive error message is bundled with the exception and can be queried with the <a class="el" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50" title="Returns the thrown error message string.">RtError::getMessage()</a> or <a class="el" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d" title="Returns the thrown error message as a c-style string.">RtError::what()</a> functions.</p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> provides four signed integer and two floating point data formats which can be specified using the RtAudioFormat parameter values mentioned earlier. If the opened device does not natively support the given format, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will automatically perform the necessary data format conversion.</p> | |||
<p>The <code>bufferFrames</code> parameter specifies the desired number of sample frames that will be written to and/or read from a device per write/read operation. This parameter can be used to control stream latency though there is no guarantee that the passed value will be that used by a device. In general, a lower <code>bufferFrames</code> value will produce less latency but perhaps less robust performance. A value of zero can be specified, in which case the smallest allowable value will be used. The <code>bufferFrames</code> parameter is passed as a pointer and the actual value used by the stream is set during the device setup procedure. <code>bufferFrames</code> values should be a power of two. Optimal and allowable buffer values tend to vary between systems and devices. Stream latency can also be controlled via the optional <a class="el" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> member <code>numberOfBuffers</code> (not used in the example above), though this tends to be more system dependent. In particular, the <code>numberOfBuffers</code> parameter is ignored when using the OS-X Core Audio, Jack, and the Windows ASIO APIs.</p> | |||
<p>As noted earlier, the device capabilities reported by a driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. Because of this, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> does not attempt to query a device's capabilities or use previously reported values when opening a device. Instead, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> simply attempts to set the given parameters on a specified device and then checks whether the setup is successful or not.</p> | |||
<p>The RtAudioCallback parameter above is a pointer to a user-defined function that will be called whenever the audio system is ready for new output data or has new input data to be read. Further details on the use of a callback function are provided in the next section.</p> | |||
<p>Several stream options are available to fine-tune the behavior of an audio stream. In the example above, we specify that data will be written by the user in a <em>non-interleaved</em> format via the <a class="el" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> member <code>flags</code>. That is, all <code>bufferFrames</code> of the first channel should be written consecutively, followed by all <code>bufferFrames</code> of the second channel. By default (when no option is specified), <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> expects data to be written in an <em>interleaved</em> format. </p> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,31 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtAudio::DeviceInfo Member List</h1>This is the complete list of members for <a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a>, including all inherited members.<table> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a></td><td><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td></td></tr> | |||
</table></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,174 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="navpath"><a class="el" href="classRtAudio.html">RtAudio</a>::<a class="el" href="structRtAudio_1_1DeviceInfo.html">DeviceInfo</a> | |||
</div> | |||
<div class="contents"> | |||
<h1>RtAudio::DeviceInfo Struct Reference</h1><!-- doxytag: class="RtAudio::DeviceInfo" --> | |||
<p>The public device information structure for returning queried values. | |||
<a href="#_details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtAudio_8h_source.html">RtAudio.h</a>></code></p> | |||
<p><a href="structRtAudio_1_1DeviceInfo-members.html">List of all members.</a></p> | |||
<table border="0" cellpadding="0" cellspacing="0"> | |||
<tr><td colspan="2"><h2>Public Attributes</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">std::vector< unsigned int > </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a></td></tr> | |||
</table> | |||
<hr/><a name="_details"></a><h2>Detailed Description</h2> | |||
<p>The public device information structure for returning queried values. </p> | |||
<hr/><h2>Member Data Documentation</h2> | |||
<a class="anchor" id="a97573717ccb1e75a834a0a108cd6982d"></a><!-- doxytag: member="RtAudio::DeviceInfo::probed" ref="a97573717ccb1e75a834a0a108cd6982d" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">bool <a class="el" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">RtAudio::DeviceInfo::probed</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>true if the device capabilities were successfully probed. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a24df596ab8d54f2eb540c7cf16212b3b"></a><!-- doxytag: member="RtAudio::DeviceInfo::name" ref="a24df596ab8d54f2eb540c7cf16212b3b" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">std::string <a class="el" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">RtAudio::DeviceInfo::name</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Character string device identifier. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a81aaf488f8158ef55b1bb678f66feb7d"></a><!-- doxytag: member="RtAudio::DeviceInfo::outputChannels" ref="a81aaf488f8158ef55b1bb678f66feb7d" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">RtAudio::DeviceInfo::outputChannels</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Maximum output channels supported by device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a56247b458a937ae84d98ca9c4b243275"></a><!-- doxytag: member="RtAudio::DeviceInfo::inputChannels" ref="a56247b458a937ae84d98ca9c4b243275" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">RtAudio::DeviceInfo::inputChannels</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Maximum input channels supported by device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a3e8ad34c2d14e24293a0beafc26186e7"></a><!-- doxytag: member="RtAudio::DeviceInfo::duplexChannels" ref="a3e8ad34c2d14e24293a0beafc26186e7" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">RtAudio::DeviceInfo::duplexChannels</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Maximum simultaneous input/output channels supported by device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a5365245e73ffe29a05734de4474acd58"></a><!-- doxytag: member="RtAudio::DeviceInfo::isDefaultOutput" ref="a5365245e73ffe29a05734de4474acd58" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">bool <a class="el" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">RtAudio::DeviceInfo::isDefaultOutput</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>true if this is the default output device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a7c8aca084bd908799b6be5954b80def2"></a><!-- doxytag: member="RtAudio::DeviceInfo::isDefaultInput" ref="a7c8aca084bd908799b6be5954b80def2" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">bool <a class="el" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">RtAudio::DeviceInfo::isDefaultInput</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>true if this is the default input device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="afa65f5f92f66ce7aacd3ff35e11b230f"></a><!-- doxytag: member="RtAudio::DeviceInfo::sampleRates" ref="afa65f5f92f66ce7aacd3ff35e11b230f" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">std::vector<unsigned int> <a class="el" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">RtAudio::DeviceInfo::sampleRates</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Supported sample rates (queried from list of standard rates). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a23251b549b89b2fe04a57fcd7cb76ea4"></a><!-- doxytag: member="RtAudio::DeviceInfo::nativeFormats" ref="a23251b549b89b2fe04a57fcd7cb76ea4" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> <a class="el" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">RtAudio::DeviceInfo::nativeFormats</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Bit mask of supported data formats. </p> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this struct was generated from the following file:<ul> | |||
<li><a class="el" href="RtAudio_8h_source.html">RtAudio.h</a></li> | |||
</ul> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,26 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtAudio::StreamOptions Member List</h1>This is the complete list of members for <a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a>, including all inherited members.<table> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a></td><td><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a></td><td><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a></td><td><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">streamName</a></td><td><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td></td></tr> | |||
</table></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,25 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="contents"> | |||
<h1>RtAudio::StreamParameters Member List</h1>This is the complete list of members for <a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a>, including all inherited members.<table> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a></td><td><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a></td><td><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a></td><td></td></tr> | |||
<tr class="memlist"><td><a class="el" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a></td><td><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a></td><td></td></tr> | |||
</table></div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,84 +0,0 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="navpath"><a class="el" href="classRtAudio.html">RtAudio</a>::<a class="el" href="structRtAudio_1_1StreamParameters.html">StreamParameters</a> | |||
</div> | |||
<div class="contents"> | |||
<h1>RtAudio::StreamParameters Struct Reference</h1><!-- doxytag: class="RtAudio::StreamParameters" --> | |||
<p>The structure for specifying input or ouput stream parameters. | |||
<a href="#_details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtAudio_8h_source.html">RtAudio.h</a>></code></p> | |||
<p><a href="structRtAudio_1_1StreamParameters-members.html">List of all members.</a></p> | |||
<table border="0" cellpadding="0" cellspacing="0"> | |||
<tr><td colspan="2"><h2>Public Attributes</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a></td></tr> | |||
</table> | |||
<hr/><a name="_details"></a><h2>Detailed Description</h2> | |||
<p>The structure for specifying input or ouput stream parameters. </p> | |||
<hr/><h2>Member Data Documentation</h2> | |||
<a class="anchor" id="ab3c72bcf3ef12149ae9a4fb597cc5489"></a><!-- doxytag: member="RtAudio::StreamParameters::deviceId" ref="ab3c72bcf3ef12149ae9a4fb597cc5489" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">RtAudio::StreamParameters::deviceId</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Device index (0 to <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a88a10091b6e284e21235cc6f25332ebd"></a><!-- doxytag: member="RtAudio::StreamParameters::nChannels" ref="a88a10091b6e284e21235cc6f25332ebd" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">RtAudio::StreamParameters::nChannels</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>Number of channels. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="ad4b4503782653ec93c83328c46abe50c"></a><!-- doxytag: member="RtAudio::StreamParameters::firstChannel" ref="ad4b4503782653ec93c83328c46abe50c" args="" --> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">RtAudio::StreamParameters::firstChannel</a></td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
<p>First channel index on device (default = 0). </p> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this struct was generated from the following file:<ul> | |||
<li><a class="el" href="RtAudio_8h_source.html">RtAudio.h</a></li> | |||
</ul> | |||
</div> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -1,105 +0,0 @@ | |||
/* tabs styles, based on http://www.alistapart.com/articles/slidingdoors */ | |||
DIV.tabs | |||
{ | |||
float : left; | |||
width : 100%; | |||
background : url("tab_b.gif") repeat-x bottom; | |||
margin-bottom : 4px; | |||
} | |||
DIV.tabs UL | |||
{ | |||
margin : 0px; | |||
padding-left : 10px; | |||
list-style : none; | |||
} | |||
DIV.tabs LI, DIV.tabs FORM | |||
{ | |||
display : inline; | |||
margin : 0px; | |||
padding : 0px; | |||
} | |||
DIV.tabs FORM | |||
{ | |||
float : right; | |||
} | |||
DIV.tabs A | |||
{ | |||
float : left; | |||
background : url("tab_r.gif") no-repeat right top; | |||
border-bottom : 1px solid #84B0C7; | |||
font-size : 80%; | |||
font-weight : bold; | |||
text-decoration : none; | |||
} | |||
DIV.tabs A:hover | |||
{ | |||
background-position: 100% -150px; | |||
} | |||
DIV.tabs A:link, DIV.tabs A:visited, | |||
DIV.tabs A:active, DIV.tabs A:hover | |||
{ | |||
color: #1A419D; | |||
} | |||
DIV.tabs SPAN | |||
{ | |||
float : left; | |||
display : block; | |||
background : url("tab_l.gif") no-repeat left top; | |||
padding : 5px 9px; | |||
white-space : nowrap; | |||
} | |||
DIV.tabs #MSearchBox | |||
{ | |||
float : right; | |||
display : inline; | |||
font-size : 1em; | |||
} | |||
DIV.tabs TD | |||
{ | |||
font-size : 80%; | |||
font-weight : bold; | |||
text-decoration : none; | |||
} | |||
/* Commented Backslash Hack hides rule from IE5-Mac \*/ | |||
DIV.tabs SPAN {float : none;} | |||
/* End IE5-Mac hack */ | |||
DIV.tabs A:hover SPAN | |||
{ | |||
background-position: 0% -150px; | |||
} | |||
DIV.tabs LI.current A | |||
{ | |||
background-position: 100% -150px; | |||
border-width : 0px; | |||
} | |||
DIV.tabs LI.current SPAN | |||
{ | |||
background-position: 0% -150px; | |||
padding-bottom : 6px; | |||
} | |||
DIV.navpath | |||
{ | |||
background : none; | |||
border : none; | |||
border-bottom : 1px solid #84B0C7; | |||
text-align : center; | |||
margin : 2px; | |||
padding : 2px; | |||
} |
@@ -8,7 +8,7 @@ OBJECTS = RtAudio.o @objects@ | |||
STATIC = librtaudio.a | |||
SHARED = @sharedlib@ | |||
RELEASE = 4.0.11 | |||
RELEASE = 4.0.12 | |||
MAJOR = 4 | |||
LIBRARIES = $(STATIC) $(SHARED) | |||
@@ -28,9 +28,8 @@ $(LIBRARIES): $(OBJECTS) | |||
$(AR) ruv $(STATIC) $(OBJECTS) | |||
ranlib $(STATIC) | |||
$(CC) -fPIC @libflags@ $(OBJECTS) @LIBS@ | |||
$(LN) -s @sharedname@ $(SHARED) | |||
# $(CC) -shared $(OBJECTS) -o $(SHARED) @LIBS@ | |||
$(LN) -sf @sharedname@ $(SHARED) | |||
$(LN) -sf @sharedname@ $(SHARED).$(MAJOR) | |||
%.o : %.cpp | |||
$(CC) $(CFLAGS) $(DEFS) -c $(<) -o $@ | |||
@@ -48,7 +47,7 @@ distclean: | |||
$(RM) -f $(LIBRARIES) @sharedname@ $(SHARED)* | |||
$(RM) -f $(OBJECTS) | |||
$(RM) -f *~ | |||
$(RM) -rf config.log config.status autom4te.cache Makefile rtaudio-config | |||
$(RM) -rf config.log config.status autom4te.cache Makefile rtaudio-config librtaudio.pc | |||
cd tests && $(MAKE) distclean | |||
strip : |
@@ -10,7 +10,7 @@ | |||
RtAudio WWW site: http://www.music.mcgill.ca/~gary/rtaudio/ | |||
RtAudio: realtime audio i/o C++ classes | |||
Copyright (c) 2001-2012 Gary P. Scavone | |||
Copyright (c) 2001-2013 Gary P. Scavone | |||
Permission is hereby granted, free of charge, to any person | |||
obtaining a copy of this software and associated documentation files | |||
@@ -42,17 +42,16 @@ | |||
\file RtAudio.h | |||
*/ | |||
// RtAudio: Version 4.0.11 | |||
#ifndef __RTAUDIO_H | |||
#define __RTAUDIO_H | |||
#include "CarlaDefines.hpp" | |||
#include <string> | |||
#include <vector> | |||
#include "RtError.h" | |||
// RtAudio version | |||
static const std::string VERSION( "4.0.12" ); | |||
/*! \typedef typedef unsigned long RtAudioFormat; | |||
\brief RtAudio data format type. | |||
@@ -61,12 +60,10 @@ | |||
internal routines will automatically take care of any necessary | |||
byte-swapping between the host format and the soundcard. Thus, | |||
endian-ness is not a concern in the following format definitions. | |||
Note that 24-bit data is expected to be encapsulated in a 32-bit | |||
format. | |||
- \e RTAUDIO_SINT8: 8-bit signed integer. | |||
- \e RTAUDIO_SINT16: 16-bit signed integer. | |||
- \e RTAUDIO_SINT24: Lower 3 bytes of 32-bit signed integer. | |||
- \e RTAUDIO_SINT24: 24-bit signed integer. | |||
- \e RTAUDIO_SINT32: 32-bit signed integer. | |||
- \e RTAUDIO_FLOAT32: Normalized between plus/minus 1.0. | |||
- \e RTAUDIO_FLOAT64: Normalized between plus/minus 1.0. | |||
@@ -74,7 +71,7 @@ | |||
typedef unsigned long RtAudioFormat; | |||
static const RtAudioFormat RTAUDIO_SINT8 = 0x1; // 8-bit signed integer. | |||
static const RtAudioFormat RTAUDIO_SINT16 = 0x2; // 16-bit signed integer. | |||
static const RtAudioFormat RTAUDIO_SINT24 = 0x4; // Lower 3 bytes of 32-bit signed integer. | |||
static const RtAudioFormat RTAUDIO_SINT24 = 0x4; // 24-bit signed integer. | |||
static const RtAudioFormat RTAUDIO_SINT32 = 0x8; // 32-bit signed integer. | |||
static const RtAudioFormat RTAUDIO_FLOAT32 = 0x10; // Normalized between plus/minus 1.0. | |||
static const RtAudioFormat RTAUDIO_FLOAT64 = 0x20; // Normalized between plus/minus 1.0. | |||
@@ -188,6 +185,12 @@ typedef int (*RtAudioCallback)( void *outputBuffer, void *inputBuffer, | |||
RtAudioStreamStatus status, | |||
void *userData ); | |||
//! RtAudio error callback function prototype. | |||
/*! | |||
\param type Type of error. | |||
\param errorText Error description. | |||
*/ | |||
typedef void (*RtAudioErrorCallback)( RtError::Type type, const std::string &errorText ); | |||
// **************************************************************** // | |||
// | |||
@@ -318,6 +321,9 @@ class RtAudio | |||
: flags(0), numberOfBuffers(0), priority(0) {} | |||
}; | |||
//! A static function to determine the current RtAudio version. | |||
static std::string getVersion( void ) { return VERSION; } | |||
//! A static function to determine the available compiled audio APIs. | |||
/*! | |||
The values returned in the std::vector can be compared against | |||
@@ -425,12 +431,14 @@ class RtAudio | |||
chosen. If the RTAUDIO_MINIMIZE_LATENCY flag bit is set, the | |||
lowest allowable value is used. The actual value used is | |||
returned via the structure argument. The parameter is API dependent. | |||
\param errorCallback A client-defined function that will be invoked | |||
when an error has occured. | |||
*/ | |||
void openStream( RtAudio::StreamParameters *outputParameters, | |||
RtAudio::StreamParameters *inputParameters, | |||
RtAudioFormat format, unsigned int sampleRate, | |||
unsigned int *bufferFrames, RtAudioCallback callback, | |||
void *userData = NULL, RtAudio::StreamOptions *options = NULL ); | |||
void *userData = NULL, RtAudio::StreamOptions *options = NULL, RtAudioErrorCallback errorCallback = NULL ); | |||
//! A function that closes a stream and frees any associated stream memory. | |||
/*! | |||
@@ -537,12 +545,15 @@ struct CallbackInfo { | |||
ThreadHandle thread; | |||
void *callback; | |||
void *userData; | |||
void *errorCallback; | |||
void *apiInfo; // void pointer for API specific callback information | |||
bool isRunning; | |||
bool doRealtime; | |||
int priority; | |||
// Default constructor. | |||
CallbackInfo() | |||
:object(nullptr), callback(nullptr), userData(nullptr), apiInfo(nullptr), isRunning(false) {} | |||
:object(0), callback(0), userData(0), errorCallback(0), apiInfo(0), isRunning(false), doRealtime(false) {} | |||
}; | |||
// **************************************************************** // | |||
@@ -559,6 +570,36 @@ struct CallbackInfo { | |||
// | |||
// **************************************************************** // | |||
#pragma pack(push, 1) | |||
class S24 { | |||
protected: | |||
unsigned char c3[3]; | |||
public: | |||
S24() {} | |||
S24& operator = ( const int& i ) { | |||
c3[0] = (i & 0x000000ff); | |||
c3[1] = (i & 0x0000ff00) >> 8; | |||
c3[2] = (i & 0x00ff0000) >> 16; | |||
return *this; | |||
} | |||
S24( const S24& v ) { *this = v; } | |||
S24( const double& d ) { *this = (int) d; } | |||
S24( const float& f ) { *this = (int) f; } | |||
S24( const signed short& s ) { *this = (int) s; } | |||
S24( const char& c ) { *this = (int) c; } | |||
int asInt() { | |||
int i = c3[0] | (c3[1] << 8) | (c3[2] << 16); | |||
if (i & 0x800000) i |= ~0xffffff; | |||
return i; | |||
} | |||
}; | |||
#pragma pack(pop) | |||
#if defined( HAVE_GETTIMEOFDAY ) | |||
#include <sys/time.h> | |||
#endif | |||
@@ -580,7 +621,8 @@ public: | |||
RtAudio::StreamParameters *inputParameters, | |||
RtAudioFormat format, unsigned int sampleRate, | |||
unsigned int *bufferFrames, RtAudioCallback callback, | |||
void *userData, RtAudio::StreamOptions *options ); | |||
void *userData, RtAudio::StreamOptions *options, | |||
RtAudioErrorCallback errorCallback ); | |||
virtual void closeStream( void ); | |||
virtual void startStream( void ) = 0; | |||
virtual void stopStream( void ) = 0; | |||
@@ -588,9 +630,9 @@ public: | |||
long getStreamLatency( void ); | |||
unsigned int getStreamSampleRate( void ); | |||
virtual double getStreamTime( void ); | |||
bool isStreamOpen( void ) const { return stream_.state != STREAM_CLOSED; }; | |||
bool isStreamRunning( void ) const { return stream_.state == STREAM_RUNNING; }; | |||
void showWarnings( bool value ) { showWarnings_ = value; }; | |||
bool isStreamOpen( void ) const { return stream_.state != STREAM_CLOSED; } | |||
bool isStreamRunning( void ) const { return stream_.state == STREAM_RUNNING; } | |||
void showWarnings( bool value ) { showWarnings_ = value; } | |||
protected: | |||
@@ -654,9 +696,10 @@ protected: | |||
#endif | |||
RtApiStream() | |||
:apiHandle(nullptr), deviceBuffer(nullptr) { device[0] = 11111; device[1] = 11111; } | |||
:apiHandle(0), deviceBuffer(0) { device[0] = 11111; device[1] = 11111; } | |||
}; | |||
typedef S24 Int24; | |||
typedef signed short Int16; | |||
typedef signed int Int32; | |||
typedef float Float32; | |||
@@ -744,7 +787,7 @@ public: | |||
RtApiCore(); | |||
~RtApiCore(); | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::MACOSX_CORE; }; | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::MACOSX_CORE; } | |||
unsigned int getDeviceCount( void ); | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ); | |||
unsigned int getDefaultOutputDevice( void ); | |||
@@ -782,7 +825,7 @@ public: | |||
RtApiJack(); | |||
~RtApiJack(); | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::UNIX_JACK; }; | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::UNIX_JACK; } | |||
unsigned int getDeviceCount( void ); | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ); | |||
void closeStream( void ); | |||
@@ -815,7 +858,7 @@ public: | |||
RtApiAsio(); | |||
~RtApiAsio(); | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::WINDOWS_ASIO; }; | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::WINDOWS_ASIO; } | |||
unsigned int getDeviceCount( void ); | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ); | |||
void closeStream( void ); | |||
@@ -851,7 +894,7 @@ public: | |||
RtApiDs(); | |||
~RtApiDs(); | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::WINDOWS_DS; }; | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::WINDOWS_DS; } | |||
unsigned int getDeviceCount( void ); | |||
unsigned int getDefaultOutputDevice( void ); | |||
unsigned int getDefaultInputDevice( void ); | |||
@@ -873,6 +916,7 @@ public: | |||
bool coInitialized_; | |||
bool buffersRolling; | |||
long duplexPrerollBytes; | |||
std::vector<struct DsDevice> dsDevices; | |||
bool probeDeviceOpen( unsigned int device, StreamMode mode, unsigned int channels, | |||
unsigned int firstChannel, unsigned int sampleRate, | |||
RtAudioFormat format, unsigned int *bufferSize, | |||
@@ -889,7 +933,7 @@ public: | |||
RtApiAlsa(); | |||
~RtApiAlsa(); | |||
RtAudio::Api getCurrentApi() { return RtAudio::LINUX_ALSA; }; | |||
RtAudio::Api getCurrentApi() { return RtAudio::LINUX_ALSA; } | |||
unsigned int getDeviceCount( void ); | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ); | |||
void closeStream( void ); | |||
@@ -921,7 +965,7 @@ class RtApiPulse: public RtApi | |||
{ | |||
public: | |||
~RtApiPulse(); | |||
RtAudio::Api getCurrentApi() { return RtAudio::LINUX_PULSE; }; | |||
RtAudio::Api getCurrentApi() { return RtAudio::LINUX_PULSE; } | |||
unsigned int getDeviceCount( void ); | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ); | |||
void closeStream( void ); | |||
@@ -955,7 +999,7 @@ public: | |||
RtApiOss(); | |||
~RtApiOss(); | |||
RtAudio::Api getCurrentApi() { return RtAudio::LINUX_OSS; }; | |||
RtAudio::Api getCurrentApi() { return RtAudio::LINUX_OSS; } | |||
unsigned int getDeviceCount( void ); | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ); | |||
void closeStream( void ); | |||
@@ -985,21 +1029,21 @@ class RtApiDummy: public RtApi | |||
{ | |||
public: | |||
RtApiDummy() { errorText_ = "RtApiDummy: This class provides no functionality."; error( RtError::WARNING ); }; | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::RTAUDIO_DUMMY; }; | |||
unsigned int getDeviceCount( void ) { return 0; }; | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int device ) { RtAudio::DeviceInfo info; return info; }; | |||
void closeStream( void ) {}; | |||
void startStream( void ) {}; | |||
void stopStream( void ) {}; | |||
void abortStream( void ) {}; | |||
RtApiDummy() { errorText_ = "RtApiDummy: This class provides no functionality."; error( RtError::WARNING ); } | |||
RtAudio::Api getCurrentApi( void ) { return RtAudio::RTAUDIO_DUMMY; } | |||
unsigned int getDeviceCount( void ) { return 0; } | |||
RtAudio::DeviceInfo getDeviceInfo( unsigned int /*device*/ ) { RtAudio::DeviceInfo info; return info; } | |||
void closeStream( void ) {} | |||
void startStream( void ) {} | |||
void stopStream( void ) {} | |||
void abortStream( void ) {} | |||
private: | |||
bool probeDeviceOpen( unsigned int device, StreamMode mode, unsigned int channels, | |||
unsigned int firstChannel, unsigned int sampleRate, | |||
RtAudioFormat format, unsigned int *bufferSize, | |||
RtAudio::StreamOptions *options ) { return false; }; | |||
bool probeDeviceOpen( unsigned int /*device*/, StreamMode /*mode*/, unsigned int /*channels*/, | |||
unsigned int /*firstChannel*/, unsigned int /*sampleRate*/, | |||
RtAudioFormat /*format*/, unsigned int * /*bufferSize*/, | |||
RtAudio::StreamOptions * /*options*/ ) { return false; } | |||
}; | |||
#endif |
@@ -3,7 +3,7 @@ | |||
# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001 | |||
# Free Software Foundation, Inc. | |||
timestamp='2004-02-26' | |||
timestamp='2012-11-19' | |||
# This file is (in principle) common to ALL GNU software. | |||
# The presence of a machine in this file suggests that SOME GNU software | |||
@@ -225,7 +225,7 @@ case $basic_machine in | |||
| alpha | alphaev[4-8] | alphaev56 | alphapca5[67] \ | |||
| alphaev6[78] \ | |||
| we32k | ns16k | clipper | i370 | sh | sh[34] \ | |||
| powerpc | powerpcle \ | |||
| powerpc | powerpc64 | powerpcle \ | |||
| 1750a | dsp16xx | pdp10 | pdp11 \ | |||
| mips16 | mips64 | mipsel | mips64el \ | |||
| mips64orion | mips64orionel | mipstx39 | mipstx39el \ | |||
@@ -271,7 +271,7 @@ case $basic_machine in | |||
| alphaev6[78]-* \ | |||
| we32k-* | cydra-* | ns16k-* | pn-* | np1-* | xps100-* \ | |||
| clipper-* | orion-* \ | |||
| sparclite-* | pdp10-* | pdp11-* | sh-* | powerpc-* | powerpcle-* \ | |||
| sparclite-* | pdp10-* | pdp11-* | sh-* | powerpc-* | powerpc64-* | powerpcle-* \ | |||
| sparc64-* | sparcv9-* | sparcv9b-* | sparc86x-* \ | |||
| mips16-* | mips64-* | mipsel-* \ | |||
| mips64el-* | mips64orion-* | mips64orionel-* \ | |||
@@ -721,6 +721,10 @@ case $basic_machine in | |||
;; | |||
ppc-*) basic_machine=powerpc-`echo $basic_machine | sed 's/^[^-]*-//'` | |||
;; | |||
ppc64) basic_machine=powerpc64-unknown | |||
;; | |||
ppc64-*) basic_machine=powerpc64-`echo $basic_machine | sed 's/^[^-]*-//'` | |||
;; | |||
ppcle | powerpclittle | ppc-le | powerpc-little) | |||
basic_machine=powerpcle-unknown | |||
;; |
@@ -2,11 +2,25 @@ | |||
AC_INIT(RtAudio, 4.0, gary@music.mcgill.ca, rtaudio) | |||
AC_CONFIG_AUX_DIR(config) | |||
AC_CONFIG_SRCDIR(RtAudio.cpp) | |||
AC_CONFIG_FILES([rtaudio-config Makefile tests/Makefile]) | |||
AC_CONFIG_FILES([rtaudio-config librtaudio.pc Makefile tests/Makefile]) | |||
# Fill GXX with something before test. | |||
AC_SUBST( GXX, ["no"] ) | |||
dnl Check for pkg-config program, used for configuring some libraries. | |||
m4_define_default([PKG_PROG_PKG_CONFIG], | |||
[AC_MSG_CHECKING([pkg-config]) | |||
AC_MSG_RESULT([no])]) | |||
PKG_PROG_PKG_CONFIG | |||
dnl If the pkg-config autoconf support isn't installed, define its | |||
dnl autoconf macro to disable any packages depending on it. | |||
m4_define_default([PKG_CHECK_MODULES], | |||
[AC_MSG_CHECKING([$1]) | |||
AC_MSG_RESULT([no]) | |||
$4]) | |||
# Checks for programs. | |||
AC_PROG_CXX(g++ CC c++ cxx) | |||
AC_PROG_RANLIB | |||
@@ -58,6 +72,7 @@ esac | |||
# Checks for package options and external software | |||
AC_SUBST( api, [""] ) | |||
AC_SUBST( req, [""] ) | |||
AC_MSG_CHECKING(for audio API) | |||
case $host in | |||
*-*-netbsd*) | |||
@@ -77,14 +92,17 @@ case $host in | |||
# Look for ALSA flag | |||
AC_ARG_WITH(alsa, [ --with-alsa = choose native ALSA API support (linux only)], [ | |||
api="$api -D__LINUX_ALSA__" | |||
req="$req alsa" | |||
AC_MSG_RESULT(using ALSA) | |||
AC_CHECK_LIB(asound, snd_pcm_open, , AC_MSG_ERROR(ALSA support requires the asound library!))], ) | |||
# Look for PULSE flag | |||
AC_ARG_WITH(pulse, [ --with-pulse = choose PulseAudio API support (linux only)], [ | |||
api="$api -D__LINUX_PULSE__" | |||
req="$req libpulse-simple" | |||
AC_MSG_RESULT(using PulseAudio) | |||
AC_CHECK_LIB(pulse-simple, pa_simple_new, , AC_MSG_ERROR(PulseAudio support requires the pulse-simple library!))], ) | |||
PKG_CHECK_MODULES([PULSE], [libpulse-simple], , AC_MSG_ERROR(PulseAudio support requires the pulse-simple library!)) | |||
LIBS="$LIBS `pkg-config --libs libpulse-simple`" ], ) | |||
# Look for OSS flag | |||
AC_ARG_WITH(oss, [ --with-oss = choose OSS API support (linux only)], [ | |||
@@ -95,6 +113,7 @@ case $host in | |||
if [test "$api" == "";] then | |||
AC_MSG_RESULT(using ALSA) | |||
AC_SUBST( api, [-D__LINUX_ALSA__] ) | |||
req="$req alsa" | |||
AC_CHECK_LIB(asound, snd_pcm_open, , AC_MSG_ERROR(ALSA support requires the asound library!)) | |||
fi | |||
@@ -31,7 +31,7 @@ PROJECT_NAME = RtAudio | |||
# This could be handy for archiving the generated documentation or | |||
# if some version control system is used. | |||
PROJECT_NUMBER = 4.0.11 | |||
PROJECT_NUMBER = 4.0.12 | |||
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) | |||
# base path where the generated documentation will be put. |
@@ -32,7 +32,7 @@ In order to compile RtAudio for a specific OS and audio API, it is necessary to | |||
<TD>RtApiPulse</TD> | |||
<TD>__LINUX_PULSE__</TD> | |||
<TD><TT>pthread</TT></TD> | |||
<TD><TT>g++ -Wall -D__LINUX_PULSE__ -o audioprobe audioprobe.cpp RtAudio.cpp -lpthread</TT></TD> | |||
<TD><TT>g++ -Wall -D__LINUX_PULSE__ -o audioprobe audioprobe.cpp RtAudio.cpp -lpthread -lpulse-simple -lpulse</TT></TD> | |||
</TR> | |||
<TR> | |||
<TD>Linux</TD> |
@@ -1,7 +1,7 @@ | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> |
@@ -15,24 +15,21 @@ RtAudio is a set of C++ classes that provide a common API (Application Programmi | |||
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 \ref apinotes section for information specific to each of the supported audio APIs. | |||
\section whatsnew What's New (Version 4.0) | |||
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. | |||
\section whatsnew Latest Updates (Version 4.0.12) | |||
- new functionality to allow error reporting via a client-supplied function (thanks to Pavel Mogilevskiy) | |||
- new function to return the version number | |||
- updated RtAudio.cpp and ASIO files for UNICODE support (thanks to Renaud Schoonbroodt) | |||
- updates to PulseAudio API support (thanks to Peter Meerwald and Tristan Matthews) | |||
- updates for pkg-config support in configure script | |||
- 24-bit format changed to true 24-bit format, not sub-bytes of 32-bits (thanks to Marc Britton) | |||
- bug fixes to make sure stream status is closed if error during probeDeviceOpen | |||
- updates / fixes to SCHED_RR code in ALSA (thanks to Marc Lindahl) | |||
- various changes to avoid global variables (thanks to Martin Koegler) | |||
\section download Download | |||
Latest Release (14 June 2012): <A href="http://www.music.mcgill.ca/~gary/rtaudio/release/rtaudio-4.0.11.tar.gz">Version 4.0.11</A> | |||
Latest Release (16 April 2013): <A href="http://www.music.mcgill.ca/~gary/rtaudio/release/rtaudio-4.0.12.tar.gz">Version 4.0.12</A> | |||
\section documentation Documentation Links | |||
@@ -0,0 +1,184 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="summary"> | |||
<a href="#nested-classes">Classes</a> | | |||
<a href="#typedef-members">Typedefs</a> </div> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio.h File Reference</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><code>#include <string></code><br/> | |||
<code>#include <vector></code><br/> | |||
<code>#include "RtError.h"</code><br/> | |||
<code>#include <sstream></code><br/> | |||
</div> | |||
<p><a href="RtAudio_8h_source.html">Go to the source code of this file.</a></p> | |||
<table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a> | |||
Classes</h2></td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html">RtAudio</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Realtime audio i/o C++ classes. <a href="classRtAudio.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The public device information structure for returning queried values. <a href="structRtAudio_1_1DeviceInfo.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying input or ouput stream parameters. <a href="structRtAudio_1_1StreamParameters.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying stream options. <a href="structRtAudio_1_1StreamOptions.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table><table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a> | |||
Typedefs</h2></td></tr> | |||
<tr class="memitem:aafca92882d25915560018873221e44b8"><td class="memItemLeft" align="right" valign="top">typedef unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a></td></tr> | |||
<tr class="memdesc:aafca92882d25915560018873221e44b8"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> data format type. <a href="#aafca92882d25915560018873221e44b8"></a><br/></td></tr> | |||
<tr class="separator:aafca92882d25915560018873221e44b8"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a2c0f59b200dcec4d4e760f9166b29c41"><td class="memItemLeft" align="right" valign="top">typedef unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a></td></tr> | |||
<tr class="memdesc:a2c0f59b200dcec4d4e760f9166b29c41"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream option flags. <a href="#a2c0f59b200dcec4d4e760f9166b29c41"></a><br/></td></tr> | |||
<tr class="separator:a2c0f59b200dcec4d4e760f9166b29c41"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a80e306d363583da3b0a1b65d9b57c806"><td class="memItemLeft" align="right" valign="top">typedef unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a></td></tr> | |||
<tr class="memdesc:a80e306d363583da3b0a1b65d9b57c806"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream status (over- or underflow) flags. <a href="#a80e306d363583da3b0a1b65d9b57c806"></a><br/></td></tr> | |||
<tr class="separator:a80e306d363583da3b0a1b65d9b57c806"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a112c7b7e25a974977f6fc094cef1a31f"><td class="memItemLeft" align="right" valign="top">typedef int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a> )(void *outputBuffer, void *inputBuffer, unsigned int nFrames, double streamTime, <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a> status, void *userData)</td></tr> | |||
<tr class="memdesc:a112c7b7e25a974977f6fc094cef1a31f"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> callback function prototype. <a href="#a112c7b7e25a974977f6fc094cef1a31f"></a><br/></td></tr> | |||
<tr class="separator:a112c7b7e25a974977f6fc094cef1a31f"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a2c8c34d284ae138dd29b53375ec9f062"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062">RtAudioErrorCallback</a> )(<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">RtError::Type</a> type, const std::string &errorText)</td></tr> | |||
<tr class="memdesc:a2c8c34d284ae138dd29b53375ec9f062"><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> error callback function prototype. <a href="#a2c8c34d284ae138dd29b53375ec9f062"></a><br/></td></tr> | |||
<tr class="separator:a2c8c34d284ae138dd29b53375ec9f062"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table> | |||
<h2 class="groupheader">Typedef Documentation</h2> | |||
<a class="anchor" id="aafca92882d25915560018873221e44b8"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef unsigned long <a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a></td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> data format type. </p> | |||
<p>Support for signed integers and floats. Audio data fed to/from an <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream is assumed to ALWAYS be in host byte order. The internal routines will automatically take care of any necessary byte-swapping between the host format and the soundcard. Thus, endian-ness is not a concern in the following format definitions.</p> | |||
<ul> | |||
<li><em>RTAUDIO_SINT8:</em> 8-bit signed integer.</li> | |||
<li><em>RTAUDIO_SINT16:</em> 16-bit signed integer.</li> | |||
<li><em>RTAUDIO_SINT24:</em> 24-bit signed integer.</li> | |||
<li><em>RTAUDIO_SINT32:</em> 32-bit signed integer.</li> | |||
<li><em>RTAUDIO_FLOAT32:</em> Normalized between plus/minus 1.0.</li> | |||
<li><em>RTAUDIO_FLOAT64:</em> Normalized between plus/minus 1.0. </li> | |||
</ul> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a2c0f59b200dcec4d4e760f9166b29c41"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef unsigned long <a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a></td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream option flags. </p> | |||
<p>The following flags can be OR'ed together to allow a client to make changes to the default stream behavior:</p> | |||
<ul> | |||
<li><em>RTAUDIO_NONINTERLEAVED:</em> Use non-interleaved buffers (default = interleaved).</li> | |||
<li><em>RTAUDIO_MINIMIZE_LATENCY:</em> Attempt to set stream parameters for lowest possible latency.</li> | |||
<li><em>RTAUDIO_HOG_DEVICE:</em> Attempt grab device for exclusive use.</li> | |||
<li><em>RTAUDIO_ALSA_USE_DEFAULT:</em> Use the "default" PCM device (ALSA only).</li> | |||
</ul> | |||
<p>By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> streams pass and receive audio data from the client in an interleaved format. By passing the RTAUDIO_NONINTERLEAVED flag to the openStream() function, audio data will instead be presented in non-interleaved buffers. In this case, each buffer argument in the RtAudioCallback function will point to a single array of data, with <code>nFrames</code> samples for each channel concatenated back-to-back. For example, the first sample of data for the second channel would be located at index <code>nFrames</code> (assuming the <code>buffer</code> pointer was recast to the correct data type for the stream).</p> | |||
<p>Certain audio APIs offer a number of parameters that influence the I/O latency of a stream. By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to set these parameters internally for robust (glitch-free) performance (though some APIs, like Windows Direct Sound, make this difficult). By passing the RTAUDIO_MINIMIZE_LATENCY flag to the openStream() function, internal stream settings will be influenced in an attempt to minimize stream latency, though possibly at the expense of stream performance.</p> | |||
<p>If the RTAUDIO_HOG_DEVICE flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to open the input and/or output stream device(s) for exclusive use. Note that this is not possible with all supported audio APIs.</p> | |||
<p>If the RTAUDIO_SCHEDULE_REALTIME flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to select realtime scheduling (round-robin) for the callback thread.</p> | |||
<p>If the RTAUDIO_ALSA_USE_DEFAULT flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to open the "default" PCM device when using the ALSA API. Note that this will override any specified input or output device id. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a80e306d363583da3b0a1b65d9b57c806"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef unsigned long <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a></td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> stream status (over- or underflow) flags. </p> | |||
<p>Notification of a stream over- or underflow is indicated by a non-zero stream <code>status</code> argument in the RtAudioCallback function. The stream status can be one of the following two options, depending on whether the stream is open for output and/or input:</p> | |||
<ul> | |||
<li><em>RTAUDIO_INPUT_OVERFLOW:</em> Input data was discarded because of an overflow condition at the driver.</li> | |||
<li><em>RTAUDIO_OUTPUT_UNDERFLOW:</em> The output buffer ran low, likely producing a break in the output sound. </li> | |||
</ul> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a112c7b7e25a974977f6fc094cef1a31f"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef int(* RtAudioCallback)(void *outputBuffer, void *inputBuffer, unsigned int nFrames, double streamTime, <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudioStreamStatus</a> status, void *userData)</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> callback function prototype. </p> | |||
<p>All <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> clients must create a function of type RtAudioCallback to read and/or write data from/to the audio stream. When the underlying audio system is ready for new input or output data, this function will be invoked.</p> | |||
<dl class="params"><dt>Parameters</dt><dd> | |||
<table class="params"> | |||
<tr><td class="paramname">outputBuffer</td><td>For output (or duplex) streams, the client should write <code>nFrames</code> of audio sample frames into this buffer. This argument should be recast to the datatype specified when the stream was opened. For input-only streams, this argument will be NULL.</td></tr> | |||
<tr><td class="paramname">inputBuffer</td><td>For input (or duplex) streams, this buffer will hold <code>nFrames</code> of input audio sample frames. This argument should be recast to the datatype specified when the stream was opened. For output-only streams, this argument will be NULL.</td></tr> | |||
<tr><td class="paramname">nFrames</td><td>The number of sample frames of input or output data in the buffers. The actual buffer size in bytes is dependent on the data type and number of channels in use.</td></tr> | |||
<tr><td class="paramname">streamTime</td><td>The number of seconds that have elapsed since the stream was started.</td></tr> | |||
<tr><td class="paramname">status</td><td>If non-zero, this argument indicates a data overflow or underflow condition for the stream. The particular condition can be determined by comparison with the RtAudioStreamStatus flags.</td></tr> | |||
<tr><td class="paramname">userData</td><td>A pointer to optional data provided by the client when opening the stream (default = NULL).</td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
<p>To continue normal stream operation, the RtAudioCallback function should return a value of zero. To stop the stream and drain the output buffer, the function should return a value of one. To abort the stream immediately, the client should return a value of two. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a2c8c34d284ae138dd29b53375ec9f062"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">typedef void(* RtAudioErrorCallback)(<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">RtError::Type</a> type, const std::string &errorText)</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> error callback function prototype. </p> | |||
<dl class="params"><dt>Parameters</dt><dd> | |||
<table class="params"> | |||
<tr><td class="paramname">type</td><td>Type of error. </td></tr> | |||
<tr><td class="paramname">errorText</td><td>Error description. </td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,721 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio.h</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<a href="RtAudio_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/************************************************************************/</span></div> | |||
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment">/************************************************************************/</span></div> | |||
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div> | |||
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="preprocessor">#ifndef __RTAUDIO_H</span></div> | |||
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="preprocessor"></span><span class="preprocessor">#define __RTAUDIO_H</span></div> | |||
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="preprocessor">#include <string></span></div> | |||
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="preprocessor">#include <vector></span></div> | |||
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="preprocessor">#include "RtError.h"</span></div> | |||
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> </div> | |||
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// RtAudio version</span></div> | |||
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="keyword">static</span> <span class="keyword">const</span> std::string VERSION( <span class="stringliteral">"4.0.12"</span> );</div> | |||
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div> | |||
<div class="line"><a name="l00071"></a><span class="lineno"><a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8"> 71</a></span> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a>;</div> | |||
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT8 = 0x1; <span class="comment">// 8-bit signed integer.</span></div> | |||
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT16 = 0x2; <span class="comment">// 16-bit signed integer.</span></div> | |||
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT24 = 0x4; <span class="comment">// 24-bit signed integer.</span></div> | |||
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_SINT32 = 0x8; <span class="comment">// 32-bit signed integer.</span></div> | |||
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_FLOAT32 = 0x10; <span class="comment">// Normalized between plus/minus 1.0.</span></div> | |||
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> RTAUDIO_FLOAT64 = 0x20; <span class="comment">// Normalized between plus/minus 1.0.</span></div> | |||
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> </div> | |||
<div class="line"><a name="l00121"></a><span class="lineno"><a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41"> 121</a></span> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a>;</div> | |||
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_NONINTERLEAVED = 0x1; <span class="comment">// Use non-interleaved buffers (default = interleaved).</span></div> | |||
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_MINIMIZE_LATENCY = 0x2; <span class="comment">// Attempt to set stream parameters for lowest possible latency.</span></div> | |||
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_HOG_DEVICE = 0x4; <span class="comment">// Attempt grab device and prevent use by others.</span></div> | |||
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_SCHEDULE_REALTIME = 0x8; <span class="comment">// Try to select realtime scheduling for callback thread.</span></div> | |||
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> RTAUDIO_ALSA_USE_DEFAULT = 0x10; <span class="comment">// Use the "default" PCM device (ALSA only).</span></div> | |||
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> </div> | |||
<div class="line"><a name="l00139"></a><span class="lineno"><a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806"> 139</a></span> <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a>;</div> | |||
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> RTAUDIO_INPUT_OVERFLOW = 0x1; <span class="comment">// Input data was discarded because of an overflow condition at the driver.</span></div> | |||
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> RTAUDIO_OUTPUT_UNDERFLOW = 0x2; <span class="comment">// The output buffer ran low, likely causing a gap in the output sound.</span></div> | |||
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span> </div> | |||
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div> | |||
<div class="line"><a name="l00182"></a><span class="lineno"><a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f"> 182</a></span> <span class="keyword">typedef</span> int (*<a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f" title="RtAudio callback function prototype.">RtAudioCallback</a>)( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer,</div> | |||
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nFrames,</div> | |||
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keywordtype">double</span> streamTime,</div> | |||
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status,</div> | |||
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keywordtype">void</span> *userData );</div> | |||
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> </div> | |||
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span> </div> | |||
<div class="line"><a name="l00193"></a><span class="lineno"><a class="code" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062"> 193</a></span> <span class="keyword">typedef</span> void (*<a class="code" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062" title="RtAudio error callback function prototype.">RtAudioErrorCallback</a>)( <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">RtError::Type</a> type, <span class="keyword">const</span> std::string &errorText );</div> | |||
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span> </div> | |||
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="comment">// **************************************************************** //</span></div> | |||
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span> <span class="comment">// RtAudio class declaration.</span></div> | |||
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span> <span class="comment">// RtAudio is a "controller" used to select an available audio i/o</span></div> | |||
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="comment">// interface. It presents a common API for the user to call but all</span></div> | |||
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="comment">// functionality is implemented by the class RtApi and its</span></div> | |||
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <span class="comment">// subclasses. RtAudio creates an instance of an RtApi subclass</span></div> | |||
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span> <span class="comment">// based on the user's API choice. If no choice is made, RtAudio</span></div> | |||
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// attempts to make a "logical" API selection.</span></div> | |||
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span> <span class="comment">// **************************************************************** //</span></div> | |||
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span> </div> | |||
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="keyword">class </span>RtApi;</div> | |||
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span> </div> | |||
<div class="line"><a name="l00210"></a><span class="lineno"><a class="code" href="classRtAudio.html"> 210</a></span> <span class="keyword">class </span><a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a></div> | |||
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span> {</div> | |||
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div> | |||
<div class="line"><a name="l00215"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849"> 215</a></span>  <span class="keyword">enum</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">Api</a> {</div> | |||
<div class="line"><a name="l00216"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae"> 216</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a>, </div> | |||
<div class="line"><a name="l00217"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8"> 217</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">LINUX_ALSA</a>, </div> | |||
<div class="line"><a name="l00218"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77"> 218</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">LINUX_PULSE</a>, </div> | |||
<div class="line"><a name="l00219"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82"> 219</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">LINUX_OSS</a>, </div> | |||
<div class="line"><a name="l00220"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105"> 220</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">UNIX_JACK</a>, </div> | |||
<div class="line"><a name="l00221"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d"> 221</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">MACOSX_CORE</a>, </div> | |||
<div class="line"><a name="l00222"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469"> 222</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">WINDOWS_ASIO</a>, </div> | |||
<div class="line"><a name="l00223"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931"> 223</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">WINDOWS_DS</a>, </div> | |||
<div class="line"><a name="l00224"></a><span class="lineno"><a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1"> 224</a></span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RTAUDIO_DUMMY</a> </div> | |||
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  };</div> | |||
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> </div> | |||
<div class="line"><a name="l00228"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html"> 228</a></span>  <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">DeviceInfo</a> {</div> | |||
<div class="line"><a name="l00229"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d"> 229</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a>; </div> | |||
<div class="line"><a name="l00230"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b"> 230</a></span>  std::string <a class="code" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a>; </div> | |||
<div class="line"><a name="l00231"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d"> 231</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a>; </div> | |||
<div class="line"><a name="l00232"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275"> 232</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a>; </div> | |||
<div class="line"><a name="l00233"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7"> 233</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a>; </div> | |||
<div class="line"><a name="l00234"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58"> 234</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a>; </div> | |||
<div class="line"><a name="l00235"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2"> 235</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a>; </div> | |||
<div class="line"><a name="l00236"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f"> 236</a></span>  std::vector<unsigned int> <a class="code" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a>; </div> | |||
<div class="line"><a name="l00237"></a><span class="lineno"><a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4"> 237</a></span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a>; </div> | |||
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="comment">// Default constructor.</span></div> | |||
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">DeviceInfo</a>()</div> | |||
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span>  :<a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a>(false), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a>(0), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a>(0), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a>(0),</div> | |||
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a>(false), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a>(false), <a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a>(0) {}</div> | |||
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span>  };</div> | |||
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span> </div> | |||
<div class="line"><a name="l00246"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamParameters.html"> 246</a></span>  <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">StreamParameters</a> {</div> | |||
<div class="line"><a name="l00247"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489"> 247</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a>; </div> | |||
<div class="line"><a name="l00248"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd"> 248</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a>; </div> | |||
<div class="line"><a name="l00249"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c"> 249</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a>; </div> | |||
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="comment">// Default constructor.</span></div> | |||
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span>  <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">StreamParameters</a>()</div> | |||
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  : <a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a>(0), <a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a>(0), <a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a>(0) {}</div> | |||
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  };</div> | |||
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span> </div> | |||
<div class="line"><a name="l00257"></a><span class="lineno"> 257</span> </div> | |||
<div class="line"><a name="l00313"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamOptions.html"> 313</a></span>  <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">StreamOptions</a> {</div> | |||
<div class="line"><a name="l00314"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b"> 314</a></span>  <a class="code" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41" title="RtAudio stream option flags.">RtAudioStreamFlags</a> <a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a>; </div> | |||
<div class="line"><a name="l00315"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240"> 315</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a>; </div> | |||
<div class="line"><a name="l00316"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba"> 316</a></span>  std::string <a class="code" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">streamName</a>; </div> | |||
<div class="line"><a name="l00317"></a><span class="lineno"><a class="code" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def"> 317</a></span>  <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a>; </div> | |||
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  <span class="comment">// Default constructor.</span></div> | |||
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">StreamOptions</a>()</div> | |||
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  : <a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a>(0), <a class="code" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a>(0), <a class="code" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a>(0) {}</div> | |||
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  };</div> | |||
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span> </div> | |||
<div class="line"><a name="l00325"></a><span class="lineno"><a class="code" href="classRtAudio.html#afee36f6d32f4744ffa7471a0ce7a3856"> 325</a></span>  <span class="keyword">static</span> std::string <a class="code" href="classRtAudio.html#afee36f6d32f4744ffa7471a0ce7a3856" title="A static function to determine the current RtAudio version.">getVersion</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> VERSION; } </div> | |||
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span> </div> | |||
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span> </div> | |||
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26" title="A static function to determine the available compiled audio APIs.">getCompiledApi</a>( std::vector<RtAudio::Api> &apis ) <span class="keywordflow">throw</span>();</div> | |||
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span> </div> | |||
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span> </div> | |||
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <a class="code" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9" title="The class constructor.">RtAudio</a>( <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> api=<a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a> ) throw();</div> | |||
<div class="line"><a name="l00345"></a><span class="lineno"> 345</span> </div> | |||
<div class="line"><a name="l00347"></a><span class="lineno"> 347</span> </div> | |||
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  ~<a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>() throw();</div> | |||
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span> </div> | |||
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::<a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) throw();</div> | |||
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span> </div> | |||
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span> </div> | |||
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> ) throw();</div> | |||
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span> </div> | |||
<div class="line"><a name="l00365"></a><span class="lineno"> 365</span> </div> | |||
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::DeviceInfo <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00376"></a><span class="lineno"> 376</span> </div> | |||
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span> </div> | |||
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>( <span class="keywordtype">void</span> ) throw();</div> | |||
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span> </div> | |||
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span> </div> | |||
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>( <span class="keywordtype">void</span> ) throw();</div> | |||
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span> </div> | |||
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span> </div> | |||
<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream</a>( <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::StreamParameters *outputParameters,</div> | |||
<div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::StreamParameters *inputParameters,</div> | |||
<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferFrames, <a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f" title="RtAudio callback function prototype.">RtAudioCallback</a> callback,</div> | |||
<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  <span class="keywordtype">void</span> *userData = NULL, <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::StreamOptions *options = NULL, <a class="code" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062" title="RtAudio error callback function prototype.">RtAudioErrorCallback</a> errorCallback = NULL );</div> | |||
<div class="line"><a name="l00442"></a><span class="lineno"> 442</span> </div> | |||
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span> </div> | |||
<div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> ) throw();</div> | |||
<div class="line"><a name="l00449"></a><span class="lineno"> 449</span> </div> | |||
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span> </div> | |||
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span> </div> | |||
<div class="line"><a name="l00460"></a><span class="lineno"> 460</span> </div> | |||
<div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00467"></a><span class="lineno"> 467</span> </div> | |||
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span> </div> | |||
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span> </div> | |||
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>( <span class="keywordtype">void</span> ) const throw();</div> | |||
<div class="line"><a name="l00479"></a><span class="lineno"> 479</span> </div> | |||
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea" title="Returns true if the stream is running and false if it is stopped or not open.">isStreamRunning</a>( <span class="keywordtype">void</span> ) const throw();</div> | |||
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span> </div> | |||
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span> </div> | |||
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="keywordtype">double</span> <a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca" title="Returns the number of elapsed seconds since the stream was started.">getStreamTime</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span> </div> | |||
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span> </div> | |||
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span> </div> | |||
<div class="line"><a name="l00501"></a><span class="lineno"> 501</span> </div> | |||
<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5" title="Returns actual sample rate in use by the stream.">getStreamSampleRate</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00507"></a><span class="lineno"> 507</span> </div> | |||
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">showWarnings</a>( <span class="keywordtype">bool</span> value = true ) throw();</div> | |||
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span> </div> | |||
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  protected:</div> | |||
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span> </div> | |||
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  <span class="keywordtype">void</span> openRtApi( <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>::<a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">Api</a> api );</div> | |||
<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  RtApi *rtapi_;</div> | |||
<div class="line"><a name="l00515"></a><span class="lineno"> 515</span> };</div> | |||
<div class="line"><a name="l00516"></a><span class="lineno"> 516</span> </div> | |||
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span> <span class="comment">// Operating system dependent thread functionality.</span></div> | |||
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span> <span class="preprocessor">#if defined(__WINDOWS_DS__) || defined(__WINDOWS_ASIO__)</span></div> | |||
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span> <span class="preprocessor"></span><span class="preprocessor"> #include <windows.h></span></div> | |||
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span> <span class="preprocessor"> #include <process.h></span></div> | |||
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span> </div> | |||
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  <span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> ThreadHandle;</div> | |||
<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <span class="keyword">typedef</span> CRITICAL_SECTION StreamMutex;</div> | |||
<div class="line"><a name="l00524"></a><span class="lineno"> 524</span> </div> | |||
<div class="line"><a name="l00525"></a><span class="lineno"> 525</span> <span class="preprocessor">#elif defined(__LINUX_ALSA__) || defined(__LINUX_PULSE__) || defined(__UNIX_JACK__) || defined(__LINUX_OSS__) || defined(__MACOSX_CORE__)</span></div> | |||
<div class="line"><a name="l00526"></a><span class="lineno"> 526</span> <span class="preprocessor"></span> <span class="comment">// Using pthread library for various flavors of unix.</span></div> | |||
<div class="line"><a name="l00527"></a><span class="lineno"> 527</span> <span class="preprocessor"> #include <pthread.h></span></div> | |||
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span> </div> | |||
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  <span class="keyword">typedef</span> pthread_t ThreadHandle;</div> | |||
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  <span class="keyword">typedef</span> pthread_mutex_t StreamMutex;</div> | |||
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span> </div> | |||
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span> <span class="preprocessor">#else // Setup for "dummy" behavior</span></div> | |||
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span> <span class="preprocessor"> #define __RTAUDIO_DUMMY__</span></div> | |||
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span> <span class="preprocessor"></span> <span class="keyword">typedef</span> <span class="keywordtype">int</span> ThreadHandle;</div> | |||
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <span class="keyword">typedef</span> <span class="keywordtype">int</span> StreamMutex;</div> | |||
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span> </div> | |||
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span> <span class="comment">// This global structure type is used to pass callback information</span></div> | |||
<div class="line"><a name="l00541"></a><span class="lineno"> 541</span> <span class="comment">// between the private RtAudio stream structure and global callback</span></div> | |||
<div class="line"><a name="l00542"></a><span class="lineno"> 542</span> <span class="comment">// handling functions.</span></div> | |||
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span> <span class="keyword">struct </span>CallbackInfo {</div> | |||
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  <span class="keywordtype">void</span> *object; <span class="comment">// Used as a "this" pointer.</span></div> | |||
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  ThreadHandle thread;</div> | |||
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <span class="keywordtype">void</span> *callback;</div> | |||
<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="keywordtype">void</span> *userData;</div> | |||
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <span class="keywordtype">void</span> *errorCallback;</div> | |||
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  <span class="keywordtype">void</span> *apiInfo; <span class="comment">// void pointer for API specific callback information</span></div> | |||
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  <span class="keywordtype">bool</span> isRunning;</div> | |||
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  <span class="keywordtype">bool</span> doRealtime;</div> | |||
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  <span class="keywordtype">int</span> priority;</div> | |||
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span> </div> | |||
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  <span class="comment">// Default constructor.</span></div> | |||
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  CallbackInfo()</div> | |||
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  :object(0), callback(0), userData(0), errorCallback(0), apiInfo(0), isRunning(false), doRealtime(false) {}</div> | |||
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span> };</div> | |||
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span> </div> | |||
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span> <span class="comment">// **************************************************************** //</span></div> | |||
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span> <span class="comment">// RtApi class declaration.</span></div> | |||
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span> <span class="comment">// Subclasses of RtApi contain all API- and OS-specific code necessary</span></div> | |||
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span> <span class="comment">// to fully implement the RtAudio API.</span></div> | |||
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span> <span class="comment">// Note that RtApi is an abstract base class and cannot be</span></div> | |||
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span> <span class="comment">// explicitly instantiated. The class RtAudio will create an</span></div> | |||
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span> <span class="comment">// instance of an RtApi subclass (RtApiOss, RtApiAlsa,</span></div> | |||
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span> <span class="comment">// RtApiJack, RtApiCore, RtApiDs, or RtApiAsio).</span></div> | |||
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span> <span class="comment">// **************************************************************** //</span></div> | |||
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span> </div> | |||
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span> <span class="preprocessor">#pragma pack(push, 1)</span></div> | |||
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span> <span class="preprocessor"></span><span class="keyword">class </span>S24 {</div> | |||
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span> </div> | |||
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  <span class="keyword">protected</span>:</div> | |||
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> c3[3];</div> | |||
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span> </div> | |||
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  S24() {}</div> | |||
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span> </div> | |||
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  S24& operator = ( <span class="keyword">const</span> <span class="keywordtype">int</span>& i ) {</div> | |||
<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  c3[0] = (i & 0x000000ff);</div> | |||
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  c3[1] = (i & 0x0000ff00) >> 8;</div> | |||
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  c3[2] = (i & 0x00ff0000) >> 16;</div> | |||
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> | |||
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  }</div> | |||
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span> </div> | |||
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  S24( <span class="keyword">const</span> S24& v ) { *<span class="keyword">this</span> = v; }</div> | |||
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>  S24( <span class="keyword">const</span> <span class="keywordtype">double</span>& d ) { *<span class="keyword">this</span> = (int) d; }</div> | |||
<div class="line"><a name="l00591"></a><span class="lineno"> 591</span>  S24( <span class="keyword">const</span> <span class="keywordtype">float</span>& f ) { *<span class="keyword">this</span> = (int) f; }</div> | |||
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  S24( <span class="keyword">const</span> <span class="keywordtype">signed</span> <span class="keywordtype">short</span>& s ) { *<span class="keyword">this</span> = (int) s; }</div> | |||
<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  S24( <span class="keyword">const</span> <span class="keywordtype">char</span>& c ) { *<span class="keyword">this</span> = (int) c; }</div> | |||
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span> </div> | |||
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  <span class="keywordtype">int</span> asInt() {</div> | |||
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  <span class="keywordtype">int</span> i = c3[0] | (c3[1] << 8) | (c3[2] << 16);</div> | |||
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  <span class="keywordflow">if</span> (i & 0x800000) i |= ~0xffffff;</div> | |||
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  <span class="keywordflow">return</span> i;</div> | |||
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  }</div> | |||
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span> };</div> | |||
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span> <span class="preprocessor">#pragma pack(pop)</span></div> | |||
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span> <span class="preprocessor">#if defined( HAVE_GETTIMEOFDAY )</span></div> | |||
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span> <span class="preprocessor"></span><span class="preprocessor"> #include <sys/time.h></span></div> | |||
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span> <span class="preprocessor">#include <sstream></span></div> | |||
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span> </div> | |||
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span> <span class="keyword">class </span>RtApi</div> | |||
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span> {</div> | |||
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span> </div> | |||
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  RtApi();</div> | |||
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  <span class="keyword">virtual</span> ~RtApi();</div> | |||
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  <span class="keyword">virtual</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) = 0;</div> | |||
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> ) = 0;</div> | |||
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  <span class="keyword">virtual</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ) = 0;</div> | |||
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>  <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>  <span class="keyword">virtual</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream</a>( <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> *outputParameters,</div> | |||
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> *inputParameters,</div> | |||
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferFrames, <a class="code" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f" title="RtAudio callback function prototype.">RtAudioCallback</a> callback,</div> | |||
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <span class="keywordtype">void</span> *userData, <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options,</div> | |||
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  <a class="code" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062" title="RtAudio error callback function prototype.">RtAudioErrorCallback</a> errorCallback );</div> | |||
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> ) = 0;</div> | |||
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> ) = 0;</div> | |||
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> ) = 0;</div> | |||
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5" title="Returns actual sample rate in use by the stream.">getStreamSampleRate</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  <span class="keyword">virtual</span> <span class="keywordtype">double</span> <a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca" title="Returns the number of elapsed seconds since the stream was started.">getStreamTime</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00633"></a><span class="lineno"> 633</span>  <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>( <span class="keywordtype">void</span> )<span class="keyword"> const </span>{ <span class="keywordflow">return</span> stream_.state != STREAM_CLOSED; }</div> | |||
<div class="line"><a name="l00634"></a><span class="lineno"> 634</span>  <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea" title="Returns true if the stream is running and false if it is stopped or not open.">isStreamRunning</a>( <span class="keywordtype">void</span> )<span class="keyword"> const </span>{ <span class="keywordflow">return</span> stream_.state == STREAM_RUNNING; }</div> | |||
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">showWarnings</a>( <span class="keywordtype">bool</span> value ) { showWarnings_ = value; }</div> | |||
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span> </div> | |||
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span> </div> | |||
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span> <span class="keyword">protected</span>:</div> | |||
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span> </div> | |||
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span>  <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> MAX_SAMPLE_RATES;</div> | |||
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span>  <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> SAMPLE_RATES[];</div> | |||
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span> </div> | |||
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  <span class="keyword">enum</span> { FAILURE, SUCCESS };</div> | |||
<div class="line"><a name="l00644"></a><span class="lineno"> 644</span> </div> | |||
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  <span class="keyword">enum</span> StreamState {</div> | |||
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  STREAM_STOPPED,</div> | |||
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  STREAM_STOPPING,</div> | |||
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  STREAM_RUNNING,</div> | |||
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>  STREAM_CLOSED = -50</div> | |||
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  };</div> | |||
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span> </div> | |||
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  <span class="keyword">enum</span> StreamMode {</div> | |||
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  OUTPUT,</div> | |||
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  INPUT,</div> | |||
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span>  DUPLEX,</div> | |||
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  UNINITIALIZED = -75</div> | |||
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  };</div> | |||
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span> </div> | |||
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  <span class="comment">// A protected structure used for buffer conversion.</span></div> | |||
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  <span class="keyword">struct </span>ConvertInfo {</div> | |||
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>  <span class="keywordtype">int</span> channels;</div> | |||
<div class="line"><a name="l00662"></a><span class="lineno"> 662</span>  <span class="keywordtype">int</span> inJump, outJump;</div> | |||
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> inFormat, outFormat;</div> | |||
<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>  std::vector<int> inOffset;</div> | |||
<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>  std::vector<int> outOffset;</div> | |||
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  };</div> | |||
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span> </div> | |||
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>  <span class="comment">// A protected structure for audio streams.</span></div> | |||
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>  <span class="keyword">struct </span>RtApiStream {</div> | |||
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span>  <span class="keywordtype">void</span> *apiHandle; <span class="comment">// void pointer for API specific stream handle information</span></div> | |||
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  StreamMode mode; <span class="comment">// OUTPUT, INPUT, or DUPLEX.</span></div> | |||
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>  StreamState state; <span class="comment">// STOPPED, RUNNING, or CLOSED</span></div> | |||
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>  <span class="keywordtype">char</span> *userBuffer[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  <span class="keywordtype">char</span> *deviceBuffer;</div> | |||
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  <span class="keywordtype">bool</span> doConvertBuffer[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00677"></a><span class="lineno"> 677</span>  <span class="keywordtype">bool</span> userInterleaved;</div> | |||
<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>  <span class="keywordtype">bool</span> deviceInterleaved[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span>  <span class="keywordtype">bool</span> doByteSwap[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate;</div> | |||
<div class="line"><a name="l00681"></a><span class="lineno"> 681</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferSize;</div> | |||
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBuffers;</div> | |||
<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nUserChannels[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00684"></a><span class="lineno"> 684</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nDeviceChannels[2]; <span class="comment">// Playback and record channels, respectively.</span></div> | |||
<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channelOffset[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> latency[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> userFormat;</div> | |||
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> deviceFormat[2]; <span class="comment">// Playback and record, respectively.</span></div> | |||
<div class="line"><a name="l00689"></a><span class="lineno"> 689</span>  StreamMutex mutex;</div> | |||
<div class="line"><a name="l00690"></a><span class="lineno"> 690</span>  CallbackInfo callbackInfo;</div> | |||
<div class="line"><a name="l00691"></a><span class="lineno"> 691</span>  ConvertInfo convertInfo[2];</div> | |||
<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  <span class="keywordtype">double</span> streamTime; <span class="comment">// Number of elapsed seconds since the stream started.</span></div> | |||
<div class="line"><a name="l00693"></a><span class="lineno"> 693</span> </div> | |||
<div class="line"><a name="l00694"></a><span class="lineno"> 694</span> <span class="preprocessor">#if defined(HAVE_GETTIMEOFDAY)</span></div> | |||
<div class="line"><a name="l00695"></a><span class="lineno"> 695</span> <span class="preprocessor"></span> <span class="keyword">struct </span>timeval lastTickTimestamp;</div> | |||
<div class="line"><a name="l00696"></a><span class="lineno"> 696</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00697"></a><span class="lineno"> 697</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00698"></a><span class="lineno"> 698</span>  RtApiStream()</div> | |||
<div class="line"><a name="l00699"></a><span class="lineno"> 699</span>  :apiHandle(0), deviceBuffer(0) { device[0] = 11111; device[1] = 11111; }</div> | |||
<div class="line"><a name="l00700"></a><span class="lineno"> 700</span>  };</div> | |||
<div class="line"><a name="l00701"></a><span class="lineno"> 701</span> </div> | |||
<div class="line"><a name="l00702"></a><span class="lineno"> 702</span>  <span class="keyword">typedef</span> S24 Int24;</div> | |||
<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  <span class="keyword">typedef</span> <span class="keywordtype">signed</span> <span class="keywordtype">short</span> Int16;</div> | |||
<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  <span class="keyword">typedef</span> <span class="keywordtype">signed</span> <span class="keywordtype">int</span> Int32;</div> | |||
<div class="line"><a name="l00705"></a><span class="lineno"> 705</span>  <span class="keyword">typedef</span> <span class="keywordtype">float</span> Float32;</div> | |||
<div class="line"><a name="l00706"></a><span class="lineno"> 706</span>  <span class="keyword">typedef</span> <span class="keywordtype">double</span> Float64;</div> | |||
<div class="line"><a name="l00707"></a><span class="lineno"> 707</span> </div> | |||
<div class="line"><a name="l00708"></a><span class="lineno"> 708</span>  std::ostringstream errorStream_;</div> | |||
<div class="line"><a name="l00709"></a><span class="lineno"> 709</span>  std::string errorText_;</div> | |||
<div class="line"><a name="l00710"></a><span class="lineno"> 710</span>  <span class="keywordtype">bool</span> showWarnings_;</div> | |||
<div class="line"><a name="l00711"></a><span class="lineno"> 711</span>  RtApiStream stream_;</div> | |||
<div class="line"><a name="l00712"></a><span class="lineno"> 712</span> </div> | |||
<div class="line"><a name="l00720"></a><span class="lineno"> 720</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00723"></a><span class="lineno"> 723</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00724"></a><span class="lineno"> 724</span> </div> | |||
<div class="line"><a name="l00726"></a><span class="lineno"> 726</span>  <span class="keywordtype">void</span> tickStreamTime( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00727"></a><span class="lineno"> 727</span> </div> | |||
<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  <span class="keywordtype">void</span> clearStreamInfo();</div> | |||
<div class="line"><a name="l00730"></a><span class="lineno"> 730</span> </div> | |||
<div class="line"><a name="l00735"></a><span class="lineno"> 735</span>  <span class="keywordtype">void</span> verifyStream( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00736"></a><span class="lineno"> 736</span> </div> | |||
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  <span class="keywordtype">void</span> error( <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">RtError::Type</a> type );</div> | |||
<div class="line"><a name="l00739"></a><span class="lineno"> 739</span> </div> | |||
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  <span class="keywordtype">void</span> convertBuffer( <span class="keywordtype">char</span> *outBuffer, <span class="keywordtype">char</span> *inBuffer, ConvertInfo &info );</div> | |||
<div class="line"><a name="l00745"></a><span class="lineno"> 745</span> </div> | |||
<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  <span class="keywordtype">void</span> byteSwapBuffer( <span class="keywordtype">char</span> *buffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> samples, <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format );</div> | |||
<div class="line"><a name="l00748"></a><span class="lineno"> 748</span> </div> | |||
<div class="line"><a name="l00750"></a><span class="lineno"> 750</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> formatBytes( <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format );</div> | |||
<div class="line"><a name="l00751"></a><span class="lineno"> 751</span> </div> | |||
<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  <span class="keywordtype">void</span> setConvertInfo( StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel );</div> | |||
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span> };</div> | |||
<div class="line"><a name="l00755"></a><span class="lineno"> 755</span> </div> | |||
<div class="line"><a name="l00756"></a><span class="lineno"> 756</span> <span class="comment">// **************************************************************** //</span></div> | |||
<div class="line"><a name="l00757"></a><span class="lineno"> 757</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00758"></a><span class="lineno"> 758</span> <span class="comment">// Inline RtAudio definitions.</span></div> | |||
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l00760"></a><span class="lineno"> 760</span> <span class="comment">// **************************************************************** //</span></div> | |||
<div class="line"><a name="l00761"></a><span class="lineno"> 761</span> </div> | |||
<div class="line"><a name="l00762"></a><span class="lineno"><a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246"> 762</a></span> <span class="keyword">inline</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">RtAudio :: getCurrentApi</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getCurrentApi(); }</div> | |||
<div class="line"><a name="l00763"></a><span class="lineno"><a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a"> 763</a></span> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">RtAudio :: getDeviceCount</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getDeviceCount(); }</div> | |||
<div class="line"><a name="l00764"></a><span class="lineno"><a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8"> 764</a></span> <span class="keyword">inline</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">RtAudio :: getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device ) { <span class="keywordflow">return</span> rtapi_->getDeviceInfo( device ); }</div> | |||
<div class="line"><a name="l00765"></a><span class="lineno"><a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce"> 765</a></span> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">RtAudio :: getDefaultInputDevice</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getDefaultInputDevice(); }</div> | |||
<div class="line"><a name="l00766"></a><span class="lineno"><a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc"> 766</a></span> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">RtAudio :: getDefaultOutputDevice</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->getDefaultOutputDevice(); }</div> | |||
<div class="line"><a name="l00767"></a><span class="lineno"><a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a"> 767</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">RtAudio :: closeStream</a>( <span class="keywordtype">void</span> ) throw() { <span class="keywordflow">return</span> rtapi_->closeStream(); }</div> | |||
<div class="line"><a name="l00768"></a><span class="lineno"><a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80"> 768</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">RtAudio :: startStream</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->startStream(); }</div> | |||
<div class="line"><a name="l00769"></a><span class="lineno"><a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd"> 769</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio :: stopStream</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->stopStream(); }</div> | |||
<div class="line"><a name="l00770"></a><span class="lineno"><a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f"> 770</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">RtAudio :: abortStream</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->abortStream(); }</div> | |||
<div class="line"><a name="l00771"></a><span class="lineno"><a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f"> 771</a></span> <span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">RtAudio :: isStreamOpen</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> rtapi_->isStreamOpen(); }</div> | |||
<div class="line"><a name="l00772"></a><span class="lineno"><a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea"> 772</a></span> <span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea" title="Returns true if the stream is running and false if it is stopped or not open.">RtAudio :: isStreamRunning</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> rtapi_->isStreamRunning(); }</div> | |||
<div class="line"><a name="l00773"></a><span class="lineno"><a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3"> 773</a></span> <span class="keyword">inline</span> <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">RtAudio :: getStreamLatency</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->getStreamLatency(); }</div> | |||
<div class="line"><a name="l00774"></a><span class="lineno"><a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5"> 774</a></span> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5" title="Returns actual sample rate in use by the stream.">RtAudio :: getStreamSampleRate</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->getStreamSampleRate(); }</div> | |||
<div class="line"><a name="l00775"></a><span class="lineno"><a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca"> 775</a></span> <span class="keyword">inline</span> <span class="keywordtype">double</span> <a class="code" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca" title="Returns the number of elapsed seconds since the stream was started.">RtAudio :: getStreamTime</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> rtapi_->getStreamTime(); }</div> | |||
<div class="line"><a name="l00776"></a><span class="lineno"><a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77"> 776</a></span> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">RtAudio :: showWarnings</a>( <span class="keywordtype">bool</span> value ) <span class="keywordflow">throw</span>() { rtapi_->showWarnings( value ); }</div> | |||
<div class="line"><a name="l00777"></a><span class="lineno"> 777</span> </div> | |||
<div class="line"><a name="l00778"></a><span class="lineno"> 778</span> <span class="comment">// RtApi Subclass prototypes.</span></div> | |||
<div class="line"><a name="l00779"></a><span class="lineno"> 779</span> </div> | |||
<div class="line"><a name="l00780"></a><span class="lineno"> 780</span> <span class="preprocessor">#if defined(__MACOSX_CORE__)</span></div> | |||
<div class="line"><a name="l00781"></a><span class="lineno"> 781</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00782"></a><span class="lineno"> 782</span> <span class="preprocessor">#include <CoreAudio/AudioHardware.h></span></div> | |||
<div class="line"><a name="l00783"></a><span class="lineno"> 783</span> </div> | |||
<div class="line"><a name="l00784"></a><span class="lineno"> 784</span> <span class="keyword">class </span>RtApiCore: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00785"></a><span class="lineno"> 785</span> {</div> | |||
<div class="line"><a name="l00786"></a><span class="lineno"> 786</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span> </div> | |||
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  RtApiCore();</div> | |||
<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  ~RtApiCore();</div> | |||
<div class="line"><a name="l00790"></a><span class="lineno"> 790</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">RtAudio::MACOSX_CORE</a>; }</div> | |||
<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00796"></a><span class="lineno"> 796</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00798"></a><span class="lineno"> 798</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00800"></a><span class="lineno"> 800</span> </div> | |||
<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="keywordtype">bool</span> callbackEvent( AudioDeviceID deviceId,</div> | |||
<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  <span class="keyword">const</span> AudioBufferList *inBufferList,</div> | |||
<div class="line"><a name="l00807"></a><span class="lineno"> 807</span>  <span class="keyword">const</span> AudioBufferList *outBufferList );</div> | |||
<div class="line"><a name="l00808"></a><span class="lineno"> 808</span> </div> | |||
<div class="line"><a name="l00809"></a><span class="lineno"> 809</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l00810"></a><span class="lineno"> 810</span> </div> | |||
<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l00812"></a><span class="lineno"> 812</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00813"></a><span class="lineno"> 813</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* getErrorCode( OSStatus code );</div> | |||
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span> };</div> | |||
<div class="line"><a name="l00817"></a><span class="lineno"> 817</span> </div> | |||
<div class="line"><a name="l00818"></a><span class="lineno"> 818</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00819"></a><span class="lineno"> 819</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00820"></a><span class="lineno"> 820</span> <span class="preprocessor">#if defined(__UNIX_JACK__)</span></div> | |||
<div class="line"><a name="l00821"></a><span class="lineno"> 821</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00822"></a><span class="lineno"> 822</span> <span class="keyword">class </span>RtApiJack: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00823"></a><span class="lineno"> 823</span> {</div> | |||
<div class="line"><a name="l00824"></a><span class="lineno"> 824</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span> </div> | |||
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  RtApiJack();</div> | |||
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  ~RtApiJack();</div> | |||
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">RtAudio::UNIX_JACK</a>; }</div> | |||
<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00830"></a><span class="lineno"> 830</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00836"></a><span class="lineno"> 836</span> </div> | |||
<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l00839"></a><span class="lineno"> 839</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l00840"></a><span class="lineno"> 840</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l00841"></a><span class="lineno"> 841</span>  <span class="keywordtype">bool</span> callbackEvent( <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> nframes );</div> | |||
<div class="line"><a name="l00842"></a><span class="lineno"> 842</span> </div> | |||
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l00844"></a><span class="lineno"> 844</span> </div> | |||
<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00849"></a><span class="lineno"> 849</span> };</div> | |||
<div class="line"><a name="l00850"></a><span class="lineno"> 850</span> </div> | |||
<div class="line"><a name="l00851"></a><span class="lineno"> 851</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00852"></a><span class="lineno"> 852</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00853"></a><span class="lineno"> 853</span> <span class="preprocessor">#if defined(__WINDOWS_ASIO__)</span></div> | |||
<div class="line"><a name="l00854"></a><span class="lineno"> 854</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00855"></a><span class="lineno"> 855</span> <span class="keyword">class </span>RtApiAsio: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00856"></a><span class="lineno"> 856</span> {</div> | |||
<div class="line"><a name="l00857"></a><span class="lineno"> 857</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00858"></a><span class="lineno"> 858</span> </div> | |||
<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  RtApiAsio();</div> | |||
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  ~RtApiAsio();</div> | |||
<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">RtAudio::WINDOWS_ASIO</a>; }</div> | |||
<div class="line"><a name="l00862"></a><span class="lineno"> 862</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00866"></a><span class="lineno"> 866</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00867"></a><span class="lineno"> 867</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00868"></a><span class="lineno"> 868</span>  <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00869"></a><span class="lineno"> 869</span> </div> | |||
<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l00871"></a><span class="lineno"> 871</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l00873"></a><span class="lineno"> 873</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <span class="keywordtype">bool</span> callbackEvent( <span class="keywordtype">long</span> bufferIndex );</div> | |||
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span> </div> | |||
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span> </div> | |||
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  std::vector<RtAudio::DeviceInfo> devices_;</div> | |||
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  <span class="keywordtype">void</span> saveDeviceInfo( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  <span class="keywordtype">bool</span> coInitialized_;</div> | |||
<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00884"></a><span class="lineno"> 884</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00885"></a><span class="lineno"> 885</span> };</div> | |||
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span> </div> | |||
<div class="line"><a name="l00887"></a><span class="lineno"> 887</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00888"></a><span class="lineno"> 888</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00889"></a><span class="lineno"> 889</span> <span class="preprocessor">#if defined(__WINDOWS_DS__)</span></div> | |||
<div class="line"><a name="l00890"></a><span class="lineno"> 890</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00891"></a><span class="lineno"> 891</span> <span class="keyword">class </span>RtApiDs: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00892"></a><span class="lineno"> 892</span> {</div> | |||
<div class="line"><a name="l00893"></a><span class="lineno"> 893</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span> </div> | |||
<div class="line"><a name="l00895"></a><span class="lineno"> 895</span>  RtApiDs();</div> | |||
<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  ~RtApiDs();</div> | |||
<div class="line"><a name="l00897"></a><span class="lineno"> 897</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">RtAudio::WINDOWS_DS</a>; }</div> | |||
<div class="line"><a name="l00898"></a><span class="lineno"> 898</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00899"></a><span class="lineno"> 899</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00900"></a><span class="lineno"> 900</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00902"></a><span class="lineno"> 902</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00903"></a><span class="lineno"> 903</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00906"></a><span class="lineno"> 906</span>  <span class="keywordtype">long</span> <a class="code" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3" title="Returns the internal stream latency in sample frames.">getStreamLatency</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00907"></a><span class="lineno"> 907</span> </div> | |||
<div class="line"><a name="l00908"></a><span class="lineno"> 908</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00913"></a><span class="lineno"> 913</span> </div> | |||
<div class="line"><a name="l00914"></a><span class="lineno"> 914</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l00915"></a><span class="lineno"> 915</span> </div> | |||
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  <span class="keywordtype">bool</span> coInitialized_;</div> | |||
<div class="line"><a name="l00917"></a><span class="lineno"> 917</span>  <span class="keywordtype">bool</span> buffersRolling;</div> | |||
<div class="line"><a name="l00918"></a><span class="lineno"> 918</span>  <span class="keywordtype">long</span> duplexPrerollBytes;</div> | |||
<div class="line"><a name="l00919"></a><span class="lineno"> 919</span>  std::vector<struct DsDevice> dsDevices;</div> | |||
<div class="line"><a name="l00920"></a><span class="lineno"> 920</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00922"></a><span class="lineno"> 922</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00923"></a><span class="lineno"> 923</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00924"></a><span class="lineno"> 924</span> };</div> | |||
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span> </div> | |||
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00927"></a><span class="lineno"> 927</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00928"></a><span class="lineno"> 928</span> <span class="preprocessor">#if defined(__LINUX_ALSA__)</span></div> | |||
<div class="line"><a name="l00929"></a><span class="lineno"> 929</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00930"></a><span class="lineno"> 930</span> <span class="keyword">class </span>RtApiAlsa: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00931"></a><span class="lineno"> 931</span> {</div> | |||
<div class="line"><a name="l00932"></a><span class="lineno"> 932</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00933"></a><span class="lineno"> 933</span> </div> | |||
<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  RtApiAlsa();</div> | |||
<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  ~RtApiAlsa();</div> | |||
<div class="line"><a name="l00936"></a><span class="lineno"> 936</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>() { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">RtAudio::LINUX_ALSA</a>; }</div> | |||
<div class="line"><a name="l00937"></a><span class="lineno"> 937</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00939"></a><span class="lineno"> 939</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00940"></a><span class="lineno"> 940</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00942"></a><span class="lineno"> 942</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00943"></a><span class="lineno"> 943</span> </div> | |||
<div class="line"><a name="l00944"></a><span class="lineno"> 944</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l00945"></a><span class="lineno"> 945</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l00946"></a><span class="lineno"> 946</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span> </div> | |||
<div class="line"><a name="l00950"></a><span class="lineno"> 950</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l00951"></a><span class="lineno"> 951</span> </div> | |||
<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  std::vector<RtAudio::DeviceInfo> devices_;</div> | |||
<div class="line"><a name="l00953"></a><span class="lineno"> 953</span>  <span class="keywordtype">void</span> saveDeviceInfo( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00954"></a><span class="lineno"> 954</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l00955"></a><span class="lineno"> 955</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00956"></a><span class="lineno"> 956</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00957"></a><span class="lineno"> 957</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00958"></a><span class="lineno"> 958</span> };</div> | |||
<div class="line"><a name="l00959"></a><span class="lineno"> 959</span> </div> | |||
<div class="line"><a name="l00960"></a><span class="lineno"> 960</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00961"></a><span class="lineno"> 961</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00962"></a><span class="lineno"> 962</span> <span class="preprocessor">#if defined(__LINUX_PULSE__)</span></div> | |||
<div class="line"><a name="l00963"></a><span class="lineno"> 963</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00964"></a><span class="lineno"> 964</span> <span class="keyword">class </span>RtApiPulse: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00965"></a><span class="lineno"> 965</span> {</div> | |||
<div class="line"><a name="l00966"></a><span class="lineno"> 966</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00967"></a><span class="lineno"> 967</span>  ~RtApiPulse();</div> | |||
<div class="line"><a name="l00968"></a><span class="lineno"> 968</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>() { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">RtAudio::LINUX_PULSE</a>; }</div> | |||
<div class="line"><a name="l00969"></a><span class="lineno"> 969</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00972"></a><span class="lineno"> 972</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00973"></a><span class="lineno"> 973</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00974"></a><span class="lineno"> 974</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00975"></a><span class="lineno"> 975</span> </div> | |||
<div class="line"><a name="l00976"></a><span class="lineno"> 976</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00981"></a><span class="lineno"> 981</span> </div> | |||
<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l00983"></a><span class="lineno"> 983</span> </div> | |||
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  std::vector<RtAudio::DeviceInfo> devices_;</div> | |||
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  <span class="keywordtype">void</span> saveDeviceInfo( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels,</div> | |||
<div class="line"><a name="l00987"></a><span class="lineno"> 987</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l00989"></a><span class="lineno"> 989</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l00990"></a><span class="lineno"> 990</span> };</div> | |||
<div class="line"><a name="l00991"></a><span class="lineno"> 991</span> </div> | |||
<div class="line"><a name="l00992"></a><span class="lineno"> 992</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l00993"></a><span class="lineno"> 993</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span> <span class="preprocessor">#if defined(__LINUX_OSS__)</span></div> | |||
<div class="line"><a name="l00995"></a><span class="lineno"> 995</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00996"></a><span class="lineno"> 996</span> <span class="keyword">class </span>RtApiOss: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l00997"></a><span class="lineno"> 997</span> {</div> | |||
<div class="line"><a name="l00998"></a><span class="lineno"> 998</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00999"></a><span class="lineno"> 999</span> </div> | |||
<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  RtApiOss();</div> | |||
<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>  ~RtApiOss();</div> | |||
<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>() { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">RtAudio::LINUX_OSS</a>; }</div> | |||
<div class="line"><a name="l01003"></a><span class="lineno"> 1003</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l01004"></a><span class="lineno"> 1004</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device );</div> | |||
<div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l01006"></a><span class="lineno"> 1006</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l01009"></a><span class="lineno"> 1009</span> </div> | |||
<div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>  <span class="comment">// This function is intended for internal use only. It must be</span></div> | |||
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  <span class="comment">// public because it is called by the internal callback handler,</span></div> | |||
<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>  <span class="comment">// which is not a member of RtAudio. External use of this function</span></div> | |||
<div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>  <span class="comment">// will most likely produce highly undesireable results!</span></div> | |||
<div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>  <span class="keywordtype">void</span> callbackEvent( <span class="keywordtype">void</span> );</div> | |||
<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span> </div> | |||
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l01017"></a><span class="lineno"> 1017</span> </div> | |||
<div class="line"><a name="l01018"></a><span class="lineno"> 1018</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> device, StreamMode mode, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channels, </div> | |||
<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> firstChannel, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate,</div> | |||
<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> format, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *bufferSize,</div> | |||
<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> *options );</div> | |||
<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span> };</div> | |||
<div class="line"><a name="l01023"></a><span class="lineno"> 1023</span> </div> | |||
<div class="line"><a name="l01024"></a><span class="lineno"> 1024</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l01025"></a><span class="lineno"> 1025</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span> <span class="preprocessor">#if defined(__RTAUDIO_DUMMY__)</span></div> | |||
<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span> <span class="keyword">class </span>RtApiDummy: <span class="keyword">public</span> RtApi</div> | |||
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span> {</div> | |||
<div class="line"><a name="l01030"></a><span class="lineno"> 1030</span> <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l01031"></a><span class="lineno"> 1031</span> </div> | |||
<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>  RtApiDummy() { errorText_ = <span class="stringliteral">"RtApiDummy: This class provides no functionality."</span>; error( <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">RtError::WARNING</a> ); }</div> | |||
<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>  <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849" title="Audio API specifier arguments.">RtAudio::Api</a> <a class="code" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">getCurrentApi</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> <a class="code" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RtAudio::RTAUDIO_DUMMY</a>; }</div> | |||
<div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>( <span class="keywordtype">void</span> ) { <span class="keywordflow">return</span> 0; }</div> | |||
<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> <a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <span class="comment">/*device*/</span> ) { <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> info; <span class="keywordflow">return</span> info; }</div> | |||
<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>( <span class="keywordtype">void</span> ) {}</div> | |||
<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>( <span class="keywordtype">void</span> ) {}</div> | |||
<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>( <span class="keywordtype">void</span> ) {}</div> | |||
<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>  <span class="keywordtype">void</span> <a class="code" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">abortStream</a>( <span class="keywordtype">void</span> ) {}</div> | |||
<div class="line"><a name="l01040"></a><span class="lineno"> 1040</span> </div> | |||
<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>  <span class="keyword">private</span>:</div> | |||
<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span> </div> | |||
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  <span class="keywordtype">bool</span> probeDeviceOpen( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <span class="comment">/*device*/</span>, StreamMode <span class="comment">/*mode*/</span>, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <span class="comment">/*channels*/</span>, </div> | |||
<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <span class="comment">/*firstChannel*/</span>, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <span class="comment">/*sampleRate*/</span>,</div> | |||
<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>  <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> <span class="comment">/*format*/</span>, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> * <span class="comment">/*bufferSize*/</span>,</div> | |||
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> * <span class="comment">/*options*/</span> ) { <span class="keywordflow">return</span> <span class="keyword">false</span>; }</div> | |||
<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span> };</div> | |||
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span> </div> | |||
<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span> <span class="preprocessor">#endif</span></div> | |||
<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span> <span class="comment">// Indentation settings for Vim and Emacs</span></div> | |||
<div class="line"><a name="l01054"></a><span class="lineno"> 1054</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l01055"></a><span class="lineno"> 1055</span> <span class="comment">// Local Variables:</span></div> | |||
<div class="line"><a name="l01056"></a><span class="lineno"> 1056</span> <span class="comment">// c-basic-offset: 2</span></div> | |||
<div class="line"><a name="l01057"></a><span class="lineno"> 1057</span> <span class="comment">// indent-tabs-mode: nil</span></div> | |||
<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span> <span class="comment">// End:</span></div> | |||
<div class="line"><a name="l01059"></a><span class="lineno"> 1059</span> <span class="comment">//</span></div> | |||
<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span> <span class="comment">// vim: et sts=2 sw=2</span></div> | |||
</div><!-- fragment --></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,69 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">RtError.h</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/************************************************************************/</span></div> | |||
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">/************************************************************************/</span></div> | |||
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> </div> | |||
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="preprocessor">#ifndef RTERROR_H</span></div> | |||
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor"></span><span class="preprocessor">#define RTERROR_H</span></div> | |||
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor"></span></div> | |||
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="preprocessor">#include <exception></span></div> | |||
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="preprocessor">#include <iostream></span></div> | |||
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#include <string></span></div> | |||
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> </div> | |||
<div class="line"><a name="l00019"></a><span class="lineno"><a class="code" href="classRtError.html"> 19</a></span> <span class="keyword">class </span><a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> : <span class="keyword">public</span> std::exception</div> | |||
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> {</div> | |||
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  <span class="keyword">public</span>:</div> | |||
<div class="line"><a name="l00023"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac"> 23</a></span>  <span class="keyword">enum</span> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a> {</div> | |||
<div class="line"><a name="l00024"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398"> 24</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">WARNING</a>, </div> | |||
<div class="line"><a name="l00025"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba"> 25</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">DEBUG_WARNING</a>, </div> | |||
<div class="line"><a name="l00026"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6"> 26</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">UNSPECIFIED</a>, </div> | |||
<div class="line"><a name="l00027"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82"> 27</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">NO_DEVICES_FOUND</a>, </div> | |||
<div class="line"><a name="l00028"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1"> 28</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">INVALID_DEVICE</a>, </div> | |||
<div class="line"><a name="l00029"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e"> 29</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">MEMORY_ERROR</a>, </div> | |||
<div class="line"><a name="l00030"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6"> 30</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">INVALID_PARAMETER</a>, </div> | |||
<div class="line"><a name="l00031"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc"> 31</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">INVALID_USE</a>, </div> | |||
<div class="line"><a name="l00032"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b"> 32</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">DRIVER_ERROR</a>, </div> | |||
<div class="line"><a name="l00033"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b"> 33</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">SYSTEM_ERROR</a>, </div> | |||
<div class="line"><a name="l00034"></a><span class="lineno"><a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6"> 34</a></span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">THREAD_ERROR</a> </div> | |||
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  };</div> | |||
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div> | |||
<div class="line"><a name="l00038"></a><span class="lineno"><a class="code" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37"> 38</a></span>  <a class="code" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37" title="The constructor.">RtError</a>( <span class="keyword">const</span> std::string& message, <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a> type = <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">RtError::UNSPECIFIED</a> ) throw() : message_(message), type_(type) {}</div> | |||
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  </div> | |||
<div class="line"><a name="l00041"></a><span class="lineno"><a class="code" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c"> 41</a></span>  <span class="keyword">virtual</span> <a class="code" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c" title="The destructor.">~RtError</a>( <span class="keywordtype">void</span> ) throw() {}</div> | |||
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> </div> | |||
<div class="line"><a name="l00044"></a><span class="lineno"><a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc"> 44</a></span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { std::cerr << <span class="charliteral">'\n'</span> << message_ << <span class="stringliteral">"\n\n"</span>; }</div> | |||
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> </div> | |||
<div class="line"><a name="l00047"></a><span class="lineno"><a class="code" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7"> 47</a></span>  <span class="keyword">virtual</span> <span class="keyword">const</span> <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a>& <a class="code" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7" title="Returns the thrown error message type.">getType</a>(<span class="keywordtype">void</span>) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> type_; }</div> | |||
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> </div> | |||
<div class="line"><a name="l00050"></a><span class="lineno"><a class="code" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50"> 50</a></span>  <span class="keyword">virtual</span> <span class="keyword">const</span> std::string& <a class="code" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50" title="Returns the thrown error message string.">getMessage</a>(<span class="keywordtype">void</span>) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> message_; }</div> | |||
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> </div> | |||
<div class="line"><a name="l00053"></a><span class="lineno"><a class="code" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d"> 53</a></span>  <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d" title="Returns the thrown error message as a c-style string.">what</a>( <span class="keywordtype">void</span> ) <span class="keyword">const</span> throw() { <span class="keywordflow">return</span> message_.c_str(); }</div> | |||
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div> | |||
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  <span class="keyword">protected</span>:</div> | |||
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  std::string message_;</div> | |||
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <a class="code" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">Type</a> type_;</div> | |||
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> };</div> | |||
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> </div> | |||
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="preprocessor">#endif</span></div> | |||
</div><!-- fragment --></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,11 +8,14 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Acknowledgements </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="acknowledge">Acknowledgements </a></h1><p>Many thanks to the following people for providing bug fixes and improvements: </p> | |||
<div class="textblock"><p>Many thanks to the following people for providing bug fixes and improvements: </p> | |||
<ul> | |||
<li> | |||
Stefan Arisona </li> | |||
@@ -51,12 +54,10 @@ Ryan Williams (Windows non-MS compiler ASIO support) </li> | |||
</ul> | |||
<p>The <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> API incorporates many of the concepts developed in the <a href="http://www.portaudio.com/">PortAudio</a> project by Phil Burk and Ross Bencina. Early development also incorporated ideas from Bill Schottstaedt's <a href="http://www-ccrma.stanford.edu/software/snd/sndlib/">sndlib</a>. The CCRMA <a href="http://www-ccrma.stanford.edu/groups/soundwire/">SoundWire group</a> provided valuable feedback during the API proposal stages.</p> | |||
<p>The early 2.0 version of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> was slowly developed over the course of many months while in residence at the <a href="http://www.iua.upf.es/">Institut Universitari de L'Audiovisual (IUA)</a> in Barcelona, Spain and the <a href="http://www.acoustics.hut.fi/">Laboratory of Acoustics and Audio Signal Processing</a> at the Helsinki University of Technology, Finland. Much subsequent development happened while working at the <a href="http://www-ccrma.stanford.edu/">Center for Computer Research in Music and Acoustics (CCRMA)</a> at <a href="http://www.stanford.edu/">Stanford University</a>. All recent versions of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> have been completed while working as an assistant / associate professor of <a href="http://www.music.mcgill.ca/musictech/">Music Technology</a> at <a href="http://www.mcgill.ca/">McGill University</a>. This work was supported in part by the United States Air Force Office of Scientific Research (grant #F49620-99-1-0293). </p> | |||
</div> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,33 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Class List</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock">Here are the classes, structs, unions and interfaces with brief descriptions:</div><div class="directory"> | |||
<div class="levels">[detail level <span onclick="javascript:toggleLevel(1);">1</span><span onclick="javascript:toggleLevel(2);">2</span>]</div><table class="directory"> | |||
<tr id="row_0_" class="even"><td class="entry"><img id="arr_0_" src="ftv2mnode.png" alt="o" width="16" height="22" onclick="toggleFolder('0_')"/><img src="ftv2cl.png" alt="C" width="24" height="22" /><a class="el" href="classRtAudio.html" target="_self">RtAudio</a></td><td class="desc">Realtime audio i/o C++ classes</td></tr> | |||
<tr id="row_0_0_"><td class="entry"><img src="ftv2vertline.png" alt="|" width="16" height="22" /><img src="ftv2node.png" alt="o" width="16" height="22" /><img src="ftv2cl.png" alt="C" width="24" height="22" /><a class="el" href="structRtAudio_1_1DeviceInfo.html" target="_self">DeviceInfo</a></td><td class="desc">The public device information structure for returning queried values</td></tr> | |||
<tr id="row_0_1_" class="even"><td class="entry"><img src="ftv2vertline.png" alt="|" width="16" height="22" /><img src="ftv2node.png" alt="o" width="16" height="22" /><img src="ftv2cl.png" alt="C" width="24" height="22" /><a class="el" href="structRtAudio_1_1StreamOptions.html" target="_self">StreamOptions</a></td><td class="desc">The structure for specifying stream options</td></tr> | |||
<tr id="row_0_2_"><td class="entry"><img src="ftv2vertline.png" alt="|" width="16" height="22" /><img src="ftv2lastnode.png" alt="\" width="16" height="22" /><img src="ftv2cl.png" alt="C" width="24" height="22" /><a class="el" href="structRtAudio_1_1StreamParameters.html" target="_self">StreamParameters</a></td><td class="desc">The structure for specifying input or ouput stream parameters</td></tr> | |||
<tr id="row_1_" class="even"><td class="entry"><img src="ftv2lastnode.png" alt="\" width="16" height="22" /><img src="ftv2cl.png" alt="C" width="24" height="22" /><a class="el" href="classRtError.html" target="_self">RtError</a></td><td class="desc">Exception handling class for <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> & RtMidi</td></tr> | |||
</table> | |||
</div><!-- directory --> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,38 +8,39 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">API Notes </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="apinotes">API Notes </a></h1><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> is designed to provide a common API across the various supported operating systems and audio libraries. Despite that, some issues should be mentioned with regard to each.</p> | |||
<h2><a class="anchor" id="linux"> | |||
Linux:</a></h2> | |||
<div class="textblock"><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> is designed to provide a common API across the various supported operating systems and audio libraries. Despite that, some issues should be mentioned with regard to each.</p> | |||
<h1><a class="anchor" id="linux"></a> | |||
Linux:</h1> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for Linux was developed under Redhat distributions 7.0 - Fedora. Four different audio APIs are supported on Linux platforms: <a href="http://www.opensound.com/oss.html">OSS</a> (versions >= 4.0), <a href="http://www.alsa-project.org/">ALSA</a>, <a href="http://jackit.sourceforge.net/">Jack</a>, and <a href="http://www.freedesktop.org/wiki/Software/PulseAudio">PulseAudio</a>. Note that <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> now only supports the newer version 4.0 OSS API. The ALSA API is now part of the Linux kernel and offers significantly better functionality than the OSS API. <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> provides support for the 1.0 and higher versions of ALSA. Jack is a low-latency audio server written primarily for the GNU/Linux operating system. It can connect a number of different applications to an audio device, as well as allow them to share audio between themselves. Input/output latency on the order of 15 milliseconds can typically be achieved using any of the Linux APIs by fine-tuning the <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> buffer parameters (without kernel modifications). Latencies on the order of 5 milliseconds or less can be achieved using a low-latency kernel patch and increasing FIFO scheduling priority. The pthread library, which is used for callback functionality, is a standard component of all Linux distributions.</p> | |||
<p>The ALSA library includes OSS emulation support. That means that you can run programs compiled for the OSS API even when using the ALSA drivers and library. It should be noted however that OSS emulation under ALSA is not perfect. Specifically, channel number queries seem to consistently produce invalid results. While OSS emulation is successful for the majority of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> tests, it is recommended that the native ALSA implementation of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> be used on systems which have ALSA drivers installed.</p> | |||
<p>The ALSA implementation of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> makes no use of the ALSA "plug" interface. All necessary data format conversions, channel compensation, de-interleaving, and byte-swapping is handled by internal <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> routines.</p> | |||
<h2><a class="anchor" id="macosx"> | |||
Macintosh OS-X (CoreAudio and Jack):</a></h2> | |||
<p>The Apple CoreAudio API is designed to use a separate callback procedure for each of its audio devices. A single <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> duplex stream using two different devices is supported, though it cannot be guaranteed to always behave correctly because we cannot synchronize these two callbacks. The <em>numberOfBuffers</em> parameter to the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function has no affect in this implementation.</p> | |||
<h1><a class="anchor" id="macosx"></a> | |||
Macintosh OS-X (CoreAudio and Jack):</h1> | |||
<p>The Apple CoreAudio API is designed to use a separate callback procedure for each of its audio devices. A single <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> duplex stream using two different devices is supported, though it cannot be guaranteed to always behave correctly because we cannot synchronize these two callbacks. The <em>numberOfBuffers</em> parameter to the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function has no affect in this implementation.</p> | |||
<p>It is not possible to have multiple instances of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> accessing the same CoreAudio device.</p> | |||
<p>The <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> Jack support can be compiled on Macintosh OS-X systems, as well as in Linux.</p> | |||
<h2><a class="anchor" id="windowsds"> | |||
Windows (DirectSound):</a></h2> | |||
<p>The <code>configure</code> script provides support for the MinGW compiler. DirectSound support is specified with the "--with-ds" flag.</p> | |||
<h1><a class="anchor" id="windowsds"></a> | |||
Windows (DirectSound):</h1> | |||
<p>The <code>configure</code> script provides support for the MinGW compiler. DirectSound support is specified with the "&ndash;with-ds" flag.</p> | |||
<p>In order to compile <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> under Windows for the DirectSound API, you must have the header and source files for DirectSound version 5.0 or higher. As far as I know, there is no DirectSoundCapture support for Windows NT. Audio output latency with DirectSound can be reasonably good, especially since <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> version 3.0.2. Input audio latency still tends to be bad but better since version 3.0.2. <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> was originally developed with Visual C++ version 6.0 but has been tested with .NET.</p> | |||
<p>The DirectSound version of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> can be compiled with or without the UNICODE preprocessor definition.</p> | |||
<h2><a class="anchor" id="windowsasio"> | |||
Windows (ASIO):</a></h2> | |||
<p>ASIO support using MinGW and the <code>configure</code> script is specified with the "--with-asio" flag.</p> | |||
<p>The Steinberg ASIO audio API allows only a single device driver to be loaded and accessed at a time. ASIO device drivers must be supplied by audio hardware manufacturers, though ASIO emulation is possible on top of systems with DirectSound drivers. The <em>numberOfBuffers</em> parameter to the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function has no affect in this implementation.</p> | |||
<h1><a class="anchor" id="windowsasio"></a> | |||
Windows (ASIO):</h1> | |||
<p>ASIO support using MinGW and the <code>configure</code> script is specified with the "&ndash;with-asio" flag.</p> | |||
<p>The Steinberg ASIO audio API allows only a single device driver to be loaded and accessed at a time. ASIO device drivers must be supplied by audio hardware manufacturers, though ASIO emulation is possible on top of systems with DirectSound drivers. The <em>numberOfBuffers</em> parameter to the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function has no affect in this implementation.</p> | |||
<p>A number of ASIO source and header files are required for use with <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>. Specifically, an <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> project must include the following files: <code>asio.h,cpp; asiodrivers.h,cpp; asiolist.h,cpp; asiodrvr.h; asiosys.h; ginclude.h; iasiodrv.h; iasiothiscallresolver.h,cpp</code>. The Visual C++ projects found in <code>/tests/Windows/</code> compile both ASIO and DirectSound support.</p> | |||
<p>The Steinberg provided <code>asiolist</code> class does not compile when the preprocessor definition UNICODE is defined. Note that this could be an issue when using <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> with Qt, though Qt programs appear to compile without the UNICODE definition (try <code>DEFINES -= UNICODE</code> in your .pro file). <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> with ASIO support has been tested using the MinGW compiler under Windows XP, as well as in the Visual Studio environment. </p> | |||
</div> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,57 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio Member List</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>This is the complete list of members for <a class="el" href="classRtAudio.html">RtAudio</a>, including all inherited members.</p> | |||
<table class="directory"> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">abortStream</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">Api</a> enum name</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a">closeStream</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26">getCompiledApi</a>(std::vector< RtAudio::Api > &apis)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">static</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246">getCurrentApi</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce">getDefaultInputDevice</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc">getDefaultOutputDevice</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a">getDeviceCount</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8">getDeviceInfo</a>(unsigned int device)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3">getStreamLatency</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5">getStreamSampleRate</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca">getStreamTime</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#afee36f6d32f4744ffa7471a0ce7a3856">getVersion</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span><span class="mlabel">static</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f">isStreamOpen</a>(void) const </td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea">isStreamRunning</a>(void) const </td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">LINUX_ALSA</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">LINUX_OSS</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">LINUX_PULSE</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">MACOSX_CORE</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b">openStream</a>(RtAudio::StreamParameters *outputParameters, RtAudio::StreamParameters *inputParameters, RtAudioFormat format, unsigned int sampleRate, unsigned int *bufferFrames, RtAudioCallback callback, void *userData=NULL, RtAudio::StreamOptions *options=NULL, RtAudioErrorCallback errorCallback=NULL)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9">RtAudio</a>(RtAudio::Api api=UNSPECIFIED)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RTAUDIO_DUMMY</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77">showWarnings</a>(bool value=true)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80">startStream</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd">stopStream</a>(void)</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">UNIX_JACK</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">WINDOWS_ASIO</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">WINDOWS_DS</a> enum value</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtAudio.html#aa8a9716fd64680657ef69c9465442a2f">~RtAudio</a>()</td><td class="entry"><a class="el" href="classRtAudio.html">RtAudio</a></td><td class="entry"></td></tr> | |||
</table></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,647 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="summary"> | |||
<a href="#nested-classes">Classes</a> | | |||
<a href="#pub-types">Public Types</a> | | |||
<a href="#pub-methods">Public Member Functions</a> | | |||
<a href="#pub-static-methods">Static Public Member Functions</a> | | |||
<a href="classRtAudio-members.html">List of all members</a> </div> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio Class Reference</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>Realtime audio i/o C++ classes. | |||
<a href="classRtAudio.html#details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtAudio_8h_source.html">RtAudio.h</a>></code></p> | |||
<table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a> | |||
Classes</h2></td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html">DeviceInfo</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The public device information structure for returning queried values. <a href="structRtAudio_1_1DeviceInfo.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html">StreamOptions</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying stream options. <a href="structRtAudio_1_1StreamOptions.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamParameters.html">StreamParameters</a></td></tr> | |||
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">The structure for specifying input or ouput stream parameters. <a href="structRtAudio_1_1StreamParameters.html#details">More...</a><br/></td></tr> | |||
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table><table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a> | |||
Public Types</h2></td></tr> | |||
<tr class="memitem:ac9b6f625da88249d08a8409a9db0d849"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">Api</a> { <br/> | |||
  <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">LINUX_ALSA</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77">LINUX_PULSE</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82">LINUX_OSS</a>, | |||
<br/> | |||
  <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">UNIX_JACK</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">MACOSX_CORE</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">WINDOWS_ASIO</a>, | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">WINDOWS_DS</a>, | |||
<br/> | |||
  <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1">RTAUDIO_DUMMY</a> | |||
<br/> | |||
}</td></tr> | |||
<tr class="memdesc:ac9b6f625da88249d08a8409a9db0d849"><td class="mdescLeft"> </td><td class="mdescRight">Audio API specifier arguments. <a href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">More...</a><br/></td></tr> | |||
<tr class="separator:ac9b6f625da88249d08a8409a9db0d849"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table><table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> | |||
Public Member Functions</h2></td></tr> | |||
<tr class="memitem:afd0bfa26deae9804e18faff59d0273d9"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9">RtAudio</a> (<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> api=<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a>) throw ()</td></tr> | |||
<tr class="memdesc:afd0bfa26deae9804e18faff59d0273d9"><td class="mdescLeft"> </td><td class="mdescRight">The class constructor. <a href="#afd0bfa26deae9804e18faff59d0273d9"></a><br/></td></tr> | |||
<tr class="separator:afd0bfa26deae9804e18faff59d0273d9"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:aa8a9716fd64680657ef69c9465442a2f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#aa8a9716fd64680657ef69c9465442a2f">~RtAudio</a> () throw ()</td></tr> | |||
<tr class="memdesc:aa8a9716fd64680657ef69c9465442a2f"><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <a href="#aa8a9716fd64680657ef69c9465442a2f"></a><br/></td></tr> | |||
<tr class="separator:aa8a9716fd64680657ef69c9465442a2f"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a83687634795792b2c47e4ae1cf8a5246"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a83687634795792b2c47e4ae1cf8a5246"></a> | |||
<a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246">getCurrentApi</a> (void) throw ()</td></tr> | |||
<tr class="memdesc:a83687634795792b2c47e4ae1cf8a5246"><td class="mdescLeft"> </td><td class="mdescRight">Returns the audio API specifier for the current instance of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>. <br/></td></tr> | |||
<tr class="separator:a83687634795792b2c47e4ae1cf8a5246"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a747ce2d73803641bbb66d6e78092aa1a"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a">getDeviceCount</a> (void) throw ()</td></tr> | |||
<tr class="memdesc:a747ce2d73803641bbb66d6e78092aa1a"><td class="mdescLeft"> </td><td class="mdescRight">A public function that queries for the number of audio devices available. <a href="#a747ce2d73803641bbb66d6e78092aa1a"></a><br/></td></tr> | |||
<tr class="separator:a747ce2d73803641bbb66d6e78092aa1a"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a02d7ff44ad1d7eae22283a052f3dfda8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8">getDeviceInfo</a> (unsigned int device)</td></tr> | |||
<tr class="memdesc:a02d7ff44ad1d7eae22283a052f3dfda8"><td class="mdescLeft"> </td><td class="mdescRight">Return an <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure for a specified device number. <a href="#a02d7ff44ad1d7eae22283a052f3dfda8"></a><br/></td></tr> | |||
<tr class="separator:a02d7ff44ad1d7eae22283a052f3dfda8"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a3a3f3dbe13ea696b521e49cdaaa357bc"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc">getDefaultOutputDevice</a> (void) throw ()</td></tr> | |||
<tr class="memdesc:a3a3f3dbe13ea696b521e49cdaaa357bc"><td class="mdescLeft"> </td><td class="mdescRight">A function that returns the index of the default output device. <a href="#a3a3f3dbe13ea696b521e49cdaaa357bc"></a><br/></td></tr> | |||
<tr class="separator:a3a3f3dbe13ea696b521e49cdaaa357bc"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:aad8b94edd3cd379ee300b125750ac6ce"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce">getDefaultInputDevice</a> (void) throw ()</td></tr> | |||
<tr class="memdesc:aad8b94edd3cd379ee300b125750ac6ce"><td class="mdescLeft"> </td><td class="mdescRight">A function that returns the index of the default input device. <a href="#aad8b94edd3cd379ee300b125750ac6ce"></a><br/></td></tr> | |||
<tr class="separator:aad8b94edd3cd379ee300b125750ac6ce"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a6907539d2527775df778ebce32ef1e3b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b">openStream</a> (<a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> *outputParameters, <a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> *inputParameters, <a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> format, unsigned int sampleRate, unsigned int *bufferFrames, <a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a> callback, void *userData=NULL, <a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a> *options=NULL, <a class="el" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062">RtAudioErrorCallback</a> errorCallback=NULL)</td></tr> | |||
<tr class="memdesc:a6907539d2527775df778ebce32ef1e3b"><td class="mdescLeft"> </td><td class="mdescRight">A public function for opening a stream with the specified parameters. <a href="#a6907539d2527775df778ebce32ef1e3b"></a><br/></td></tr> | |||
<tr class="separator:a6907539d2527775df778ebce32ef1e3b"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a90d599002ad32cf250a4cb866f2cc93a"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a">closeStream</a> (void) throw ()</td></tr> | |||
<tr class="memdesc:a90d599002ad32cf250a4cb866f2cc93a"><td class="mdescLeft"> </td><td class="mdescRight">A function that closes a stream and frees any associated stream memory. <a href="#a90d599002ad32cf250a4cb866f2cc93a"></a><br/></td></tr> | |||
<tr class="separator:a90d599002ad32cf250a4cb866f2cc93a"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:aec017a89629ccef66a90b60be22a2f80"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80">startStream</a> (void)</td></tr> | |||
<tr class="memdesc:aec017a89629ccef66a90b60be22a2f80"><td class="mdescLeft"> </td><td class="mdescRight">A function that starts a stream. <a href="#aec017a89629ccef66a90b60be22a2f80"></a><br/></td></tr> | |||
<tr class="separator:aec017a89629ccef66a90b60be22a2f80"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:af4c241ff86936ecc8108f0d9dfe3efdd"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd">stopStream</a> (void)</td></tr> | |||
<tr class="memdesc:af4c241ff86936ecc8108f0d9dfe3efdd"><td class="mdescLeft"> </td><td class="mdescRight">Stop a stream, allowing any samples remaining in the output queue to be played. <a href="#af4c241ff86936ecc8108f0d9dfe3efdd"></a><br/></td></tr> | |||
<tr class="separator:af4c241ff86936ecc8108f0d9dfe3efdd"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:ad0586b47cd6bb9591a80b4052815991f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">abortStream</a> (void)</td></tr> | |||
<tr class="memdesc:ad0586b47cd6bb9591a80b4052815991f"><td class="mdescLeft"> </td><td class="mdescRight">Stop a stream, discarding any samples remaining in the input/output queue. <a href="#ad0586b47cd6bb9591a80b4052815991f"></a><br/></td></tr> | |||
<tr class="separator:ad0586b47cd6bb9591a80b4052815991f"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a3863e45ff81dbe97176de0ee7545917f"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3863e45ff81dbe97176de0ee7545917f"></a> | |||
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f">isStreamOpen</a> (void) const throw ()</td></tr> | |||
<tr class="memdesc:a3863e45ff81dbe97176de0ee7545917f"><td class="mdescLeft"> </td><td class="mdescRight">Returns true if a stream is open and false if not. <br/></td></tr> | |||
<tr class="separator:a3863e45ff81dbe97176de0ee7545917f"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a84cc8d9b7ab9bc5f37bcf48430ec5aea"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a84cc8d9b7ab9bc5f37bcf48430ec5aea"></a> | |||
bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea">isStreamRunning</a> (void) const throw ()</td></tr> | |||
<tr class="memdesc:a84cc8d9b7ab9bc5f37bcf48430ec5aea"><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the stream is running and false if it is stopped or not open. <br/></td></tr> | |||
<tr class="separator:a84cc8d9b7ab9bc5f37bcf48430ec5aea"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a344e59a62353c5791db4621b985cb2ca"><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a344e59a62353c5791db4621b985cb2ca">getStreamTime</a> (void)</td></tr> | |||
<tr class="memdesc:a344e59a62353c5791db4621b985cb2ca"><td class="mdescLeft"> </td><td class="mdescRight">Returns the number of elapsed seconds since the stream was started. <a href="#a344e59a62353c5791db4621b985cb2ca"></a><br/></td></tr> | |||
<tr class="separator:a344e59a62353c5791db4621b985cb2ca"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a843c989d9f501c71bc2f2c5ca18df9f3"><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a843c989d9f501c71bc2f2c5ca18df9f3">getStreamLatency</a> (void)</td></tr> | |||
<tr class="memdesc:a843c989d9f501c71bc2f2c5ca18df9f3"><td class="mdescLeft"> </td><td class="mdescRight">Returns the internal stream latency in sample frames. <a href="#a843c989d9f501c71bc2f2c5ca18df9f3"></a><br/></td></tr> | |||
<tr class="separator:a843c989d9f501c71bc2f2c5ca18df9f3"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a28214b8b05d60b45c24ee6fae7b2a0b5"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#a28214b8b05d60b45c24ee6fae7b2a0b5">getStreamSampleRate</a> (void)</td></tr> | |||
<tr class="memdesc:a28214b8b05d60b45c24ee6fae7b2a0b5"><td class="mdescLeft"> </td><td class="mdescRight">Returns actual sample rate in use by the stream. <a href="#a28214b8b05d60b45c24ee6fae7b2a0b5"></a><br/></td></tr> | |||
<tr class="separator:a28214b8b05d60b45c24ee6fae7b2a0b5"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:af0752ee51cce3dd90a3bd009f9fdbe77"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af0752ee51cce3dd90a3bd009f9fdbe77"></a> | |||
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77">showWarnings</a> (bool value=true) throw ()</td></tr> | |||
<tr class="memdesc:af0752ee51cce3dd90a3bd009f9fdbe77"><td class="mdescLeft"> </td><td class="mdescRight">Specify whether warning messages should be printed to stderr. <br/></td></tr> | |||
<tr class="separator:af0752ee51cce3dd90a3bd009f9fdbe77"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table><table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a> | |||
Static Public Member Functions</h2></td></tr> | |||
<tr class="memitem:afee36f6d32f4744ffa7471a0ce7a3856"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afee36f6d32f4744ffa7471a0ce7a3856"></a> | |||
static std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#afee36f6d32f4744ffa7471a0ce7a3856">getVersion</a> (void)</td></tr> | |||
<tr class="memdesc:afee36f6d32f4744ffa7471a0ce7a3856"><td class="mdescLeft"> </td><td class="mdescRight">A static function to determine the current <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> version. <br/></td></tr> | |||
<tr class="separator:afee36f6d32f4744ffa7471a0ce7a3856"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:ae266ffad2ef428d0b2c6c262d391ce26"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26">getCompiledApi</a> (std::vector< <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> > &apis) throw ()</td></tr> | |||
<tr class="memdesc:ae266ffad2ef428d0b2c6c262d391ce26"><td class="mdescLeft"> </td><td class="mdescRight">A static function to determine the available compiled audio APIs. <a href="#ae266ffad2ef428d0b2c6c262d391ce26"></a><br/></td></tr> | |||
<tr class="separator:ae266ffad2ef428d0b2c6c262d391ce26"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table> | |||
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> | |||
<div class="textblock"><p>Realtime audio i/o C++ classes. </p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> provides a common API (Application Programming Interface) 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.</p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> WWW site: <a href="http://www.music.mcgill.ca/~gary/rtaudio/">http://www.music.mcgill.ca/~gary/rtaudio/</a></p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>: realtime audio i/o C++ classes Copyright (c) 2001-2013 Gary P. Scavone</p> | |||
<p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p> | |||
<p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p> | |||
<p>Any person wishing to distribute modifications to the Software is asked to send the modifications to the original developer so that they can be incorporated into the canonical version. This is, however, not a binding provision of this license.</p> | |||
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. </p> | |||
</div><h2 class="groupheader">Member Enumeration Documentation</h2> | |||
<a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">enum <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a></td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Audio API specifier arguments. </p> | |||
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0"> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae"></a>UNSPECIFIED</em> </td><td> | |||
<p>Search for a working compiled API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8"></a>LINUX_ALSA</em> </td><td> | |||
<p>The Advanced Linux Sound Architecture API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849adc17dff310e85d303fb326c837c08d77"></a>LINUX_PULSE</em> </td><td> | |||
<p>The Linux PulseAudio API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a39c84615e61de75e6a4e865596d62c82"></a>LINUX_OSS</em> </td><td> | |||
<p>The Linux Open Sound System API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105"></a>UNIX_JACK</em> </td><td> | |||
<p>The Jack Low-Latency Audio Server API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d"></a>MACOSX_CORE</em> </td><td> | |||
<p>Macintosh OS-X Core Audio API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469"></a>WINDOWS_ASIO</em> </td><td> | |||
<p>The Steinberg Audio Stream I/O API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931"></a>WINDOWS_DS</em> </td><td> | |||
<p>The Microsoft Direct Sound API. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ac9b6f625da88249d08a8409a9db0d849ab06b8fd88bf18c9a2b8271f6961ae2d1"></a>RTAUDIO_DUMMY</em> </td><td> | |||
<p>A compilable but non-functional API. </p> | |||
</td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
<h2 class="groupheader">Constructor & Destructor Documentation</h2> | |||
<a class="anchor" id="afd0bfa26deae9804e18faff59d0273d9"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">RtAudio::RtAudio </td> | |||
<td>(</td> | |||
<td class="paramtype"><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> </td> | |||
<td class="paramname"><em>api</em> = <code><a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa49af3ac767106158bc6cad74fb214ae">UNSPECIFIED</a></code></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>The class constructor. </p> | |||
<p>The constructor performs minor initialization tasks. No exceptions can be thrown.</p> | |||
<p>If no API argument is specified and multiple API support has been compiled, the default order of use is JACK, ALSA, OSS (Linux systems) and ASIO, DS (Windows systems). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="aa8a9716fd64680657ef69c9465442a2f"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">RtAudio::~RtAudio </td> | |||
<td>(</td> | |||
<td class="paramname"></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>The destructor. </p> | |||
<p>If a stream is running or open, it will be stopped and closed automatically. </p> | |||
</div> | |||
</div> | |||
<h2 class="groupheader">Member Function Documentation</h2> | |||
<a class="anchor" id="ae266ffad2ef428d0b2c6c262d391ce26"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">static void RtAudio::getCompiledApi </td> | |||
<td>(</td> | |||
<td class="paramtype">std::vector< <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio::Api</a> > & </td> | |||
<td class="paramname"><em>apis</em></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">static</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A static function to determine the available compiled audio APIs. </p> | |||
<p>The values returned in the std::vector can be compared against the enumerated list values. Note that there can be more than one API compiled for certain operating systems. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a747ce2d73803641bbb66d6e78092aa1a"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getDeviceCount </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A public function that queries for the number of audio devices available. </p> | |||
<p>This function performs a system query of available devices each time it is called, thus supporting devices connected <em>after</em> instantiation. If a system error occurs during processing, a warning will be issued. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a02d7ff44ad1d7eae22283a052f3dfda8"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a> RtAudio::getDeviceInfo </td> | |||
<td>(</td> | |||
<td class="paramtype">unsigned int </td> | |||
<td class="paramname"><em>device</em></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Return an <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure for a specified device number. </p> | |||
<p>Any device integer between 0 and <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1 is valid. If an invalid argument is provided, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. If a device is busy or otherwise unavailable, the structure member "probed" will have a value of "false" and all other members are undefined. If the specified device is the current default input or output device, the corresponding "isDefault" member will have a value of "true". </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a3a3f3dbe13ea696b521e49cdaaa357bc"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getDefaultOutputDevice </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A function that returns the index of the default output device. </p> | |||
<p>If the underlying audio API does not provide a "default | |||
device", or if no devices are available, the return value will be 0. Note that this is a valid device identifier and it is the client's responsibility to verify that a device is available before attempting to open a stream. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="aad8b94edd3cd379ee300b125750ac6ce"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getDefaultInputDevice </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A function that returns the index of the default input device. </p> | |||
<p>If the underlying audio API does not provide a "default | |||
device", or if no devices are available, the return value will be 0. Note that this is a valid device identifier and it is the client's responsibility to verify that a device is available before attempting to open a stream. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a6907539d2527775df778ebce32ef1e3b"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::openStream </td> | |||
<td>(</td> | |||
<td class="paramtype"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> * </td> | |||
<td class="paramname"><em>outputParameters</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a> * </td> | |||
<td class="paramname"><em>inputParameters</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> </td> | |||
<td class="paramname"><em>format</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype">unsigned int </td> | |||
<td class="paramname"><em>sampleRate</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype">unsigned int * </td> | |||
<td class="paramname"><em>bufferFrames</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudioCallback</a> </td> | |||
<td class="paramname"><em>callback</em>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype">void * </td> | |||
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a> * </td> | |||
<td class="paramname"><em>options</em> = <code>NULL</code>, </td> | |||
</tr> | |||
<tr> | |||
<td class="paramkey"></td> | |||
<td></td> | |||
<td class="paramtype"><a class="el" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062">RtAudioErrorCallback</a> </td> | |||
<td class="paramname"><em>errorCallback</em> = <code>NULL</code> </td> | |||
</tr> | |||
<tr> | |||
<td></td> | |||
<td>)</td> | |||
<td></td><td></td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A public function for opening a stream with the specified parameters. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if a stream cannot be opened with the specified parameters or an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if any invalid device ID or channel number parameters are specified.</p> | |||
<dl class="params"><dt>Parameters</dt><dd> | |||
<table class="params"> | |||
<tr><td class="paramname">outputParameters</td><td>Specifies output stream parameters to use when opening a stream, including a device ID, number of channels, and starting channel number. For input-only streams, this argument should be NULL. The device ID is an index value between 0 and <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1. </td></tr> | |||
<tr><td class="paramname">inputParameters</td><td>Specifies input stream parameters to use when opening a stream, including a device ID, number of channels, and starting channel number. For output-only streams, this argument should be NULL. The device ID is an index value between 0 and <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount()</a> - 1. </td></tr> | |||
<tr><td class="paramname">format</td><td>An RtAudioFormat specifying the desired sample data format. </td></tr> | |||
<tr><td class="paramname">sampleRate</td><td>The desired sample rate (sample frames per second). </td></tr> | |||
<tr><td class="paramname">*bufferFrames</td><td>A pointer to a value indicating the desired internal buffer size in sample frames. The actual value used by the device is returned via the same pointer. A value of zero can be specified, in which case the lowest allowable value is determined. </td></tr> | |||
<tr><td class="paramname">callback</td><td>A client-defined function that will be invoked when input data is available and/or output data is needed. </td></tr> | |||
<tr><td class="paramname">userData</td><td>An optional pointer to data that can be accessed from within the callback function. </td></tr> | |||
<tr><td class="paramname">options</td><td>An optional pointer to a structure containing various global stream options, including a list of OR'ed RtAudioStreamFlags and a suggested number of stream buffers that can be used to control stream latency. More buffers typically result in more robust performance, though at a cost of greater latency. If a value of zero is specified, a system-specific median value is chosen. If the RTAUDIO_MINIMIZE_LATENCY flag bit is set, the lowest allowable value is used. The actual value used is returned via the structure argument. The parameter is API dependent. </td></tr> | |||
<tr><td class="paramname">errorCallback</td><td>A client-defined function that will be invoked when an error has occured. </td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a90d599002ad32cf250a4cb866f2cc93a"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::closeStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td> throw ()</td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A function that closes a stream and frees any associated stream memory. </p> | |||
<p>If a stream is not open, this function issues a warning and returns (no exception is thrown). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="aec017a89629ccef66a90b60be22a2f80"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::startStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>A function that starts a stream. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if a stream is not open. A warning is issued if the stream is already running. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="af4c241ff86936ecc8108f0d9dfe3efdd"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::stopStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Stop a stream, allowing any samples remaining in the output queue to be played. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if a stream is not open. A warning is issued if the stream is already stopped. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="ad0586b47cd6bb9591a80b4052815991f"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">void RtAudio::abortStream </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Stop a stream, discarding any samples remaining in the input/output queue. </p> | |||
<p>An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = SYSTEM_ERROR) is thrown if an error occurs during processing. An <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) is thrown if a stream is not open. A warning is issued if the stream is already stopped. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a344e59a62353c5791db4621b985cb2ca"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">double RtAudio::getStreamTime </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Returns the number of elapsed seconds since the stream was started. </p> | |||
<p>If a stream is not open, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a843c989d9f501c71bc2f2c5ca18df9f3"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">long RtAudio::getStreamLatency </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Returns the internal stream latency in sample frames. </p> | |||
<p>The stream latency refers to delay in audio input and/or output caused by internal buffering by the audio system and/or hardware. For duplex streams, the returned value will represent the sum of the input and output latencies. If a stream is not open, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. If the API does not report latency, the return value will be zero. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a28214b8b05d60b45c24ee6fae7b2a0b5"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="mlabels"> | |||
<tr> | |||
<td class="mlabels-left"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::getStreamSampleRate </td> | |||
<td>(</td> | |||
<td class="paramtype">void </td> | |||
<td class="paramname"></td><td>)</td> | |||
<td></td> | |||
</tr> | |||
</table> | |||
</td> | |||
<td class="mlabels-right"> | |||
<span class="mlabels"><span class="mlabel">inline</span></span> </td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Returns actual sample rate in use by the stream. </p> | |||
<p>On some systems, the sample rate used may be slightly different than that specified in the stream parameters. If a stream is not open, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> (type = INVALID_USE) will be thrown. </p> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this class was generated from the following file:<ul> | |||
<li><a class="el" href="RtAudio_8h_source.html">RtAudio.h</a></li> | |||
</ul> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,45 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">RtError Member List</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>This is the complete list of members for <a class="el" href="classRtError.html">RtError</a>, including all inherited members.</p> | |||
<table class="directory"> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">DEBUG_WARNING</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">DRIVER_ERROR</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50">getMessage</a>(void) const </td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"><span class="mlabel">inline</span><span class="mlabel">virtual</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">getType</a>(void) const </td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"><span class="mlabel">inline</span><span class="mlabel">virtual</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">INVALID_DEVICE</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">INVALID_PARAMETER</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">INVALID_USE</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">MEMORY_ERROR</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">NO_DEVICES_FOUND</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">printMessage</a>(void) const </td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"><span class="mlabel">inline</span><span class="mlabel">virtual</span></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37">RtError</a>(const std::string &message, Type type=RtError::UNSPECIFIED)</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"><span class="mlabel">inline</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">SYSTEM_ERROR</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">THREAD_ERROR</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> enum name</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">UNSPECIFIED</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">WARNING</a> enum value</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d">what</a>(void) const </td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"><span class="mlabel">inline</span><span class="mlabel">virtual</span></td></tr> | |||
<tr><td class="entry"><a class="el" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">~RtError</a>(void)</td><td class="entry"><a class="el" href="classRtError.html">RtError</a></td><td class="entry"><span class="mlabel">inline</span><span class="mlabel">virtual</span></td></tr> | |||
</table></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,142 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="summary"> | |||
<a href="#pub-types">Public Types</a> | | |||
<a href="#pub-methods">Public Member Functions</a> | | |||
<a href="classRtError-members.html">List of all members</a> </div> | |||
<div class="headertitle"> | |||
<div class="title">RtError Class Reference</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>Exception handling class for <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> & RtMidi. | |||
<a href="classRtError.html#details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtError_8h_source.html">RtError.h</a>></code></p> | |||
<p>Inherits exception.</p> | |||
<table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a> | |||
Public Types</h2></td></tr> | |||
<tr class="memitem:ab04667aae01bffc354a9ac6bda6903ac"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> { <br/> | |||
  <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">WARNING</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">DEBUG_WARNING</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">UNSPECIFIED</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82">NO_DEVICES_FOUND</a>, | |||
<br/> | |||
  <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1">INVALID_DEVICE</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e">MEMORY_ERROR</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6">INVALID_PARAMETER</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc">INVALID_USE</a>, | |||
<br/> | |||
  <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b">DRIVER_ERROR</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b">SYSTEM_ERROR</a>, | |||
<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">THREAD_ERROR</a> | |||
<br/> | |||
}</td></tr> | |||
<tr class="memdesc:ab04667aae01bffc354a9ac6bda6903ac"><td class="mdescLeft"> </td><td class="mdescRight">Defined <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> types. <a href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">More...</a><br/></td></tr> | |||
<tr class="separator:ab04667aae01bffc354a9ac6bda6903ac"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table><table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> | |||
Public Member Functions</h2></td></tr> | |||
<tr class="memitem:aa479a305ccbe56be0fd9137b9b405a37"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa479a305ccbe56be0fd9137b9b405a37"></a> | |||
 </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#aa479a305ccbe56be0fd9137b9b405a37">RtError</a> (const std::string &message, <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> type=<a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6">RtError::UNSPECIFIED</a>) throw ()</td></tr> | |||
<tr class="memdesc:aa479a305ccbe56be0fd9137b9b405a37"><td class="mdescLeft"> </td><td class="mdescRight">The constructor. <br/></td></tr> | |||
<tr class="separator:aa479a305ccbe56be0fd9137b9b405a37"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a6793e03386e7e69ffafb65a296dfa48c"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a6793e03386e7e69ffafb65a296dfa48c"></a> | |||
virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">~RtError</a> (void) throw ()</td></tr> | |||
<tr class="memdesc:a6793e03386e7e69ffafb65a296dfa48c"><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <br/></td></tr> | |||
<tr class="separator:a6793e03386e7e69ffafb65a296dfa48c"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a251dcdac396c998c91706dd2dd3b8bfc"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a251dcdac396c998c91706dd2dd3b8bfc"></a> | |||
virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">printMessage</a> (void) const throw ()</td></tr> | |||
<tr class="memdesc:a251dcdac396c998c91706dd2dd3b8bfc"><td class="mdescLeft"> </td><td class="mdescRight">Prints thrown error message to stderr. <br/></td></tr> | |||
<tr class="separator:a251dcdac396c998c91706dd2dd3b8bfc"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a3e316dc9b9b41fe2f64cabf34beb4fe7"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3e316dc9b9b41fe2f64cabf34beb4fe7"></a> | |||
virtual const <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">Type</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">getType</a> (void) const throw ()</td></tr> | |||
<tr class="memdesc:a3e316dc9b9b41fe2f64cabf34beb4fe7"><td class="mdescLeft"> </td><td class="mdescRight">Returns the thrown error message type. <br/></td></tr> | |||
<tr class="separator:a3e316dc9b9b41fe2f64cabf34beb4fe7"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:afd067ba6b46edd37f989cad02cd70b50"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="afd067ba6b46edd37f989cad02cd70b50"></a> | |||
virtual const std::string & </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50">getMessage</a> (void) const throw ()</td></tr> | |||
<tr class="memdesc:afd067ba6b46edd37f989cad02cd70b50"><td class="mdescLeft"> </td><td class="mdescRight">Returns the thrown error message string. <br/></td></tr> | |||
<tr class="separator:afd067ba6b46edd37f989cad02cd70b50"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:aeb843b7a7785d66061c61ebfc29e7e9d"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aeb843b7a7785d66061c61ebfc29e7e9d"></a> | |||
virtual const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d">what</a> (void) const throw ()</td></tr> | |||
<tr class="memdesc:aeb843b7a7785d66061c61ebfc29e7e9d"><td class="mdescLeft"> </td><td class="mdescRight">Returns the thrown error message as a c-style string. <br/></td></tr> | |||
<tr class="separator:aeb843b7a7785d66061c61ebfc29e7e9d"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table> | |||
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> | |||
<div class="textblock"><p>Exception handling class for <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> & RtMidi. </p> | |||
<p>The <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> class is quite simple but it does allow errors to be "caught" by <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac" title="Defined RtError types.">RtError::Type</a>. See the <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> and RtMidi documentation to know which methods can throw an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>. </p> | |||
</div><h2 class="groupheader">Member Enumeration Documentation</h2> | |||
<a class="anchor" id="ab04667aae01bffc354a9ac6bda6903ac"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">enum <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">RtError::Type</a></td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Defined <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> types. </p> | |||
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0"> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398"></a>WARNING</em> </td><td> | |||
<p>A non-critical error. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba"></a>DEBUG_WARNING</em> </td><td> | |||
<p>A non-critical error which might be useful for debugging. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca444efd3ccf774b2ba9f9bde70ec71cd6"></a>UNSPECIFIED</em> </td><td> | |||
<p>The default, unspecified error type. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acaf267eb2d710f33d649ba840eeab6ff82"></a>NO_DEVICES_FOUND</em> </td><td> | |||
<p>No devices found on system. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acad6064062066fffdba258237a7c2159b1"></a>INVALID_DEVICE</em> </td><td> | |||
<p>An invalid device ID was specified. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acab4f813e5a36905c89d4081a59497432e"></a>MEMORY_ERROR</em> </td><td> | |||
<p>An error occured during memory allocation. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acaa3eabf0f71120beaba94148a1b78fed6"></a>INVALID_PARAMETER</em> </td><td> | |||
<p>An invalid parameter was specified to a function. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca8e65f51a3fbdc1a4a1552b3260df36bc"></a>INVALID_USE</em> </td><td> | |||
<p>The function was called incorrectly. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca995e97ecf6beeedaba525022a63aec6b"></a>DRIVER_ERROR</em> </td><td> | |||
<p>A system driver error occured. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903aca8947d0a2e2a84ecf3646271844e06a6b"></a>SYSTEM_ERROR</em> </td><td> | |||
<p>A system error occured. </p> | |||
</td></tr> | |||
<tr><td valign="top"><em><a class="anchor" id="ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6"></a>THREAD_ERROR</em> </td><td> | |||
<p>A thread error occured. </p> | |||
</td></tr> | |||
</table> | |||
</dd> | |||
</dl> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this class was generated from the following file:<ul> | |||
<li><a class="el" href="RtError_8h_source.html">RtError.h</a></li> | |||
</ul> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,36 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Class Index</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="qindex"><a class="qindex" href="#letter_D">D</a> | <a class="qindex" href="#letter_R">R</a> | <a class="qindex" href="#letter_S">S</a></div> | |||
<table style="margin: 10px; white-space: nowrap;" align="center" width="95%" border="0" cellspacing="0" cellpadding="0"> | |||
<tr><td rowspan="2" valign="bottom"><a name="letter_D"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">  D  </div></td></tr></table> | |||
</td><td rowspan="2" valign="bottom"><a name="letter_R"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">  R  </div></td></tr></table> | |||
</td><td valign="top"><a class="el" href="classRtError.html">RtError</a>   </td><td valign="top"><a class="el" href="structRtAudio_1_1StreamParameters.html">RtAudio::StreamParameters</a>   </td></tr> | |||
<tr><td rowspan="2" valign="bottom"><a name="letter_S"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">  S  </div></td></tr></table> | |||
</td><td></td></tr> | |||
<tr><td valign="top"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a>   </td><td valign="top"><a class="el" href="classRtAudio.html">RtAudio</a>   </td><td></td></tr> | |||
<tr><td></td><td></td><td valign="top"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a>   </td><td></td></tr> | |||
<tr><td></td><td></td><td></td><td></td></tr> | |||
</table> | |||
<div class="qindex"><a class="qindex" href="#letter_D">D</a> | <a class="qindex" href="#letter_R">R</a> | <a class="qindex" href="#letter_S">S</a></div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,27 +8,30 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Debugging & Compiling </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="compiling">Debugging & Compiling </a></h1><h2><a class="anchor" id="debug"> | |||
Debugging</a></h2> | |||
<p>If you are having problems getting <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> to run on your system, make sure to pass a value of <em>true</em> to the <a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">RtAudio::showWarnings()</a> function (this is the default setting). A variety of warning messages will be displayed which may help in determining the problem. Also, try using the programs included in the <code>tests</code> directory. The program <code>audioprobe</code> displays the queried capabilities of all hardware devices found for all APIs compiled. When using the ALSA and JACK APIs, further information can be displayed by defining the preprocessor definition __RTAUDIO_DEBUG__.</p> | |||
<h2><a class="anchor" id="compile"> | |||
Compiling</a></h2> | |||
<div class="textblock"><h1><a class="anchor" id="debug"></a> | |||
Debugging</h1> | |||
<p>If you are having problems getting <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> to run on your system, make sure to pass a value of <em>true</em> to the <a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">RtAudio::showWarnings()</a> function (this is the default setting). A variety of warning messages will be displayed which may help in determining the problem. Also, try using the programs included in the <code>tests</code> directory. The program <code>audioprobe</code> displays the queried capabilities of all hardware devices found for all APIs compiled. When using the ALSA and JACK APIs, further information can be displayed by defining the preprocessor definition <b>RTAUDIO_DEBUG</b>.</p> | |||
<h1><a class="anchor" id="compile"></a> | |||
Compiling</h1> | |||
<p>In order to compile <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for a specific OS and audio API, it is necessary to supply the appropriate preprocessor definition and library within the compiler statement: </p> | |||
<table class="doxtable" border="2" cols="5" width="100%"> | |||
<table border="2" cols="5" width="100%"> | |||
<tr bgcolor="beige"> | |||
<td width="5%"><b>OS:</b> </td><td width="5%"><b>Audio API:</b> </td><td width="5%"><b>C++ Class:</b> </td><td width="5%"><b>Preprocessor Definition:</b> </td><td width="5%"><b>Library or Framework:</b> </td><td><b>Example Compiler Statement:</b> </td></tr> | |||
<tr> | |||
<td>Linux </td><td>ALSA </td><td>RtApiAlsa </td><td>__LINUX_ALSA__ </td><td><code>asound, pthread</code> </td><td><code>g++ -Wall -D__LINUX_ALSA__ -o audioprobe audioprobe.cpp RtAudio.cpp -lasound -lpthread</code> </td></tr> | |||
<tr> | |||
<td>Linux </td><td>PulseAudio </td><td>RtApiPulse </td><td>__LINUX_PULSE__ </td><td><code>pthread</code> </td><td><code>g++ -Wall -D__LINUX_PULSE__ -o audioprobe audioprobe.cpp RtAudio.cpp -lpthread</code> </td></tr> | |||
<td>Linux </td><td>PulseAudio </td><td>RtApiPulse </td><td>__LINUX_PULSE__ </td><td><code>pthread</code> </td><td><code>g++ -Wall -D__LINUX_PULSE__ -o audioprobe audioprobe.cpp RtAudio.cpp -lpthread -lpulse-simple -lpulse</code> </td></tr> | |||
<tr> | |||
<td>Linux </td><td>OSS </td><td>RtApiOss </td><td>__LINUX_OSS__ </td><td><code>pthread</code> </td><td><code>g++ -Wall -D__LINUX_OSS__ -o audioprobe audioprobe.cpp RtAudio.cpp -lpthread</code> </td></tr> | |||
<tr> | |||
<td>Linux or Macintosh OS-X </td><td>Jack Audio Server </td><td>RtApiJack </td><td>__UNIX_JACK__ </td><td><code>jack, pthread</code> </td><td><p class="starttd"><code>g++ -Wall -D__UNIX_JACK__ -o audioprobe audioprobe.cpp RtAudio.cpp `pkg-config --cflags --libs jack` -lpthread</code> </p> | |||
<td>Linux or Macintosh OS-X </td><td>Jack Audio Server </td><td>RtApiJack </td><td>__UNIX_JACK__ </td><td><code>jack, pthread</code> </td><td><p class="starttd"><code>g++ -Wall -D__UNIX_JACK__ -o audioprobe audioprobe.cpp RtAudio.cpp <code>pkg-config --cflags --libs jack</code> -lpthread</code> </p> | |||
<p class="endtd"></p> | |||
</td></tr> | |||
<tr> | |||
@@ -39,12 +42,10 @@ Compiling</a></h2> | |||
<td>Windows </td><td>ASIO </td><td>RtApiAsio </td><td>__WINDOWS_ASIO__ </td><td><em>various ASIO header and source files</em> </td><td><em>compiler specific</em> </td></tr> | |||
</table> | |||
<p>The example compiler statements above could be used to compile the <code>audioprobe.cpp</code> example file, assuming that <code>audioprobe.cpp</code>, <code><a class="el" href="RtAudio_8h.html">RtAudio.h</a></code>, <code><a class="el" href="RtError_8h_source.html">RtError.h</a></code>, and <code>RtAudio.cpp</code> all exist in the same directory. </p> | |||
</div> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,91 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Duplex Mode </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p>Finally, it is easy to use <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for simultaneous audio input/output, or duplex operation. In this example, we simply pass the input data back to the output.</p> | |||
<div class="fragment"><div class="line"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span></div> | |||
<div class="line"><span class="preprocessor">#include <iostream></span></div> | |||
<div class="line"><span class="preprocessor">#include <cstdlib></span></div> | |||
<div class="line"><span class="preprocessor">#include <cstring></span></div> | |||
<div class="line"></div> | |||
<div class="line"><span class="comment">// Pass-through function.</span></div> | |||
<div class="line"><span class="keywordtype">int</span> inout( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBufferFrames,</div> | |||
<div class="line"> <span class="keywordtype">double</span> streamTime, <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, <span class="keywordtype">void</span> *data )</div> | |||
<div class="line">{</div> | |||
<div class="line"> <span class="comment">// Since the number of input and output channels is equal, we can do</span></div> | |||
<div class="line"> <span class="comment">// a simple buffer copy operation here.</span></div> | |||
<div class="line"> <span class="keywordflow">if</span> ( status ) std::cout << <span class="stringliteral">"Stream over/underflow detected."</span> << std::endl;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *bytes = (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *) data;</div> | |||
<div class="line"> memcpy( outputBuffer, inputBuffer, *bytes );</div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
<div class="line"></div> | |||
<div class="line"><span class="keywordtype">int</span> main()</div> | |||
<div class="line">{</div> | |||
<div class="line"> <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> adac;</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( adac.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() < 1 ) {</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"\nNo audio devices found!\n"</span>;</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="comment">// Set the same number of channels for both input and output.</span></div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferBytes, bufferFrames = 512;</div> | |||
<div class="line"> <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> iParams, oParams;</div> | |||
<div class="line"> iParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = 0; <span class="comment">// first available device</span></div> | |||
<div class="line"> iParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2;</div> | |||
<div class="line"> oParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = 0; <span class="comment">// first available device</span></div> | |||
<div class="line"> oParams.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> adac.<a class="code" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream</a>( &oParams, &iParams, RTAUDIO_SINT32, 44100, &bufferFrames, &inout, (<span class="keywordtype">void</span> *)&bufferBytes );</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e ) {</div> | |||
<div class="line"> e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>();</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> bufferBytes = bufferFrames * 2 * 4;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> adac.<a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>();</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordtype">char</span> input;</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"\nRunning ... press <enter> to quit.\n"</span>;</div> | |||
<div class="line"> std::cin.get(input);</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="comment">// Stop the stream.</span></div> | |||
<div class="line"> adac.<a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e ) {</div> | |||
<div class="line"> e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>();</div> | |||
<div class="line"> <span class="keywordflow">goto</span> cleanup;</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> cleanup:</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( adac.<a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>() ) adac.<a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>();</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
</div><!-- fragment --><p>In this example, audio recorded by the stream input will be played out during the next round of audio processing.</p> | |||
<p>Note that a duplex stream can make use of two different devices (except when using the Linux Jack and Windows ASIO APIs). However, this may cause timing problems due to possible device clock variations, unless a common external "sync" is provided. </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,25 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Error Handling </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> makes restrained use of C++ exceptions. That is, exceptions are thrown only when system errors occur that prevent further class operation or when the user makes invalid function calls. In other cases, a warning message may be displayed and an appropriate value is returned. For example, if a system error occurs when processing the <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">RtAudio::getDeviceCount()</a> function, the return value is zero. In such a case, the user cannot expect to make use of most other <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> functions because no devices are available (and thus a stream cannot be opened). A client can call the function <a class="el" href="classRtAudio.html#af0752ee51cce3dd90a3bd009f9fdbe77" title="Specify whether warning messages should be printed to stderr.">RtAudio::showWarnings()</a> with a boolean argument to enable or disable the printing of warning messages to <code>stderr</code>. By default, warning messages are displayed. There is a protected <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> method, error(), that can be modified to globally control how these messages are handled and reported. </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,30 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">File List</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock">Here is a list of all documented files with brief descriptions:</div><div class="directory"> | |||
<table class="directory"> | |||
<tr id="row_0_" class="even"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a href="RtAudio_8h_source.html"><img src="ftv2doc.png" alt="*" width="24" height="22" /></a><a class="el" href="RtAudio_8h.html" target="_self">RtAudio.h</a></td><td class="desc"></td></tr> | |||
<tr id="row_1_"><td class="entry"><img src="ftv2lastnode.png" alt="\" width="16" height="22" /><a href="RtError_8h_source.html"><img src="ftv2doc.png" alt="*" width="24" height="22" /></a><b>RtError.h</b></td><td class="desc"></td></tr> | |||
</table> | |||
</div><!-- directory --> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,41 +8,12 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li class="current"><a href="functions.html"><span>All</span></a></li> | |||
<li><a href="functions_func.html"><span>Functions</span></a></li> | |||
<li><a href="functions_vars.html"><span>Variables</span></a></li> | |||
<li><a href="functions_enum.html"><span>Enumerations</span></a></li> | |||
<li><a href="functions_eval.html"><span>Enumerator</span></a></li> | |||
</ul> | |||
</div> | |||
<div class="tabs"> | |||
<ul> | |||
<li><a href="#index_a"><span>a</span></a></li> | |||
<li><a href="#index_c"><span>c</span></a></li> | |||
<li><a href="#index_d"><span>d</span></a></li> | |||
<li><a href="#index_f"><span>f</span></a></li> | |||
<li><a href="#index_g"><span>g</span></a></li> | |||
<li><a href="#index_i"><span>i</span></a></li> | |||
<li><a href="#index_l"><span>l</span></a></li> | |||
<li><a href="#index_m"><span>m</span></a></li> | |||
<li><a href="#index_n"><span>n</span></a></li> | |||
<li><a href="#index_o"><span>o</span></a></li> | |||
<li><a href="#index_p"><span>p</span></a></li> | |||
<li><a href="#index_r"><span>r</span></a></li> | |||
<li><a href="#index_s"><span>s</span></a></li> | |||
<li><a href="#index_t"><span>t</span></a></li> | |||
<li><a href="#index_u"><span>u</span></a></li> | |||
<li><a href="#index_w"><span>w</span></a></li> | |||
<li><a href="#index_~"><span>~</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
Here is a list of all documented class members with links to the class documentation for each member: | |||
<div class="textblock">Here is a list of all documented class members with links to the class documentation for each member:</div> | |||
<h3><a class="anchor" id="index_a">- a -</a></h3><ul> | |||
<h3><a class="anchor" id="index_a"></a>- a -</h3><ul> | |||
<li>abortStream() | |||
: <a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">RtAudio</a> | |||
</li> | |||
@@ -52,14 +23,14 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_c">- c -</a></h3><ul> | |||
<h3><a class="anchor" id="index_c"></a>- c -</h3><ul> | |||
<li>closeStream() | |||
: <a class="el" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a">RtAudio</a> | |||
</li> | |||
</ul> | |||
<h3><a class="anchor" id="index_d">- d -</a></h3><ul> | |||
<h3><a class="anchor" id="index_d"></a>- d -</h3><ul> | |||
<li>DEBUG_WARNING | |||
: <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">RtError</a> | |||
</li> | |||
@@ -75,7 +46,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_f">- f -</a></h3><ul> | |||
<h3><a class="anchor" id="index_f"></a>- f -</h3><ul> | |||
<li>firstChannel | |||
: <a class="el" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">RtAudio::StreamParameters</a> | |||
</li> | |||
@@ -85,7 +56,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_g">- g -</a></h3><ul> | |||
<h3><a class="anchor" id="index_g"></a>- g -</h3><ul> | |||
<li>getCompiledApi() | |||
: <a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26">RtAudio</a> | |||
</li> | |||
@@ -119,10 +90,13 @@ Here is a list of all documented class members with links to the class documenta | |||
<li>getType() | |||
: <a class="el" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">RtError</a> | |||
</li> | |||
<li>getVersion() | |||
: <a class="el" href="classRtAudio.html#afee36f6d32f4744ffa7471a0ce7a3856">RtAudio</a> | |||
</li> | |||
</ul> | |||
<h3><a class="anchor" id="index_i">- i -</a></h3><ul> | |||
<h3><a class="anchor" id="index_i"></a>- i -</h3><ul> | |||
<li>inputChannels | |||
: <a class="el" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">RtAudio::DeviceInfo</a> | |||
</li> | |||
@@ -150,7 +124,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_l">- l -</a></h3><ul> | |||
<h3><a class="anchor" id="index_l"></a>- l -</h3><ul> | |||
<li>LINUX_ALSA | |||
: <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849aa7a2ba095c2806caa893b6fb8fc3a1a8">RtAudio</a> | |||
</li> | |||
@@ -163,7 +137,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_m">- m -</a></h3><ul> | |||
<h3><a class="anchor" id="index_m"></a>- m -</h3><ul> | |||
<li>MACOSX_CORE | |||
: <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a9fec92b8272244a87a6a11a717bd662d">RtAudio</a> | |||
</li> | |||
@@ -173,7 +147,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_n">- n -</a></h3><ul> | |||
<h3><a class="anchor" id="index_n"></a>- n -</h3><ul> | |||
<li>name | |||
: <a class="el" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">RtAudio::DeviceInfo</a> | |||
</li> | |||
@@ -192,9 +166,9 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_o">- o -</a></h3><ul> | |||
<h3><a class="anchor" id="index_o"></a>- o -</h3><ul> | |||
<li>openStream() | |||
: <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8">RtAudio</a> | |||
: <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b">RtAudio</a> | |||
</li> | |||
<li>outputChannels | |||
: <a class="el" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">RtAudio::DeviceInfo</a> | |||
@@ -202,7 +176,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_p">- p -</a></h3><ul> | |||
<h3><a class="anchor" id="index_p"></a>- p -</h3><ul> | |||
<li>printMessage() | |||
: <a class="el" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">RtError</a> | |||
</li> | |||
@@ -215,7 +189,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_r">- r -</a></h3><ul> | |||
<h3><a class="anchor" id="index_r"></a>- r -</h3><ul> | |||
<li>RtAudio() | |||
: <a class="el" href="classRtAudio.html#afd0bfa26deae9804e18faff59d0273d9">RtAudio</a> | |||
</li> | |||
@@ -228,7 +202,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_s">- s -</a></h3><ul> | |||
<h3><a class="anchor" id="index_s"></a>- s -</h3><ul> | |||
<li>sampleRates | |||
: <a class="el" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">RtAudio::DeviceInfo</a> | |||
</li> | |||
@@ -250,7 +224,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_t">- t -</a></h3><ul> | |||
<h3><a class="anchor" id="index_t"></a>- t -</h3><ul> | |||
<li>THREAD_ERROR | |||
: <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903acaeb6282f991e2d93ab294a4272fc3f6c6">RtError</a> | |||
</li> | |||
@@ -260,7 +234,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_u">- u -</a></h3><ul> | |||
<h3><a class="anchor" id="index_u"></a>- u -</h3><ul> | |||
<li>UNIX_JACK | |||
: <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a4767e17c6edfbd827f91763915df4105">RtAudio</a> | |||
</li> | |||
@@ -271,7 +245,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_w">- w -</a></h3><ul> | |||
<h3><a class="anchor" id="index_w"></a>- w -</h3><ul> | |||
<li>WARNING | |||
: <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca3a1603c24a56cbdaf5f8ae4ddcb86398">RtError</a> | |||
</li> | |||
@@ -287,7 +261,7 @@ Here is a list of all documented class members with links to the class documenta | |||
</ul> | |||
<h3><a class="anchor" id="index_0x7e">- ~ -</a></h3><ul> | |||
<h3><a class="anchor" id="index_0x7e"></a>- ~ -</h3><ul> | |||
<li>~RtAudio() | |||
: <a class="el" href="classRtAudio.html#aa8a9716fd64680657ef69c9465442a2f">RtAudio</a> | |||
</li> | |||
@@ -295,12 +269,10 @@ Here is a list of all documented class members with links to the class documenta | |||
: <a class="el" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">RtError</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,18 +8,10 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li><a href="functions.html"><span>All</span></a></li> | |||
<li><a href="functions_func.html"><span>Functions</span></a></li> | |||
<li><a href="functions_vars.html"><span>Variables</span></a></li> | |||
<li class="current"><a href="functions_enum.html"><span>Enumerations</span></a></li> | |||
<li><a href="functions_eval.html"><span>Enumerator</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
<ul> | |||
 <ul> | |||
<li>Api | |||
: <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849">RtAudio</a> | |||
</li> | |||
@@ -27,12 +19,10 @@ | |||
: <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903ac">RtError</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,18 +8,10 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li><a href="functions.html"><span>All</span></a></li> | |||
<li><a href="functions_func.html"><span>Functions</span></a></li> | |||
<li><a href="functions_vars.html"><span>Variables</span></a></li> | |||
<li><a href="functions_enum.html"><span>Enumerations</span></a></li> | |||
<li class="current"><a href="functions_eval.html"><span>Enumerator</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
<ul> | |||
 <ul> | |||
<li>DEBUG_WARNING | |||
: <a class="el" href="classRtError.html#ab04667aae01bffc354a9ac6bda6903aca20e5a369394d19b704ace17002007eba">RtError</a> | |||
</li> | |||
@@ -79,12 +71,10 @@ | |||
: <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">RtAudio</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,18 +8,10 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li><a href="functions.html"><span>All</span></a></li> | |||
<li class="current"><a href="functions_func.html"><span>Functions</span></a></li> | |||
<li><a href="functions_vars.html"><span>Variables</span></a></li> | |||
<li><a href="functions_enum.html"><span>Enumerations</span></a></li> | |||
<li><a href="functions_eval.html"><span>Enumerator</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
<ul> | |||
 <ul> | |||
<li>abortStream() | |||
: <a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f">RtAudio</a> | |||
</li> | |||
@@ -59,6 +51,9 @@ | |||
<li>getType() | |||
: <a class="el" href="classRtError.html#a3e316dc9b9b41fe2f64cabf34beb4fe7">RtError</a> | |||
</li> | |||
<li>getVersion() | |||
: <a class="el" href="classRtAudio.html#afee36f6d32f4744ffa7471a0ce7a3856">RtAudio</a> | |||
</li> | |||
<li>isStreamOpen() | |||
: <a class="el" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f">RtAudio</a> | |||
</li> | |||
@@ -66,7 +61,7 @@ | |||
: <a class="el" href="classRtAudio.html#a84cc8d9b7ab9bc5f37bcf48430ec5aea">RtAudio</a> | |||
</li> | |||
<li>openStream() | |||
: <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8">RtAudio</a> | |||
: <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b">RtAudio</a> | |||
</li> | |||
<li>printMessage() | |||
: <a class="el" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc">RtError</a> | |||
@@ -96,12 +91,10 @@ | |||
: <a class="el" href="classRtError.html#a6793e03386e7e69ffafb65a296dfa48c">RtError</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,18 +8,10 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li><a href="functions.html"><span>All</span></a></li> | |||
<li><a href="functions_func.html"><span>Functions</span></a></li> | |||
<li class="current"><a href="functions_vars.html"><span>Variables</span></a></li> | |||
<li><a href="functions_enum.html"><span>Enumerations</span></a></li> | |||
<li><a href="functions_eval.html"><span>Enumerator</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
<ul> | |||
 <ul> | |||
<li>deviceId | |||
: <a class="el" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">RtAudio::StreamParameters</a> | |||
</li> | |||
@@ -69,12 +61,10 @@ | |||
: <a class="el" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">RtAudio::StreamOptions</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,18 +8,16 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li class="current"><a href="globals.html"><span>All</span></a></li> | |||
<li><a href="globals_type.html"><span>Typedefs</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
Here is a list of all documented file members with links to the documentation:<ul> | |||
<div class="textblock">Here is a list of all documented file members with links to the documentation:</div><ul> | |||
<li>RtAudioCallback | |||
: <a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudio.h</a> | |||
</li> | |||
<li>RtAudioErrorCallback | |||
: <a class="el" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062">RtAudio.h</a> | |||
</li> | |||
<li>RtAudioFormat | |||
: <a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudio.h</a> | |||
</li> | |||
@@ -30,12 +28,10 @@ Here is a list of all documented file members with links to the documentation:<u | |||
: <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudio.h</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,18 +8,16 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="tabs"> | |||
<ul> | |||
<li><a href="globals.html"><span>All</span></a></li> | |||
<li class="current"><a href="globals_type.html"><span>Typedefs</span></a></li> | |||
</ul> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="contents"> | |||
<ul> | |||
 <ul> | |||
<li>RtAudioCallback | |||
: <a class="el" href="RtAudio_8h.html#a112c7b7e25a974977f6fc094cef1a31f">RtAudio.h</a> | |||
</li> | |||
<li>RtAudioErrorCallback | |||
: <a class="el" href="RtAudio_8h.html#a2c8c34d284ae138dd29b53375ec9f062">RtAudio.h</a> | |||
</li> | |||
<li>RtAudioFormat | |||
: <a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudio.h</a> | |||
</li> | |||
@@ -30,12 +28,10 @@ | |||
: <a class="el" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806">RtAudio.h</a> | |||
</li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,9 +8,14 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">The <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> Home Page </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<h1>The <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> Home Page </h1><h3 class="version">4.0.11 </h3><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> 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 operating systems. <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> significantly simplifies the process of interacting with computer audio hardware. It was designed with the following objectives:</p> | |||
<div class="textblock"><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> 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 operating systems. <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> significantly simplifies the process of interacting with computer audio hardware. It was designed with the following objectives:</p> | |||
<ul> | |||
<li> | |||
object-oriented C++ design </li> | |||
@@ -30,26 +35,24 @@ allow audio device capability probing </li> | |||
automatic internal conversion for data format, channel number compensation, (de)interleaving, and byte-swapping </li> | |||
</ul> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> 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 <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> instance. See the <a class="el" href="apinotes.html">API Notes</a> section for information specific to each of the supported audio APIs.</p> | |||
<h2><a class="anchor" id="whatsnew"> | |||
What's New (Version 4.0)</a></h2> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> 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:</p> | |||
<h1><a class="anchor" id="whatsnew"></a> | |||
Latest Updates (Version 4.0.12)</h1> | |||
<ul> | |||
<li>new support for non-interleaved user data</li> | |||
<li>additional input/output parameter specifications, including channel offset</li> | |||
<li>new support for dynamic connection of devices</li> | |||
<li>new support for stream time</li> | |||
<li>revised callback arguments, including separate input and output buffer arguments</li> | |||
<li>revised C++ exception handling</li> | |||
<li>updated support for OSS version 4.0</li> | |||
<li>discontinued support of blocking functionality</li> | |||
<li>discontinued support of SGI</li> | |||
<li>new functionality to allow error reporting via a client-supplied function (thanks to Pavel Mogilevskiy)</li> | |||
<li>new function to return the version number</li> | |||
<li>updated RtAudio.cpp and ASIO files for UNICODE support (thanks to Renaud Schoonbroodt)</li> | |||
<li>updates to PulseAudio API support (thanks to Peter Meerwald and Tristan Matthews)</li> | |||
<li>updates for pkg-config support in configure script</li> | |||
<li>24-bit format changed to true 24-bit format, not sub-bytes of 32-bits (thanks to Marc Britton)</li> | |||
<li>bug fixes to make sure stream status is closed if error during probeDeviceOpen</li> | |||
<li>updates / fixes to SCHED_RR code in ALSA (thanks to Marc Lindahl)</li> | |||
<li>various changes to avoid global variables (thanks to Martin Koegler)</li> | |||
</ul> | |||
<p>Devices are now re-enumerated every time the <a class="el" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">RtAudio::getDeviceCount()</a>, <a class="el" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">RtAudio::getDeviceInfo()</a>, and <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> functions are called. This allows for the proper identification of hot-pluggable (USB, Firewire, ...) devices that are connected after an <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> instance is created.</p> | |||
<h2><a class="anchor" id="download"> | |||
Download</a></h2> | |||
<p>Latest Release (14 June 2012): <a href="http://www.music.mcgill.ca/~gary/rtaudio/release/rtaudio-4.0.11.tar.gz">Version 4.0.11</a></p> | |||
<h2><a class="anchor" id="documentation"> | |||
Documentation Links</a></h2> | |||
<h1><a class="anchor" id="download"></a> | |||
Download</h1> | |||
<p>Latest Release (16 April 2013): <a href="http://www.music.mcgill.ca/~gary/rtaudio/release/rtaudio-4.0.12.tar.gz">Version 4.0.12</a></p> | |||
<h1><a class="anchor" id="documentation"></a> | |||
Documentation Links</h1> | |||
<ol type="1"> | |||
<li><a class="el" href="errors.html">Error Handling</a></li> | |||
<li><a class="el" href="probe.html">Probing Device Capabilities</a></li> | |||
@@ -66,12 +69,10 @@ Documentation Links</a></h2> | |||
<li><a href="updates.html">Possible Updates</a></li> | |||
<li><a href="http://sourceforge.net/projects/rtaudio">RtAudio at SourceForge</a> </li> | |||
</ol> | |||
</div> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,22 +8,23 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">License </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<h1><a class="anchor" id="license">License </a></h1><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>: a set of realtime audio i/o C++ classes<br/> | |||
<div class="textblock"><p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>: a set of realtime audio i/o C++ classes<br/> | |||
Copyright (c) 2001-2012 Gary P. Scavone</p> | |||
<p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p> | |||
<p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p> | |||
<p>Any person wishing to distribute modifications to the Software is asked to send the modifications to the original developer so that they can be incorporated into the canonical version. This is, however, not a binding provision of this license.</p> | |||
<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. </p> | |||
</div> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,26 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Using Simultaneous Multiple APIs </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p>Because support for each audio API is encapsulated in a specific RtApi subclass, it is possible to compile and instantiate multiple API-specific subclasses on a given operating system. For example, one can compile both the RtApiDs and RtApiAsio classes on Windows operating systems by providing the appropriate preprocessor definitions, include files, and libraries for each. In a run-time situation, one might first attempt to determine whether any ASIO device drivers exist. This can be done by specifying the api argument <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a219517d1df90f94d07758481155bd469">RtAudio::WINDOWS_ASIO</a> when attempting to create an instance of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>. If no available devices are found, then an instance of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> with the api argument <a class="el" href="classRtAudio.html#ac9b6f625da88249d08a8409a9db0d849a28478830f42c2fd61e6c7ad498901931">RtAudio::WINDOWS_DS</a> can be created. Alternately, if no api argument is specified, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will first look for an ASIO instance and then a DirectSound instance (on Linux systems, the default API search order is Jack, Alsa, and finally OSS). In theory, it should also be possible to have separate instances of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> open at the same time with different underlying audio API support, though this has not been tested. It is difficult to know how well different audio APIs can simultaneously coexist on a given operating system. In particular, it is unlikely that the same device could be simultaneously controlled with two different audio APIs.</p> | |||
<p>The static function <a class="el" href="classRtAudio.html#ae266ffad2ef428d0b2c6c262d391ce26" title="A static function to determine the available compiled audio APIs.">RtAudio::getCompiledApi()</a> is provided to determine the available compiled API support. The function <a class="el" href="classRtAudio.html#a83687634795792b2c47e4ae1cf8a5246" title="Returns the audio API specifier for the current instance of RtAudio.">RtAudio::getCurrentApi()</a> indicates the API selected for a given <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> instance. </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,39 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Related Pages</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock">Here is a list of all related documentation pages:</div><div class="directory"> | |||
<table class="directory"> | |||
<tr id="row_0_" class="even"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="acknowledge.html" target="_self">Acknowledgements</a></td><td class="desc"></td></tr> | |||
<tr id="row_1_"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="apinotes.html" target="_self">API Notes</a></td><td class="desc"></td></tr> | |||
<tr id="row_2_" class="even"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="compiling.html" target="_self">Debugging & Compiling</a></td><td class="desc"></td></tr> | |||
<tr id="row_3_"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="duplex.html" target="_self">Duplex Mode</a></td><td class="desc"></td></tr> | |||
<tr id="row_4_" class="even"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="errors.html" target="_self">Error Handling</a></td><td class="desc"></td></tr> | |||
<tr id="row_5_"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="license.html" target="_self">License</a></td><td class="desc"></td></tr> | |||
<tr id="row_6_" class="even"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="multi.html" target="_self">Using Simultaneous Multiple APIs</a></td><td class="desc"></td></tr> | |||
<tr id="row_7_"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="playback.html" target="_self">Playback</a></td><td class="desc"></td></tr> | |||
<tr id="row_8_" class="even"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="probe.html" target="_self">Probing Device Capabilities</a></td><td class="desc"></td></tr> | |||
<tr id="row_9_"><td class="entry"><img src="ftv2node.png" alt="o" width="16" height="22" /><a class="el" href="recording.html" target="_self">Recording</a></td><td class="desc"></td></tr> | |||
<tr id="row_10_" class="even"><td class="entry"><img src="ftv2lastnode.png" alt="\" width="16" height="22" /><a class="el" href="settings.html" target="_self">Device Settings</a></td><td class="desc"></td></tr> | |||
</table> | |||
</div><!-- directory --> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,97 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Playback </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p>In this example, we provide a complete program that demonstrates the use of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for audio playback. Our program produces a two-channel sawtooth waveform for output.</p> | |||
<div class="fragment"><div class="line"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span></div> | |||
<div class="line"><span class="preprocessor">#include <iostream></span></div> | |||
<div class="line"><span class="preprocessor">#include <cstdlib></span></div> | |||
<div class="line"></div> | |||
<div class="line"><span class="comment">// Two-channel sawtooth wave generator.</span></div> | |||
<div class="line"><span class="keywordtype">int</span> saw( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBufferFrames,</div> | |||
<div class="line"> <span class="keywordtype">double</span> streamTime, <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, <span class="keywordtype">void</span> *userData )</div> | |||
<div class="line">{</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i, j;</div> | |||
<div class="line"> <span class="keywordtype">double</span> *buffer = (<span class="keywordtype">double</span> *) outputBuffer;</div> | |||
<div class="line"> <span class="keywordtype">double</span> *lastValues = (<span class="keywordtype">double</span> *) userData;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">if</span> ( status )</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"Stream underflow detected!"</span> << std::endl;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="comment">// Write interleaved audio data.</span></div> | |||
<div class="line"> <span class="keywordflow">for</span> ( i=0; i<nBufferFrames; i++ ) {</div> | |||
<div class="line"> <span class="keywordflow">for</span> ( j=0; j<2; j++ ) {</div> | |||
<div class="line"> *buffer++ = lastValues[j];</div> | |||
<div class="line"></div> | |||
<div class="line"> lastValues[j] += 0.005 * (j+1+(j*0.1));</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( lastValues[j] >= 1.0 ) lastValues[j] -= 2.0;</div> | |||
<div class="line"> }</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
<div class="line"></div> | |||
<div class="line"><span class="keywordtype">int</span> main()</div> | |||
<div class="line">{</div> | |||
<div class="line"> <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> dac;</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( dac.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() < 1 ) {</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"\nNo audio devices found!\n"</span>;</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> parameters;</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = dac.<a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>();</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2;</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a> = 0;</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate = 44100;</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferFrames = 256; <span class="comment">// 256 sample frames</span></div> | |||
<div class="line"> <span class="keywordtype">double</span> data[2];</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> dac.<a class="code" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream</a>( &parameters, NULL, RTAUDIO_FLOAT64,</div> | |||
<div class="line"> sampleRate, &bufferFrames, &saw, (<span class="keywordtype">void</span> *)&data );</div> | |||
<div class="line"> dac.<a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e ) {</div> | |||
<div class="line"> e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>();</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"> </div> | |||
<div class="line"> <span class="keywordtype">char</span> input;</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"\nPlaying ... press <enter> to quit.\n"</span>;</div> | |||
<div class="line"> std::cin.get( input );</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> <span class="comment">// Stop the stream</span></div> | |||
<div class="line"> dac.<a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> (<a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e) {</div> | |||
<div class="line"> e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">if</span> ( dac.<a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>() ) dac.<a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>();</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
</div><!-- fragment --><p>We open the stream in exactly the same way as the previous example (except with a data format change) and specify the address of our callback function <em>"saw()"</em>. The callback function will automatically be invoked when the underlying audio system needs data for output. Note that the callback function is called only when the stream is "running" (between calls to the <a class="el" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">RtAudio::startStream()</a> and <a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio::stopStream()</a> functions). We can also pass a pointer value to the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function that is made available in the callback function. In this way, it is possible to gain access to arbitrary data created in our <em>main()</em> function from within the globally defined callback function.</p> | |||
<p>In this example, we stop the stream with an explicit call to <a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio::stopStream()</a>. It is also possible to stop a stream by returning a non-zero value from the callback function. A return value of 1 will cause the stream to finish draining its internal buffers and then halt (equivalent to calling the <a class="el" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">RtAudio::stopStream()</a> function). A return value of 2 will cause the stream to stop immediately (equivalent to calling the <a class="el" href="classRtAudio.html#ad0586b47cd6bb9591a80b4052815991f" title="Stop a stream, discarding any samples remaining in the input/output queue.">RtAudio::abortStream()</a> function). </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,75 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Probing Device Capabilities </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p>A programmer may wish to query the available audio device capabilities before deciding which to use. The following example outlines how this can be done.</p> | |||
<div class="fragment"><div class="line"><span class="comment">// audioprobe.cpp</span></div> | |||
<div class="line"></div> | |||
<div class="line"><span class="preprocessor">#include <iostream></span></div> | |||
<div class="line"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span></div> | |||
<div class="line"></div> | |||
<div class="line"><span class="keywordtype">int</span> main()</div> | |||
<div class="line">{</div> | |||
<div class="line"> <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> audio;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="comment">// Determine the number of devices available</span></div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> devices = audio.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>();</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="comment">// Scan through devices for various capabilities</span></div> | |||
<div class="line"> <a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> info;</div> | |||
<div class="line"> <span class="keywordflow">for</span> ( <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i=0; i<=devices; i++ ) {</div> | |||
<div class="line"></div> | |||
<div class="line"> info = audio.<a class="code" href="classRtAudio.html#a02d7ff44ad1d7eae22283a052f3dfda8" title="Return an RtAudio::DeviceInfo structure for a specified device number.">getDeviceInfo</a>( i );</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">if</span> ( info.<a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a> == <span class="keyword">true</span> ) {</div> | |||
<div class="line"> <span class="comment">// Print, for example, the maximum number of output channels for each device</span></div> | |||
<div class="line"> std::cout << <span class="stringliteral">"device = "</span> << i;</div> | |||
<div class="line"> std::cout << <span class="stringliteral">": maximum output channels = "</span> << info.<a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a> << <span class="stringliteral">"\n"</span>;</div> | |||
<div class="line"> }</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
</div><!-- fragment --><p>The <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure is defined in <a class="el" href="RtAudio_8h.html">RtAudio.h</a> and provides a variety of information useful in assessing the capabilities of a device:</p> | |||
<div class="fragment"><div class="line"><span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> {</div> | |||
<div class="line"> <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a>; <span class="comment">// true if the device capabilities were successfully probed.</span></div> | |||
<div class="line"> std::string <a class="code" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a>; <span class="comment">// Character string device identifier.</span></div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a>; <span class="comment">// Maximum output channels supported by device.</span></div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a>; <span class="comment">// Maximum input channels supported by device.</span></div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a>; <span class="comment">// Maximum simultaneous input/output channels supported by device.</span></div> | |||
<div class="line"> <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a>; <span class="comment">// true if this is the default output device.</span></div> | |||
<div class="line"> <span class="keywordtype">bool</span> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a>; <span class="comment">// true if this is the default input device.</span></div> | |||
<div class="line"> std::vector<unsigned int> <a class="code" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a>; <span class="comment">// Supported sample rates.</span></div> | |||
<div class="line"> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a> <a class="code" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a>; <span class="comment">// Bit mask of supported data formats.</span></div> | |||
<div class="line">};</div> | |||
</div><!-- fragment --><p>The following data formats are defined and fully supported by <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a>:</p> | |||
<div class="fragment"><div class="line"><span class="keyword">typedef</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8" title="RtAudio data format type.">RtAudioFormat</a>;</div> | |||
<div class="line"><span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT8; <span class="comment">// Signed 8-bit integer</span></div> | |||
<div class="line"><span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT16; <span class="comment">// Signed 16-bit integer</span></div> | |||
<div class="line"><span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT24; <span class="comment">// Signed 24-bit integer (lower 3 bytes of 32-bit signed integer.)</span></div> | |||
<div class="line"><span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_SINT32; <span class="comment">// Signed 32-bit integer</span></div> | |||
<div class="line"><span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_FLOAT32; <span class="comment">// 32-bit float normalized between +/- 1.0</span></div> | |||
<div class="line"><span class="keyword">static</span> <span class="keyword">const</span> RtAudioFormat RTAUDIO_FLOAT64; <span class="comment">// 64-bit double normalized between +/- 1.0</span></div> | |||
</div><!-- fragment --><p>The <code>nativeFormats</code> member of the <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure is a bit mask of the above formats which are natively supported by the device. However, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will automatically provide format conversion if a particular format is not natively supported. When the <code>probed</code> member of the <a class="el" href="structRtAudio_1_1DeviceInfo.html" title="The public device information structure for returning queried values.">RtAudio::DeviceInfo</a> structure is false, the remaining structure members are undefined and the device is probably unusable.</p> | |||
<p>Some audio devices may require a minimum channel value greater than one. <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will provide automatic channel number compensation when the number of channels set by the user is less than that required by the device. Channel compensation is <em>NOT</em> possible when the number of channels set by the user is greater than that supported by the device.</p> | |||
<p>It should be noted that the capabilities reported by a device driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. For this reason, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> does not rely on the queried values when attempting to open a stream. </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,83 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Recording </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p>Using <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> for audio input is almost identical to the way it is used for playback. Here's the blocking playback example rewritten for recording:</p> | |||
<div class="fragment"><div class="line"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span></div> | |||
<div class="line"><span class="preprocessor">#include <iostream></span></div> | |||
<div class="line"><span class="preprocessor">#include <cstdlib></span></div> | |||
<div class="line"><span class="preprocessor">#include <cstring></span></div> | |||
<div class="line"></div> | |||
<div class="line"><span class="keywordtype">int</span> record( <span class="keywordtype">void</span> *outputBuffer, <span class="keywordtype">void</span> *inputBuffer, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> nBufferFrames,</div> | |||
<div class="line"> <span class="keywordtype">double</span> streamTime, <a class="code" href="RtAudio_8h.html#a80e306d363583da3b0a1b65d9b57c806" title="RtAudio stream status (over- or underflow) flags.">RtAudioStreamStatus</a> status, <span class="keywordtype">void</span> *userData )</div> | |||
<div class="line">{</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( status )</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"Stream overflow detected!"</span> << std::endl;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="comment">// Do something with the data in the "inputBuffer" buffer.</span></div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
<div class="line"></div> | |||
<div class="line"><span class="keywordtype">int</span> main()</div> | |||
<div class="line">{</div> | |||
<div class="line"> <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> adc;</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( adc.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() < 1 ) {</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"\nNo audio devices found!\n"</span>;</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> parameters;</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = adc.<a class="code" href="classRtAudio.html#aad8b94edd3cd379ee300b125750ac6ce" title="A function that returns the index of the default input device.">getDefaultInputDevice</a>();</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2;</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ad4b4503782653ec93c83328c46abe50c">firstChannel</a> = 0;</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate = 44100;</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferFrames = 256; <span class="comment">// 256 sample frames</span></div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> adc.<a class="code" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream</a>( NULL, &parameters, RTAUDIO_SINT16,</div> | |||
<div class="line"> sampleRate, &bufferFrames, &record );</div> | |||
<div class="line"> adc.<a class="code" href="classRtAudio.html#aec017a89629ccef66a90b60be22a2f80" title="A function that starts a stream.">startStream</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e ) {</div> | |||
<div class="line"> e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>();</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"> </div> | |||
<div class="line"> <span class="keywordtype">char</span> input;</div> | |||
<div class="line"> std::cout << <span class="stringliteral">"\nRecording ... press <enter> to quit.\n"</span>;</div> | |||
<div class="line"> std::cin.get( input );</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> <span class="comment">// Stop the stream</span></div> | |||
<div class="line"> adc.<a class="code" href="classRtAudio.html#af4c241ff86936ecc8108f0d9dfe3efdd" title="Stop a stream, allowing any samples remaining in the output queue to be played.">stopStream</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> (<a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e) {</div> | |||
<div class="line"> e.<a class="code" href="classRtError.html#a251dcdac396c998c91706dd2dd3b8bfc" title="Prints thrown error message to stderr.">printMessage</a>();</div> | |||
<div class="line"> }</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">if</span> ( adc.<a class="code" href="classRtAudio.html#a3863e45ff81dbe97176de0ee7545917f" title="Returns true if a stream is open and false if not.">isStreamOpen</a>() ) adc.<a class="code" href="classRtAudio.html#a90d599002ad32cf250a4cb866f2cc93a" title="A function that closes a stream and frees any associated stream memory.">closeStream</a>();</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
</div><!-- fragment --><p>In this example, we pass the address of the stream parameter structure as the second argument of the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function and pass a NULL value for the output stream parameters. In this example, the <em>record()</em> callback function performs no specific operations. </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,58 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">Device Settings </div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<div class="textblock"><p>The next step in using <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> is to open a stream with particular device and parameter settings.</p> | |||
<div class="fragment"><div class="line"><span class="preprocessor">#include "<a class="code" href="RtAudio_8h.html">RtAudio.h</a>"</span></div> | |||
<div class="line"></div> | |||
<div class="line"><span class="keywordtype">int</span> main()</div> | |||
<div class="line">{</div> | |||
<div class="line"> <a class="code" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> dac;</div> | |||
<div class="line"> <span class="keywordflow">if</span> ( dac.<a class="code" href="classRtAudio.html#a747ce2d73803641bbb66d6e78092aa1a" title="A public function that queries for the number of audio devices available.">getDeviceCount</a>() == 0 ) exit( 0 );</div> | |||
<div class="line"></div> | |||
<div class="line"> <a class="code" href="structRtAudio_1_1StreamParameters.html" title="The structure for specifying input or ouput stream parameters.">RtAudio::StreamParameters</a> parameters;</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#ab3c72bcf3ef12149ae9a4fb597cc5489">deviceId</a> = dac.<a class="code" href="classRtAudio.html#a3a3f3dbe13ea696b521e49cdaaa357bc" title="A function that returns the index of the default output device.">getDefaultOutputDevice</a>();</div> | |||
<div class="line"> parameters.<a class="code" href="structRtAudio_1_1StreamParameters.html#a88a10091b6e284e21235cc6f25332ebd">nChannels</a> = 2;</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate = 44100;</div> | |||
<div class="line"> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> bufferFrames = 256; <span class="comment">// 256 sample frames</span></div> | |||
<div class="line"></div> | |||
<div class="line"> <a class="code" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> options;</div> | |||
<div class="line"> options.<a class="code" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a> = RTAUDIO_NONINTERLEAVED;</div> | |||
<div class="line"></div> | |||
<div class="line"> <span class="keywordflow">try</span> {</div> | |||
<div class="line"> dac.<a class="code" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream</a>( &parameters, NULL, RTAUDIO_FLOAT32,</div> | |||
<div class="line"> sampleRate, &bufferFrames, &myCallback, NULL, &options );</div> | |||
<div class="line"> }</div> | |||
<div class="line"> <span class="keywordflow">catch</span> ( <a class="code" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a>& e ) {</div> | |||
<div class="line"> std::cout << <span class="charliteral">'\n'</span> << e.<a class="code" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50" title="Returns the thrown error message string.">getMessage</a>() << <span class="charliteral">'\n'</span> << std::endl;</div> | |||
<div class="line"> exit( 0 );</div> | |||
<div class="line"> }</div> | |||
<div class="line"> </div> | |||
<div class="line"> <span class="keywordflow">return</span> 0;</div> | |||
<div class="line">}</div> | |||
</div><!-- fragment --><p>The <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function attempts to open a stream with a specified set of parameter values. In the above example, we attempt to open a two channel playback stream using the default output device, 32-bit floating point data, a sample rate of 44100 Hz, and a frame rate of 256 sample frames per output buffer. If the user specifies an invalid parameter value (such as a device id greater than or equal to the number of enumerated devices), an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> is thrown of type = INVALID_USE. If a system error occurs or the device does not support the specified parameter values, an <a class="el" href="classRtError.html" title="Exception handling class for RtAudio & RtMidi.">RtError</a> of type = SYSTEM_ERROR is thrown. In either case, a descriptive error message is bundled with the exception and can be queried with the <a class="el" href="classRtError.html#afd067ba6b46edd37f989cad02cd70b50" title="Returns the thrown error message string.">RtError::getMessage()</a> or <a class="el" href="classRtError.html#aeb843b7a7785d66061c61ebfc29e7e9d" title="Returns the thrown error message as a c-style string.">RtError::what()</a> functions.</p> | |||
<p><a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> provides four signed integer and two floating point data formats which can be specified using the RtAudioFormat parameter values mentioned earlier. If the opened device does not natively support the given format, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will automatically perform the necessary data format conversion.</p> | |||
<p>The <code>bufferFrames</code> parameter specifies the desired number of sample frames that will be written to and/or read from a device per write/read operation. This parameter can be used to control stream latency though there is no guarantee that the passed value will be that used by a device. In general, a lower <code>bufferFrames</code> value will produce less latency but perhaps less robust performance. A value of zero can be specified, in which case the smallest allowable value will be used. The <code>bufferFrames</code> parameter is passed as a pointer and the actual value used by the stream is set during the device setup procedure. <code>bufferFrames</code> values should be a power of two. Optimal and allowable buffer values tend to vary between systems and devices. Stream latency can also be controlled via the optional <a class="el" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> member <code>numberOfBuffers</code> (not used in the example above), though this tends to be more system dependent. In particular, the <code>numberOfBuffers</code> parameter is ignored when using the OS-X Core Audio, Jack, and the Windows ASIO APIs.</p> | |||
<p>As noted earlier, the device capabilities reported by a driver or underlying audio API are not always accurate and/or may be dependent on a combination of device settings. Because of this, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> does not attempt to query a device's capabilities or use previously reported values when opening a device. Instead, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> simply attempts to set the given parameters on a specified device and then checks whether the setup is successful or not.</p> | |||
<p>The RtAudioCallback parameter above is a pointer to a user-defined function that will be called whenever the audio system is ready for new output data or has new input data to be read. Further details on the use of a callback function are provided in the next section.</p> | |||
<p>Several stream options are available to fine-tune the behavior of an audio stream. In the example above, we specify that data will be written by the user in a <em>non-interleaved</em> format via the <a class="el" href="structRtAudio_1_1StreamOptions.html" title="The structure for specifying stream options.">RtAudio::StreamOptions</a> member <code>flags</code>. That is, all <code>bufferFrames</code> of the first channel should be written consecutively, followed by all <code>bufferFrames</code> of the second channel. By default (when no option is specified), <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> expects data to be written in an <em>interleaved</em> format. </p> | |||
</div></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,40 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
<div id="nav-path" class="navpath"> | |||
<ul> | |||
<li class="navelem"><a class="el" href="classRtAudio.html">RtAudio</a></li><li class="navelem"><a class="el" href="structRtAudio_1_1DeviceInfo.html">DeviceInfo</a></li> </ul> | |||
</div> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio::DeviceInfo Member List</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>This is the complete list of members for <a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a>, including all inherited members.</p> | |||
<table class="directory"> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a></td><td class="entry"><a class="el" href="structRtAudio_1_1DeviceInfo.html">RtAudio::DeviceInfo</a></td><td class="entry"></td></tr> | |||
</table></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,181 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
<div id="nav-path" class="navpath"> | |||
<ul> | |||
<li class="navelem"><a class="el" href="classRtAudio.html">RtAudio</a></li><li class="navelem"><a class="el" href="structRtAudio_1_1DeviceInfo.html">DeviceInfo</a></li> </ul> | |||
</div> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="summary"> | |||
<a href="#pub-attribs">Public Attributes</a> | | |||
<a href="structRtAudio_1_1DeviceInfo-members.html">List of all members</a> </div> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio::DeviceInfo Struct Reference</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>The public device information structure for returning queried values. | |||
<a href="structRtAudio_1_1DeviceInfo.html#details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtAudio_8h_source.html">RtAudio.h</a>></code></p> | |||
<table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a> | |||
Public Attributes</h2></td></tr> | |||
<tr class="memitem:a97573717ccb1e75a834a0a108cd6982d"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a97573717ccb1e75a834a0a108cd6982d">probed</a></td></tr> | |||
<tr class="separator:a97573717ccb1e75a834a0a108cd6982d"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a24df596ab8d54f2eb540c7cf16212b3b"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a24df596ab8d54f2eb540c7cf16212b3b">name</a></td></tr> | |||
<tr class="separator:a24df596ab8d54f2eb540c7cf16212b3b"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a81aaf488f8158ef55b1bb678f66feb7d"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a81aaf488f8158ef55b1bb678f66feb7d">outputChannels</a></td></tr> | |||
<tr class="separator:a81aaf488f8158ef55b1bb678f66feb7d"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a56247b458a937ae84d98ca9c4b243275"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a56247b458a937ae84d98ca9c4b243275">inputChannels</a></td></tr> | |||
<tr class="separator:a56247b458a937ae84d98ca9c4b243275"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a3e8ad34c2d14e24293a0beafc26186e7"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a3e8ad34c2d14e24293a0beafc26186e7">duplexChannels</a></td></tr> | |||
<tr class="separator:a3e8ad34c2d14e24293a0beafc26186e7"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a5365245e73ffe29a05734de4474acd58"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a5365245e73ffe29a05734de4474acd58">isDefaultOutput</a></td></tr> | |||
<tr class="separator:a5365245e73ffe29a05734de4474acd58"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a7c8aca084bd908799b6be5954b80def2"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a7c8aca084bd908799b6be5954b80def2">isDefaultInput</a></td></tr> | |||
<tr class="separator:a7c8aca084bd908799b6be5954b80def2"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:afa65f5f92f66ce7aacd3ff35e11b230f"><td class="memItemLeft" align="right" valign="top">std::vector< unsigned int > </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#afa65f5f92f66ce7aacd3ff35e11b230f">sampleRates</a></td></tr> | |||
<tr class="separator:afa65f5f92f66ce7aacd3ff35e11b230f"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a23251b549b89b2fe04a57fcd7cb76ea4"><td class="memItemLeft" align="right" valign="top"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1DeviceInfo.html#a23251b549b89b2fe04a57fcd7cb76ea4">nativeFormats</a></td></tr> | |||
<tr class="separator:a23251b549b89b2fe04a57fcd7cb76ea4"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table> | |||
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> | |||
<div class="textblock"><p>The public device information structure for returning queried values. </p> | |||
</div><h2 class="groupheader">Member Data Documentation</h2> | |||
<a class="anchor" id="a97573717ccb1e75a834a0a108cd6982d"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">bool RtAudio::DeviceInfo::probed</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>true if the device capabilities were successfully probed. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a24df596ab8d54f2eb540c7cf16212b3b"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">std::string RtAudio::DeviceInfo::name</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Character string device identifier. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a81aaf488f8158ef55b1bb678f66feb7d"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::DeviceInfo::outputChannels</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Maximum output channels supported by device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a56247b458a937ae84d98ca9c4b243275"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::DeviceInfo::inputChannels</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Maximum input channels supported by device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a3e8ad34c2d14e24293a0beafc26186e7"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int RtAudio::DeviceInfo::duplexChannels</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Maximum simultaneous input/output channels supported by device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a5365245e73ffe29a05734de4474acd58"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">bool RtAudio::DeviceInfo::isDefaultOutput</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>true if this is the default output device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a7c8aca084bd908799b6be5954b80def2"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">bool RtAudio::DeviceInfo::isDefaultInput</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>true if this is the default input device. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="afa65f5f92f66ce7aacd3ff35e11b230f"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">std::vector<unsigned int> RtAudio::DeviceInfo::sampleRates</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Supported sample rates (queried from list of standard rates). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a23251b549b89b2fe04a57fcd7cb76ea4"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname"><a class="el" href="RtAudio_8h.html#aafca92882d25915560018873221e44b8">RtAudioFormat</a> RtAudio::DeviceInfo::nativeFormats</td> | |||
</tr> | |||
</table> | |||
</div><div class="memdoc"> | |||
<p>Bit mask of supported data formats. </p> | |||
</div> | |||
</div> | |||
<hr/>The documentation for this struct was generated from the following file:<ul> | |||
<li><a class="el" href="RtAudio_8h_source.html">RtAudio.h</a></li> | |||
</ul> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -0,0 +1,35 @@ | |||
<HTML> | |||
<HEAD> | |||
<TITLE>The RtAudio Home Page</TITLE> | |||
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css"> | |||
<LINK REL="SHORTCUT ICON" HREF="http://www.music.mcgill.ca/~gary/favicon.ico"> | |||
</HEAD> | |||
<BODY BGCOLOR="#FFFFFF"> | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
<div id="nav-path" class="navpath"> | |||
<ul> | |||
<li class="navelem"><a class="el" href="classRtAudio.html">RtAudio</a></li><li class="navelem"><a class="el" href="structRtAudio_1_1StreamOptions.html">StreamOptions</a></li> </ul> | |||
</div> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio::StreamOptions Member List</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<p>This is the complete list of members for <a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a>, including all inherited members.</p> | |||
<table class="directory"> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a></td><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a></td><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td class="entry"></td></tr> | |||
<tr class="even"><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a></td><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td class="entry"></td></tr> | |||
<tr><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">streamName</a></td><td class="entry"><a class="el" href="structRtAudio_1_1StreamOptions.html">RtAudio::StreamOptions</a></td><td class="entry"></td></tr> | |||
</table></div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |
@@ -8,26 +8,39 @@ | |||
<CENTER> | |||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="annotated.html">Class/Enum List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> </CENTER> | |||
<HR> | |||
<!-- Generated by Doxygen 1.6.2 --> | |||
<div class="navpath"><a class="el" href="classRtAudio.html">RtAudio</a>::<a class="el" href="structRtAudio_1_1StreamOptions.html">StreamOptions</a> | |||
</div> | |||
<!-- Generated by Doxygen 1.8.2 --> | |||
<div id="nav-path" class="navpath"> | |||
<ul> | |||
<li class="navelem"><a class="el" href="classRtAudio.html">RtAudio</a></li><li class="navelem"><a class="el" href="structRtAudio_1_1StreamOptions.html">StreamOptions</a></li> </ul> | |||
</div> | |||
</div><!-- top --> | |||
<div class="header"> | |||
<div class="summary"> | |||
<a href="#pub-attribs">Public Attributes</a> | | |||
<a href="structRtAudio_1_1StreamOptions-members.html">List of all members</a> </div> | |||
<div class="headertitle"> | |||
<div class="title">RtAudio::StreamOptions Struct Reference</div> </div> | |||
</div><!--header--> | |||
<div class="contents"> | |||
<h1>RtAudio::StreamOptions Struct Reference</h1><!-- doxytag: class="RtAudio::StreamOptions" --> | |||
<p>The structure for specifying stream options. | |||
<a href="#_details">More...</a></p> | |||
<a href="structRtAudio_1_1StreamOptions.html#details">More...</a></p> | |||
<p><code>#include <<a class="el" href="RtAudio_8h_source.html">RtAudio.h</a>></code></p> | |||
<p><a href="structRtAudio_1_1StreamOptions-members.html">List of all members.</a></p> | |||
<table border="0" cellpadding="0" cellspacing="0"> | |||
<tr><td colspan="2"><h2>Public Attributes</h2></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">streamName</a></td></tr> | |||
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a></td></tr> | |||
<table class="memberdecls"> | |||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a> | |||
Public Attributes</h2></td></tr> | |||
<tr class="memitem:a0ecc98b031aa3af49d09b781643e298b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">flags</a></td></tr> | |||
<tr class="separator:a0ecc98b031aa3af49d09b781643e298b"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a75a14cfab903d0e1c091bc16aec80240"><td class="memItemLeft" align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">numberOfBuffers</a></td></tr> | |||
<tr class="separator:a75a14cfab903d0e1c091bc16aec80240"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:a2a4b0b8d690c624d20f4e8f4be6ca9ba"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">streamName</a></td></tr> | |||
<tr class="separator:a2a4b0b8d690c624d20f4e8f4be6ca9ba"><td class="memSeparator" colspan="2"> </td></tr> | |||
<tr class="memitem:adfd267059434edb21573c584e6367def"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">priority</a></td></tr> | |||
<tr class="separator:adfd267059434edb21573c584e6367def"><td class="memSeparator" colspan="2"> </td></tr> | |||
</table> | |||
<hr/><a name="_details"></a><h2>Detailed Description</h2> | |||
<p>The structure for specifying stream options. </p> | |||
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> | |||
<div class="textblock"><p>The structure for specifying stream options. </p> | |||
<p>The following flags can be OR'ed together to allow a client to make changes to the default stream behavior:</p> | |||
<ul> | |||
<li><em>RTAUDIO_NONINTERLEAVED:</em> Use non-interleaved buffers (default = interleaved).</li> | |||
@@ -36,66 +49,62 @@ | |||
<li><em>RTAUDIO_SCHEDULE_REALTIME:</em> Attempt to select realtime scheduling for callback thread.</li> | |||
<li><em>RTAUDIO_ALSA_USE_DEFAULT:</em> Use the "default" PCM device (ALSA only).</li> | |||
</ul> | |||
<p>By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> streams pass and receive audio data from the client in an interleaved format. By passing the RTAUDIO_NONINTERLEAVED flag to the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream()</a> function, audio data will instead be presented in non-interleaved buffers. In this case, each buffer argument in the RtAudioCallback function will point to a single array of data, with <code>nFrames</code> samples for each channel concatenated back-to-back. For example, the first sample of data for the second channel would be located at index <code>nFrames</code> (assuming the <code>buffer</code> pointer was recast to the correct data type for the stream).</p> | |||
<p>Certain audio APIs offer a number of parameters that influence the I/O latency of a stream. By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to set these parameters internally for robust (glitch-free) performance (though some APIs, like Windows Direct Sound, make this difficult). By passing the RTAUDIO_MINIMIZE_LATENCY flag to the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">openStream()</a> function, internal stream settings will be influenced in an attempt to minimize stream latency, though possibly at the expense of stream performance.</p> | |||
<p>By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> streams pass and receive audio data from the client in an interleaved format. By passing the RTAUDIO_NONINTERLEAVED flag to the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream()</a> function, audio data will instead be presented in non-interleaved buffers. In this case, each buffer argument in the RtAudioCallback function will point to a single array of data, with <code>nFrames</code> samples for each channel concatenated back-to-back. For example, the first sample of data for the second channel would be located at index <code>nFrames</code> (assuming the <code>buffer</code> pointer was recast to the correct data type for the stream).</p> | |||
<p>Certain audio APIs offer a number of parameters that influence the I/O latency of a stream. By default, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to set these parameters internally for robust (glitch-free) performance (though some APIs, like Windows Direct Sound, make this difficult). By passing the RTAUDIO_MINIMIZE_LATENCY flag to the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">openStream()</a> function, internal stream settings will be influenced in an attempt to minimize stream latency, though possibly at the expense of stream performance.</p> | |||
<p>If the RTAUDIO_HOG_DEVICE flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to open the input and/or output stream device(s) for exclusive use. Note that this is not possible with all supported audio APIs.</p> | |||
<p>If the RTAUDIO_SCHEDULE_REALTIME flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to select realtime scheduling (round-robin) for the callback thread. The <code>priority</code> parameter will only be used if the RTAUDIO_SCHEDULE_REALTIME flag is set. It defines the thread's realtime priority.</p> | |||
<p>If the RTAUDIO_ALSA_USE_DEFAULT flag is set, <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> will attempt to open the "default" PCM device when using the ALSA API. Note that this will override any specified input or output device id.</p> | |||
<p>The <code>numberOfBuffers</code> parameter can be used to control stream latency in the Windows DirectSound, Linux OSS, and Linux Alsa APIs only. A value of two is usually the smallest allowed. Larger numbers can potentially result in more robust stream performance, though likely at the cost of stream latency. The value set by the user is replaced during execution of the <a class="el" href="classRtAudio.html#afacc99740fa4c5606fb35467cdea6da8" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function by the value actually used by the system.</p> | |||
<p>The <code>numberOfBuffers</code> parameter can be used to control stream latency in the Windows DirectSound, Linux OSS, and Linux Alsa APIs only. A value of two is usually the smallest allowed. Larger numbers can potentially result in more robust stream performance, though likely at the cost of stream latency. The value set by the user is replaced during execution of the <a class="el" href="classRtAudio.html#a6907539d2527775df778ebce32ef1e3b" title="A public function for opening a stream with the specified parameters.">RtAudio::openStream()</a> function by the value actually used by the system.</p> | |||
<p>The <code>streamName</code> parameter can be used to set the client name when using the Jack API. By default, the client name is set to RtApiJack. However, if you wish to create multiple instances of <a class="el" href="classRtAudio.html" title="Realtime audio i/o C++ classes.">RtAudio</a> with Jack, each instance must have a unique client name. </p> | |||
<hr/><h2>Member Data Documentation</h2> | |||
<a class="anchor" id="a0ecc98b031aa3af49d09b781643e298b"></a><!-- doxytag: member="RtAudio::StreamOptions::flags" ref="a0ecc98b031aa3af49d09b781643e298b" args="" --> | |||
</div><h2 class="groupheader">Member Data Documentation</h2> | |||
<a class="anchor" id="a0ecc98b031aa3af49d09b781643e298b"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname"><a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a> <a class="el" href="structRtAudio_1_1StreamOptions.html#a0ecc98b031aa3af49d09b781643e298b">RtAudio::StreamOptions::flags</a></td> | |||
<td class="memname"><a class="el" href="RtAudio_8h.html#a2c0f59b200dcec4d4e760f9166b29c41">RtAudioStreamFlags</a> RtAudio::StreamOptions::flags</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
</div><div class="memdoc"> | |||
<p>A bit-mask of stream flags (RTAUDIO_NONINTERLEAVED, RTAUDIO_MINIMIZE_LATENCY, RTAUDIO_HOG_DEVICE, RTAUDIO_ALSA_USE_DEFAULT). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a75a14cfab903d0e1c091bc16aec80240"></a><!-- doxytag: member="RtAudio::StreamOptions::numberOfBuffers" ref="a75a14cfab903d0e1c091bc16aec80240" args="" --> | |||
<a class="anchor" id="a75a14cfab903d0e1c091bc16aec80240"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">unsigned int <a class="el" href="structRtAudio_1_1StreamOptions.html#a75a14cfab903d0e1c091bc16aec80240">RtAudio::StreamOptions::numberOfBuffers</a></td> | |||
<td class="memname">unsigned int RtAudio::StreamOptions::numberOfBuffers</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
</div><div class="memdoc"> | |||
<p>Number of stream buffers. </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="a2a4b0b8d690c624d20f4e8f4be6ca9ba"></a><!-- doxytag: member="RtAudio::StreamOptions::streamName" ref="a2a4b0b8d690c624d20f4e8f4be6ca9ba" args="" --> | |||
<a class="anchor" id="a2a4b0b8d690c624d20f4e8f4be6ca9ba"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">std::string <a class="el" href="structRtAudio_1_1StreamOptions.html#a2a4b0b8d690c624d20f4e8f4be6ca9ba">RtAudio::StreamOptions::streamName</a></td> | |||
<td class="memname">std::string RtAudio::StreamOptions::streamName</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
</div><div class="memdoc"> | |||
<p>A stream name (currently used only in Jack). </p> | |||
</div> | |||
</div> | |||
<a class="anchor" id="adfd267059434edb21573c584e6367def"></a><!-- doxytag: member="RtAudio::StreamOptions::priority" ref="adfd267059434edb21573c584e6367def" args="" --> | |||
<a class="anchor" id="adfd267059434edb21573c584e6367def"></a> | |||
<div class="memitem"> | |||
<div class="memproto"> | |||
<table class="memname"> | |||
<tr> | |||
<td class="memname">int <a class="el" href="structRtAudio_1_1StreamOptions.html#adfd267059434edb21573c584e6367def">RtAudio::StreamOptions::priority</a></td> | |||
<td class="memname">int RtAudio::StreamOptions::priority</td> | |||
</tr> | |||
</table> | |||
</div> | |||
<div class="memdoc"> | |||
</div><div class="memdoc"> | |||
<p>Scheduling priority of callback thread (only used with flag RTAUDIO_SCHEDULE_REALTIME). </p> | |||
</div> | |||
@@ -103,12 +112,10 @@ | |||
<hr/>The documentation for this struct was generated from the following file:<ul> | |||
<li><a class="el" href="RtAudio_8h_source.html">RtAudio.h</a></li> | |||
</ul> | |||
</div> | |||
</div><!-- contents --> | |||
<HR> | |||
<table><tr><td><img src="../images/mcgill.gif" width=165></td> | |||
<td>©2001-2012 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
<td>©2001-2013 Gary P. Scavone, McGill University. All Rights Reserved.<br>Maintained by <a href="http://www.music.mcgill.ca/~gary/">Gary P. Scavone</a>.</td></tr> | |||
</table> | |||
</BODY> | |||
</HTML> |