doc/html/updates.html

   1 <html>
   2 <head>
   3 <title>RtAudio Updates</title>
   4 </head>
   5 <body bgcolor="#FFFFFF">
   6
   7 <center><h1>RtAudio Update Tracker</h1></center>
   8
   9 <h2>Needed Updates & Possible New Features:</h2>
  10
  11 <table border=1 cellpadding=10 cellspacing=0>
  12 <tr bgcolor="#C7CAFF"><td><b>#</b></td><td><b>Description</b></td><td><b>Status</b></td></b></tr>
  13
  14 <tr><td>1</td><td>Check implementation of various stream options (RTAUDIO_HOG_DEVICE, ...) to verify proper implementation.</td><td>UC</td></tr>
  15 <tr><td>2</td><td>Do API-specific implementations of stream time where possible.</td><td>UC</td></tr>
  16 <tr><td>3</td><td>Better support for multichannel (>2) audio devices in Windows DirectSound API.</td><td>UC</td></tr>
  17 <tr><td>4</td><td>Mixer support to set the input volume, output volume, and select the input source (e.g., "Mic" vs "Line In") via following new methods:
  18 <ul>
  19 <li><tt>double getStreamOutputVolume()</tt>:   // returns value between 0.0 and 1.0</li>
  20 <li><tt>void setStreamOutputVolume( double volume )</tt>:  // volume should be value between 0.0 and 1.0</li>
  21 <li><tt>double getStreamInputVolume()</tt>:   // returns value between 0.0 and 1.0</li>
  22 <li><tt>void setStreamInputVolume( double volume )</tt>:  // volume should be value between 0.0 and 1.0</li>
  23 <li><tt>void getStreamInputSources( std::vector&lt;std::string&gt;& sources )</tt>:  // returns a vector of strings with source names</li>
  24 <li><tt>void setStreamInputSource( unsigned int index )</tt>: // source index is value between 0 and sources.size()-1, as determined from function above</li>
  25 </ul></td><td>UC<a href="#4"><sup>4</sup></a></td></tr>
  26 <tr><td>5</td><td>Robust support for full-duplex with different devices.  Provide well-defined behavior if the devices get out of sync, with input taking precedence, so no incoming samples are lost (if possible).</td><td>UC</td></tr>
  27 <tr><td>6</td><td>More sophisticated querying of device capabilities - for example, it'd be nice to figure out that a device supports either 4 channels of 16-bit or 2 channels of 24-bit audio.</td><td>UC</td></tr>
  28
  29
  30 </table>
  31
  32 <p>
  33 <b>Status Codes:</b>
  34 <p>
  35 <table border=1 cellpadding=10 cellspacing=0>
  36 <tr><td>UC</td><td>Under Consideration</td></tr>
  37 <tr><td>API?</td><td>Approved but need to determine API change</td></tr>
  38 </table>
  39
  40
  41 <h2>Recently Added Features:</h2>
  42
  43 <table border=1 cellpadding=10 cellspacing=0>
  44 <tr bgcolor="#C7CAFF"><td><b>#</b></td><td><b>Description</b></td><td width="20%"><b>Solution</b></td><td><b>Version</b></td></tr>
  45
  46 <tr><td>1</td><td>Stream time support - ability to query the stream and find out the exact time since the stream was started, according to that device's clock.  For APIs where this is not supported, this is estimated based on a count of the bytes that have been sent and the known latency.</td><td><a href="#1"><sup>1</sup></a>New <tt>getStreamTime()</tt> function (DM)</td><td>4.0</td></tr>
  47
  48 <tr><td>2</td><td>Ability to determine whether stream is currently running.</td><td>New <tt>bool isStreamRunning()</tt> function (DM)</td><td>4.0</td></tr>
  49
  50 <tr><td>3</td><td>NetBSD support added to Linux OSS API.</td><td>__NetBSD__ must be defined (Emmanuel Dreyfus)</td><td>4.0</td></tr>
  51
  52 <tr><td>4</td><td>Added function to return available compiled APIs</td><td>New <tt>getCompiledApi()</tt> function (GS)</td><td>4.0</td></tr>
  53
  54 <tr><td>5</td><td>Changed <tt>isDefault</tt> member of RtAudioDeviceInfo structure to <tt>isDefaultOutput</tt> and <tt>isDefaultInput</tt> to be able to distinguish between default input and output devices.</td><td>Modified <tt>RtAudioDeviceInfo</tt> structure (GS)</td><td>4.0</td></tr>
  55
  56 <tr><td>6</td><td>Added function to return current API for RtAudio instance</td><td>New <tt>getCurrentApi()</tt> function (GS)</td><td>4.0</td></tr>
  57
  58 <tr><td>7</td><td>Added function to return current stream device(s) index</td><td>New <tt>getStreamDevice()</tt> function (GS)</td><td>4.0</td></tr>
  59
  60 <tr><td>8</td><td>Dummy version that compiles without API compiler flag but does nothing</td><td>New <tt>RtApiDummy</tt> class (GS)</td><td>4.0</td></tr>
  61
  62 <tr><td>9</td><td>Ability to query device latency.</td><td><a href="#2"><sup>2</sup></a>New <tt>getStreamLatency()</tt> function (GS)</td><td>4.0</td></tr>
  63
  64 <tr><td>10</td><td>Choice of opening a device in exclusive or non-exclusive mode.  If opening in non-exclusive mode, try to use the device as-is without changing its sample rate, etc - this is good when users want to use two audio devices at once.</td><td><a href="#3"><sup>3</sup></a>New RtAudio::StreamOptions structure and parameters</td><td>4.0</td></tr>
  65
  66 </table>
  67
  68 <h2>Details:</h2>
  69
  70 <a name="1"><sup>1</sup></a>Currently implemented by incrementing a counter every time the tickStream() or callback function is called.  If the gettimeofday() function is available (right now it is enabled for all Unix-like systems but not Windows), it also records the time of each tickStream() call.  Then, when you call getStreamTime(), it adds the elapsed time since the last tickStream also.  This makes the playback counter pretty smooth, but accurate.  The intent is that now we could implement something more accurate on platforms that support it - but this is a reasonable baseline.  One thing to watch out for: asking OSS for the stream time is problematic; on some devices the counter is only 16-bit and wraps around frequently, and on some devices it will sometimes return bogus values.
  71 <P>
  72 <P>
  73 <a name="2"><sup>2</sup></a>This function could not be implemented for all APIs.  If the function returns a value of zero, it should be assumed to be invalid.
  74 <P>
  75 <P>
  76 <a name="3"><sup>3</sup></a>This implementation does not attempt to leave a device as-is.  However, the flag <tt>RTAUDIO_HOG_DEVICE</tt> is provided to attempt to grab exclusive use of a device.
  77 <P>
  78 <P>
  79 <a name="4"><sup>4</sup></a>I actually coded this up for OS-X Core Audio.  However, I found it bloated the code and presented a number of interface problems that did more harm than good.  Thus, it is currently not being considered further (GS).
  80 </body>
  81 </html>