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.

1372 lines
64KB

  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 Class Reference</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. <!-- window showing the filter options -->
  49. <div id="MSearchSelectWindow"
  50. onmouseover="return searchBox.OnSearchSelectShow()"
  51. onmouseout="return searchBox.OnSearchSelectHide()"
  52. onkeydown="return searchBox.OnSearchSelectKey(event)">
  53. </div>
  54. <!-- iframe showing the search results (closed by default) -->
  55. <div id="MSearchResultsWindow">
  56. <iframe src="javascript:void(0)" frameborder="0"
  57. name="MSearchResults" id="MSearchResults">
  58. </iframe>
  59. </div>
  60. </div><!-- top -->
  61. <div class="header">
  62. <div class="summary">
  63. <a href="#pub-methods">Public Member Functions</a> &#124;
  64. <a href="#pro-methods">Protected Member Functions</a> &#124;
  65. <a href="#friends">Friends</a> &#124;
  66. <a href="classPlugin-members.html">List of all members</a> </div>
  67. <div class="headertitle">
  68. <div class="title">Plugin Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span><div class="ingroups"><a class="el" href="group__MainClasses.html">Main Classes</a></div></div> </div>
  69. </div><!--header-->
  70. <div class="contents">
  71. <p><code>#include &lt;<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a>&gt;</code></p>
  72. <table class="memberdecls">
  73. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  74. Public Member Functions</h2></td></tr>
  75. <tr class="memitem:acb5a3632da5a5c4110172a3a78e1fd32"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#acb5a3632da5a5c4110172a3a78e1fd32">Plugin</a> (uint32_t parameterCount, uint32_t programCount, uint32_t stateCount)</td></tr>
  76. <tr class="separator:acb5a3632da5a5c4110172a3a78e1fd32"><td class="memSeparator" colspan="2">&#160;</td></tr>
  77. <tr class="memitem:a89814b8f0b1c91e49140d42eb8331383"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a89814b8f0b1c91e49140d42eb8331383">~Plugin</a> ()</td></tr>
  78. <tr class="separator:a89814b8f0b1c91e49140d42eb8331383"><td class="memSeparator" colspan="2">&#160;</td></tr>
  79. <tr class="memitem:a2643e638f62cfd4990247ec66bed60d2"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a2643e638f62cfd4990247ec66bed60d2">getBufferSize</a> () const noexcept</td></tr>
  80. <tr class="separator:a2643e638f62cfd4990247ec66bed60d2"><td class="memSeparator" colspan="2">&#160;</td></tr>
  81. <tr class="memitem:a3e162cfe8f1c52bf09805fd327bcc3c4"><td class="memItemLeft" align="right" valign="top">double&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a3e162cfe8f1c52bf09805fd327bcc3c4">getSampleRate</a> () const noexcept</td></tr>
  82. <tr class="separator:a3e162cfe8f1c52bf09805fd327bcc3c4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  83. <tr class="memitem:a5fd60c82f5a50f12312c57729885fc2f"><td class="memItemLeft" align="right" valign="top">const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a5fd60c82f5a50f12312c57729885fc2f">getBundlePath</a> () const noexcept</td></tr>
  84. <tr class="separator:a5fd60c82f5a50f12312c57729885fc2f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  85. <tr class="memitem:ab2c6b7bc2e0cdcd589cf9d03be831042"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ab2c6b7bc2e0cdcd589cf9d03be831042">isDummyInstance</a> () const noexcept</td></tr>
  86. <tr class="separator:ab2c6b7bc2e0cdcd589cf9d03be831042"><td class="memSeparator" colspan="2">&#160;</td></tr>
  87. <tr class="memitem:a8d07561f935bf9918e8b395e6eaabfa0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a8d07561f935bf9918e8b395e6eaabfa0">isSelfTestInstance</a> () const noexcept</td></tr>
  88. <tr class="separator:a8d07561f935bf9918e8b395e6eaabfa0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  89. <tr class="memitem:ae85d602c430b1a4361a88d714d3a42c1"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="structTimePosition.html">TimePosition</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ae85d602c430b1a4361a88d714d3a42c1">getTimePosition</a> () const noexcept</td></tr>
  90. <tr class="separator:ae85d602c430b1a4361a88d714d3a42c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91. <tr class="memitem:a2a70c4ec55d74d9bc26862975d8df8a7"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a2a70c4ec55d74d9bc26862975d8df8a7">setLatency</a> (uint32_t frames) noexcept</td></tr>
  92. <tr class="separator:a2a70c4ec55d74d9bc26862975d8df8a7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  93. <tr class="memitem:a0467eef817ac130cbbe1c0fbe09660c6"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a0467eef817ac130cbbe1c0fbe09660c6">writeMidiEvent</a> (const <a class="el" href="structMidiEvent.html">MidiEvent</a> &amp;midiEvent) noexcept</td></tr>
  94. <tr class="separator:a0467eef817ac130cbbe1c0fbe09660c6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  95. <tr class="memitem:a581614e1d301ee613a988855c61b2517"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a581614e1d301ee613a988855c61b2517">canRequestParameterValueChanges</a> () const noexcept</td></tr>
  96. <tr class="separator:a581614e1d301ee613a988855c61b2517"><td class="memSeparator" colspan="2">&#160;</td></tr>
  97. <tr class="memitem:ae65d8603022c09d1ce2ee5cf568de70f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ae65d8603022c09d1ce2ee5cf568de70f">requestParameterValueChange</a> (uint32_t index, float value) noexcept</td></tr>
  98. <tr class="separator:ae65d8603022c09d1ce2ee5cf568de70f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  99. <tr class="memitem:aa85c50c732d9083f57b72d6b4cd7c5ae"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#aa85c50c732d9083f57b72d6b4cd7c5ae">updateStateValue</a> (const char *key, const char *value) noexcept</td></tr>
  100. <tr class="separator:aa85c50c732d9083f57b72d6b4cd7c5ae"><td class="memSeparator" colspan="2">&#160;</td></tr>
  101. </table><table class="memberdecls">
  102. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
  103. Protected Member Functions</h2></td></tr>
  104. <tr class="memitem:aebb5df5cde162462dc460d4fd45dae75"><td class="memItemLeft" align="right" valign="top">virtual const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#aebb5df5cde162462dc460d4fd45dae75">getName</a> () const</td></tr>
  105. <tr class="separator:aebb5df5cde162462dc460d4fd45dae75"><td class="memSeparator" colspan="2">&#160;</td></tr>
  106. <tr class="memitem:a00f7945c16149db6845fbcc2af729f4f"><td class="memItemLeft" align="right" valign="top">virtual const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a00f7945c16149db6845fbcc2af729f4f">getLabel</a> () const =0</td></tr>
  107. <tr class="separator:a00f7945c16149db6845fbcc2af729f4f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  108. <tr class="memitem:a30db5eef9de617f4c81d5c6925facea3"><td class="memItemLeft" align="right" valign="top">virtual const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a30db5eef9de617f4c81d5c6925facea3">getDescription</a> () const</td></tr>
  109. <tr class="separator:a30db5eef9de617f4c81d5c6925facea3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  110. <tr class="memitem:a955832840de786a7a22798f0ef451c5d"><td class="memItemLeft" align="right" valign="top">virtual const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a955832840de786a7a22798f0ef451c5d">getMaker</a> () const =0</td></tr>
  111. <tr class="separator:a955832840de786a7a22798f0ef451c5d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  112. <tr class="memitem:ad12c681ce31004da0badd609763f45c5"><td class="memItemLeft" align="right" valign="top">virtual const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ad12c681ce31004da0badd609763f45c5">getHomePage</a> () const</td></tr>
  113. <tr class="separator:ad12c681ce31004da0badd609763f45c5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  114. <tr class="memitem:a686a3c92a376a185d6fd97efd59125d1"><td class="memItemLeft" align="right" valign="top">virtual const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a686a3c92a376a185d6fd97efd59125d1">getLicense</a> () const =0</td></tr>
  115. <tr class="separator:a686a3c92a376a185d6fd97efd59125d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <tr class="memitem:abae540dd93caf4834270358a8aad334a"><td class="memItemLeft" align="right" valign="top">virtual uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#abae540dd93caf4834270358a8aad334a">getVersion</a> () const =0</td></tr>
  117. <tr class="separator:abae540dd93caf4834270358a8aad334a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:ad6ff8c80227d5ceebd40b96f3be29a66"><td class="memItemLeft" align="right" valign="top">virtual int64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ad6ff8c80227d5ceebd40b96f3be29a66">getUniqueId</a> () const =0</td></tr>
  119. <tr class="separator:ad6ff8c80227d5ceebd40b96f3be29a66"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. <tr class="memitem:a75f30935198a0acba25f4ea92af72dc4"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a75f30935198a0acba25f4ea92af72dc4">initAudioPort</a> (bool input, uint32_t index, <a class="el" href="structAudioPort.html">AudioPort</a> &amp;port)</td></tr>
  121. <tr class="separator:a75f30935198a0acba25f4ea92af72dc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <tr class="memitem:aacf87bd0037efeb3b60d204940f3f4a0"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#aacf87bd0037efeb3b60d204940f3f4a0">initParameter</a> (uint32_t index, <a class="el" href="structParameter.html">Parameter</a> &amp;parameter)</td></tr>
  123. <tr class="separator:aacf87bd0037efeb3b60d204940f3f4a0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  124. <tr class="memitem:a71b876c8157b087b3552960f2877a44d"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a71b876c8157b087b3552960f2877a44d">initPortGroup</a> (uint32_t groupId, <a class="el" href="structPortGroup.html">PortGroup</a> &amp;portGroup)</td></tr>
  125. <tr class="separator:a71b876c8157b087b3552960f2877a44d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  126. <tr class="memitem:a54d66af3111541b7c118f9749ef0231b"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a54d66af3111541b7c118f9749ef0231b">initProgramName</a> (uint32_t index, <a class="el" href="classString.html">String</a> &amp;programName)=0</td></tr>
  127. <tr class="separator:a54d66af3111541b7c118f9749ef0231b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  128. <tr class="memitem:ad4ab623187f905c250a42284704eb840"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ad4ab623187f905c250a42284704eb840">initState</a> (uint32_t index, <a class="el" href="structState.html">State</a> &amp;state)</td></tr>
  129. <tr class="separator:ad4ab623187f905c250a42284704eb840"><td class="memSeparator" colspan="2">&#160;</td></tr>
  130. <tr class="memitem:a234313269360dea74d63c94c72b4e1f7"><td class="memItemLeft" align="right" valign="top"><a id="a234313269360dea74d63c94c72b4e1f7"></a>
  131. virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>initState</b> (uint32_t, <a class="el" href="classString.html">String</a> &amp;, <a class="el" href="classString.html">String</a> &amp;)</td></tr>
  132. <tr class="separator:a234313269360dea74d63c94c72b4e1f7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  133. <tr class="memitem:aab71534f4a99952f145b533469a255fa"><td class="memItemLeft" align="right" valign="top"><a id="aab71534f4a99952f145b533469a255fa"></a>
  134. virtual bool&#160;</td><td class="memItemRight" valign="bottom"><b>isStateFile</b> (uint32_t)</td></tr>
  135. <tr class="separator:aab71534f4a99952f145b533469a255fa"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:af9e9f5438e2e0c2352052eb5f95832aa"><td class="memItemLeft" align="right" valign="top">virtual float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#af9e9f5438e2e0c2352052eb5f95832aa">getParameterValue</a> (uint32_t index) const</td></tr>
  137. <tr class="separator:af9e9f5438e2e0c2352052eb5f95832aa"><td class="memSeparator" colspan="2">&#160;</td></tr>
  138. <tr class="memitem:a7e9e26ceafc7603ef6163483a9dc39be"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a7e9e26ceafc7603ef6163483a9dc39be">setParameterValue</a> (uint32_t index, float value)</td></tr>
  139. <tr class="separator:a7e9e26ceafc7603ef6163483a9dc39be"><td class="memSeparator" colspan="2">&#160;</td></tr>
  140. <tr class="memitem:a44eb1bfcc3a3e5949ad053fc9ce55ce8"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a44eb1bfcc3a3e5949ad053fc9ce55ce8">loadProgram</a> (uint32_t index)</td></tr>
  141. <tr class="separator:a44eb1bfcc3a3e5949ad053fc9ce55ce8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  142. <tr class="memitem:a9cf24d4880f200eaeacd08a591d00d1f"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classString.html">String</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a9cf24d4880f200eaeacd08a591d00d1f">getState</a> (const char *key) const</td></tr>
  143. <tr class="separator:a9cf24d4880f200eaeacd08a591d00d1f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  144. <tr class="memitem:afcbb504b824bacea622de9bac09b2331"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#afcbb504b824bacea622de9bac09b2331">setState</a> (const char *key, const char *value)</td></tr>
  145. <tr class="separator:afcbb504b824bacea622de9bac09b2331"><td class="memSeparator" colspan="2">&#160;</td></tr>
  146. <tr class="memitem:aa5c1262f5ca20536bb5850fdd6faa22c"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#aa5c1262f5ca20536bb5850fdd6faa22c">activate</a> ()</td></tr>
  147. <tr class="separator:aa5c1262f5ca20536bb5850fdd6faa22c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  148. <tr class="memitem:aa089a56572bc8f1cb7e4b538c0d19c46"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#aa089a56572bc8f1cb7e4b538c0d19c46">deactivate</a> ()</td></tr>
  149. <tr class="separator:aa089a56572bc8f1cb7e4b538c0d19c46"><td class="memSeparator" colspan="2">&#160;</td></tr>
  150. <tr class="memitem:a0a969c78f8455ac6ba65fa42e8c498f6"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run</a> (const float **inputs, float **outputs, uint32_t frames, const <a class="el" href="structMidiEvent.html">MidiEvent</a> *midiEvents, uint32_t midiEventCount)=0</td></tr>
  151. <tr class="separator:a0a969c78f8455ac6ba65fa42e8c498f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  152. <tr class="memitem:a9f6c8ad6b054056649d0250e527e1297"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a9f6c8ad6b054056649d0250e527e1297">bufferSizeChanged</a> (uint32_t newBufferSize)</td></tr>
  153. <tr class="separator:a9f6c8ad6b054056649d0250e527e1297"><td class="memSeparator" colspan="2">&#160;</td></tr>
  154. <tr class="memitem:a2fcbfa1893f44e661d0d8cd53391dadc"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a2fcbfa1893f44e661d0d8cd53391dadc">sampleRateChanged</a> (double newSampleRate)</td></tr>
  155. <tr class="separator:a2fcbfa1893f44e661d0d8cd53391dadc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  156. <tr class="memitem:ac3a55830c3474a3dc663365d43b581c1"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ac3a55830c3474a3dc663365d43b581c1">ioChanged</a> (uint16_t numInputs, uint16_t numOutputs)</td></tr>
  157. <tr class="separator:ac3a55830c3474a3dc663365d43b581c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  158. </table><table class="memberdecls">
  159. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="friends"></a>
  160. Friends</h2></td></tr>
  161. <tr class="memitem:a37441261848b635971dab1ee767285dd"><td class="memItemLeft" align="right" valign="top"><a id="a37441261848b635971dab1ee767285dd"></a>
  162. class&#160;</td><td class="memItemRight" valign="bottom"><b>PluginExporter</b></td></tr>
  163. <tr class="separator:a37441261848b635971dab1ee767285dd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  164. </table>
  165. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  166. <div class="textblock"><p>DPF <a class="el" href="classPlugin.html">Plugin</a> class from where plugin instances are created.</p>
  167. <p>The public methods (Host state) are called from the plugin to get or set host information.<br />
  168. They can be called from a plugin instance at anytime unless stated otherwise.<br />
  169. All other methods are to be implemented by the plugin and will be called by the host.</p>
  170. <p>Shortly after a plugin instance is created, the various init* functions will be called by the host.<br />
  171. Host will call <a class="el" href="classPlugin.html#aa5c1262f5ca20536bb5850fdd6faa22c">activate()</a> before <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>, and <a class="el" href="classPlugin.html#aa089a56572bc8f1cb7e4b538c0d19c46">deactivate()</a> before the plugin instance is destroyed.<br />
  172. The host may call deactivate right after activate and vice-versa, but never activate/deactivate consecutively.<br />
  173. There is no limit on how many times <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> is called, only that activate/deactivate will be called in between.</p>
  174. <p>The buffer size and sample rate values will remain constant between activate and deactivate.<br />
  175. Buffer size is only a hint though, the host might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames.</p>
  176. <p>Some of this class functions are only available according to some macros.</p>
  177. <p>DISTRHO_PLUGIN_WANT_PROGRAMS activates program related features.<br />
  178. When enabled you need to implement <a class="el" href="classPlugin.html#a54d66af3111541b7c118f9749ef0231b">initProgramName()</a> and <a class="el" href="classPlugin.html#a44eb1bfcc3a3e5949ad053fc9ce55ce8">loadProgram()</a>.</p>
  179. <p>DISTRHO_PLUGIN_WANT_STATE activates internal state features.<br />
  180. When enabled you need to implement <a class="el" href="classPlugin.html#ad4ab623187f905c250a42284704eb840">initState()</a> and <a class="el" href="classPlugin.html#afcbb504b824bacea622de9bac09b2331">setState()</a>.</p>
  181. <p>The process function <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> changes wherever DISTRHO_PLUGIN_WANT_MIDI_INPUT is enabled or not.<br />
  182. When enabled it provides midi input events. </p>
  183. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  184. <a id="acb5a3632da5a5c4110172a3a78e1fd32"></a>
  185. <h2 class="memtitle"><span class="permalink"><a href="#acb5a3632da5a5c4110172a3a78e1fd32">&#9670;&nbsp;</a></span>Plugin()</h2>
  186. <div class="memitem">
  187. <div class="memproto">
  188. <table class="memname">
  189. <tr>
  190. <td class="memname">Plugin::Plugin </td>
  191. <td>(</td>
  192. <td class="paramtype">uint32_t&#160;</td>
  193. <td class="paramname"><em>parameterCount</em>, </td>
  194. </tr>
  195. <tr>
  196. <td class="paramkey"></td>
  197. <td></td>
  198. <td class="paramtype">uint32_t&#160;</td>
  199. <td class="paramname"><em>programCount</em>, </td>
  200. </tr>
  201. <tr>
  202. <td class="paramkey"></td>
  203. <td></td>
  204. <td class="paramtype">uint32_t&#160;</td>
  205. <td class="paramname"><em>stateCount</em>&#160;</td>
  206. </tr>
  207. <tr>
  208. <td></td>
  209. <td>)</td>
  210. <td></td><td></td>
  211. </tr>
  212. </table>
  213. </div><div class="memdoc">
  214. <p><a class="el" href="classPlugin.html">Plugin</a> class constructor.<br />
  215. You must set all parameter values to their defaults, matching <a class="el" href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">ParameterRanges::def</a>. </p>
  216. </div>
  217. </div>
  218. <a id="a89814b8f0b1c91e49140d42eb8331383"></a>
  219. <h2 class="memtitle"><span class="permalink"><a href="#a89814b8f0b1c91e49140d42eb8331383">&#9670;&nbsp;</a></span>~Plugin()</h2>
  220. <div class="memitem">
  221. <div class="memproto">
  222. <table class="mlabels">
  223. <tr>
  224. <td class="mlabels-left">
  225. <table class="memname">
  226. <tr>
  227. <td class="memname">virtual Plugin::~Plugin </td>
  228. <td>(</td>
  229. <td class="paramname"></td><td>)</td>
  230. <td></td>
  231. </tr>
  232. </table>
  233. </td>
  234. <td class="mlabels-right">
  235. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  236. </tr>
  237. </table>
  238. </div><div class="memdoc">
  239. <p>Destructor. </p>
  240. </div>
  241. </div>
  242. <h2 class="groupheader">Member Function Documentation</h2>
  243. <a id="a2643e638f62cfd4990247ec66bed60d2"></a>
  244. <h2 class="memtitle"><span class="permalink"><a href="#a2643e638f62cfd4990247ec66bed60d2">&#9670;&nbsp;</a></span>getBufferSize()</h2>
  245. <div class="memitem">
  246. <div class="memproto">
  247. <table class="mlabels">
  248. <tr>
  249. <td class="mlabels-left">
  250. <table class="memname">
  251. <tr>
  252. <td class="memname">uint32_t Plugin::getBufferSize </td>
  253. <td>(</td>
  254. <td class="paramname"></td><td>)</td>
  255. <td> const</td>
  256. </tr>
  257. </table>
  258. </td>
  259. <td class="mlabels-right">
  260. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  261. </tr>
  262. </table>
  263. </div><div class="memdoc">
  264. <p>Get the current buffer size that will probably be used during processing, in frames.<br />
  265. This value will remain constant between activate and deactivate. </p><dl class="section note"><dt>Note</dt><dd>This value is only a hint!<br />
  266. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  267. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a9f6c8ad6b054056649d0250e527e1297">bufferSizeChanged(uint32_t)</a> </dd></dl>
  268. </div>
  269. </div>
  270. <a id="a3e162cfe8f1c52bf09805fd327bcc3c4"></a>
  271. <h2 class="memtitle"><span class="permalink"><a href="#a3e162cfe8f1c52bf09805fd327bcc3c4">&#9670;&nbsp;</a></span>getSampleRate()</h2>
  272. <div class="memitem">
  273. <div class="memproto">
  274. <table class="mlabels">
  275. <tr>
  276. <td class="mlabels-left">
  277. <table class="memname">
  278. <tr>
  279. <td class="memname">double Plugin::getSampleRate </td>
  280. <td>(</td>
  281. <td class="paramname"></td><td>)</td>
  282. <td> const</td>
  283. </tr>
  284. </table>
  285. </td>
  286. <td class="mlabels-right">
  287. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  288. </tr>
  289. </table>
  290. </div><div class="memdoc">
  291. <p>Get the current sample rate that will be used during processing.<br />
  292. This value will remain constant between activate and deactivate. </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a2fcbfa1893f44e661d0d8cd53391dadc">sampleRateChanged(double)</a> </dd></dl>
  293. </div>
  294. </div>
  295. <a id="a5fd60c82f5a50f12312c57729885fc2f"></a>
  296. <h2 class="memtitle"><span class="permalink"><a href="#a5fd60c82f5a50f12312c57729885fc2f">&#9670;&nbsp;</a></span>getBundlePath()</h2>
  297. <div class="memitem">
  298. <div class="memproto">
  299. <table class="mlabels">
  300. <tr>
  301. <td class="mlabels-left">
  302. <table class="memname">
  303. <tr>
  304. <td class="memname">const char* Plugin::getBundlePath </td>
  305. <td>(</td>
  306. <td class="paramname"></td><td>)</td>
  307. <td> const</td>
  308. </tr>
  309. </table>
  310. </td>
  311. <td class="mlabels-right">
  312. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  313. </tr>
  314. </table>
  315. </div><div class="memdoc">
  316. <p>Get the bundle path where the plugin resides. Can return null if the plugin is not available in a bundle (if it is a single binary). </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="group__PluginRelatedUtilities.html#ga59aac78ab7142a37a7a2c5f0c7fd2a62">getBinaryFilename</a> </dd>
  317. <dd>
  318. <a class="el" href="group__PluginRelatedUtilities.html#ga53aa68de85dae4e3102b1c0551950b86">getResourcePath</a> </dd></dl>
  319. </div>
  320. </div>
  321. <a id="ab2c6b7bc2e0cdcd589cf9d03be831042"></a>
  322. <h2 class="memtitle"><span class="permalink"><a href="#ab2c6b7bc2e0cdcd589cf9d03be831042">&#9670;&nbsp;</a></span>isDummyInstance()</h2>
  323. <div class="memitem">
  324. <div class="memproto">
  325. <table class="mlabels">
  326. <tr>
  327. <td class="mlabels-left">
  328. <table class="memname">
  329. <tr>
  330. <td class="memname">bool Plugin::isDummyInstance </td>
  331. <td>(</td>
  332. <td class="paramname"></td><td>)</td>
  333. <td> const</td>
  334. </tr>
  335. </table>
  336. </td>
  337. <td class="mlabels-right">
  338. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  339. </tr>
  340. </table>
  341. </div><div class="memdoc">
  342. <p>Check if this plugin instance is a "dummy" one used for plugin meta-data/information export.<br />
  343. When true no processing will be done, the plugin is created only to extract information.<br />
  344. In DPF, LADSPA/DSSI, VST2 and VST3 formats create one global instance per plugin binary while LV2 creates one when generating turtle meta-data. </p>
  345. </div>
  346. </div>
  347. <a id="a8d07561f935bf9918e8b395e6eaabfa0"></a>
  348. <h2 class="memtitle"><span class="permalink"><a href="#a8d07561f935bf9918e8b395e6eaabfa0">&#9670;&nbsp;</a></span>isSelfTestInstance()</h2>
  349. <div class="memitem">
  350. <div class="memproto">
  351. <table class="mlabels">
  352. <tr>
  353. <td class="mlabels-left">
  354. <table class="memname">
  355. <tr>
  356. <td class="memname">bool Plugin::isSelfTestInstance </td>
  357. <td>(</td>
  358. <td class="paramname"></td><td>)</td>
  359. <td> const</td>
  360. </tr>
  361. </table>
  362. </td>
  363. <td class="mlabels-right">
  364. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  365. </tr>
  366. </table>
  367. </div><div class="memdoc">
  368. <p>Check if this plugin instance is a "selftest" one used for automated plugin tests.<br />
  369. To enable this mode build with <code>DPF_RUNTIME_TESTING</code> macro defined (i.e. set as compiler build flag), and run the JACK/Standalone executable with "selftest" as its only and single argument.</p>
  370. <p>A few basic DSP and <a class="el" href="classUI.html">UI</a> tests will run in self-test mode, with once instance having this function returning true.<br />
  371. You can use this chance to do a few tests of your own as well. </p>
  372. </div>
  373. </div>
  374. <a id="ae85d602c430b1a4361a88d714d3a42c1"></a>
  375. <h2 class="memtitle"><span class="permalink"><a href="#ae85d602c430b1a4361a88d714d3a42c1">&#9670;&nbsp;</a></span>getTimePosition()</h2>
  376. <div class="memitem">
  377. <div class="memproto">
  378. <table class="mlabels">
  379. <tr>
  380. <td class="mlabels-left">
  381. <table class="memname">
  382. <tr>
  383. <td class="memname">const <a class="el" href="structTimePosition.html">TimePosition</a>&amp; Plugin::getTimePosition </td>
  384. <td>(</td>
  385. <td class="paramname"></td><td>)</td>
  386. <td> const</td>
  387. </tr>
  388. </table>
  389. </td>
  390. <td class="mlabels-right">
  391. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  392. </tr>
  393. </table>
  394. </div><div class="memdoc">
  395. <p>Get the current host transport time position.<br />
  396. This function should only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  397. You can call this during other times, but the returned position is not guaranteed to be in sync. </p><dl class="section note"><dt>Note</dt><dd><a class="el" href="structTimePosition.html">TimePosition</a> is not supported in LADSPA and DSSI plugin formats. </dd></dl>
  398. </div>
  399. </div>
  400. <a id="a2a70c4ec55d74d9bc26862975d8df8a7"></a>
  401. <h2 class="memtitle"><span class="permalink"><a href="#a2a70c4ec55d74d9bc26862975d8df8a7">&#9670;&nbsp;</a></span>setLatency()</h2>
  402. <div class="memitem">
  403. <div class="memproto">
  404. <table class="mlabels">
  405. <tr>
  406. <td class="mlabels-left">
  407. <table class="memname">
  408. <tr>
  409. <td class="memname">void Plugin::setLatency </td>
  410. <td>(</td>
  411. <td class="paramtype">uint32_t&#160;</td>
  412. <td class="paramname"><em>frames</em></td><td>)</td>
  413. <td></td>
  414. </tr>
  415. </table>
  416. </td>
  417. <td class="mlabels-right">
  418. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  419. </tr>
  420. </table>
  421. </div><div class="memdoc">
  422. <p>Change the plugin audio output latency to <em>frames</em>.<br />
  423. This function should only be called in the constructor, <a class="el" href="classPlugin.html#aa5c1262f5ca20536bb5850fdd6faa22c">activate()</a> and <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>. </p><dl class="section note"><dt>Note</dt><dd>This function is only available if DISTRHO_PLUGIN_WANT_LATENCY is enabled. </dd></dl>
  424. </div>
  425. </div>
  426. <a id="a0467eef817ac130cbbe1c0fbe09660c6"></a>
  427. <h2 class="memtitle"><span class="permalink"><a href="#a0467eef817ac130cbbe1c0fbe09660c6">&#9670;&nbsp;</a></span>writeMidiEvent()</h2>
  428. <div class="memitem">
  429. <div class="memproto">
  430. <table class="mlabels">
  431. <tr>
  432. <td class="mlabels-left">
  433. <table class="memname">
  434. <tr>
  435. <td class="memname">bool Plugin::writeMidiEvent </td>
  436. <td>(</td>
  437. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> &amp;&#160;</td>
  438. <td class="paramname"><em>midiEvent</em></td><td>)</td>
  439. <td></td>
  440. </tr>
  441. </table>
  442. </td>
  443. <td class="mlabels-right">
  444. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  445. </tr>
  446. </table>
  447. </div><div class="memdoc">
  448. <p>Write a MIDI output event.<br />
  449. This function must only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  450. Returns false when the host buffer is full, in which case do not call this again until the next <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>. </p>
  451. </div>
  452. </div>
  453. <a id="a581614e1d301ee613a988855c61b2517"></a>
  454. <h2 class="memtitle"><span class="permalink"><a href="#a581614e1d301ee613a988855c61b2517">&#9670;&nbsp;</a></span>canRequestParameterValueChanges()</h2>
  455. <div class="memitem">
  456. <div class="memproto">
  457. <table class="mlabels">
  458. <tr>
  459. <td class="mlabels-left">
  460. <table class="memname">
  461. <tr>
  462. <td class="memname">bool Plugin::canRequestParameterValueChanges </td>
  463. <td>(</td>
  464. <td class="paramname"></td><td>)</td>
  465. <td> const</td>
  466. </tr>
  467. </table>
  468. </td>
  469. <td class="mlabels-right">
  470. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  471. </tr>
  472. </table>
  473. </div><div class="memdoc">
  474. <p>Check if parameter value change requests will work with the current plugin host. </p><dl class="section note"><dt>Note</dt><dd>This function is only available if DISTRHO_PLUGIN_WANT_PARAMETER_VALUE_CHANGE_REQUEST is enabled. </dd></dl>
  475. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#ae65d8603022c09d1ce2ee5cf568de70f">requestParameterValueChange(uint32_t, float)</a> </dd></dl>
  476. </div>
  477. </div>
  478. <a id="ae65d8603022c09d1ce2ee5cf568de70f"></a>
  479. <h2 class="memtitle"><span class="permalink"><a href="#ae65d8603022c09d1ce2ee5cf568de70f">&#9670;&nbsp;</a></span>requestParameterValueChange()</h2>
  480. <div class="memitem">
  481. <div class="memproto">
  482. <table class="mlabels">
  483. <tr>
  484. <td class="mlabels-left">
  485. <table class="memname">
  486. <tr>
  487. <td class="memname">bool Plugin::requestParameterValueChange </td>
  488. <td>(</td>
  489. <td class="paramtype">uint32_t&#160;</td>
  490. <td class="paramname"><em>index</em>, </td>
  491. </tr>
  492. <tr>
  493. <td class="paramkey"></td>
  494. <td></td>
  495. <td class="paramtype">float&#160;</td>
  496. <td class="paramname"><em>value</em>&#160;</td>
  497. </tr>
  498. <tr>
  499. <td></td>
  500. <td>)</td>
  501. <td></td><td></td>
  502. </tr>
  503. </table>
  504. </td>
  505. <td class="mlabels-right">
  506. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  507. </tr>
  508. </table>
  509. </div><div class="memdoc">
  510. <p>Request a parameter value change from the host. If successful, this function will automatically trigger a parameter update on the <a class="el" href="classUI.html">UI</a> side as well. This function can fail, for example if the host is busy with the parameter for read-only automation. Some hosts simply do not have this functionality, which can be verified with <a class="el" href="classPlugin.html#a581614e1d301ee613a988855c61b2517">canRequestParameterValueChanges()</a>. </p><dl class="section note"><dt>Note</dt><dd>This function is only available if DISTRHO_PLUGIN_WANT_PARAMETER_VALUE_CHANGE_REQUEST is enabled. </dd></dl>
  511. </div>
  512. </div>
  513. <a id="aa85c50c732d9083f57b72d6b4cd7c5ae"></a>
  514. <h2 class="memtitle"><span class="permalink"><a href="#aa85c50c732d9083f57b72d6b4cd7c5ae">&#9670;&nbsp;</a></span>updateStateValue()</h2>
  515. <div class="memitem">
  516. <div class="memproto">
  517. <table class="mlabels">
  518. <tr>
  519. <td class="mlabels-left">
  520. <table class="memname">
  521. <tr>
  522. <td class="memname">bool Plugin::updateStateValue </td>
  523. <td>(</td>
  524. <td class="paramtype">const char *&#160;</td>
  525. <td class="paramname"><em>key</em>, </td>
  526. </tr>
  527. <tr>
  528. <td class="paramkey"></td>
  529. <td></td>
  530. <td class="paramtype">const char *&#160;</td>
  531. <td class="paramname"><em>value</em>&#160;</td>
  532. </tr>
  533. <tr>
  534. <td></td>
  535. <td>)</td>
  536. <td></td><td></td>
  537. </tr>
  538. </table>
  539. </td>
  540. <td class="mlabels-right">
  541. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  542. </tr>
  543. </table>
  544. </div><div class="memdoc">
  545. <p>Set state value and notify the host about the change.<br />
  546. This function will call <code><a class="el" href="classPlugin.html#afcbb504b824bacea622de9bac09b2331">setState()</a></code> and also trigger an update on the <a class="el" href="classUI.html">UI</a> side as necessary.<br />
  547. It must not be called during run.<br />
  548. The state must be host readable. </p><dl class="section note"><dt>Note</dt><dd>this function does nothing on DSSI plugin format, as DSSI only supports UI-&gt;DSP messages.</dd></dl>
  549. <p>TODO API under construction </p>
  550. </div>
  551. </div>
  552. <a id="aebb5df5cde162462dc460d4fd45dae75"></a>
  553. <h2 class="memtitle"><span class="permalink"><a href="#aebb5df5cde162462dc460d4fd45dae75">&#9670;&nbsp;</a></span>getName()</h2>
  554. <div class="memitem">
  555. <div class="memproto">
  556. <table class="mlabels">
  557. <tr>
  558. <td class="mlabels-left">
  559. <table class="memname">
  560. <tr>
  561. <td class="memname">virtual const char* Plugin::getName </td>
  562. <td>(</td>
  563. <td class="paramname"></td><td>)</td>
  564. <td> const</td>
  565. </tr>
  566. </table>
  567. </td>
  568. <td class="mlabels-right">
  569. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  570. </tr>
  571. </table>
  572. </div><div class="memdoc">
  573. <p>Get the plugin name.<br />
  574. Returns DISTRHO_PLUGIN_NAME by default. </p>
  575. </div>
  576. </div>
  577. <a id="a00f7945c16149db6845fbcc2af729f4f"></a>
  578. <h2 class="memtitle"><span class="permalink"><a href="#a00f7945c16149db6845fbcc2af729f4f">&#9670;&nbsp;</a></span>getLabel()</h2>
  579. <div class="memitem">
  580. <div class="memproto">
  581. <table class="mlabels">
  582. <tr>
  583. <td class="mlabels-left">
  584. <table class="memname">
  585. <tr>
  586. <td class="memname">virtual const char* Plugin::getLabel </td>
  587. <td>(</td>
  588. <td class="paramname"></td><td>)</td>
  589. <td> const</td>
  590. </tr>
  591. </table>
  592. </td>
  593. <td class="mlabels-right">
  594. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  595. </tr>
  596. </table>
  597. </div><div class="memdoc">
  598. <p>Get the plugin label.<br />
  599. This label is a short restricted name consisting of only _, a-z, A-Z and 0-9 characters. </p>
  600. </div>
  601. </div>
  602. <a id="a30db5eef9de617f4c81d5c6925facea3"></a>
  603. <h2 class="memtitle"><span class="permalink"><a href="#a30db5eef9de617f4c81d5c6925facea3">&#9670;&nbsp;</a></span>getDescription()</h2>
  604. <div class="memitem">
  605. <div class="memproto">
  606. <table class="mlabels">
  607. <tr>
  608. <td class="mlabels-left">
  609. <table class="memname">
  610. <tr>
  611. <td class="memname">virtual const char* Plugin::getDescription </td>
  612. <td>(</td>
  613. <td class="paramname"></td><td>)</td>
  614. <td> const</td>
  615. </tr>
  616. </table>
  617. </td>
  618. <td class="mlabels-right">
  619. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  620. </tr>
  621. </table>
  622. </div><div class="memdoc">
  623. <p>Get an extensive comment/description about the plugin.<br />
  624. Optional, returns nothing by default. </p>
  625. </div>
  626. </div>
  627. <a id="a955832840de786a7a22798f0ef451c5d"></a>
  628. <h2 class="memtitle"><span class="permalink"><a href="#a955832840de786a7a22798f0ef451c5d">&#9670;&nbsp;</a></span>getMaker()</h2>
  629. <div class="memitem">
  630. <div class="memproto">
  631. <table class="mlabels">
  632. <tr>
  633. <td class="mlabels-left">
  634. <table class="memname">
  635. <tr>
  636. <td class="memname">virtual const char* Plugin::getMaker </td>
  637. <td>(</td>
  638. <td class="paramname"></td><td>)</td>
  639. <td> const</td>
  640. </tr>
  641. </table>
  642. </td>
  643. <td class="mlabels-right">
  644. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  645. </tr>
  646. </table>
  647. </div><div class="memdoc">
  648. <p>Get the plugin author/maker. </p>
  649. </div>
  650. </div>
  651. <a id="ad12c681ce31004da0badd609763f45c5"></a>
  652. <h2 class="memtitle"><span class="permalink"><a href="#ad12c681ce31004da0badd609763f45c5">&#9670;&nbsp;</a></span>getHomePage()</h2>
  653. <div class="memitem">
  654. <div class="memproto">
  655. <table class="mlabels">
  656. <tr>
  657. <td class="mlabels-left">
  658. <table class="memname">
  659. <tr>
  660. <td class="memname">virtual const char* Plugin::getHomePage </td>
  661. <td>(</td>
  662. <td class="paramname"></td><td>)</td>
  663. <td> const</td>
  664. </tr>
  665. </table>
  666. </td>
  667. <td class="mlabels-right">
  668. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  669. </tr>
  670. </table>
  671. </div><div class="memdoc">
  672. <p>Get the plugin homepage.<br />
  673. Optional, returns nothing by default. </p>
  674. </div>
  675. </div>
  676. <a id="a686a3c92a376a185d6fd97efd59125d1"></a>
  677. <h2 class="memtitle"><span class="permalink"><a href="#a686a3c92a376a185d6fd97efd59125d1">&#9670;&nbsp;</a></span>getLicense()</h2>
  678. <div class="memitem">
  679. <div class="memproto">
  680. <table class="mlabels">
  681. <tr>
  682. <td class="mlabels-left">
  683. <table class="memname">
  684. <tr>
  685. <td class="memname">virtual const char* Plugin::getLicense </td>
  686. <td>(</td>
  687. <td class="paramname"></td><td>)</td>
  688. <td> const</td>
  689. </tr>
  690. </table>
  691. </td>
  692. <td class="mlabels-right">
  693. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  694. </tr>
  695. </table>
  696. </div><div class="memdoc">
  697. <p>Get the plugin license (a single line of text or a URL).<br />
  698. For commercial plugins this should return some short copyright information. </p>
  699. </div>
  700. </div>
  701. <a id="abae540dd93caf4834270358a8aad334a"></a>
  702. <h2 class="memtitle"><span class="permalink"><a href="#abae540dd93caf4834270358a8aad334a">&#9670;&nbsp;</a></span>getVersion()</h2>
  703. <div class="memitem">
  704. <div class="memproto">
  705. <table class="mlabels">
  706. <tr>
  707. <td class="mlabels-left">
  708. <table class="memname">
  709. <tr>
  710. <td class="memname">virtual uint32_t Plugin::getVersion </td>
  711. <td>(</td>
  712. <td class="paramname"></td><td>)</td>
  713. <td> const</td>
  714. </tr>
  715. </table>
  716. </td>
  717. <td class="mlabels-right">
  718. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  719. </tr>
  720. </table>
  721. </div><div class="memdoc">
  722. <p>Get the plugin version, in hexadecimal. </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="group__MiscellaneousFunctions.html#ga95d67ff74d46b2c80f15c7790a523154">d_version()</a> </dd></dl>
  723. </div>
  724. </div>
  725. <a id="ad6ff8c80227d5ceebd40b96f3be29a66"></a>
  726. <h2 class="memtitle"><span class="permalink"><a href="#ad6ff8c80227d5ceebd40b96f3be29a66">&#9670;&nbsp;</a></span>getUniqueId()</h2>
  727. <div class="memitem">
  728. <div class="memproto">
  729. <table class="mlabels">
  730. <tr>
  731. <td class="mlabels-left">
  732. <table class="memname">
  733. <tr>
  734. <td class="memname">virtual int64_t Plugin::getUniqueId </td>
  735. <td>(</td>
  736. <td class="paramname"></td><td>)</td>
  737. <td> const</td>
  738. </tr>
  739. </table>
  740. </td>
  741. <td class="mlabels-right">
  742. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  743. </tr>
  744. </table>
  745. </div><div class="memdoc">
  746. <p>Get the plugin unique Id.<br />
  747. This value is used by LADSPA, DSSI, VST2, VST3 and AUv2 plugin formats.<br />
  748. </p><dl class="section note"><dt>Note</dt><dd>It is preferred that you set DISTRHO_PLUGIN_UNIQUE_ID macro instead of overriding this call, as that is required for AUv2 plugins anyhow. </dd></dl>
  749. <dl class="section see"><dt>See also</dt><dd><a class="el" href="group__MiscellaneousFunctions.html#ga6827e90feb9bdcb6f76175a245fbf12c">d_cconst()</a> </dd></dl>
  750. </div>
  751. </div>
  752. <a id="a75f30935198a0acba25f4ea92af72dc4"></a>
  753. <h2 class="memtitle"><span class="permalink"><a href="#a75f30935198a0acba25f4ea92af72dc4">&#9670;&nbsp;</a></span>initAudioPort()</h2>
  754. <div class="memitem">
  755. <div class="memproto">
  756. <table class="mlabels">
  757. <tr>
  758. <td class="mlabels-left">
  759. <table class="memname">
  760. <tr>
  761. <td class="memname">virtual void Plugin::initAudioPort </td>
  762. <td>(</td>
  763. <td class="paramtype">bool&#160;</td>
  764. <td class="paramname"><em>input</em>, </td>
  765. </tr>
  766. <tr>
  767. <td class="paramkey"></td>
  768. <td></td>
  769. <td class="paramtype">uint32_t&#160;</td>
  770. <td class="paramname"><em>index</em>, </td>
  771. </tr>
  772. <tr>
  773. <td class="paramkey"></td>
  774. <td></td>
  775. <td class="paramtype"><a class="el" href="structAudioPort.html">AudioPort</a> &amp;&#160;</td>
  776. <td class="paramname"><em>port</em>&#160;</td>
  777. </tr>
  778. <tr>
  779. <td></td>
  780. <td>)</td>
  781. <td></td><td></td>
  782. </tr>
  783. </table>
  784. </td>
  785. <td class="mlabels-right">
  786. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  787. </tr>
  788. </table>
  789. </div><div class="memdoc">
  790. <p>Initialize the audio port <em>index</em>.<br />
  791. This function will be called once, shortly after the plugin is created. </p>
  792. </div>
  793. </div>
  794. <a id="aacf87bd0037efeb3b60d204940f3f4a0"></a>
  795. <h2 class="memtitle"><span class="permalink"><a href="#aacf87bd0037efeb3b60d204940f3f4a0">&#9670;&nbsp;</a></span>initParameter()</h2>
  796. <div class="memitem">
  797. <div class="memproto">
  798. <table class="mlabels">
  799. <tr>
  800. <td class="mlabels-left">
  801. <table class="memname">
  802. <tr>
  803. <td class="memname">virtual void Plugin::initParameter </td>
  804. <td>(</td>
  805. <td class="paramtype">uint32_t&#160;</td>
  806. <td class="paramname"><em>index</em>, </td>
  807. </tr>
  808. <tr>
  809. <td class="paramkey"></td>
  810. <td></td>
  811. <td class="paramtype"><a class="el" href="structParameter.html">Parameter</a> &amp;&#160;</td>
  812. <td class="paramname"><em>parameter</em>&#160;</td>
  813. </tr>
  814. <tr>
  815. <td></td>
  816. <td>)</td>
  817. <td></td><td></td>
  818. </tr>
  819. </table>
  820. </td>
  821. <td class="mlabels-right">
  822. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  823. </tr>
  824. </table>
  825. </div><div class="memdoc">
  826. <p>Initialize the parameter <em>index</em>.<br />
  827. This function will be called once, shortly after the plugin is created. </p>
  828. </div>
  829. </div>
  830. <a id="a71b876c8157b087b3552960f2877a44d"></a>
  831. <h2 class="memtitle"><span class="permalink"><a href="#a71b876c8157b087b3552960f2877a44d">&#9670;&nbsp;</a></span>initPortGroup()</h2>
  832. <div class="memitem">
  833. <div class="memproto">
  834. <table class="mlabels">
  835. <tr>
  836. <td class="mlabels-left">
  837. <table class="memname">
  838. <tr>
  839. <td class="memname">virtual void Plugin::initPortGroup </td>
  840. <td>(</td>
  841. <td class="paramtype">uint32_t&#160;</td>
  842. <td class="paramname"><em>groupId</em>, </td>
  843. </tr>
  844. <tr>
  845. <td class="paramkey"></td>
  846. <td></td>
  847. <td class="paramtype"><a class="el" href="structPortGroup.html">PortGroup</a> &amp;&#160;</td>
  848. <td class="paramname"><em>portGroup</em>&#160;</td>
  849. </tr>
  850. <tr>
  851. <td></td>
  852. <td>)</td>
  853. <td></td><td></td>
  854. </tr>
  855. </table>
  856. </td>
  857. <td class="mlabels-right">
  858. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  859. </tr>
  860. </table>
  861. </div><div class="memdoc">
  862. <p>Initialize the port group <em>groupId</em>.<br />
  863. This function will be called once, shortly after the plugin is created and all audio ports and parameters have been enumerated. </p>
  864. </div>
  865. </div>
  866. <a id="a54d66af3111541b7c118f9749ef0231b"></a>
  867. <h2 class="memtitle"><span class="permalink"><a href="#a54d66af3111541b7c118f9749ef0231b">&#9670;&nbsp;</a></span>initProgramName()</h2>
  868. <div class="memitem">
  869. <div class="memproto">
  870. <table class="mlabels">
  871. <tr>
  872. <td class="mlabels-left">
  873. <table class="memname">
  874. <tr>
  875. <td class="memname">virtual void Plugin::initProgramName </td>
  876. <td>(</td>
  877. <td class="paramtype">uint32_t&#160;</td>
  878. <td class="paramname"><em>index</em>, </td>
  879. </tr>
  880. <tr>
  881. <td class="paramkey"></td>
  882. <td></td>
  883. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  884. <td class="paramname"><em>programName</em>&#160;</td>
  885. </tr>
  886. <tr>
  887. <td></td>
  888. <td>)</td>
  889. <td></td><td></td>
  890. </tr>
  891. </table>
  892. </td>
  893. <td class="mlabels-right">
  894. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  895. </tr>
  896. </table>
  897. </div><div class="memdoc">
  898. <p>Set the name of the program <em>index</em>.<br />
  899. This function will be called once, shortly after the plugin is created.<br />
  900. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  901. </div>
  902. </div>
  903. <a id="ad4ab623187f905c250a42284704eb840"></a>
  904. <h2 class="memtitle"><span class="permalink"><a href="#ad4ab623187f905c250a42284704eb840">&#9670;&nbsp;</a></span>initState()</h2>
  905. <div class="memitem">
  906. <div class="memproto">
  907. <table class="mlabels">
  908. <tr>
  909. <td class="mlabels-left">
  910. <table class="memname">
  911. <tr>
  912. <td class="memname">virtual void Plugin::initState </td>
  913. <td>(</td>
  914. <td class="paramtype">uint32_t&#160;</td>
  915. <td class="paramname"><em>index</em>, </td>
  916. </tr>
  917. <tr>
  918. <td class="paramkey"></td>
  919. <td></td>
  920. <td class="paramtype"><a class="el" href="structState.html">State</a> &amp;&#160;</td>
  921. <td class="paramname"><em>state</em>&#160;</td>
  922. </tr>
  923. <tr>
  924. <td></td>
  925. <td>)</td>
  926. <td></td><td></td>
  927. </tr>
  928. </table>
  929. </td>
  930. <td class="mlabels-right">
  931. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  932. </tr>
  933. </table>
  934. </div><div class="memdoc">
  935. <p>Initialize the state <em>index</em>.<br />
  936. This function will be called once, shortly after the plugin is created.<br />
  937. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  938. </div>
  939. </div>
  940. <a id="af9e9f5438e2e0c2352052eb5f95832aa"></a>
  941. <h2 class="memtitle"><span class="permalink"><a href="#af9e9f5438e2e0c2352052eb5f95832aa">&#9670;&nbsp;</a></span>getParameterValue()</h2>
  942. <div class="memitem">
  943. <div class="memproto">
  944. <table class="mlabels">
  945. <tr>
  946. <td class="mlabels-left">
  947. <table class="memname">
  948. <tr>
  949. <td class="memname">virtual float Plugin::getParameterValue </td>
  950. <td>(</td>
  951. <td class="paramtype">uint32_t&#160;</td>
  952. <td class="paramname"><em>index</em></td><td>)</td>
  953. <td> const</td>
  954. </tr>
  955. </table>
  956. </td>
  957. <td class="mlabels-right">
  958. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  959. </tr>
  960. </table>
  961. </div><div class="memdoc">
  962. <p>Get the current value of a parameter.<br />
  963. The host may call this function from any context, including realtime processing. </p>
  964. </div>
  965. </div>
  966. <a id="a7e9e26ceafc7603ef6163483a9dc39be"></a>
  967. <h2 class="memtitle"><span class="permalink"><a href="#a7e9e26ceafc7603ef6163483a9dc39be">&#9670;&nbsp;</a></span>setParameterValue()</h2>
  968. <div class="memitem">
  969. <div class="memproto">
  970. <table class="mlabels">
  971. <tr>
  972. <td class="mlabels-left">
  973. <table class="memname">
  974. <tr>
  975. <td class="memname">virtual void Plugin::setParameterValue </td>
  976. <td>(</td>
  977. <td class="paramtype">uint32_t&#160;</td>
  978. <td class="paramname"><em>index</em>, </td>
  979. </tr>
  980. <tr>
  981. <td class="paramkey"></td>
  982. <td></td>
  983. <td class="paramtype">float&#160;</td>
  984. <td class="paramname"><em>value</em>&#160;</td>
  985. </tr>
  986. <tr>
  987. <td></td>
  988. <td>)</td>
  989. <td></td><td></td>
  990. </tr>
  991. </table>
  992. </td>
  993. <td class="mlabels-right">
  994. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  995. </tr>
  996. </table>
  997. </div><div class="memdoc">
  998. <p>Change a parameter value.<br />
  999. The host may call this function from any context, including realtime processing.<br />
  1000. When a parameter is marked as automatable, you must ensure no non-realtime operations are performed. </p><dl class="section note"><dt>Note</dt><dd>This function will only be called for parameter inputs. </dd></dl>
  1001. </div>
  1002. </div>
  1003. <a id="a44eb1bfcc3a3e5949ad053fc9ce55ce8"></a>
  1004. <h2 class="memtitle"><span class="permalink"><a href="#a44eb1bfcc3a3e5949ad053fc9ce55ce8">&#9670;&nbsp;</a></span>loadProgram()</h2>
  1005. <div class="memitem">
  1006. <div class="memproto">
  1007. <table class="mlabels">
  1008. <tr>
  1009. <td class="mlabels-left">
  1010. <table class="memname">
  1011. <tr>
  1012. <td class="memname">virtual void Plugin::loadProgram </td>
  1013. <td>(</td>
  1014. <td class="paramtype">uint32_t&#160;</td>
  1015. <td class="paramname"><em>index</em></td><td>)</td>
  1016. <td></td>
  1017. </tr>
  1018. </table>
  1019. </td>
  1020. <td class="mlabels-right">
  1021. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1022. </tr>
  1023. </table>
  1024. </div><div class="memdoc">
  1025. <p>Load a program.<br />
  1026. The host may call this function from any context, including realtime processing.<br />
  1027. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  1028. </div>
  1029. </div>
  1030. <a id="a9cf24d4880f200eaeacd08a591d00d1f"></a>
  1031. <h2 class="memtitle"><span class="permalink"><a href="#a9cf24d4880f200eaeacd08a591d00d1f">&#9670;&nbsp;</a></span>getState()</h2>
  1032. <div class="memitem">
  1033. <div class="memproto">
  1034. <table class="mlabels">
  1035. <tr>
  1036. <td class="mlabels-left">
  1037. <table class="memname">
  1038. <tr>
  1039. <td class="memname">virtual <a class="el" href="classString.html">String</a> Plugin::getState </td>
  1040. <td>(</td>
  1041. <td class="paramtype">const char *&#160;</td>
  1042. <td class="paramname"><em>key</em></td><td>)</td>
  1043. <td> const</td>
  1044. </tr>
  1045. </table>
  1046. </td>
  1047. <td class="mlabels-right">
  1048. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1049. </tr>
  1050. </table>
  1051. </div><div class="memdoc">
  1052. <p>Get the value of an internal state.<br />
  1053. The host may call this function from any non-realtime context.<br />
  1054. Must be implemented by your plugin class if DISTRHO_PLUGIN_WANT_FULL_STATE is enabled. </p><dl class="section note"><dt>Note</dt><dd>The use of this function breaks compatibility with the DSSI format. </dd></dl>
  1055. </div>
  1056. </div>
  1057. <a id="afcbb504b824bacea622de9bac09b2331"></a>
  1058. <h2 class="memtitle"><span class="permalink"><a href="#afcbb504b824bacea622de9bac09b2331">&#9670;&nbsp;</a></span>setState()</h2>
  1059. <div class="memitem">
  1060. <div class="memproto">
  1061. <table class="mlabels">
  1062. <tr>
  1063. <td class="mlabels-left">
  1064. <table class="memname">
  1065. <tr>
  1066. <td class="memname">virtual void Plugin::setState </td>
  1067. <td>(</td>
  1068. <td class="paramtype">const char *&#160;</td>
  1069. <td class="paramname"><em>key</em>, </td>
  1070. </tr>
  1071. <tr>
  1072. <td class="paramkey"></td>
  1073. <td></td>
  1074. <td class="paramtype">const char *&#160;</td>
  1075. <td class="paramname"><em>value</em>&#160;</td>
  1076. </tr>
  1077. <tr>
  1078. <td></td>
  1079. <td>)</td>
  1080. <td></td><td></td>
  1081. </tr>
  1082. </table>
  1083. </td>
  1084. <td class="mlabels-right">
  1085. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1086. </tr>
  1087. </table>
  1088. </div><div class="memdoc">
  1089. <p>Change an internal state <em>key</em> to <em>value</em>.<br />
  1090. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  1091. </div>
  1092. </div>
  1093. <a id="aa5c1262f5ca20536bb5850fdd6faa22c"></a>
  1094. <h2 class="memtitle"><span class="permalink"><a href="#aa5c1262f5ca20536bb5850fdd6faa22c">&#9670;&nbsp;</a></span>activate()</h2>
  1095. <div class="memitem">
  1096. <div class="memproto">
  1097. <table class="mlabels">
  1098. <tr>
  1099. <td class="mlabels-left">
  1100. <table class="memname">
  1101. <tr>
  1102. <td class="memname">virtual void Plugin::activate </td>
  1103. <td>(</td>
  1104. <td class="paramname"></td><td>)</td>
  1105. <td></td>
  1106. </tr>
  1107. </table>
  1108. </td>
  1109. <td class="mlabels-right">
  1110. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1111. </tr>
  1112. </table>
  1113. </div><div class="memdoc">
  1114. <p>Activate this plugin. </p>
  1115. </div>
  1116. </div>
  1117. <a id="aa089a56572bc8f1cb7e4b538c0d19c46"></a>
  1118. <h2 class="memtitle"><span class="permalink"><a href="#aa089a56572bc8f1cb7e4b538c0d19c46">&#9670;&nbsp;</a></span>deactivate()</h2>
  1119. <div class="memitem">
  1120. <div class="memproto">
  1121. <table class="mlabels">
  1122. <tr>
  1123. <td class="mlabels-left">
  1124. <table class="memname">
  1125. <tr>
  1126. <td class="memname">virtual void Plugin::deactivate </td>
  1127. <td>(</td>
  1128. <td class="paramname"></td><td>)</td>
  1129. <td></td>
  1130. </tr>
  1131. </table>
  1132. </td>
  1133. <td class="mlabels-right">
  1134. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1135. </tr>
  1136. </table>
  1137. </div><div class="memdoc">
  1138. <p>Deactivate this plugin. </p>
  1139. </div>
  1140. </div>
  1141. <a id="a0a969c78f8455ac6ba65fa42e8c498f6"></a>
  1142. <h2 class="memtitle"><span class="permalink"><a href="#a0a969c78f8455ac6ba65fa42e8c498f6">&#9670;&nbsp;</a></span>run()</h2>
  1143. <div class="memitem">
  1144. <div class="memproto">
  1145. <table class="mlabels">
  1146. <tr>
  1147. <td class="mlabels-left">
  1148. <table class="memname">
  1149. <tr>
  1150. <td class="memname">virtual void Plugin::run </td>
  1151. <td>(</td>
  1152. <td class="paramtype">const float **&#160;</td>
  1153. <td class="paramname"><em>inputs</em>, </td>
  1154. </tr>
  1155. <tr>
  1156. <td class="paramkey"></td>
  1157. <td></td>
  1158. <td class="paramtype">float **&#160;</td>
  1159. <td class="paramname"><em>outputs</em>, </td>
  1160. </tr>
  1161. <tr>
  1162. <td class="paramkey"></td>
  1163. <td></td>
  1164. <td class="paramtype">uint32_t&#160;</td>
  1165. <td class="paramname"><em>frames</em>, </td>
  1166. </tr>
  1167. <tr>
  1168. <td class="paramkey"></td>
  1169. <td></td>
  1170. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> *&#160;</td>
  1171. <td class="paramname"><em>midiEvents</em>, </td>
  1172. </tr>
  1173. <tr>
  1174. <td class="paramkey"></td>
  1175. <td></td>
  1176. <td class="paramtype">uint32_t&#160;</td>
  1177. <td class="paramname"><em>midiEventCount</em>&#160;</td>
  1178. </tr>
  1179. <tr>
  1180. <td></td>
  1181. <td>)</td>
  1182. <td></td><td></td>
  1183. </tr>
  1184. </table>
  1185. </td>
  1186. <td class="mlabels-right">
  1187. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1188. </tr>
  1189. </table>
  1190. </div><div class="memdoc">
  1191. <p>Run/process function for plugins with MIDI input. </p><dl class="section note"><dt>Note</dt><dd>Some parameters might be null if there are no audio inputs/outputs or MIDI events. </dd></dl>
  1192. </div>
  1193. </div>
  1194. <a id="a9f6c8ad6b054056649d0250e527e1297"></a>
  1195. <h2 class="memtitle"><span class="permalink"><a href="#a9f6c8ad6b054056649d0250e527e1297">&#9670;&nbsp;</a></span>bufferSizeChanged()</h2>
  1196. <div class="memitem">
  1197. <div class="memproto">
  1198. <table class="mlabels">
  1199. <tr>
  1200. <td class="mlabels-left">
  1201. <table class="memname">
  1202. <tr>
  1203. <td class="memname">virtual void Plugin::bufferSizeChanged </td>
  1204. <td>(</td>
  1205. <td class="paramtype">uint32_t&#160;</td>
  1206. <td class="paramname"><em>newBufferSize</em></td><td>)</td>
  1207. <td></td>
  1208. </tr>
  1209. </table>
  1210. </td>
  1211. <td class="mlabels-right">
  1212. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1213. </tr>
  1214. </table>
  1215. </div><div class="memdoc">
  1216. <p>Optional callback to inform the plugin about a buffer size change.<br />
  1217. This function will only be called when the plugin is deactivated. </p><dl class="section note"><dt>Note</dt><dd>This value is only a hint!<br />
  1218. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  1219. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a2643e638f62cfd4990247ec66bed60d2">getBufferSize()</a> </dd></dl>
  1220. </div>
  1221. </div>
  1222. <a id="a2fcbfa1893f44e661d0d8cd53391dadc"></a>
  1223. <h2 class="memtitle"><span class="permalink"><a href="#a2fcbfa1893f44e661d0d8cd53391dadc">&#9670;&nbsp;</a></span>sampleRateChanged()</h2>
  1224. <div class="memitem">
  1225. <div class="memproto">
  1226. <table class="mlabels">
  1227. <tr>
  1228. <td class="mlabels-left">
  1229. <table class="memname">
  1230. <tr>
  1231. <td class="memname">virtual void Plugin::sampleRateChanged </td>
  1232. <td>(</td>
  1233. <td class="paramtype">double&#160;</td>
  1234. <td class="paramname"><em>newSampleRate</em></td><td>)</td>
  1235. <td></td>
  1236. </tr>
  1237. </table>
  1238. </td>
  1239. <td class="mlabels-right">
  1240. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1241. </tr>
  1242. </table>
  1243. </div><div class="memdoc">
  1244. <p>Optional callback to inform the plugin about a sample rate change.<br />
  1245. This function will only be called when the plugin is deactivated. </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a3e162cfe8f1c52bf09805fd327bcc3c4">getSampleRate()</a> </dd></dl>
  1246. </div>
  1247. </div>
  1248. <a id="ac3a55830c3474a3dc663365d43b581c1"></a>
  1249. <h2 class="memtitle"><span class="permalink"><a href="#ac3a55830c3474a3dc663365d43b581c1">&#9670;&nbsp;</a></span>ioChanged()</h2>
  1250. <div class="memitem">
  1251. <div class="memproto">
  1252. <table class="mlabels">
  1253. <tr>
  1254. <td class="mlabels-left">
  1255. <table class="memname">
  1256. <tr>
  1257. <td class="memname">virtual void Plugin::ioChanged </td>
  1258. <td>(</td>
  1259. <td class="paramtype">uint16_t&#160;</td>
  1260. <td class="paramname"><em>numInputs</em>, </td>
  1261. </tr>
  1262. <tr>
  1263. <td class="paramkey"></td>
  1264. <td></td>
  1265. <td class="paramtype">uint16_t&#160;</td>
  1266. <td class="paramname"><em>numOutputs</em>&#160;</td>
  1267. </tr>
  1268. <tr>
  1269. <td></td>
  1270. <td>)</td>
  1271. <td></td><td></td>
  1272. </tr>
  1273. </table>
  1274. </td>
  1275. <td class="mlabels-right">
  1276. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1277. </tr>
  1278. </table>
  1279. </div><div class="memdoc">
  1280. <p>Optional callback to inform the plugin about audio port IO changes.<br />
  1281. This function will only be called when the plugin is deactivated.<br />
  1282. Only used in AU (AudioUnit) format when DISTRHO_PLUGIN_EXTRA_IO is defined. </p><dl class="section see"><dt>See also</dt><dd>DISTRHO_PLUGIN_EXTRA_IO </dd></dl>
  1283. </div>
  1284. </div>
  1285. <hr/>The documentation for this class was generated from the following file:<ul>
  1286. <li>distrho/<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a></li>
  1287. </ul>
  1288. </div><!-- contents -->
  1289. <!-- start footer part -->
  1290. <hr class="footer"/><address class="footer"><small>
  1291. 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
  1292. </small></address>
  1293. </body>
  1294. </html>