<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.3.1"/> <title>PortAudio: BlockingStream.java Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">PortAudio  <span id="projectnumber">2.0</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.3.1 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_00240dc4a1a4845ae58be68fbad02d02.html">bindings</a></li><li class="navelem"><a class="el" href="dir_41aa6dd12e5ba72d4ae407fdd152c1a3.html">java</a></li><li class="navelem"><a class="el" href="dir_5b8472bd87f246d54ea51ecb7aeb1e6a.html">jportaudio</a></li><li class="navelem"><a class="el" href="dir_6a252b7c422c406616d11406107bfe7f.html">src</a></li><li class="navelem"><a class="el" href="dir_d0eac7566f1d8d883a610e0191ef9014.html">com</a></li><li class="navelem"><a class="el" href="dir_23319d3558061812c719008a37d0e996.html">portaudio</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">BlockingStream.java</div> </div> </div><!--header--> <div class="contents"> <a href="BlockingStream_8java.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="l00002"></a><span class="lineno"> 2</span> <span class="comment"> * Portable Audio I/O Library</span></div> <div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"> * Java Binding for PortAudio</span></div> <div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> *</span></div> <div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"> * Based on the Open Source API proposed by Ross Bencina</span></div> <div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> * Copyright (c) 2008 Ross Bencina</span></div> <div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> *</span></div> <div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> * Permission is hereby granted, free of charge, to any person obtaining</span></div> <div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> * a copy of this software and associated documentation files</span></div> <div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"> * (the "Software"), to deal in the Software without restriction,</span></div> <div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> * including without limitation the rights to use, copy, modify, merge,</span></div> <div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> * publish, distribute, sublicense, and/or sell copies of the Software,</span></div> <div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> * and to permit persons to whom the Software is furnished to do so,</span></div> <div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> * subject to the following conditions:</span></div> <div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"> *</span></div> <div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> * The above copyright notice and this permission notice shall be</span></div> <div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> * included in all copies or substantial portions of the Software.</span></div> <div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> *</span></div> <div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,</span></div> <div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"> * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF</span></div> <div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"> * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.</span></div> <div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment"> * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR</span></div> <div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment"> * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF</span></div> <div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment"> * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION</span></div> <div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment"> * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</span></div> <div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment"> */</span></div> <div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div> <div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment">/*</span></div> <div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment"> * The text above constitutes the entire PortAudio license; however, </span></div> <div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment"> * the PortAudio community also makes the following non-binding requests:</span></div> <div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment"> *</span></div> <div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="comment"> * Any person wishing to distribute modifications to the Software is</span></div> <div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="comment"> * requested to send the modifications to the original developer so that</span></div> <div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment"> * they can be incorporated into the canonical version. It is also </span></div> <div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment"> * requested that these non-binding requests be included along with the </span></div> <div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment"> * license above.</span></div> <div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment"> */</span></div> <div class="line"><a name="l00038"></a><span class="lineno"> 38</span> </div> <div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="keyword">package </span>com.portaudio;</div> <div class="line"><a name="l00045"></a><span class="lineno"> 45</span> </div> <div class="line"><a name="l00059"></a><span class="lineno"><a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html"> 59</a></span> <span class="keyword">public</span> <span class="keyword">class </span><a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html">BlockingStream</a></div> <div class="line"><a name="l00060"></a><span class="lineno"> 60</span> {</div> <div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="comment">// nativeStream is only accessed by the native code. It contains a pointer</span></div> <div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <span class="comment">// to a PaStream.</span></div> <div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keyword">private</span> <span class="keywordtype">long</span> nativeStream;</div> <div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keyword">private</span> <span class="keywordtype">int</span> inputFormat = -1;</div> <div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <span class="keyword">private</span> <span class="keywordtype">int</span> outputFormat = -1;</div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span> </div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="keyword">protected</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html">BlockingStream</a>()</div> <div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  {</div> <div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  }</div> <div class="line"><a name="l00070"></a><span class="lineno"> 70</span> </div> <div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  <span class="keyword">public</span> native <span class="keywordtype">int</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a4cb237d1596fcfb10adf7e21166bfd10">getReadAvailable</a>();</div> <div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div> <div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keyword">public</span> native <span class="keywordtype">int</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a24fcac3b87ee7f15cbf97c9f821009dd">getWriteAvailable</a>();</div> <div class="line"><a name="l00080"></a><span class="lineno"> 80</span> </div> <div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="keyword">private</span> native <span class="keywordtype">boolean</span> readFloats( <span class="keywordtype">float</span>[] buffer, <span class="keywordtype">int</span> numFrames );</div> <div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div> <div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <span class="keyword">private</span> native <span class="keywordtype">boolean</span> writeFloats( <span class="keywordtype">float</span>[] buffer, <span class="keywordtype">int</span> numFrames );</div> <div class="line"><a name="l00084"></a><span class="lineno"> 84</span> </div> <div class="line"><a name="l00093"></a><span class="lineno"><a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#ab6004b6eb81636c73053841b32c371fa"> 93</a></span>  <span class="keyword">public</span> <span class="keywordtype">boolean</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#ab6004b6eb81636c73053841b32c371fa">read</a>( <span class="keywordtype">float</span>[] buffer, <span class="keywordtype">int</span> numFrames )</div> <div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  {</div> <div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keywordflow">if</span>( inputFormat != <a class="code" href="classcom_1_1portaudio_1_1PortAudio.html">PortAudio</a>.<a class="code" href="classcom_1_1portaudio_1_1PortAudio.html#a2d96208f8de10d8b5888aeaf5e43fa57">FORMAT_FLOAT_32</a> )</div> <div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  {</div> <div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="keywordflow">throw</span> <span class="keyword">new</span> RuntimeException(</div> <div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="stringliteral">"Tried to read float samples from a non float stream."</span> );</div> <div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  }</div> <div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="keywordflow">return</span> readFloats( buffer, numFrames );</div> <div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  }</div> <div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div> <div class="line"><a name="l00112"></a><span class="lineno"><a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#ab12ce694b065cb1729fff4815345b4a9"> 112</a></span>  <span class="keyword">public</span> <span class="keywordtype">boolean</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#ab12ce694b065cb1729fff4815345b4a9">write</a>( <span class="keywordtype">float</span>[] buffer, <span class="keywordtype">int</span> numFrames )</div> <div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  {</div> <div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keywordflow">if</span>( outputFormat != <a class="code" href="classcom_1_1portaudio_1_1PortAudio.html">PortAudio</a>.<a class="code" href="classcom_1_1portaudio_1_1PortAudio.html#a2d96208f8de10d8b5888aeaf5e43fa57">FORMAT_FLOAT_32</a> )</div> <div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  {</div> <div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="keywordflow">throw</span> <span class="keyword">new</span> RuntimeException(</div> <div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="stringliteral">"Tried to write float samples to a non float stream."</span> );</div> <div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  }</div> <div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="keywordflow">return</span> writeFloats( buffer, numFrames );</div> <div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  }</div> <div class="line"><a name="l00121"></a><span class="lineno"> 121</span> </div> <div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="keyword">private</span> native <span class="keywordtype">boolean</span> readShorts( <span class="keywordtype">short</span>[] buffer, <span class="keywordtype">int</span> numFrames );</div> <div class="line"><a name="l00123"></a><span class="lineno"> 123</span> </div> <div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keyword">private</span> native <span class="keywordtype">boolean</span> writeShorts( <span class="keywordtype">short</span>[] buffer, <span class="keywordtype">int</span> numFrames );</div> <div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div> <div class="line"><a name="l00134"></a><span class="lineno"><a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a3817b1e550497d46eb20459d9a41dc03"> 134</a></span>  <span class="keyword">public</span> <span class="keywordtype">boolean</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#ab6004b6eb81636c73053841b32c371fa">read</a>( <span class="keywordtype">short</span>[] buffer, <span class="keywordtype">int</span> numFrames )</div> <div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  {</div> <div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="keywordflow">if</span>( inputFormat != <a class="code" href="classcom_1_1portaudio_1_1PortAudio.html">PortAudio</a>.FORMAT_INT_16 )</div> <div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  {</div> <div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="keywordflow">throw</span> <span class="keyword">new</span> RuntimeException(</div> <div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="stringliteral">"Tried to read short samples from a non short stream."</span> );</div> <div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  }</div> <div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="keywordflow">return</span> readShorts( buffer, numFrames );</div> <div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  }</div> <div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div> <div class="line"><a name="l00152"></a><span class="lineno"><a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a4a7b50bb6f5f7cb1cb95748ec20ca874"> 152</a></span>  <span class="keyword">public</span> <span class="keywordtype">boolean</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#ab12ce694b065cb1729fff4815345b4a9">write</a>( <span class="keywordtype">short</span>[] buffer, <span class="keywordtype">int</span> numFrames )</div> <div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  {</div> <div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  <span class="keywordflow">if</span>( outputFormat != <a class="code" href="classcom_1_1portaudio_1_1PortAudio.html">PortAudio</a>.FORMAT_INT_16 )</div> <div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  {</div> <div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordflow">throw</span> <span class="keyword">new</span> RuntimeException(</div> <div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <span class="stringliteral">"Tried to write short samples from a non short stream."</span> );</div> <div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  }</div> <div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keywordflow">return</span> writeShorts( buffer, numFrames );</div> <div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  }</div> <div class="line"><a name="l00161"></a><span class="lineno"> 161</span> </div> <div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keyword">public</span> native <span class="keywordtype">void</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a8acbba9e18de0678780d1209548f9c8d">start</a>();</div> <div class="line"><a name="l00166"></a><span class="lineno"> 166</span> </div> <div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <span class="keyword">public</span> native <span class="keywordtype">void</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a912f5332bc0c5f610ec94bf583a3e2d6">stop</a>();</div> <div class="line"><a name="l00172"></a><span class="lineno"> 172</span> </div> <div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span class="keyword">public</span> native <span class="keywordtype">void</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a9897ea14063ab8e9cf01da7f0c71dcf3">abort</a>();</div> <div class="line"><a name="l00177"></a><span class="lineno"> 177</span> </div> <div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keyword">public</span> native <span class="keywordtype">void</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a8aa21c90665dbd02b7578ec83aa7bc38">close</a>();</div> <div class="line"><a name="l00183"></a><span class="lineno"> 183</span> </div> <div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keyword">public</span> native <span class="keywordtype">boolean</span> isStopped();</div> <div class="line"><a name="l00185"></a><span class="lineno"> 185</span> </div> <div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keyword">public</span> native <span class="keywordtype">boolean</span> isActive();</div> <div class="line"><a name="l00187"></a><span class="lineno"> 187</span> </div> <div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="keyword">public</span> String toString()</div> <div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  {</div> <div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  <span class="keywordflow">return</span> <span class="stringliteral">"BlockingStream: streamPtr = "</span> + Long.toHexString( nativeStream )</div> <div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  + <span class="stringliteral">", inFormat = "</span> + inputFormat + <span class="stringliteral">", outFormat = "</span></div> <div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  + outputFormat;</div> <div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  }</div> <div class="line"><a name="l00194"></a><span class="lineno"> 194</span> </div> <div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keyword">public</span> native <span class="keywordtype">double</span> <a class="code" href="classcom_1_1portaudio_1_1BlockingStream.html#a1768a144ac219d3ce7682ac8422d20f2">getTime</a>();</div> <div class="line"><a name="l00199"></a><span class="lineno"> 199</span> </div> <div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="keyword">private</span> native <span class="keywordtype">void</span> getInfo( StreamInfo streamInfo );</div> <div class="line"><a name="l00201"></a><span class="lineno"> 201</span> </div> <div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="keyword">public</span> StreamInfo getInfo()</div> <div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  {</div> <div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  StreamInfo streamInfo = <span class="keyword">new</span> StreamInfo();</div> <div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  getInfo( streamInfo );</div> <div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keywordflow">return</span> streamInfo;</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> }</div> </div><!-- fragment --></div><!-- contents --> <hr size="1"><address style="text-align: right;"><small>Generated for PortAudio by <a href="http://www.doxygen.org/index.html"> <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a>1.8.3.1</small></address> </body> </html>