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

295 lines
13KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.9.1"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>DISTRHO Plugin Framework: Plugin related utilities</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  13. <script type="text/javascript" src="search/searchdata.js"></script>
  14. <script type="text/javascript" src="search/search.js"></script>
  15. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  16. </head>
  17. <body>
  18. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  19. <div id="titlearea">
  20. <table cellspacing="0" cellpadding="0">
  21. <tbody>
  22. <tr style="height: 56px;">
  23. <td id="projectalign" style="padding-left: 0.5em;">
  24. <div id="projectname">DISTRHO Plugin Framework
  25. </div>
  26. </td>
  27. </tr>
  28. </tbody>
  29. </table>
  30. </div>
  31. <!-- end header part -->
  32. <!-- Generated by Doxygen 1.9.1 -->
  33. <script type="text/javascript">
  34. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  35. var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
  36. /* @license-end */
  37. </script>
  38. <script type="text/javascript" src="menudata.js"></script>
  39. <script type="text/javascript" src="menu.js"></script>
  40. <script type="text/javascript">
  41. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  42. $(function() {
  43. initMenu('',true,false,'search.php','Search');
  44. $(document).ready(function() { init_search(); });
  45. });
  46. /* @license-end */</script>
  47. <div id="main-nav"></div>
  48. </div><!-- top -->
  49. <!-- window showing the filter options -->
  50. <div id="MSearchSelectWindow"
  51. onmouseover="return searchBox.OnSearchSelectShow()"
  52. onmouseout="return searchBox.OnSearchSelectHide()"
  53. onkeydown="return searchBox.OnSearchSelectKey(event)">
  54. </div>
  55. <!-- iframe showing the search results (closed by default) -->
  56. <div id="MSearchResultsWindow">
  57. <iframe src="javascript:void(0)" frameborder="0"
  58. name="MSearchResults" id="MSearchResults">
  59. </iframe>
  60. </div>
  61. <div class="header">
  62. <div class="summary">
  63. <a href="#func-members">Functions</a> </div>
  64. <div class="headertitle">
  65. <div class="title">Plugin related utilities</div> </div>
  66. </div><!--header-->
  67. <div class="contents">
  68. <table class="memberdecls">
  69. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
  70. Functions</h2></td></tr>
  71. <tr class="memitem:gae42de84169a5b578063b833caf5a5570"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#gae42de84169a5b578063b833caf5a5570">isUsingNativeAudio</a> () noexcept</td></tr>
  72. <tr class="separator:gae42de84169a5b578063b833caf5a5570"><td class="memSeparator" colspan="2">&#160;</td></tr>
  73. <tr class="memitem:ga13301901e329e098883c62de0972d9ec"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#ga13301901e329e098883c62de0972d9ec">supportsAudioInput</a> ()</td></tr>
  74. <tr class="separator:ga13301901e329e098883c62de0972d9ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
  75. <tr class="memitem:gae30b95b8622bdce705b5e7465548ed4c"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#gae30b95b8622bdce705b5e7465548ed4c">supportsBufferSizeChanges</a> ()</td></tr>
  76. <tr class="separator:gae30b95b8622bdce705b5e7465548ed4c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  77. <tr class="memitem:gadbfa0c2cdcb4c114db1063651e97066e"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#gadbfa0c2cdcb4c114db1063651e97066e">supportsMIDI</a> ()</td></tr>
  78. <tr class="separator:gadbfa0c2cdcb4c114db1063651e97066e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  79. <tr class="memitem:ga0a61814996c249f0010928afe976950a"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#ga0a61814996c249f0010928afe976950a">isAudioInputEnabled</a> ()</td></tr>
  80. <tr class="separator:ga0a61814996c249f0010928afe976950a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  81. <tr class="memitem:ga14edff90e67fc028b106c7dc0888d1d3"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#ga14edff90e67fc028b106c7dc0888d1d3">isMIDIEnabled</a> ()</td></tr>
  82. <tr class="separator:ga14edff90e67fc028b106c7dc0888d1d3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  83. <tr class="memitem:gaeb5392c82fb90c8f58e07465503ce11b"><td class="memItemLeft" align="right" valign="top">uint&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#gaeb5392c82fb90c8f58e07465503ce11b">getBufferSize</a> ()</td></tr>
  84. <tr class="separator:gaeb5392c82fb90c8f58e07465503ce11b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  85. <tr class="memitem:gaa499fd42799f9d7479917549634c0226"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#gaa499fd42799f9d7479917549634c0226">requestAudioInput</a> ()</td></tr>
  86. <tr class="separator:gaa499fd42799f9d7479917549634c0226"><td class="memSeparator" colspan="2">&#160;</td></tr>
  87. <tr class="memitem:ga448fb5c17b53116ff45716884b7a7635"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#ga448fb5c17b53116ff45716884b7a7635">requestBufferSizeChange</a> (uint newBufferSize)</td></tr>
  88. <tr class="separator:ga448fb5c17b53116ff45716884b7a7635"><td class="memSeparator" colspan="2">&#160;</td></tr>
  89. <tr class="memitem:gac81794c2f59b4a1793ea25b73b76e5e3"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__StandalonePluginRelatedUtilities.html#gac81794c2f59b4a1793ea25b73b76e5e3">requestMIDI</a> ()</td></tr>
  90. <tr class="separator:gac81794c2f59b4a1793ea25b73b76e5e3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91. </table>
  92. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  93. <p>When the plugin is running as standalone and JACK is not available, a native audio handling is in place. It is a very simple handling, auto-connecting to the default audio interface for outputs.</p>
  94. <p>!!EXPERIMENTAL!!</p>
  95. <p>Still under development and testing. </p>
  96. <h2 class="groupheader">Function Documentation</h2>
  97. <a id="gae42de84169a5b578063b833caf5a5570"></a>
  98. <h2 class="memtitle"><span class="permalink"><a href="#gae42de84169a5b578063b833caf5a5570">&#9670;&nbsp;</a></span>isUsingNativeAudio()</h2>
  99. <div class="memitem">
  100. <div class="memproto">
  101. <table class="mlabels">
  102. <tr>
  103. <td class="mlabels-left">
  104. <table class="memname">
  105. <tr>
  106. <td class="memname">bool isUsingNativeAudio </td>
  107. <td>(</td>
  108. <td class="paramname"></td><td>)</td>
  109. <td></td>
  110. </tr>
  111. </table>
  112. </td>
  113. <td class="mlabels-right">
  114. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  115. </tr>
  116. </table>
  117. </div><div class="memdoc">
  118. <p>Check if the current standalone is using native audio methods. If this function returns false, you MUST NOT use any other function from this group. </p>
  119. </div>
  120. </div>
  121. <a id="ga13301901e329e098883c62de0972d9ec"></a>
  122. <h2 class="memtitle"><span class="permalink"><a href="#ga13301901e329e098883c62de0972d9ec">&#9670;&nbsp;</a></span>supportsAudioInput()</h2>
  123. <div class="memitem">
  124. <div class="memproto">
  125. <table class="memname">
  126. <tr>
  127. <td class="memname">bool supportsAudioInput </td>
  128. <td>(</td>
  129. <td class="paramname"></td><td>)</td>
  130. <td></td>
  131. </tr>
  132. </table>
  133. </div><div class="memdoc">
  134. <p>Check if the current standalone supports audio input. </p>
  135. </div>
  136. </div>
  137. <a id="gae30b95b8622bdce705b5e7465548ed4c"></a>
  138. <h2 class="memtitle"><span class="permalink"><a href="#gae30b95b8622bdce705b5e7465548ed4c">&#9670;&nbsp;</a></span>supportsBufferSizeChanges()</h2>
  139. <div class="memitem">
  140. <div class="memproto">
  141. <table class="memname">
  142. <tr>
  143. <td class="memname">bool supportsBufferSizeChanges </td>
  144. <td>(</td>
  145. <td class="paramname"></td><td>)</td>
  146. <td></td>
  147. </tr>
  148. </table>
  149. </div><div class="memdoc">
  150. <p>Check if the current standalone supports dynamic buffer size changes. </p>
  151. </div>
  152. </div>
  153. <a id="gadbfa0c2cdcb4c114db1063651e97066e"></a>
  154. <h2 class="memtitle"><span class="permalink"><a href="#gadbfa0c2cdcb4c114db1063651e97066e">&#9670;&nbsp;</a></span>supportsMIDI()</h2>
  155. <div class="memitem">
  156. <div class="memproto">
  157. <table class="memname">
  158. <tr>
  159. <td class="memname">bool supportsMIDI </td>
  160. <td>(</td>
  161. <td class="paramname"></td><td>)</td>
  162. <td></td>
  163. </tr>
  164. </table>
  165. </div><div class="memdoc">
  166. <p>Check if the current standalone supports MIDI. </p>
  167. </div>
  168. </div>
  169. <a id="ga0a61814996c249f0010928afe976950a"></a>
  170. <h2 class="memtitle"><span class="permalink"><a href="#ga0a61814996c249f0010928afe976950a">&#9670;&nbsp;</a></span>isAudioInputEnabled()</h2>
  171. <div class="memitem">
  172. <div class="memproto">
  173. <table class="memname">
  174. <tr>
  175. <td class="memname">bool isAudioInputEnabled </td>
  176. <td>(</td>
  177. <td class="paramname"></td><td>)</td>
  178. <td></td>
  179. </tr>
  180. </table>
  181. </div><div class="memdoc">
  182. <p>Check if the current standalone has audio input enabled. </p>
  183. </div>
  184. </div>
  185. <a id="ga14edff90e67fc028b106c7dc0888d1d3"></a>
  186. <h2 class="memtitle"><span class="permalink"><a href="#ga14edff90e67fc028b106c7dc0888d1d3">&#9670;&nbsp;</a></span>isMIDIEnabled()</h2>
  187. <div class="memitem">
  188. <div class="memproto">
  189. <table class="memname">
  190. <tr>
  191. <td class="memname">bool isMIDIEnabled </td>
  192. <td>(</td>
  193. <td class="paramname"></td><td>)</td>
  194. <td></td>
  195. </tr>
  196. </table>
  197. </div><div class="memdoc">
  198. <p>Check if the current standalone has MIDI enabled. </p>
  199. </div>
  200. </div>
  201. <a id="gaeb5392c82fb90c8f58e07465503ce11b"></a>
  202. <h2 class="memtitle"><span class="permalink"><a href="#gaeb5392c82fb90c8f58e07465503ce11b">&#9670;&nbsp;</a></span>getBufferSize()</h2>
  203. <div class="memitem">
  204. <div class="memproto">
  205. <table class="memname">
  206. <tr>
  207. <td class="memname">uint getBufferSize </td>
  208. <td>(</td>
  209. <td class="paramname"></td><td>)</td>
  210. <td></td>
  211. </tr>
  212. </table>
  213. </div><div class="memdoc">
  214. <p>Get the current buffer size. </p>
  215. </div>
  216. </div>
  217. <a id="gaa499fd42799f9d7479917549634c0226"></a>
  218. <h2 class="memtitle"><span class="permalink"><a href="#gaa499fd42799f9d7479917549634c0226">&#9670;&nbsp;</a></span>requestAudioInput()</h2>
  219. <div class="memitem">
  220. <div class="memproto">
  221. <table class="memname">
  222. <tr>
  223. <td class="memname">bool requestAudioInput </td>
  224. <td>(</td>
  225. <td class="paramname"></td><td>)</td>
  226. <td></td>
  227. </tr>
  228. </table>
  229. </div><div class="memdoc">
  230. <p>Request permissions to use audio input. Only valid to call if audio input is supported but not currently enabled. </p>
  231. </div>
  232. </div>
  233. <a id="ga448fb5c17b53116ff45716884b7a7635"></a>
  234. <h2 class="memtitle"><span class="permalink"><a href="#ga448fb5c17b53116ff45716884b7a7635">&#9670;&nbsp;</a></span>requestBufferSizeChange()</h2>
  235. <div class="memitem">
  236. <div class="memproto">
  237. <table class="memname">
  238. <tr>
  239. <td class="memname">bool requestBufferSizeChange </td>
  240. <td>(</td>
  241. <td class="paramtype">uint&#160;</td>
  242. <td class="paramname"><em>newBufferSize</em></td><td>)</td>
  243. <td></td>
  244. </tr>
  245. </table>
  246. </div><div class="memdoc">
  247. <p>Request change to a new buffer size. </p>
  248. </div>
  249. </div>
  250. <a id="gac81794c2f59b4a1793ea25b73b76e5e3"></a>
  251. <h2 class="memtitle"><span class="permalink"><a href="#gac81794c2f59b4a1793ea25b73b76e5e3">&#9670;&nbsp;</a></span>requestMIDI()</h2>
  252. <div class="memitem">
  253. <div class="memproto">
  254. <table class="memname">
  255. <tr>
  256. <td class="memname">bool requestMIDI </td>
  257. <td>(</td>
  258. <td class="paramname"></td><td>)</td>
  259. <td></td>
  260. </tr>
  261. </table>
  262. </div><div class="memdoc">
  263. <p>Request permissions to use MIDI. Only valid to call if MIDI is supported but not currently enabled. </p>
  264. </div>
  265. </div>
  266. </div><!-- contents -->
  267. <!-- start footer part -->
  268. <hr class="footer"/><address class="footer"><small>
  269. Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
  270. </small></address>
  271. </body>
  272. </html>