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.

2099 lines
96KB

  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.8.17"/>
  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.8.17 -->
  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');
  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: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>
  84. <tr class="separator:ae85d602c430b1a4361a88d714d3a42c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  85. <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>
  86. <tr class="separator:a2a70c4ec55d74d9bc26862975d8df8a7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  87. <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>
  88. <tr class="separator:a0467eef817ac130cbbe1c0fbe09660c6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  89. <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>
  90. <tr class="separator:acb5a3632da5a5c4110172a3a78e1fd32"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91. <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>
  92. <tr class="separator:a89814b8f0b1c91e49140d42eb8331383"><td class="memSeparator" colspan="2">&#160;</td></tr>
  93. <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>
  94. <tr class="separator:a2643e638f62cfd4990247ec66bed60d2"><td class="memSeparator" colspan="2">&#160;</td></tr>
  95. <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>
  96. <tr class="separator:a3e162cfe8f1c52bf09805fd327bcc3c4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  97. <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>
  98. <tr class="separator:ae85d602c430b1a4361a88d714d3a42c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  99. <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>
  100. <tr class="separator:a2a70c4ec55d74d9bc26862975d8df8a7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  101. <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>
  102. <tr class="separator:a0467eef817ac130cbbe1c0fbe09660c6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  103. </table><table class="memberdecls">
  104. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
  105. Protected Member Functions</h2></td></tr>
  106. <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>
  107. <tr class="separator:aebb5df5cde162462dc460d4fd45dae75"><td class="memSeparator" colspan="2">&#160;</td></tr>
  108. <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>
  109. <tr class="separator:a00f7945c16149db6845fbcc2af729f4f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  110. <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>
  111. <tr class="separator:a30db5eef9de617f4c81d5c6925facea3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  112. <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>
  113. <tr class="separator:a955832840de786a7a22798f0ef451c5d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  114. <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>
  115. <tr class="separator:ad12c681ce31004da0badd609763f45c5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <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>
  117. <tr class="separator:a686a3c92a376a185d6fd97efd59125d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <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>
  119. <tr class="separator:abae540dd93caf4834270358a8aad334a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. <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>
  121. <tr class="separator:ad6ff8c80227d5ceebd40b96f3be29a66"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <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>
  123. <tr class="separator:a75f30935198a0acba25f4ea92af72dc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  124. <tr class="memitem:a5b0ec59527a1c2f4b01f17fc8c18ea8b"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a5b0ec59527a1c2f4b01f17fc8c18ea8b">initParameter</a> (uint32_t index, <a class="el" href="structParameter.html">Parameter</a> &amp;parameter)=0</td></tr>
  125. <tr class="separator:a5b0ec59527a1c2f4b01f17fc8c18ea8b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  126. <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>
  127. <tr class="separator:a71b876c8157b087b3552960f2877a44d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  128. <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>
  129. <tr class="separator:a54d66af3111541b7c118f9749ef0231b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  130. <tr class="memitem:ae301a970a8b5cff3c7ecef927ea20080"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ae301a970a8b5cff3c7ecef927ea20080">initState</a> (uint32_t index, <a class="el" href="classString.html">String</a> &amp;stateKey, <a class="el" href="classString.html">String</a> &amp;defaultStateValue)=0</td></tr>
  131. <tr class="separator:ae301a970a8b5cff3c7ecef927ea20080"><td class="memSeparator" colspan="2">&#160;</td></tr>
  132. <tr class="memitem:a2d1da98c90568bb4547662bc4f02c31f"><td class="memItemLeft" align="right" valign="top">virtual float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a2d1da98c90568bb4547662bc4f02c31f">getParameterValue</a> (uint32_t index) const =0</td></tr>
  133. <tr class="separator:a2d1da98c90568bb4547662bc4f02c31f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  134. <tr class="memitem:a6911a881fabb9eca9daf0eadbaad8599"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a6911a881fabb9eca9daf0eadbaad8599">setParameterValue</a> (uint32_t index, float value)=0</td></tr>
  135. <tr class="separator:a6911a881fabb9eca9daf0eadbaad8599"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:ab629f35c60406d6f2c0b9d530e67cf09"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ab629f35c60406d6f2c0b9d530e67cf09">loadProgram</a> (uint32_t index)=0</td></tr>
  137. <tr class="separator:ab629f35c60406d6f2c0b9d530e67cf09"><td class="memSeparator" colspan="2">&#160;</td></tr>
  138. <tr class="memitem:a84af70cd84fa4c3054caaa8affaab8f1"><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#a84af70cd84fa4c3054caaa8affaab8f1">getState</a> (const char *key) const =0</td></tr>
  139. <tr class="separator:a84af70cd84fa4c3054caaa8affaab8f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  140. <tr class="memitem:ad25ed64a2f00f48c86d2ae0016ea3e59"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ad25ed64a2f00f48c86d2ae0016ea3e59">setState</a> (const char *key, const char *value)=0</td></tr>
  141. <tr class="separator:ad25ed64a2f00f48c86d2ae0016ea3e59"><td class="memSeparator" colspan="2">&#160;</td></tr>
  142. <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>
  143. <tr class="separator:aa5c1262f5ca20536bb5850fdd6faa22c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  144. <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>
  145. <tr class="separator:aa089a56572bc8f1cb7e4b538c0d19c46"><td class="memSeparator" colspan="2">&#160;</td></tr>
  146. <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>
  147. <tr class="separator:a0a969c78f8455ac6ba65fa42e8c498f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  148. <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>
  149. <tr class="separator:a9f6c8ad6b054056649d0250e527e1297"><td class="memSeparator" colspan="2">&#160;</td></tr>
  150. <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>
  151. <tr class="separator:a2fcbfa1893f44e661d0d8cd53391dadc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  152. <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>
  153. <tr class="separator:aebb5df5cde162462dc460d4fd45dae75"><td class="memSeparator" colspan="2">&#160;</td></tr>
  154. <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>
  155. <tr class="separator:a00f7945c16149db6845fbcc2af729f4f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  156. <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>
  157. <tr class="separator:a30db5eef9de617f4c81d5c6925facea3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  158. <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>
  159. <tr class="separator:a955832840de786a7a22798f0ef451c5d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  160. <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>
  161. <tr class="separator:ad12c681ce31004da0badd609763f45c5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  162. <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>
  163. <tr class="separator:a686a3c92a376a185d6fd97efd59125d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  164. <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>
  165. <tr class="separator:abae540dd93caf4834270358a8aad334a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  166. <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>
  167. <tr class="separator:ad6ff8c80227d5ceebd40b96f3be29a66"><td class="memSeparator" colspan="2">&#160;</td></tr>
  168. <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>
  169. <tr class="separator:a75f30935198a0acba25f4ea92af72dc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  170. <tr class="memitem:a5b0ec59527a1c2f4b01f17fc8c18ea8b"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a5b0ec59527a1c2f4b01f17fc8c18ea8b">initParameter</a> (uint32_t index, <a class="el" href="structParameter.html">Parameter</a> &amp;parameter)=0</td></tr>
  171. <tr class="separator:a5b0ec59527a1c2f4b01f17fc8c18ea8b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  172. <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>
  173. <tr class="separator:a54d66af3111541b7c118f9749ef0231b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  174. <tr class="memitem:ae301a970a8b5cff3c7ecef927ea20080"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ae301a970a8b5cff3c7ecef927ea20080">initState</a> (uint32_t index, <a class="el" href="classString.html">String</a> &amp;stateKey, <a class="el" href="classString.html">String</a> &amp;defaultStateValue)=0</td></tr>
  175. <tr class="separator:ae301a970a8b5cff3c7ecef927ea20080"><td class="memSeparator" colspan="2">&#160;</td></tr>
  176. <tr class="memitem:a2d1da98c90568bb4547662bc4f02c31f"><td class="memItemLeft" align="right" valign="top">virtual float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a2d1da98c90568bb4547662bc4f02c31f">getParameterValue</a> (uint32_t index) const =0</td></tr>
  177. <tr class="separator:a2d1da98c90568bb4547662bc4f02c31f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  178. <tr class="memitem:a6911a881fabb9eca9daf0eadbaad8599"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#a6911a881fabb9eca9daf0eadbaad8599">setParameterValue</a> (uint32_t index, float value)=0</td></tr>
  179. <tr class="separator:a6911a881fabb9eca9daf0eadbaad8599"><td class="memSeparator" colspan="2">&#160;</td></tr>
  180. <tr class="memitem:ab629f35c60406d6f2c0b9d530e67cf09"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ab629f35c60406d6f2c0b9d530e67cf09">loadProgram</a> (uint32_t index)=0</td></tr>
  181. <tr class="separator:ab629f35c60406d6f2c0b9d530e67cf09"><td class="memSeparator" colspan="2">&#160;</td></tr>
  182. <tr class="memitem:a84af70cd84fa4c3054caaa8affaab8f1"><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#a84af70cd84fa4c3054caaa8affaab8f1">getState</a> (const char *key) const =0</td></tr>
  183. <tr class="separator:a84af70cd84fa4c3054caaa8affaab8f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  184. <tr class="memitem:ad25ed64a2f00f48c86d2ae0016ea3e59"><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classPlugin.html#ad25ed64a2f00f48c86d2ae0016ea3e59">setState</a> (const char *key, const char *value)=0</td></tr>
  185. <tr class="separator:ad25ed64a2f00f48c86d2ae0016ea3e59"><td class="memSeparator" colspan="2">&#160;</td></tr>
  186. <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>
  187. <tr class="separator:aa5c1262f5ca20536bb5850fdd6faa22c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  188. <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>
  189. <tr class="separator:aa089a56572bc8f1cb7e4b538c0d19c46"><td class="memSeparator" colspan="2">&#160;</td></tr>
  190. <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>
  191. <tr class="separator:a0a969c78f8455ac6ba65fa42e8c498f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  192. <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>
  193. <tr class="separator:a9f6c8ad6b054056649d0250e527e1297"><td class="memSeparator" colspan="2">&#160;</td></tr>
  194. <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>
  195. <tr class="separator:a2fcbfa1893f44e661d0d8cd53391dadc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  196. </table><table class="memberdecls">
  197. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="friends"></a>
  198. Friends</h2></td></tr>
  199. <tr class="memitem:a2f5c27fa6eebc862797da6179cc6927b"><td class="memItemLeft" align="right" valign="top"><a id="a2f5c27fa6eebc862797da6179cc6927b"></a>
  200. class&#160;</td><td class="memItemRight" valign="bottom"><b>PluginExporter</b></td></tr>
  201. <tr class="separator:a2f5c27fa6eebc862797da6179cc6927b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  202. </table>
  203. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  204. <div class="textblock"><p>DPF <a class="el" href="classPlugin.html">Plugin</a> class from where plugin instances are created.</p>
  205. <p>The public methods (Host state) are called from the plugin to get or set host information.<br />
  206. They can be called from a plugin instance at anytime unless stated otherwise.<br />
  207. All other methods are to be implemented by the plugin and will be called by the host.</p>
  208. <p>Shortly after a plugin instance is created, the various init* functions will be called by the host.<br />
  209. 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 />
  210. The host may call deactivate right after activate and vice-versa, but never activate/deactivate consecutively.<br />
  211. 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>
  212. <p>The buffer size and sample rate values will remain constant between activate and deactivate.<br />
  213. 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>
  214. <p>Some of this class functions are only available according to some macros.</p>
  215. <p>DISTRHO_PLUGIN_WANT_PROGRAMS activates program related features.<br />
  216. When enabled you need to implement <a class="el" href="classPlugin.html#a54d66af3111541b7c118f9749ef0231b">initProgramName()</a> and <a class="el" href="classPlugin.html#ab629f35c60406d6f2c0b9d530e67cf09">loadProgram()</a>.</p>
  217. <p>DISTRHO_PLUGIN_WANT_STATE activates internal state features.<br />
  218. When enabled you need to implement initStateKey() and <a class="el" href="classPlugin.html#ad25ed64a2f00f48c86d2ae0016ea3e59">setState()</a>.</p>
  219. <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 />
  220. When enabled it provides midi input events. </p>
  221. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  222. <a id="acb5a3632da5a5c4110172a3a78e1fd32"></a>
  223. <h2 class="memtitle"><span class="permalink"><a href="#acb5a3632da5a5c4110172a3a78e1fd32">&#9670;&nbsp;</a></span>Plugin() <span class="overload">[1/2]</span></h2>
  224. <div class="memitem">
  225. <div class="memproto">
  226. <table class="memname">
  227. <tr>
  228. <td class="memname">Plugin::Plugin </td>
  229. <td>(</td>
  230. <td class="paramtype">uint32_t&#160;</td>
  231. <td class="paramname"><em>parameterCount</em>, </td>
  232. </tr>
  233. <tr>
  234. <td class="paramkey"></td>
  235. <td></td>
  236. <td class="paramtype">uint32_t&#160;</td>
  237. <td class="paramname"><em>programCount</em>, </td>
  238. </tr>
  239. <tr>
  240. <td class="paramkey"></td>
  241. <td></td>
  242. <td class="paramtype">uint32_t&#160;</td>
  243. <td class="paramname"><em>stateCount</em>&#160;</td>
  244. </tr>
  245. <tr>
  246. <td></td>
  247. <td>)</td>
  248. <td></td><td></td>
  249. </tr>
  250. </table>
  251. </div><div class="memdoc">
  252. <p><a class="el" href="classPlugin.html">Plugin</a> class constructor.<br />
  253. You must set all parameter values to their defaults, matching <a class="el" href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">ParameterRanges::def</a>. </p>
  254. </div>
  255. </div>
  256. <a id="a89814b8f0b1c91e49140d42eb8331383"></a>
  257. <h2 class="memtitle"><span class="permalink"><a href="#a89814b8f0b1c91e49140d42eb8331383">&#9670;&nbsp;</a></span>~Plugin() <span class="overload">[1/2]</span></h2>
  258. <div class="memitem">
  259. <div class="memproto">
  260. <table class="mlabels">
  261. <tr>
  262. <td class="mlabels-left">
  263. <table class="memname">
  264. <tr>
  265. <td class="memname">virtual Plugin::~Plugin </td>
  266. <td>(</td>
  267. <td class="paramname"></td><td>)</td>
  268. <td></td>
  269. </tr>
  270. </table>
  271. </td>
  272. <td class="mlabels-right">
  273. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  274. </tr>
  275. </table>
  276. </div><div class="memdoc">
  277. <p>Destructor. </p>
  278. </div>
  279. </div>
  280. <a id="acb5a3632da5a5c4110172a3a78e1fd32"></a>
  281. <h2 class="memtitle"><span class="permalink"><a href="#acb5a3632da5a5c4110172a3a78e1fd32">&#9670;&nbsp;</a></span>Plugin() <span class="overload">[2/2]</span></h2>
  282. <div class="memitem">
  283. <div class="memproto">
  284. <table class="memname">
  285. <tr>
  286. <td class="memname">Plugin::Plugin </td>
  287. <td>(</td>
  288. <td class="paramtype">uint32_t&#160;</td>
  289. <td class="paramname"><em>parameterCount</em>, </td>
  290. </tr>
  291. <tr>
  292. <td class="paramkey"></td>
  293. <td></td>
  294. <td class="paramtype">uint32_t&#160;</td>
  295. <td class="paramname"><em>programCount</em>, </td>
  296. </tr>
  297. <tr>
  298. <td class="paramkey"></td>
  299. <td></td>
  300. <td class="paramtype">uint32_t&#160;</td>
  301. <td class="paramname"><em>stateCount</em>&#160;</td>
  302. </tr>
  303. <tr>
  304. <td></td>
  305. <td>)</td>
  306. <td></td><td></td>
  307. </tr>
  308. </table>
  309. </div><div class="memdoc">
  310. <p><a class="el" href="classPlugin.html">Plugin</a> class constructor.<br />
  311. You must set all parameter values to their defaults, matching <a class="el" href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">ParameterRanges::def</a>. </p>
  312. </div>
  313. </div>
  314. <a id="a89814b8f0b1c91e49140d42eb8331383"></a>
  315. <h2 class="memtitle"><span class="permalink"><a href="#a89814b8f0b1c91e49140d42eb8331383">&#9670;&nbsp;</a></span>~Plugin() <span class="overload">[2/2]</span></h2>
  316. <div class="memitem">
  317. <div class="memproto">
  318. <table class="mlabels">
  319. <tr>
  320. <td class="mlabels-left">
  321. <table class="memname">
  322. <tr>
  323. <td class="memname">virtual Plugin::~Plugin </td>
  324. <td>(</td>
  325. <td class="paramname"></td><td>)</td>
  326. <td></td>
  327. </tr>
  328. </table>
  329. </td>
  330. <td class="mlabels-right">
  331. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  332. </tr>
  333. </table>
  334. </div><div class="memdoc">
  335. <p>Destructor. </p>
  336. </div>
  337. </div>
  338. <h2 class="groupheader">Member Function Documentation</h2>
  339. <a id="a2643e638f62cfd4990247ec66bed60d2"></a>
  340. <h2 class="memtitle"><span class="permalink"><a href="#a2643e638f62cfd4990247ec66bed60d2">&#9670;&nbsp;</a></span>getBufferSize() <span class="overload">[1/2]</span></h2>
  341. <div class="memitem">
  342. <div class="memproto">
  343. <table class="mlabels">
  344. <tr>
  345. <td class="mlabels-left">
  346. <table class="memname">
  347. <tr>
  348. <td class="memname">uint32_t Plugin::getBufferSize </td>
  349. <td>(</td>
  350. <td class="paramname"></td><td>)</td>
  351. <td> const</td>
  352. </tr>
  353. </table>
  354. </td>
  355. <td class="mlabels-right">
  356. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  357. </tr>
  358. </table>
  359. </div><div class="memdoc">
  360. <p>Get the current buffer size that will probably be used during processing, in frames.<br />
  361. 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 />
  362. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  363. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a9f6c8ad6b054056649d0250e527e1297">bufferSizeChanged(uint32_t)</a> </dd></dl>
  364. </div>
  365. </div>
  366. <a id="a3e162cfe8f1c52bf09805fd327bcc3c4"></a>
  367. <h2 class="memtitle"><span class="permalink"><a href="#a3e162cfe8f1c52bf09805fd327bcc3c4">&#9670;&nbsp;</a></span>getSampleRate() <span class="overload">[1/2]</span></h2>
  368. <div class="memitem">
  369. <div class="memproto">
  370. <table class="mlabels">
  371. <tr>
  372. <td class="mlabels-left">
  373. <table class="memname">
  374. <tr>
  375. <td class="memname">double Plugin::getSampleRate </td>
  376. <td>(</td>
  377. <td class="paramname"></td><td>)</td>
  378. <td> const</td>
  379. </tr>
  380. </table>
  381. </td>
  382. <td class="mlabels-right">
  383. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  384. </tr>
  385. </table>
  386. </div><div class="memdoc">
  387. <p>Get the current sample rate that will be used during processing.<br />
  388. 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>
  389. </div>
  390. </div>
  391. <a id="ae85d602c430b1a4361a88d714d3a42c1"></a>
  392. <h2 class="memtitle"><span class="permalink"><a href="#ae85d602c430b1a4361a88d714d3a42c1">&#9670;&nbsp;</a></span>getTimePosition() <span class="overload">[1/2]</span></h2>
  393. <div class="memitem">
  394. <div class="memproto">
  395. <table class="mlabels">
  396. <tr>
  397. <td class="mlabels-left">
  398. <table class="memname">
  399. <tr>
  400. <td class="memname">const <a class="el" href="structTimePosition.html">TimePosition</a>&amp; Plugin::getTimePosition </td>
  401. <td>(</td>
  402. <td class="paramname"></td><td>)</td>
  403. <td> const</td>
  404. </tr>
  405. </table>
  406. </td>
  407. <td class="mlabels-right">
  408. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  409. </tr>
  410. </table>
  411. </div><div class="memdoc">
  412. <p>Get the current host transport time position.<br />
  413. This function should only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  414. 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>
  415. </div>
  416. </div>
  417. <a id="a2a70c4ec55d74d9bc26862975d8df8a7"></a>
  418. <h2 class="memtitle"><span class="permalink"><a href="#a2a70c4ec55d74d9bc26862975d8df8a7">&#9670;&nbsp;</a></span>setLatency() <span class="overload">[1/2]</span></h2>
  419. <div class="memitem">
  420. <div class="memproto">
  421. <table class="mlabels">
  422. <tr>
  423. <td class="mlabels-left">
  424. <table class="memname">
  425. <tr>
  426. <td class="memname">void Plugin::setLatency </td>
  427. <td>(</td>
  428. <td class="paramtype">uint32_t&#160;</td>
  429. <td class="paramname"><em>frames</em></td><td>)</td>
  430. <td></td>
  431. </tr>
  432. </table>
  433. </td>
  434. <td class="mlabels-right">
  435. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  436. </tr>
  437. </table>
  438. </div><div class="memdoc">
  439. <p>Change the plugin audio output latency to <em>frames</em>.<br />
  440. 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>
  441. </div>
  442. </div>
  443. <a id="a0467eef817ac130cbbe1c0fbe09660c6"></a>
  444. <h2 class="memtitle"><span class="permalink"><a href="#a0467eef817ac130cbbe1c0fbe09660c6">&#9670;&nbsp;</a></span>writeMidiEvent() <span class="overload">[1/2]</span></h2>
  445. <div class="memitem">
  446. <div class="memproto">
  447. <table class="mlabels">
  448. <tr>
  449. <td class="mlabels-left">
  450. <table class="memname">
  451. <tr>
  452. <td class="memname">bool Plugin::writeMidiEvent </td>
  453. <td>(</td>
  454. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> &amp;&#160;</td>
  455. <td class="paramname"><em>midiEvent</em></td><td>)</td>
  456. <td></td>
  457. </tr>
  458. </table>
  459. </td>
  460. <td class="mlabels-right">
  461. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  462. </tr>
  463. </table>
  464. </div><div class="memdoc">
  465. <p>Write a MIDI output event.<br />
  466. This function must only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  467. 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>
  468. </div>
  469. </div>
  470. <a id="aebb5df5cde162462dc460d4fd45dae75"></a>
  471. <h2 class="memtitle"><span class="permalink"><a href="#aebb5df5cde162462dc460d4fd45dae75">&#9670;&nbsp;</a></span>getName() <span class="overload">[1/2]</span></h2>
  472. <div class="memitem">
  473. <div class="memproto">
  474. <table class="mlabels">
  475. <tr>
  476. <td class="mlabels-left">
  477. <table class="memname">
  478. <tr>
  479. <td class="memname">virtual const char* Plugin::getName </td>
  480. <td>(</td>
  481. <td class="paramname"></td><td>)</td>
  482. <td> const</td>
  483. </tr>
  484. </table>
  485. </td>
  486. <td class="mlabels-right">
  487. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  488. </tr>
  489. </table>
  490. </div><div class="memdoc">
  491. <p>Get the plugin name.<br />
  492. Returns DISTRHO_PLUGIN_NAME by default. </p>
  493. </div>
  494. </div>
  495. <a id="a00f7945c16149db6845fbcc2af729f4f"></a>
  496. <h2 class="memtitle"><span class="permalink"><a href="#a00f7945c16149db6845fbcc2af729f4f">&#9670;&nbsp;</a></span>getLabel() <span class="overload">[1/2]</span></h2>
  497. <div class="memitem">
  498. <div class="memproto">
  499. <table class="mlabels">
  500. <tr>
  501. <td class="mlabels-left">
  502. <table class="memname">
  503. <tr>
  504. <td class="memname">virtual const char* Plugin::getLabel </td>
  505. <td>(</td>
  506. <td class="paramname"></td><td>)</td>
  507. <td> const</td>
  508. </tr>
  509. </table>
  510. </td>
  511. <td class="mlabels-right">
  512. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  513. </tr>
  514. </table>
  515. </div><div class="memdoc">
  516. <p>Get the plugin label.<br />
  517. This label is a short restricted name consisting of only _, a-z, A-Z and 0-9 characters. </p>
  518. </div>
  519. </div>
  520. <a id="a30db5eef9de617f4c81d5c6925facea3"></a>
  521. <h2 class="memtitle"><span class="permalink"><a href="#a30db5eef9de617f4c81d5c6925facea3">&#9670;&nbsp;</a></span>getDescription() <span class="overload">[1/2]</span></h2>
  522. <div class="memitem">
  523. <div class="memproto">
  524. <table class="mlabels">
  525. <tr>
  526. <td class="mlabels-left">
  527. <table class="memname">
  528. <tr>
  529. <td class="memname">virtual const char* Plugin::getDescription </td>
  530. <td>(</td>
  531. <td class="paramname"></td><td>)</td>
  532. <td> const</td>
  533. </tr>
  534. </table>
  535. </td>
  536. <td class="mlabels-right">
  537. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  538. </tr>
  539. </table>
  540. </div><div class="memdoc">
  541. <p>Get an extensive comment/description about the plugin.<br />
  542. Optional, returns nothing by default. </p>
  543. </div>
  544. </div>
  545. <a id="a955832840de786a7a22798f0ef451c5d"></a>
  546. <h2 class="memtitle"><span class="permalink"><a href="#a955832840de786a7a22798f0ef451c5d">&#9670;&nbsp;</a></span>getMaker() <span class="overload">[1/2]</span></h2>
  547. <div class="memitem">
  548. <div class="memproto">
  549. <table class="mlabels">
  550. <tr>
  551. <td class="mlabels-left">
  552. <table class="memname">
  553. <tr>
  554. <td class="memname">virtual const char* Plugin::getMaker </td>
  555. <td>(</td>
  556. <td class="paramname"></td><td>)</td>
  557. <td> const</td>
  558. </tr>
  559. </table>
  560. </td>
  561. <td class="mlabels-right">
  562. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  563. </tr>
  564. </table>
  565. </div><div class="memdoc">
  566. <p>Get the plugin author/maker. </p>
  567. </div>
  568. </div>
  569. <a id="ad12c681ce31004da0badd609763f45c5"></a>
  570. <h2 class="memtitle"><span class="permalink"><a href="#ad12c681ce31004da0badd609763f45c5">&#9670;&nbsp;</a></span>getHomePage() <span class="overload">[1/2]</span></h2>
  571. <div class="memitem">
  572. <div class="memproto">
  573. <table class="mlabels">
  574. <tr>
  575. <td class="mlabels-left">
  576. <table class="memname">
  577. <tr>
  578. <td class="memname">virtual const char* Plugin::getHomePage </td>
  579. <td>(</td>
  580. <td class="paramname"></td><td>)</td>
  581. <td> const</td>
  582. </tr>
  583. </table>
  584. </td>
  585. <td class="mlabels-right">
  586. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  587. </tr>
  588. </table>
  589. </div><div class="memdoc">
  590. <p>Get the plugin homepage.<br />
  591. Optional, returns nothing by default. </p>
  592. </div>
  593. </div>
  594. <a id="a686a3c92a376a185d6fd97efd59125d1"></a>
  595. <h2 class="memtitle"><span class="permalink"><a href="#a686a3c92a376a185d6fd97efd59125d1">&#9670;&nbsp;</a></span>getLicense() <span class="overload">[1/2]</span></h2>
  596. <div class="memitem">
  597. <div class="memproto">
  598. <table class="mlabels">
  599. <tr>
  600. <td class="mlabels-left">
  601. <table class="memname">
  602. <tr>
  603. <td class="memname">virtual const char* Plugin::getLicense </td>
  604. <td>(</td>
  605. <td class="paramname"></td><td>)</td>
  606. <td> const</td>
  607. </tr>
  608. </table>
  609. </td>
  610. <td class="mlabels-right">
  611. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  612. </tr>
  613. </table>
  614. </div><div class="memdoc">
  615. <p>Get the plugin license (a single line of text or a URL).<br />
  616. For commercial plugins this should return some short copyright information. </p>
  617. </div>
  618. </div>
  619. <a id="abae540dd93caf4834270358a8aad334a"></a>
  620. <h2 class="memtitle"><span class="permalink"><a href="#abae540dd93caf4834270358a8aad334a">&#9670;&nbsp;</a></span>getVersion() <span class="overload">[1/2]</span></h2>
  621. <div class="memitem">
  622. <div class="memproto">
  623. <table class="mlabels">
  624. <tr>
  625. <td class="mlabels-left">
  626. <table class="memname">
  627. <tr>
  628. <td class="memname">virtual uint32_t Plugin::getVersion </td>
  629. <td>(</td>
  630. <td class="paramname"></td><td>)</td>
  631. <td> const</td>
  632. </tr>
  633. </table>
  634. </td>
  635. <td class="mlabels-right">
  636. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  637. </tr>
  638. </table>
  639. </div><div class="memdoc">
  640. <p>Get the plugin version, in hexadecimal. </p><dl class="section see"><dt>See also</dt><dd>d_version() </dd></dl>
  641. </div>
  642. </div>
  643. <a id="ad6ff8c80227d5ceebd40b96f3be29a66"></a>
  644. <h2 class="memtitle"><span class="permalink"><a href="#ad6ff8c80227d5ceebd40b96f3be29a66">&#9670;&nbsp;</a></span>getUniqueId() <span class="overload">[1/2]</span></h2>
  645. <div class="memitem">
  646. <div class="memproto">
  647. <table class="mlabels">
  648. <tr>
  649. <td class="mlabels-left">
  650. <table class="memname">
  651. <tr>
  652. <td class="memname">virtual int64_t Plugin::getUniqueId </td>
  653. <td>(</td>
  654. <td class="paramname"></td><td>)</td>
  655. <td> const</td>
  656. </tr>
  657. </table>
  658. </td>
  659. <td class="mlabels-right">
  660. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  661. </tr>
  662. </table>
  663. </div><div class="memdoc">
  664. <p>Get the plugin unique Id.<br />
  665. This value is used by LADSPA, DSSI and VST plugin formats. </p><dl class="section see"><dt>See also</dt><dd>d_cconst() </dd></dl>
  666. </div>
  667. </div>
  668. <a id="a75f30935198a0acba25f4ea92af72dc4"></a>
  669. <h2 class="memtitle"><span class="permalink"><a href="#a75f30935198a0acba25f4ea92af72dc4">&#9670;&nbsp;</a></span>initAudioPort() <span class="overload">[1/2]</span></h2>
  670. <div class="memitem">
  671. <div class="memproto">
  672. <table class="mlabels">
  673. <tr>
  674. <td class="mlabels-left">
  675. <table class="memname">
  676. <tr>
  677. <td class="memname">virtual void Plugin::initAudioPort </td>
  678. <td>(</td>
  679. <td class="paramtype">bool&#160;</td>
  680. <td class="paramname"><em>input</em>, </td>
  681. </tr>
  682. <tr>
  683. <td class="paramkey"></td>
  684. <td></td>
  685. <td class="paramtype">uint32_t&#160;</td>
  686. <td class="paramname"><em>index</em>, </td>
  687. </tr>
  688. <tr>
  689. <td class="paramkey"></td>
  690. <td></td>
  691. <td class="paramtype"><a class="el" href="structAudioPort.html">AudioPort</a> &amp;&#160;</td>
  692. <td class="paramname"><em>port</em>&#160;</td>
  693. </tr>
  694. <tr>
  695. <td></td>
  696. <td>)</td>
  697. <td></td><td></td>
  698. </tr>
  699. </table>
  700. </td>
  701. <td class="mlabels-right">
  702. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  703. </tr>
  704. </table>
  705. </div><div class="memdoc">
  706. <p>Initialize the audio port <em>index</em>.<br />
  707. This function will be called once, shortly after the plugin is created. </p>
  708. </div>
  709. </div>
  710. <a id="a5b0ec59527a1c2f4b01f17fc8c18ea8b"></a>
  711. <h2 class="memtitle"><span class="permalink"><a href="#a5b0ec59527a1c2f4b01f17fc8c18ea8b">&#9670;&nbsp;</a></span>initParameter() <span class="overload">[1/2]</span></h2>
  712. <div class="memitem">
  713. <div class="memproto">
  714. <table class="mlabels">
  715. <tr>
  716. <td class="mlabels-left">
  717. <table class="memname">
  718. <tr>
  719. <td class="memname">virtual void Plugin::initParameter </td>
  720. <td>(</td>
  721. <td class="paramtype">uint32_t&#160;</td>
  722. <td class="paramname"><em>index</em>, </td>
  723. </tr>
  724. <tr>
  725. <td class="paramkey"></td>
  726. <td></td>
  727. <td class="paramtype"><a class="el" href="structParameter.html">Parameter</a> &amp;&#160;</td>
  728. <td class="paramname"><em>parameter</em>&#160;</td>
  729. </tr>
  730. <tr>
  731. <td></td>
  732. <td>)</td>
  733. <td></td><td></td>
  734. </tr>
  735. </table>
  736. </td>
  737. <td class="mlabels-right">
  738. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  739. </tr>
  740. </table>
  741. </div><div class="memdoc">
  742. <p>Initialize the parameter <em>index</em>.<br />
  743. This function will be called once, shortly after the plugin is created. </p>
  744. </div>
  745. </div>
  746. <a id="a71b876c8157b087b3552960f2877a44d"></a>
  747. <h2 class="memtitle"><span class="permalink"><a href="#a71b876c8157b087b3552960f2877a44d">&#9670;&nbsp;</a></span>initPortGroup()</h2>
  748. <div class="memitem">
  749. <div class="memproto">
  750. <table class="mlabels">
  751. <tr>
  752. <td class="mlabels-left">
  753. <table class="memname">
  754. <tr>
  755. <td class="memname">virtual void Plugin::initPortGroup </td>
  756. <td>(</td>
  757. <td class="paramtype">uint32_t&#160;</td>
  758. <td class="paramname"><em>groupId</em>, </td>
  759. </tr>
  760. <tr>
  761. <td class="paramkey"></td>
  762. <td></td>
  763. <td class="paramtype"><a class="el" href="structPortGroup.html">PortGroup</a> &amp;&#160;</td>
  764. <td class="paramname"><em>portGroup</em>&#160;</td>
  765. </tr>
  766. <tr>
  767. <td></td>
  768. <td>)</td>
  769. <td></td><td></td>
  770. </tr>
  771. </table>
  772. </td>
  773. <td class="mlabels-right">
  774. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  775. </tr>
  776. </table>
  777. </div><div class="memdoc">
  778. <p>Initialize the port group <em>groupId</em>.<br />
  779. This function will be called once, shortly after the plugin is created and all audio ports and parameters have been enumerated. </p>
  780. </div>
  781. </div>
  782. <a id="a54d66af3111541b7c118f9749ef0231b"></a>
  783. <h2 class="memtitle"><span class="permalink"><a href="#a54d66af3111541b7c118f9749ef0231b">&#9670;&nbsp;</a></span>initProgramName() <span class="overload">[1/2]</span></h2>
  784. <div class="memitem">
  785. <div class="memproto">
  786. <table class="mlabels">
  787. <tr>
  788. <td class="mlabels-left">
  789. <table class="memname">
  790. <tr>
  791. <td class="memname">virtual void Plugin::initProgramName </td>
  792. <td>(</td>
  793. <td class="paramtype">uint32_t&#160;</td>
  794. <td class="paramname"><em>index</em>, </td>
  795. </tr>
  796. <tr>
  797. <td class="paramkey"></td>
  798. <td></td>
  799. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  800. <td class="paramname"><em>programName</em>&#160;</td>
  801. </tr>
  802. <tr>
  803. <td></td>
  804. <td>)</td>
  805. <td></td><td></td>
  806. </tr>
  807. </table>
  808. </td>
  809. <td class="mlabels-right">
  810. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  811. </tr>
  812. </table>
  813. </div><div class="memdoc">
  814. <p>Set the name of the program <em>index</em>.<br />
  815. This function will be called once, shortly after the plugin is created.<br />
  816. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  817. </div>
  818. </div>
  819. <a id="ae301a970a8b5cff3c7ecef927ea20080"></a>
  820. <h2 class="memtitle"><span class="permalink"><a href="#ae301a970a8b5cff3c7ecef927ea20080">&#9670;&nbsp;</a></span>initState() <span class="overload">[1/2]</span></h2>
  821. <div class="memitem">
  822. <div class="memproto">
  823. <table class="mlabels">
  824. <tr>
  825. <td class="mlabels-left">
  826. <table class="memname">
  827. <tr>
  828. <td class="memname">virtual void Plugin::initState </td>
  829. <td>(</td>
  830. <td class="paramtype">uint32_t&#160;</td>
  831. <td class="paramname"><em>index</em>, </td>
  832. </tr>
  833. <tr>
  834. <td class="paramkey"></td>
  835. <td></td>
  836. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  837. <td class="paramname"><em>stateKey</em>, </td>
  838. </tr>
  839. <tr>
  840. <td class="paramkey"></td>
  841. <td></td>
  842. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  843. <td class="paramname"><em>defaultStateValue</em>&#160;</td>
  844. </tr>
  845. <tr>
  846. <td></td>
  847. <td>)</td>
  848. <td></td><td></td>
  849. </tr>
  850. </table>
  851. </td>
  852. <td class="mlabels-right">
  853. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  854. </tr>
  855. </table>
  856. </div><div class="memdoc">
  857. <p>Set the state key and default value of <em>index</em>.<br />
  858. This function will be called once, shortly after the plugin is created.<br />
  859. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  860. </div>
  861. </div>
  862. <a id="a2d1da98c90568bb4547662bc4f02c31f"></a>
  863. <h2 class="memtitle"><span class="permalink"><a href="#a2d1da98c90568bb4547662bc4f02c31f">&#9670;&nbsp;</a></span>getParameterValue() <span class="overload">[1/2]</span></h2>
  864. <div class="memitem">
  865. <div class="memproto">
  866. <table class="mlabels">
  867. <tr>
  868. <td class="mlabels-left">
  869. <table class="memname">
  870. <tr>
  871. <td class="memname">virtual float Plugin::getParameterValue </td>
  872. <td>(</td>
  873. <td class="paramtype">uint32_t&#160;</td>
  874. <td class="paramname"><em>index</em></td><td>)</td>
  875. <td> const</td>
  876. </tr>
  877. </table>
  878. </td>
  879. <td class="mlabels-right">
  880. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  881. </tr>
  882. </table>
  883. </div><div class="memdoc">
  884. <p>Get the current value of a parameter.<br />
  885. The host may call this function from any context, including realtime processing. </p>
  886. </div>
  887. </div>
  888. <a id="a6911a881fabb9eca9daf0eadbaad8599"></a>
  889. <h2 class="memtitle"><span class="permalink"><a href="#a6911a881fabb9eca9daf0eadbaad8599">&#9670;&nbsp;</a></span>setParameterValue() <span class="overload">[1/2]</span></h2>
  890. <div class="memitem">
  891. <div class="memproto">
  892. <table class="mlabels">
  893. <tr>
  894. <td class="mlabels-left">
  895. <table class="memname">
  896. <tr>
  897. <td class="memname">virtual void Plugin::setParameterValue </td>
  898. <td>(</td>
  899. <td class="paramtype">uint32_t&#160;</td>
  900. <td class="paramname"><em>index</em>, </td>
  901. </tr>
  902. <tr>
  903. <td class="paramkey"></td>
  904. <td></td>
  905. <td class="paramtype">float&#160;</td>
  906. <td class="paramname"><em>value</em>&#160;</td>
  907. </tr>
  908. <tr>
  909. <td></td>
  910. <td>)</td>
  911. <td></td><td></td>
  912. </tr>
  913. </table>
  914. </td>
  915. <td class="mlabels-right">
  916. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  917. </tr>
  918. </table>
  919. </div><div class="memdoc">
  920. <p>Change a parameter value.<br />
  921. The host may call this function from any context, including realtime processing.<br />
  922. When a parameter is marked as automable, 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>
  923. </div>
  924. </div>
  925. <a id="ab629f35c60406d6f2c0b9d530e67cf09"></a>
  926. <h2 class="memtitle"><span class="permalink"><a href="#ab629f35c60406d6f2c0b9d530e67cf09">&#9670;&nbsp;</a></span>loadProgram() <span class="overload">[1/2]</span></h2>
  927. <div class="memitem">
  928. <div class="memproto">
  929. <table class="mlabels">
  930. <tr>
  931. <td class="mlabels-left">
  932. <table class="memname">
  933. <tr>
  934. <td class="memname">virtual void Plugin::loadProgram </td>
  935. <td>(</td>
  936. <td class="paramtype">uint32_t&#160;</td>
  937. <td class="paramname"><em>index</em></td><td>)</td>
  938. <td></td>
  939. </tr>
  940. </table>
  941. </td>
  942. <td class="mlabels-right">
  943. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  944. </tr>
  945. </table>
  946. </div><div class="memdoc">
  947. <p>Load a program.<br />
  948. The host may call this function from any context, including realtime processing.<br />
  949. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  950. </div>
  951. </div>
  952. <a id="a84af70cd84fa4c3054caaa8affaab8f1"></a>
  953. <h2 class="memtitle"><span class="permalink"><a href="#a84af70cd84fa4c3054caaa8affaab8f1">&#9670;&nbsp;</a></span>getState() <span class="overload">[1/2]</span></h2>
  954. <div class="memitem">
  955. <div class="memproto">
  956. <table class="mlabels">
  957. <tr>
  958. <td class="mlabels-left">
  959. <table class="memname">
  960. <tr>
  961. <td class="memname">virtual <a class="el" href="classString.html">String</a> Plugin::getState </td>
  962. <td>(</td>
  963. <td class="paramtype">const char *&#160;</td>
  964. <td class="paramname"><em>key</em></td><td>)</td>
  965. <td> const</td>
  966. </tr>
  967. </table>
  968. </td>
  969. <td class="mlabels-right">
  970. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  971. </tr>
  972. </table>
  973. </div><div class="memdoc">
  974. <p>Get the value of an internal state.<br />
  975. The host may call this function from any non-realtime context.<br />
  976. 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>
  977. </div>
  978. </div>
  979. <a id="ad25ed64a2f00f48c86d2ae0016ea3e59"></a>
  980. <h2 class="memtitle"><span class="permalink"><a href="#ad25ed64a2f00f48c86d2ae0016ea3e59">&#9670;&nbsp;</a></span>setState() <span class="overload">[1/2]</span></h2>
  981. <div class="memitem">
  982. <div class="memproto">
  983. <table class="mlabels">
  984. <tr>
  985. <td class="mlabels-left">
  986. <table class="memname">
  987. <tr>
  988. <td class="memname">virtual void Plugin::setState </td>
  989. <td>(</td>
  990. <td class="paramtype">const char *&#160;</td>
  991. <td class="paramname"><em>key</em>, </td>
  992. </tr>
  993. <tr>
  994. <td class="paramkey"></td>
  995. <td></td>
  996. <td class="paramtype">const char *&#160;</td>
  997. <td class="paramname"><em>value</em>&#160;</td>
  998. </tr>
  999. <tr>
  1000. <td></td>
  1001. <td>)</td>
  1002. <td></td><td></td>
  1003. </tr>
  1004. </table>
  1005. </td>
  1006. <td class="mlabels-right">
  1007. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1008. </tr>
  1009. </table>
  1010. </div><div class="memdoc">
  1011. <p>Change an internal state <em>key</em> to <em>value</em>.<br />
  1012. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  1013. </div>
  1014. </div>
  1015. <a id="aa5c1262f5ca20536bb5850fdd6faa22c"></a>
  1016. <h2 class="memtitle"><span class="permalink"><a href="#aa5c1262f5ca20536bb5850fdd6faa22c">&#9670;&nbsp;</a></span>activate() <span class="overload">[1/2]</span></h2>
  1017. <div class="memitem">
  1018. <div class="memproto">
  1019. <table class="mlabels">
  1020. <tr>
  1021. <td class="mlabels-left">
  1022. <table class="memname">
  1023. <tr>
  1024. <td class="memname">virtual void Plugin::activate </td>
  1025. <td>(</td>
  1026. <td class="paramname"></td><td>)</td>
  1027. <td></td>
  1028. </tr>
  1029. </table>
  1030. </td>
  1031. <td class="mlabels-right">
  1032. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1033. </tr>
  1034. </table>
  1035. </div><div class="memdoc">
  1036. <p>Activate this plugin. </p>
  1037. </div>
  1038. </div>
  1039. <a id="aa089a56572bc8f1cb7e4b538c0d19c46"></a>
  1040. <h2 class="memtitle"><span class="permalink"><a href="#aa089a56572bc8f1cb7e4b538c0d19c46">&#9670;&nbsp;</a></span>deactivate() <span class="overload">[1/2]</span></h2>
  1041. <div class="memitem">
  1042. <div class="memproto">
  1043. <table class="mlabels">
  1044. <tr>
  1045. <td class="mlabels-left">
  1046. <table class="memname">
  1047. <tr>
  1048. <td class="memname">virtual void Plugin::deactivate </td>
  1049. <td>(</td>
  1050. <td class="paramname"></td><td>)</td>
  1051. <td></td>
  1052. </tr>
  1053. </table>
  1054. </td>
  1055. <td class="mlabels-right">
  1056. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1057. </tr>
  1058. </table>
  1059. </div><div class="memdoc">
  1060. <p>Deactivate this plugin. </p>
  1061. </div>
  1062. </div>
  1063. <a id="a0a969c78f8455ac6ba65fa42e8c498f6"></a>
  1064. <h2 class="memtitle"><span class="permalink"><a href="#a0a969c78f8455ac6ba65fa42e8c498f6">&#9670;&nbsp;</a></span>run() <span class="overload">[1/2]</span></h2>
  1065. <div class="memitem">
  1066. <div class="memproto">
  1067. <table class="mlabels">
  1068. <tr>
  1069. <td class="mlabels-left">
  1070. <table class="memname">
  1071. <tr>
  1072. <td class="memname">virtual void Plugin::run </td>
  1073. <td>(</td>
  1074. <td class="paramtype">const float **&#160;</td>
  1075. <td class="paramname"><em>inputs</em>, </td>
  1076. </tr>
  1077. <tr>
  1078. <td class="paramkey"></td>
  1079. <td></td>
  1080. <td class="paramtype">float **&#160;</td>
  1081. <td class="paramname"><em>outputs</em>, </td>
  1082. </tr>
  1083. <tr>
  1084. <td class="paramkey"></td>
  1085. <td></td>
  1086. <td class="paramtype">uint32_t&#160;</td>
  1087. <td class="paramname"><em>frames</em>, </td>
  1088. </tr>
  1089. <tr>
  1090. <td class="paramkey"></td>
  1091. <td></td>
  1092. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> *&#160;</td>
  1093. <td class="paramname"><em>midiEvents</em>, </td>
  1094. </tr>
  1095. <tr>
  1096. <td class="paramkey"></td>
  1097. <td></td>
  1098. <td class="paramtype">uint32_t&#160;</td>
  1099. <td class="paramname"><em>midiEventCount</em>&#160;</td>
  1100. </tr>
  1101. <tr>
  1102. <td></td>
  1103. <td>)</td>
  1104. <td></td><td></td>
  1105. </tr>
  1106. </table>
  1107. </td>
  1108. <td class="mlabels-right">
  1109. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1110. </tr>
  1111. </table>
  1112. </div><div class="memdoc">
  1113. <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>
  1114. </div>
  1115. </div>
  1116. <a id="a9f6c8ad6b054056649d0250e527e1297"></a>
  1117. <h2 class="memtitle"><span class="permalink"><a href="#a9f6c8ad6b054056649d0250e527e1297">&#9670;&nbsp;</a></span>bufferSizeChanged() <span class="overload">[1/2]</span></h2>
  1118. <div class="memitem">
  1119. <div class="memproto">
  1120. <table class="mlabels">
  1121. <tr>
  1122. <td class="mlabels-left">
  1123. <table class="memname">
  1124. <tr>
  1125. <td class="memname">virtual void Plugin::bufferSizeChanged </td>
  1126. <td>(</td>
  1127. <td class="paramtype">uint32_t&#160;</td>
  1128. <td class="paramname"><em>newBufferSize</em></td><td>)</td>
  1129. <td></td>
  1130. </tr>
  1131. </table>
  1132. </td>
  1133. <td class="mlabels-right">
  1134. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1135. </tr>
  1136. </table>
  1137. </div><div class="memdoc">
  1138. <p>Optional callback to inform the plugin about a buffer size change.<br />
  1139. 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 />
  1140. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  1141. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a2643e638f62cfd4990247ec66bed60d2">getBufferSize()</a> </dd></dl>
  1142. </div>
  1143. </div>
  1144. <a id="a2fcbfa1893f44e661d0d8cd53391dadc"></a>
  1145. <h2 class="memtitle"><span class="permalink"><a href="#a2fcbfa1893f44e661d0d8cd53391dadc">&#9670;&nbsp;</a></span>sampleRateChanged() <span class="overload">[1/2]</span></h2>
  1146. <div class="memitem">
  1147. <div class="memproto">
  1148. <table class="mlabels">
  1149. <tr>
  1150. <td class="mlabels-left">
  1151. <table class="memname">
  1152. <tr>
  1153. <td class="memname">virtual void Plugin::sampleRateChanged </td>
  1154. <td>(</td>
  1155. <td class="paramtype">double&#160;</td>
  1156. <td class="paramname"><em>newSampleRate</em></td><td>)</td>
  1157. <td></td>
  1158. </tr>
  1159. </table>
  1160. </td>
  1161. <td class="mlabels-right">
  1162. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1163. </tr>
  1164. </table>
  1165. </div><div class="memdoc">
  1166. <p>Optional callback to inform the plugin about a sample rate change.<br />
  1167. 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>
  1168. </div>
  1169. </div>
  1170. <a id="a2643e638f62cfd4990247ec66bed60d2"></a>
  1171. <h2 class="memtitle"><span class="permalink"><a href="#a2643e638f62cfd4990247ec66bed60d2">&#9670;&nbsp;</a></span>getBufferSize() <span class="overload">[2/2]</span></h2>
  1172. <div class="memitem">
  1173. <div class="memproto">
  1174. <table class="mlabels">
  1175. <tr>
  1176. <td class="mlabels-left">
  1177. <table class="memname">
  1178. <tr>
  1179. <td class="memname">uint32_t Plugin::getBufferSize </td>
  1180. <td>(</td>
  1181. <td class="paramname"></td><td>)</td>
  1182. <td> const</td>
  1183. </tr>
  1184. </table>
  1185. </td>
  1186. <td class="mlabels-right">
  1187. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  1188. </tr>
  1189. </table>
  1190. </div><div class="memdoc">
  1191. <p>Get the current buffer size that will probably be used during processing, in frames.<br />
  1192. 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 />
  1193. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  1194. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a9f6c8ad6b054056649d0250e527e1297">bufferSizeChanged(uint32_t)</a> </dd></dl>
  1195. </div>
  1196. </div>
  1197. <a id="a3e162cfe8f1c52bf09805fd327bcc3c4"></a>
  1198. <h2 class="memtitle"><span class="permalink"><a href="#a3e162cfe8f1c52bf09805fd327bcc3c4">&#9670;&nbsp;</a></span>getSampleRate() <span class="overload">[2/2]</span></h2>
  1199. <div class="memitem">
  1200. <div class="memproto">
  1201. <table class="mlabels">
  1202. <tr>
  1203. <td class="mlabels-left">
  1204. <table class="memname">
  1205. <tr>
  1206. <td class="memname">double Plugin::getSampleRate </td>
  1207. <td>(</td>
  1208. <td class="paramname"></td><td>)</td>
  1209. <td> const</td>
  1210. </tr>
  1211. </table>
  1212. </td>
  1213. <td class="mlabels-right">
  1214. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  1215. </tr>
  1216. </table>
  1217. </div><div class="memdoc">
  1218. <p>Get the current sample rate that will be used during processing.<br />
  1219. 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>
  1220. </div>
  1221. </div>
  1222. <a id="ae85d602c430b1a4361a88d714d3a42c1"></a>
  1223. <h2 class="memtitle"><span class="permalink"><a href="#ae85d602c430b1a4361a88d714d3a42c1">&#9670;&nbsp;</a></span>getTimePosition() <span class="overload">[2/2]</span></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">const <a class="el" href="structTimePosition.html">TimePosition</a>&amp; Plugin::getTimePosition </td>
  1232. <td>(</td>
  1233. <td class="paramname"></td><td>)</td>
  1234. <td> const</td>
  1235. </tr>
  1236. </table>
  1237. </td>
  1238. <td class="mlabels-right">
  1239. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  1240. </tr>
  1241. </table>
  1242. </div><div class="memdoc">
  1243. <p>Get the current host transport time position.<br />
  1244. This function should only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  1245. 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>
  1246. </div>
  1247. </div>
  1248. <a id="a2a70c4ec55d74d9bc26862975d8df8a7"></a>
  1249. <h2 class="memtitle"><span class="permalink"><a href="#a2a70c4ec55d74d9bc26862975d8df8a7">&#9670;&nbsp;</a></span>setLatency() <span class="overload">[2/2]</span></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">void Plugin::setLatency </td>
  1258. <td>(</td>
  1259. <td class="paramtype">uint32_t&#160;</td>
  1260. <td class="paramname"><em>frames</em></td><td>)</td>
  1261. <td></td>
  1262. </tr>
  1263. </table>
  1264. </td>
  1265. <td class="mlabels-right">
  1266. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  1267. </tr>
  1268. </table>
  1269. </div><div class="memdoc">
  1270. <p>Change the plugin audio output latency to <em>frames</em>.<br />
  1271. 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>
  1272. </div>
  1273. </div>
  1274. <a id="a0467eef817ac130cbbe1c0fbe09660c6"></a>
  1275. <h2 class="memtitle"><span class="permalink"><a href="#a0467eef817ac130cbbe1c0fbe09660c6">&#9670;&nbsp;</a></span>writeMidiEvent() <span class="overload">[2/2]</span></h2>
  1276. <div class="memitem">
  1277. <div class="memproto">
  1278. <table class="mlabels">
  1279. <tr>
  1280. <td class="mlabels-left">
  1281. <table class="memname">
  1282. <tr>
  1283. <td class="memname">bool Plugin::writeMidiEvent </td>
  1284. <td>(</td>
  1285. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> &amp;&#160;</td>
  1286. <td class="paramname"><em>midiEvent</em></td><td>)</td>
  1287. <td></td>
  1288. </tr>
  1289. </table>
  1290. </td>
  1291. <td class="mlabels-right">
  1292. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  1293. </tr>
  1294. </table>
  1295. </div><div class="memdoc">
  1296. <p>Write a MIDI output event.<br />
  1297. This function must only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  1298. 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>
  1299. </div>
  1300. </div>
  1301. <a id="aebb5df5cde162462dc460d4fd45dae75"></a>
  1302. <h2 class="memtitle"><span class="permalink"><a href="#aebb5df5cde162462dc460d4fd45dae75">&#9670;&nbsp;</a></span>getName() <span class="overload">[2/2]</span></h2>
  1303. <div class="memitem">
  1304. <div class="memproto">
  1305. <table class="mlabels">
  1306. <tr>
  1307. <td class="mlabels-left">
  1308. <table class="memname">
  1309. <tr>
  1310. <td class="memname">virtual const char* Plugin::getName </td>
  1311. <td>(</td>
  1312. <td class="paramname"></td><td>)</td>
  1313. <td> const</td>
  1314. </tr>
  1315. </table>
  1316. </td>
  1317. <td class="mlabels-right">
  1318. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1319. </tr>
  1320. </table>
  1321. </div><div class="memdoc">
  1322. <p>Get the plugin name.<br />
  1323. Returns DISTRHO_PLUGIN_NAME by default. </p>
  1324. </div>
  1325. </div>
  1326. <a id="a00f7945c16149db6845fbcc2af729f4f"></a>
  1327. <h2 class="memtitle"><span class="permalink"><a href="#a00f7945c16149db6845fbcc2af729f4f">&#9670;&nbsp;</a></span>getLabel() <span class="overload">[2/2]</span></h2>
  1328. <div class="memitem">
  1329. <div class="memproto">
  1330. <table class="mlabels">
  1331. <tr>
  1332. <td class="mlabels-left">
  1333. <table class="memname">
  1334. <tr>
  1335. <td class="memname">virtual const char* Plugin::getLabel </td>
  1336. <td>(</td>
  1337. <td class="paramname"></td><td>)</td>
  1338. <td> const</td>
  1339. </tr>
  1340. </table>
  1341. </td>
  1342. <td class="mlabels-right">
  1343. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1344. </tr>
  1345. </table>
  1346. </div><div class="memdoc">
  1347. <p>Get the plugin label.<br />
  1348. This label is a short restricted name consisting of only _, a-z, A-Z and 0-9 characters. </p>
  1349. </div>
  1350. </div>
  1351. <a id="a30db5eef9de617f4c81d5c6925facea3"></a>
  1352. <h2 class="memtitle"><span class="permalink"><a href="#a30db5eef9de617f4c81d5c6925facea3">&#9670;&nbsp;</a></span>getDescription() <span class="overload">[2/2]</span></h2>
  1353. <div class="memitem">
  1354. <div class="memproto">
  1355. <table class="mlabels">
  1356. <tr>
  1357. <td class="mlabels-left">
  1358. <table class="memname">
  1359. <tr>
  1360. <td class="memname">virtual const char* Plugin::getDescription </td>
  1361. <td>(</td>
  1362. <td class="paramname"></td><td>)</td>
  1363. <td> const</td>
  1364. </tr>
  1365. </table>
  1366. </td>
  1367. <td class="mlabels-right">
  1368. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1369. </tr>
  1370. </table>
  1371. </div><div class="memdoc">
  1372. <p>Get an extensive comment/description about the plugin.<br />
  1373. Optional, returns nothing by default. </p>
  1374. </div>
  1375. </div>
  1376. <a id="a955832840de786a7a22798f0ef451c5d"></a>
  1377. <h2 class="memtitle"><span class="permalink"><a href="#a955832840de786a7a22798f0ef451c5d">&#9670;&nbsp;</a></span>getMaker() <span class="overload">[2/2]</span></h2>
  1378. <div class="memitem">
  1379. <div class="memproto">
  1380. <table class="mlabels">
  1381. <tr>
  1382. <td class="mlabels-left">
  1383. <table class="memname">
  1384. <tr>
  1385. <td class="memname">virtual const char* Plugin::getMaker </td>
  1386. <td>(</td>
  1387. <td class="paramname"></td><td>)</td>
  1388. <td> const</td>
  1389. </tr>
  1390. </table>
  1391. </td>
  1392. <td class="mlabels-right">
  1393. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1394. </tr>
  1395. </table>
  1396. </div><div class="memdoc">
  1397. <p>Get the plugin author/maker. </p>
  1398. </div>
  1399. </div>
  1400. <a id="ad12c681ce31004da0badd609763f45c5"></a>
  1401. <h2 class="memtitle"><span class="permalink"><a href="#ad12c681ce31004da0badd609763f45c5">&#9670;&nbsp;</a></span>getHomePage() <span class="overload">[2/2]</span></h2>
  1402. <div class="memitem">
  1403. <div class="memproto">
  1404. <table class="mlabels">
  1405. <tr>
  1406. <td class="mlabels-left">
  1407. <table class="memname">
  1408. <tr>
  1409. <td class="memname">virtual const char* Plugin::getHomePage </td>
  1410. <td>(</td>
  1411. <td class="paramname"></td><td>)</td>
  1412. <td> const</td>
  1413. </tr>
  1414. </table>
  1415. </td>
  1416. <td class="mlabels-right">
  1417. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1418. </tr>
  1419. </table>
  1420. </div><div class="memdoc">
  1421. <p>Get the plugin homepage.<br />
  1422. Optional, returns nothing by default. </p>
  1423. </div>
  1424. </div>
  1425. <a id="a686a3c92a376a185d6fd97efd59125d1"></a>
  1426. <h2 class="memtitle"><span class="permalink"><a href="#a686a3c92a376a185d6fd97efd59125d1">&#9670;&nbsp;</a></span>getLicense() <span class="overload">[2/2]</span></h2>
  1427. <div class="memitem">
  1428. <div class="memproto">
  1429. <table class="mlabels">
  1430. <tr>
  1431. <td class="mlabels-left">
  1432. <table class="memname">
  1433. <tr>
  1434. <td class="memname">virtual const char* Plugin::getLicense </td>
  1435. <td>(</td>
  1436. <td class="paramname"></td><td>)</td>
  1437. <td> const</td>
  1438. </tr>
  1439. </table>
  1440. </td>
  1441. <td class="mlabels-right">
  1442. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1443. </tr>
  1444. </table>
  1445. </div><div class="memdoc">
  1446. <p>Get the plugin license (a single line of text or a URL).<br />
  1447. For commercial plugins this should return some short copyright information. </p>
  1448. </div>
  1449. </div>
  1450. <a id="abae540dd93caf4834270358a8aad334a"></a>
  1451. <h2 class="memtitle"><span class="permalink"><a href="#abae540dd93caf4834270358a8aad334a">&#9670;&nbsp;</a></span>getVersion() <span class="overload">[2/2]</span></h2>
  1452. <div class="memitem">
  1453. <div class="memproto">
  1454. <table class="mlabels">
  1455. <tr>
  1456. <td class="mlabels-left">
  1457. <table class="memname">
  1458. <tr>
  1459. <td class="memname">virtual uint32_t Plugin::getVersion </td>
  1460. <td>(</td>
  1461. <td class="paramname"></td><td>)</td>
  1462. <td> const</td>
  1463. </tr>
  1464. </table>
  1465. </td>
  1466. <td class="mlabels-right">
  1467. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1468. </tr>
  1469. </table>
  1470. </div><div class="memdoc">
  1471. <p>Get the plugin version, in hexadecimal. </p><dl class="section see"><dt>See also</dt><dd>d_version() </dd></dl>
  1472. </div>
  1473. </div>
  1474. <a id="ad6ff8c80227d5ceebd40b96f3be29a66"></a>
  1475. <h2 class="memtitle"><span class="permalink"><a href="#ad6ff8c80227d5ceebd40b96f3be29a66">&#9670;&nbsp;</a></span>getUniqueId() <span class="overload">[2/2]</span></h2>
  1476. <div class="memitem">
  1477. <div class="memproto">
  1478. <table class="mlabels">
  1479. <tr>
  1480. <td class="mlabels-left">
  1481. <table class="memname">
  1482. <tr>
  1483. <td class="memname">virtual int64_t Plugin::getUniqueId </td>
  1484. <td>(</td>
  1485. <td class="paramname"></td><td>)</td>
  1486. <td> const</td>
  1487. </tr>
  1488. </table>
  1489. </td>
  1490. <td class="mlabels-right">
  1491. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1492. </tr>
  1493. </table>
  1494. </div><div class="memdoc">
  1495. <p>Get the plugin unique Id.<br />
  1496. This value is used by LADSPA, DSSI and VST plugin formats. </p><dl class="section see"><dt>See also</dt><dd>d_cconst() </dd></dl>
  1497. </div>
  1498. </div>
  1499. <a id="a75f30935198a0acba25f4ea92af72dc4"></a>
  1500. <h2 class="memtitle"><span class="permalink"><a href="#a75f30935198a0acba25f4ea92af72dc4">&#9670;&nbsp;</a></span>initAudioPort() <span class="overload">[2/2]</span></h2>
  1501. <div class="memitem">
  1502. <div class="memproto">
  1503. <table class="mlabels">
  1504. <tr>
  1505. <td class="mlabels-left">
  1506. <table class="memname">
  1507. <tr>
  1508. <td class="memname">virtual void Plugin::initAudioPort </td>
  1509. <td>(</td>
  1510. <td class="paramtype">bool&#160;</td>
  1511. <td class="paramname"><em>input</em>, </td>
  1512. </tr>
  1513. <tr>
  1514. <td class="paramkey"></td>
  1515. <td></td>
  1516. <td class="paramtype">uint32_t&#160;</td>
  1517. <td class="paramname"><em>index</em>, </td>
  1518. </tr>
  1519. <tr>
  1520. <td class="paramkey"></td>
  1521. <td></td>
  1522. <td class="paramtype"><a class="el" href="structAudioPort.html">AudioPort</a> &amp;&#160;</td>
  1523. <td class="paramname"><em>port</em>&#160;</td>
  1524. </tr>
  1525. <tr>
  1526. <td></td>
  1527. <td>)</td>
  1528. <td></td><td></td>
  1529. </tr>
  1530. </table>
  1531. </td>
  1532. <td class="mlabels-right">
  1533. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1534. </tr>
  1535. </table>
  1536. </div><div class="memdoc">
  1537. <p>Initialize the audio port <em>index</em>.<br />
  1538. This function will be called once, shortly after the plugin is created. </p>
  1539. </div>
  1540. </div>
  1541. <a id="a5b0ec59527a1c2f4b01f17fc8c18ea8b"></a>
  1542. <h2 class="memtitle"><span class="permalink"><a href="#a5b0ec59527a1c2f4b01f17fc8c18ea8b">&#9670;&nbsp;</a></span>initParameter() <span class="overload">[2/2]</span></h2>
  1543. <div class="memitem">
  1544. <div class="memproto">
  1545. <table class="mlabels">
  1546. <tr>
  1547. <td class="mlabels-left">
  1548. <table class="memname">
  1549. <tr>
  1550. <td class="memname">virtual void Plugin::initParameter </td>
  1551. <td>(</td>
  1552. <td class="paramtype">uint32_t&#160;</td>
  1553. <td class="paramname"><em>index</em>, </td>
  1554. </tr>
  1555. <tr>
  1556. <td class="paramkey"></td>
  1557. <td></td>
  1558. <td class="paramtype"><a class="el" href="structParameter.html">Parameter</a> &amp;&#160;</td>
  1559. <td class="paramname"><em>parameter</em>&#160;</td>
  1560. </tr>
  1561. <tr>
  1562. <td></td>
  1563. <td>)</td>
  1564. <td></td><td></td>
  1565. </tr>
  1566. </table>
  1567. </td>
  1568. <td class="mlabels-right">
  1569. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1570. </tr>
  1571. </table>
  1572. </div><div class="memdoc">
  1573. <p>Initialize the parameter <em>index</em>.<br />
  1574. This function will be called once, shortly after the plugin is created. </p>
  1575. </div>
  1576. </div>
  1577. <a id="a54d66af3111541b7c118f9749ef0231b"></a>
  1578. <h2 class="memtitle"><span class="permalink"><a href="#a54d66af3111541b7c118f9749ef0231b">&#9670;&nbsp;</a></span>initProgramName() <span class="overload">[2/2]</span></h2>
  1579. <div class="memitem">
  1580. <div class="memproto">
  1581. <table class="mlabels">
  1582. <tr>
  1583. <td class="mlabels-left">
  1584. <table class="memname">
  1585. <tr>
  1586. <td class="memname">virtual void Plugin::initProgramName </td>
  1587. <td>(</td>
  1588. <td class="paramtype">uint32_t&#160;</td>
  1589. <td class="paramname"><em>index</em>, </td>
  1590. </tr>
  1591. <tr>
  1592. <td class="paramkey"></td>
  1593. <td></td>
  1594. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  1595. <td class="paramname"><em>programName</em>&#160;</td>
  1596. </tr>
  1597. <tr>
  1598. <td></td>
  1599. <td>)</td>
  1600. <td></td><td></td>
  1601. </tr>
  1602. </table>
  1603. </td>
  1604. <td class="mlabels-right">
  1605. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1606. </tr>
  1607. </table>
  1608. </div><div class="memdoc">
  1609. <p>Set the name of the program <em>index</em>.<br />
  1610. This function will be called once, shortly after the plugin is created.<br />
  1611. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  1612. </div>
  1613. </div>
  1614. <a id="ae301a970a8b5cff3c7ecef927ea20080"></a>
  1615. <h2 class="memtitle"><span class="permalink"><a href="#ae301a970a8b5cff3c7ecef927ea20080">&#9670;&nbsp;</a></span>initState() <span class="overload">[2/2]</span></h2>
  1616. <div class="memitem">
  1617. <div class="memproto">
  1618. <table class="mlabels">
  1619. <tr>
  1620. <td class="mlabels-left">
  1621. <table class="memname">
  1622. <tr>
  1623. <td class="memname">virtual void Plugin::initState </td>
  1624. <td>(</td>
  1625. <td class="paramtype">uint32_t&#160;</td>
  1626. <td class="paramname"><em>index</em>, </td>
  1627. </tr>
  1628. <tr>
  1629. <td class="paramkey"></td>
  1630. <td></td>
  1631. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  1632. <td class="paramname"><em>stateKey</em>, </td>
  1633. </tr>
  1634. <tr>
  1635. <td class="paramkey"></td>
  1636. <td></td>
  1637. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  1638. <td class="paramname"><em>defaultStateValue</em>&#160;</td>
  1639. </tr>
  1640. <tr>
  1641. <td></td>
  1642. <td>)</td>
  1643. <td></td><td></td>
  1644. </tr>
  1645. </table>
  1646. </td>
  1647. <td class="mlabels-right">
  1648. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1649. </tr>
  1650. </table>
  1651. </div><div class="memdoc">
  1652. <p>Set the state key and default value of <em>index</em>.<br />
  1653. This function will be called once, shortly after the plugin is created.<br />
  1654. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  1655. </div>
  1656. </div>
  1657. <a id="a2d1da98c90568bb4547662bc4f02c31f"></a>
  1658. <h2 class="memtitle"><span class="permalink"><a href="#a2d1da98c90568bb4547662bc4f02c31f">&#9670;&nbsp;</a></span>getParameterValue() <span class="overload">[2/2]</span></h2>
  1659. <div class="memitem">
  1660. <div class="memproto">
  1661. <table class="mlabels">
  1662. <tr>
  1663. <td class="mlabels-left">
  1664. <table class="memname">
  1665. <tr>
  1666. <td class="memname">virtual float Plugin::getParameterValue </td>
  1667. <td>(</td>
  1668. <td class="paramtype">uint32_t&#160;</td>
  1669. <td class="paramname"><em>index</em></td><td>)</td>
  1670. <td> const</td>
  1671. </tr>
  1672. </table>
  1673. </td>
  1674. <td class="mlabels-right">
  1675. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1676. </tr>
  1677. </table>
  1678. </div><div class="memdoc">
  1679. <p>Get the current value of a parameter.<br />
  1680. The host may call this function from any context, including realtime processing. </p>
  1681. </div>
  1682. </div>
  1683. <a id="a6911a881fabb9eca9daf0eadbaad8599"></a>
  1684. <h2 class="memtitle"><span class="permalink"><a href="#a6911a881fabb9eca9daf0eadbaad8599">&#9670;&nbsp;</a></span>setParameterValue() <span class="overload">[2/2]</span></h2>
  1685. <div class="memitem">
  1686. <div class="memproto">
  1687. <table class="mlabels">
  1688. <tr>
  1689. <td class="mlabels-left">
  1690. <table class="memname">
  1691. <tr>
  1692. <td class="memname">virtual void Plugin::setParameterValue </td>
  1693. <td>(</td>
  1694. <td class="paramtype">uint32_t&#160;</td>
  1695. <td class="paramname"><em>index</em>, </td>
  1696. </tr>
  1697. <tr>
  1698. <td class="paramkey"></td>
  1699. <td></td>
  1700. <td class="paramtype">float&#160;</td>
  1701. <td class="paramname"><em>value</em>&#160;</td>
  1702. </tr>
  1703. <tr>
  1704. <td></td>
  1705. <td>)</td>
  1706. <td></td><td></td>
  1707. </tr>
  1708. </table>
  1709. </td>
  1710. <td class="mlabels-right">
  1711. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1712. </tr>
  1713. </table>
  1714. </div><div class="memdoc">
  1715. <p>Change a parameter value.<br />
  1716. The host may call this function from any context, including realtime processing.<br />
  1717. When a parameter is marked as automable, 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>
  1718. </div>
  1719. </div>
  1720. <a id="ab629f35c60406d6f2c0b9d530e67cf09"></a>
  1721. <h2 class="memtitle"><span class="permalink"><a href="#ab629f35c60406d6f2c0b9d530e67cf09">&#9670;&nbsp;</a></span>loadProgram() <span class="overload">[2/2]</span></h2>
  1722. <div class="memitem">
  1723. <div class="memproto">
  1724. <table class="mlabels">
  1725. <tr>
  1726. <td class="mlabels-left">
  1727. <table class="memname">
  1728. <tr>
  1729. <td class="memname">virtual void Plugin::loadProgram </td>
  1730. <td>(</td>
  1731. <td class="paramtype">uint32_t&#160;</td>
  1732. <td class="paramname"><em>index</em></td><td>)</td>
  1733. <td></td>
  1734. </tr>
  1735. </table>
  1736. </td>
  1737. <td class="mlabels-right">
  1738. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1739. </tr>
  1740. </table>
  1741. </div><div class="memdoc">
  1742. <p>Load a program.<br />
  1743. The host may call this function from any context, including realtime processing.<br />
  1744. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  1745. </div>
  1746. </div>
  1747. <a id="a84af70cd84fa4c3054caaa8affaab8f1"></a>
  1748. <h2 class="memtitle"><span class="permalink"><a href="#a84af70cd84fa4c3054caaa8affaab8f1">&#9670;&nbsp;</a></span>getState() <span class="overload">[2/2]</span></h2>
  1749. <div class="memitem">
  1750. <div class="memproto">
  1751. <table class="mlabels">
  1752. <tr>
  1753. <td class="mlabels-left">
  1754. <table class="memname">
  1755. <tr>
  1756. <td class="memname">virtual <a class="el" href="classString.html">String</a> Plugin::getState </td>
  1757. <td>(</td>
  1758. <td class="paramtype">const char *&#160;</td>
  1759. <td class="paramname"><em>key</em></td><td>)</td>
  1760. <td> const</td>
  1761. </tr>
  1762. </table>
  1763. </td>
  1764. <td class="mlabels-right">
  1765. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1766. </tr>
  1767. </table>
  1768. </div><div class="memdoc">
  1769. <p>Get the value of an internal state.<br />
  1770. The host may call this function from any non-realtime context.<br />
  1771. 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>
  1772. </div>
  1773. </div>
  1774. <a id="ad25ed64a2f00f48c86d2ae0016ea3e59"></a>
  1775. <h2 class="memtitle"><span class="permalink"><a href="#ad25ed64a2f00f48c86d2ae0016ea3e59">&#9670;&nbsp;</a></span>setState() <span class="overload">[2/2]</span></h2>
  1776. <div class="memitem">
  1777. <div class="memproto">
  1778. <table class="mlabels">
  1779. <tr>
  1780. <td class="mlabels-left">
  1781. <table class="memname">
  1782. <tr>
  1783. <td class="memname">virtual void Plugin::setState </td>
  1784. <td>(</td>
  1785. <td class="paramtype">const char *&#160;</td>
  1786. <td class="paramname"><em>key</em>, </td>
  1787. </tr>
  1788. <tr>
  1789. <td class="paramkey"></td>
  1790. <td></td>
  1791. <td class="paramtype">const char *&#160;</td>
  1792. <td class="paramname"><em>value</em>&#160;</td>
  1793. </tr>
  1794. <tr>
  1795. <td></td>
  1796. <td>)</td>
  1797. <td></td><td></td>
  1798. </tr>
  1799. </table>
  1800. </td>
  1801. <td class="mlabels-right">
  1802. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1803. </tr>
  1804. </table>
  1805. </div><div class="memdoc">
  1806. <p>Change an internal state <em>key</em> to <em>value</em>.<br />
  1807. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  1808. </div>
  1809. </div>
  1810. <a id="aa5c1262f5ca20536bb5850fdd6faa22c"></a>
  1811. <h2 class="memtitle"><span class="permalink"><a href="#aa5c1262f5ca20536bb5850fdd6faa22c">&#9670;&nbsp;</a></span>activate() <span class="overload">[2/2]</span></h2>
  1812. <div class="memitem">
  1813. <div class="memproto">
  1814. <table class="mlabels">
  1815. <tr>
  1816. <td class="mlabels-left">
  1817. <table class="memname">
  1818. <tr>
  1819. <td class="memname">virtual void Plugin::activate </td>
  1820. <td>(</td>
  1821. <td class="paramname"></td><td>)</td>
  1822. <td></td>
  1823. </tr>
  1824. </table>
  1825. </td>
  1826. <td class="mlabels-right">
  1827. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1828. </tr>
  1829. </table>
  1830. </div><div class="memdoc">
  1831. <p>Activate this plugin. </p>
  1832. </div>
  1833. </div>
  1834. <a id="aa089a56572bc8f1cb7e4b538c0d19c46"></a>
  1835. <h2 class="memtitle"><span class="permalink"><a href="#aa089a56572bc8f1cb7e4b538c0d19c46">&#9670;&nbsp;</a></span>deactivate() <span class="overload">[2/2]</span></h2>
  1836. <div class="memitem">
  1837. <div class="memproto">
  1838. <table class="mlabels">
  1839. <tr>
  1840. <td class="mlabels-left">
  1841. <table class="memname">
  1842. <tr>
  1843. <td class="memname">virtual void Plugin::deactivate </td>
  1844. <td>(</td>
  1845. <td class="paramname"></td><td>)</td>
  1846. <td></td>
  1847. </tr>
  1848. </table>
  1849. </td>
  1850. <td class="mlabels-right">
  1851. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1852. </tr>
  1853. </table>
  1854. </div><div class="memdoc">
  1855. <p>Deactivate this plugin. </p>
  1856. </div>
  1857. </div>
  1858. <a id="a0a969c78f8455ac6ba65fa42e8c498f6"></a>
  1859. <h2 class="memtitle"><span class="permalink"><a href="#a0a969c78f8455ac6ba65fa42e8c498f6">&#9670;&nbsp;</a></span>run() <span class="overload">[2/2]</span></h2>
  1860. <div class="memitem">
  1861. <div class="memproto">
  1862. <table class="mlabels">
  1863. <tr>
  1864. <td class="mlabels-left">
  1865. <table class="memname">
  1866. <tr>
  1867. <td class="memname">virtual void Plugin::run </td>
  1868. <td>(</td>
  1869. <td class="paramtype">const float **&#160;</td>
  1870. <td class="paramname"><em>inputs</em>, </td>
  1871. </tr>
  1872. <tr>
  1873. <td class="paramkey"></td>
  1874. <td></td>
  1875. <td class="paramtype">float **&#160;</td>
  1876. <td class="paramname"><em>outputs</em>, </td>
  1877. </tr>
  1878. <tr>
  1879. <td class="paramkey"></td>
  1880. <td></td>
  1881. <td class="paramtype">uint32_t&#160;</td>
  1882. <td class="paramname"><em>frames</em>, </td>
  1883. </tr>
  1884. <tr>
  1885. <td class="paramkey"></td>
  1886. <td></td>
  1887. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> *&#160;</td>
  1888. <td class="paramname"><em>midiEvents</em>, </td>
  1889. </tr>
  1890. <tr>
  1891. <td class="paramkey"></td>
  1892. <td></td>
  1893. <td class="paramtype">uint32_t&#160;</td>
  1894. <td class="paramname"><em>midiEventCount</em>&#160;</td>
  1895. </tr>
  1896. <tr>
  1897. <td></td>
  1898. <td>)</td>
  1899. <td></td><td></td>
  1900. </tr>
  1901. </table>
  1902. </td>
  1903. <td class="mlabels-right">
  1904. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  1905. </tr>
  1906. </table>
  1907. </div><div class="memdoc">
  1908. <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>
  1909. </div>
  1910. </div>
  1911. <a id="a9f6c8ad6b054056649d0250e527e1297"></a>
  1912. <h2 class="memtitle"><span class="permalink"><a href="#a9f6c8ad6b054056649d0250e527e1297">&#9670;&nbsp;</a></span>bufferSizeChanged() <span class="overload">[2/2]</span></h2>
  1913. <div class="memitem">
  1914. <div class="memproto">
  1915. <table class="mlabels">
  1916. <tr>
  1917. <td class="mlabels-left">
  1918. <table class="memname">
  1919. <tr>
  1920. <td class="memname">virtual void Plugin::bufferSizeChanged </td>
  1921. <td>(</td>
  1922. <td class="paramtype">uint32_t&#160;</td>
  1923. <td class="paramname"><em>newBufferSize</em></td><td>)</td>
  1924. <td></td>
  1925. </tr>
  1926. </table>
  1927. </td>
  1928. <td class="mlabels-right">
  1929. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1930. </tr>
  1931. </table>
  1932. </div><div class="memdoc">
  1933. <p>Optional callback to inform the plugin about a buffer size change.<br />
  1934. 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 />
  1935. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  1936. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a2643e638f62cfd4990247ec66bed60d2">getBufferSize()</a> </dd></dl>
  1937. </div>
  1938. </div>
  1939. <a id="a2fcbfa1893f44e661d0d8cd53391dadc"></a>
  1940. <h2 class="memtitle"><span class="permalink"><a href="#a2fcbfa1893f44e661d0d8cd53391dadc">&#9670;&nbsp;</a></span>sampleRateChanged() <span class="overload">[2/2]</span></h2>
  1941. <div class="memitem">
  1942. <div class="memproto">
  1943. <table class="mlabels">
  1944. <tr>
  1945. <td class="mlabels-left">
  1946. <table class="memname">
  1947. <tr>
  1948. <td class="memname">virtual void Plugin::sampleRateChanged </td>
  1949. <td>(</td>
  1950. <td class="paramtype">double&#160;</td>
  1951. <td class="paramname"><em>newSampleRate</em></td><td>)</td>
  1952. <td></td>
  1953. </tr>
  1954. </table>
  1955. </td>
  1956. <td class="mlabels-right">
  1957. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1958. </tr>
  1959. </table>
  1960. </div><div class="memdoc">
  1961. <p>Optional callback to inform the plugin about a sample rate change.<br />
  1962. 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>
  1963. </div>
  1964. </div>
  1965. <hr/>The documentation for this class was generated from the following files:<ul>
  1966. <li>distrho/<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a></li>
  1967. <li>distrho/<a class="el" href="DistrhoPluginLV2_8hpp_source.html">DistrhoPluginLV2.hpp</a></li>
  1968. </ul>
  1969. </div><!-- contents -->
  1970. <!-- start footer part -->
  1971. <hr class="footer"/><address class="footer"><small>
  1972. Generated on Mon Jun 14 2021 12:26:12 for DISTRHO Plugin Framework by &#160;<a href="http://www.doxygen.org/index.html">
  1973. <img class="footer" src="doxygen.png" alt="doxygen"/>
  1974. </a> 1.8.17
  1975. </small></address>
  1976. </body>
  1977. </html>