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.

1086 lines
49KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://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.13"/>
  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.13 -->
  33. <script type="text/javascript">
  34. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  35. </script>
  36. <script type="text/javascript" src="menudata.js"></script>
  37. <script type="text/javascript" src="menu.js"></script>
  38. <script type="text/javascript">
  39. $(function() {
  40. initMenu('',true,false,'search.php','Search');
  41. $(document).ready(function() { init_search(); });
  42. });
  43. </script>
  44. <div id="main-nav"></div>
  45. <!-- window showing the filter options -->
  46. <div id="MSearchSelectWindow"
  47. onmouseover="return searchBox.OnSearchSelectShow()"
  48. onmouseout="return searchBox.OnSearchSelectHide()"
  49. onkeydown="return searchBox.OnSearchSelectKey(event)">
  50. </div>
  51. <!-- iframe showing the search results (closed by default) -->
  52. <div id="MSearchResultsWindow">
  53. <iframe src="javascript:void(0)" frameborder="0"
  54. name="MSearchResults" id="MSearchResults">
  55. </iframe>
  56. </div>
  57. </div><!-- top -->
  58. <div class="header">
  59. <div class="summary">
  60. <a href="#pub-methods">Public Member Functions</a> &#124;
  61. <a href="#pro-methods">Protected Member Functions</a> &#124;
  62. <a href="#friends">Friends</a> &#124;
  63. <a href="classPlugin-members.html">List of all members</a> </div>
  64. <div class="headertitle">
  65. <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>
  66. </div><!--header-->
  67. <div class="contents">
  68. <p><code>#include &lt;<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a>&gt;</code></p>
  69. <table class="memberdecls">
  70. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  71. Public Member Functions</h2></td></tr>
  72. <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>
  73. <tr class="separator:acb5a3632da5a5c4110172a3a78e1fd32"><td class="memSeparator" colspan="2">&#160;</td></tr>
  74. <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>
  75. <tr class="separator:a89814b8f0b1c91e49140d42eb8331383"><td class="memSeparator" colspan="2">&#160;</td></tr>
  76. <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>
  77. <tr class="separator:a2643e638f62cfd4990247ec66bed60d2"><td class="memSeparator" colspan="2">&#160;</td></tr>
  78. <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>
  79. <tr class="separator:a3e162cfe8f1c52bf09805fd327bcc3c4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  80. <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>
  81. <tr class="separator:ae85d602c430b1a4361a88d714d3a42c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  82. <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>
  83. <tr class="separator:a2a70c4ec55d74d9bc26862975d8df8a7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  84. <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>
  85. <tr class="separator:a0467eef817ac130cbbe1c0fbe09660c6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  86. </table><table class="memberdecls">
  87. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
  88. Protected Member Functions</h2></td></tr>
  89. <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>
  90. <tr class="separator:aebb5df5cde162462dc460d4fd45dae75"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91. <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>
  92. <tr class="separator:a00f7945c16149db6845fbcc2af729f4f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  93. <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>
  94. <tr class="separator:a30db5eef9de617f4c81d5c6925facea3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  95. <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>
  96. <tr class="separator:a955832840de786a7a22798f0ef451c5d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  97. <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>
  98. <tr class="separator:ad12c681ce31004da0badd609763f45c5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  99. <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>
  100. <tr class="separator:a686a3c92a376a185d6fd97efd59125d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  101. <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>
  102. <tr class="separator:abae540dd93caf4834270358a8aad334a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  103. <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>
  104. <tr class="separator:ad6ff8c80227d5ceebd40b96f3be29a66"><td class="memSeparator" colspan="2">&#160;</td></tr>
  105. <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>
  106. <tr class="separator:a75f30935198a0acba25f4ea92af72dc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  107. <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>
  108. <tr class="separator:a5b0ec59527a1c2f4b01f17fc8c18ea8b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  109. <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>
  110. <tr class="separator:a54d66af3111541b7c118f9749ef0231b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  111. <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>
  112. <tr class="separator:ae301a970a8b5cff3c7ecef927ea20080"><td class="memSeparator" colspan="2">&#160;</td></tr>
  113. <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>
  114. <tr class="separator:a2d1da98c90568bb4547662bc4f02c31f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  115. <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>
  116. <tr class="separator:a6911a881fabb9eca9daf0eadbaad8599"><td class="memSeparator" colspan="2">&#160;</td></tr>
  117. <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>
  118. <tr class="separator:ab629f35c60406d6f2c0b9d530e67cf09"><td class="memSeparator" colspan="2">&#160;</td></tr>
  119. <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>
  120. <tr class="separator:a84af70cd84fa4c3054caaa8affaab8f1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  121. <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>
  122. <tr class="separator:ad25ed64a2f00f48c86d2ae0016ea3e59"><td class="memSeparator" colspan="2">&#160;</td></tr>
  123. <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>
  124. <tr class="separator:aa5c1262f5ca20536bb5850fdd6faa22c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  125. <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>
  126. <tr class="separator:aa089a56572bc8f1cb7e4b538c0d19c46"><td class="memSeparator" colspan="2">&#160;</td></tr>
  127. <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>
  128. <tr class="separator:a0a969c78f8455ac6ba65fa42e8c498f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  129. <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>
  130. <tr class="separator:a9f6c8ad6b054056649d0250e527e1297"><td class="memSeparator" colspan="2">&#160;</td></tr>
  131. <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>
  132. <tr class="separator:a2fcbfa1893f44e661d0d8cd53391dadc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  133. </table><table class="memberdecls">
  134. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="friends"></a>
  135. Friends</h2></td></tr>
  136. <tr class="memitem:a37441261848b635971dab1ee767285dd"><td class="memItemLeft" align="right" valign="top"><a id="a37441261848b635971dab1ee767285dd"></a>
  137. class&#160;</td><td class="memItemRight" valign="bottom"><b>PluginExporter</b></td></tr>
  138. <tr class="separator:a37441261848b635971dab1ee767285dd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  139. </table>
  140. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  141. <div class="textblock"><p>DPF <a class="el" href="classPlugin.html">Plugin</a> class from where plugin instances are created.</p>
  142. <p>The public methods (Host state) are called from the plugin to get or set host information.<br />
  143. They can be called from a plugin instance at anytime unless stated otherwise.<br />
  144. All other methods are to be implemented by the plugin and will be called by the host.</p>
  145. <p>Shortly after a plugin instance is created, the various init* functions will be called by the host.<br />
  146. 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 />
  147. The host may call deactivate right after activate and vice-versa, but never activate/deactivate consecutively.<br />
  148. 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>
  149. <p>The buffer size and sample rate values will remain constant between activate and deactivate.<br />
  150. 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>
  151. <p>Some of this class functions are only available according to some macros.</p>
  152. <p>DISTRHO_PLUGIN_WANT_PROGRAMS activates program related features.<br />
  153. 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>
  154. <p>DISTRHO_PLUGIN_WANT_STATE activates internal state features.<br />
  155. When enabled you need to implement initStateKey() and <a class="el" href="classPlugin.html#ad25ed64a2f00f48c86d2ae0016ea3e59">setState()</a>.</p>
  156. <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 />
  157. When enabled it provides midi input events. </p>
  158. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  159. <a id="acb5a3632da5a5c4110172a3a78e1fd32"></a>
  160. <h2 class="memtitle"><span class="permalink"><a href="#acb5a3632da5a5c4110172a3a78e1fd32">&#9670;&nbsp;</a></span>Plugin()</h2>
  161. <div class="memitem">
  162. <div class="memproto">
  163. <table class="memname">
  164. <tr>
  165. <td class="memname">Plugin::Plugin </td>
  166. <td>(</td>
  167. <td class="paramtype">uint32_t&#160;</td>
  168. <td class="paramname"><em>parameterCount</em>, </td>
  169. </tr>
  170. <tr>
  171. <td class="paramkey"></td>
  172. <td></td>
  173. <td class="paramtype">uint32_t&#160;</td>
  174. <td class="paramname"><em>programCount</em>, </td>
  175. </tr>
  176. <tr>
  177. <td class="paramkey"></td>
  178. <td></td>
  179. <td class="paramtype">uint32_t&#160;</td>
  180. <td class="paramname"><em>stateCount</em>&#160;</td>
  181. </tr>
  182. <tr>
  183. <td></td>
  184. <td>)</td>
  185. <td></td><td></td>
  186. </tr>
  187. </table>
  188. </div><div class="memdoc">
  189. <p><a class="el" href="classPlugin.html">Plugin</a> class constructor.<br />
  190. You must set all parameter values to their defaults, matching <a class="el" href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">ParameterRanges::def</a>. </p>
  191. </div>
  192. </div>
  193. <a id="a89814b8f0b1c91e49140d42eb8331383"></a>
  194. <h2 class="memtitle"><span class="permalink"><a href="#a89814b8f0b1c91e49140d42eb8331383">&#9670;&nbsp;</a></span>~Plugin()</h2>
  195. <div class="memitem">
  196. <div class="memproto">
  197. <table class="mlabels">
  198. <tr>
  199. <td class="mlabels-left">
  200. <table class="memname">
  201. <tr>
  202. <td class="memname">virtual Plugin::~Plugin </td>
  203. <td>(</td>
  204. <td class="paramname"></td><td>)</td>
  205. <td></td>
  206. </tr>
  207. </table>
  208. </td>
  209. <td class="mlabels-right">
  210. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  211. </tr>
  212. </table>
  213. </div><div class="memdoc">
  214. <p>Destructor. </p>
  215. </div>
  216. </div>
  217. <h2 class="groupheader">Member Function Documentation</h2>
  218. <a id="a2643e638f62cfd4990247ec66bed60d2"></a>
  219. <h2 class="memtitle"><span class="permalink"><a href="#a2643e638f62cfd4990247ec66bed60d2">&#9670;&nbsp;</a></span>getBufferSize()</h2>
  220. <div class="memitem">
  221. <div class="memproto">
  222. <table class="mlabels">
  223. <tr>
  224. <td class="mlabels-left">
  225. <table class="memname">
  226. <tr>
  227. <td class="memname">uint32_t Plugin::getBufferSize </td>
  228. <td>(</td>
  229. <td class="paramname"></td><td>)</td>
  230. <td> const</td>
  231. </tr>
  232. </table>
  233. </td>
  234. <td class="mlabels-right">
  235. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  236. </tr>
  237. </table>
  238. </div><div class="memdoc">
  239. <p>Get the current buffer size that will probably be used during processing, in frames.<br />
  240. 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 />
  241. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  242. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a9f6c8ad6b054056649d0250e527e1297">bufferSizeChanged(uint32_t)</a> </dd></dl>
  243. </div>
  244. </div>
  245. <a id="a3e162cfe8f1c52bf09805fd327bcc3c4"></a>
  246. <h2 class="memtitle"><span class="permalink"><a href="#a3e162cfe8f1c52bf09805fd327bcc3c4">&#9670;&nbsp;</a></span>getSampleRate()</h2>
  247. <div class="memitem">
  248. <div class="memproto">
  249. <table class="mlabels">
  250. <tr>
  251. <td class="mlabels-left">
  252. <table class="memname">
  253. <tr>
  254. <td class="memname">double Plugin::getSampleRate </td>
  255. <td>(</td>
  256. <td class="paramname"></td><td>)</td>
  257. <td> const</td>
  258. </tr>
  259. </table>
  260. </td>
  261. <td class="mlabels-right">
  262. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  263. </tr>
  264. </table>
  265. </div><div class="memdoc">
  266. <p>Get the current sample rate that will be used during processing.<br />
  267. 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>
  268. </div>
  269. </div>
  270. <a id="ae85d602c430b1a4361a88d714d3a42c1"></a>
  271. <h2 class="memtitle"><span class="permalink"><a href="#ae85d602c430b1a4361a88d714d3a42c1">&#9670;&nbsp;</a></span>getTimePosition()</h2>
  272. <div class="memitem">
  273. <div class="memproto">
  274. <table class="mlabels">
  275. <tr>
  276. <td class="mlabels-left">
  277. <table class="memname">
  278. <tr>
  279. <td class="memname">const <a class="el" href="structTimePosition.html">TimePosition</a>&amp; Plugin::getTimePosition </td>
  280. <td>(</td>
  281. <td class="paramname"></td><td>)</td>
  282. <td> const</td>
  283. </tr>
  284. </table>
  285. </td>
  286. <td class="mlabels-right">
  287. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  288. </tr>
  289. </table>
  290. </div><div class="memdoc">
  291. <p>Get the current host transport time position.<br />
  292. This function should only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  293. 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>
  294. </div>
  295. </div>
  296. <a id="a2a70c4ec55d74d9bc26862975d8df8a7"></a>
  297. <h2 class="memtitle"><span class="permalink"><a href="#a2a70c4ec55d74d9bc26862975d8df8a7">&#9670;&nbsp;</a></span>setLatency()</h2>
  298. <div class="memitem">
  299. <div class="memproto">
  300. <table class="mlabels">
  301. <tr>
  302. <td class="mlabels-left">
  303. <table class="memname">
  304. <tr>
  305. <td class="memname">void Plugin::setLatency </td>
  306. <td>(</td>
  307. <td class="paramtype">uint32_t&#160;</td>
  308. <td class="paramname"><em>frames</em></td><td>)</td>
  309. <td></td>
  310. </tr>
  311. </table>
  312. </td>
  313. <td class="mlabels-right">
  314. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  315. </tr>
  316. </table>
  317. </div><div class="memdoc">
  318. <p>Change the plugin audio output latency to <em>frames</em>.<br />
  319. 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>
  320. </div>
  321. </div>
  322. <a id="a0467eef817ac130cbbe1c0fbe09660c6"></a>
  323. <h2 class="memtitle"><span class="permalink"><a href="#a0467eef817ac130cbbe1c0fbe09660c6">&#9670;&nbsp;</a></span>writeMidiEvent()</h2>
  324. <div class="memitem">
  325. <div class="memproto">
  326. <table class="mlabels">
  327. <tr>
  328. <td class="mlabels-left">
  329. <table class="memname">
  330. <tr>
  331. <td class="memname">bool Plugin::writeMidiEvent </td>
  332. <td>(</td>
  333. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> &amp;&#160;</td>
  334. <td class="paramname"><em>midiEvent</em></td><td>)</td>
  335. <td></td>
  336. </tr>
  337. </table>
  338. </td>
  339. <td class="mlabels-right">
  340. <span class="mlabels"><span class="mlabel">noexcept</span></span> </td>
  341. </tr>
  342. </table>
  343. </div><div class="memdoc">
  344. <p>Write a MIDI output event.<br />
  345. This function must only be called during <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a>.<br />
  346. 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>
  347. </div>
  348. </div>
  349. <a id="aebb5df5cde162462dc460d4fd45dae75"></a>
  350. <h2 class="memtitle"><span class="permalink"><a href="#aebb5df5cde162462dc460d4fd45dae75">&#9670;&nbsp;</a></span>getName()</h2>
  351. <div class="memitem">
  352. <div class="memproto">
  353. <table class="mlabels">
  354. <tr>
  355. <td class="mlabels-left">
  356. <table class="memname">
  357. <tr>
  358. <td class="memname">virtual const char* Plugin::getName </td>
  359. <td>(</td>
  360. <td class="paramname"></td><td>)</td>
  361. <td> const</td>
  362. </tr>
  363. </table>
  364. </td>
  365. <td class="mlabels-right">
  366. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  367. </tr>
  368. </table>
  369. </div><div class="memdoc">
  370. <p>Get the plugin name.<br />
  371. Returns DISTRHO_PLUGIN_NAME by default. </p>
  372. </div>
  373. </div>
  374. <a id="a00f7945c16149db6845fbcc2af729f4f"></a>
  375. <h2 class="memtitle"><span class="permalink"><a href="#a00f7945c16149db6845fbcc2af729f4f">&#9670;&nbsp;</a></span>getLabel()</h2>
  376. <div class="memitem">
  377. <div class="memproto">
  378. <table class="mlabels">
  379. <tr>
  380. <td class="mlabels-left">
  381. <table class="memname">
  382. <tr>
  383. <td class="memname">virtual const char* Plugin::getLabel </td>
  384. <td>(</td>
  385. <td class="paramname"></td><td>)</td>
  386. <td> const</td>
  387. </tr>
  388. </table>
  389. </td>
  390. <td class="mlabels-right">
  391. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  392. </tr>
  393. </table>
  394. </div><div class="memdoc">
  395. <p>Get the plugin label.<br />
  396. This label is a short restricted name consisting of only _, a-z, A-Z and 0-9 characters. </p>
  397. </div>
  398. </div>
  399. <a id="a30db5eef9de617f4c81d5c6925facea3"></a>
  400. <h2 class="memtitle"><span class="permalink"><a href="#a30db5eef9de617f4c81d5c6925facea3">&#9670;&nbsp;</a></span>getDescription()</h2>
  401. <div class="memitem">
  402. <div class="memproto">
  403. <table class="mlabels">
  404. <tr>
  405. <td class="mlabels-left">
  406. <table class="memname">
  407. <tr>
  408. <td class="memname">virtual const char* Plugin::getDescription </td>
  409. <td>(</td>
  410. <td class="paramname"></td><td>)</td>
  411. <td> const</td>
  412. </tr>
  413. </table>
  414. </td>
  415. <td class="mlabels-right">
  416. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  417. </tr>
  418. </table>
  419. </div><div class="memdoc">
  420. <p>Get an extensive comment/description about the plugin.<br />
  421. Optional, returns nothing by default. </p>
  422. </div>
  423. </div>
  424. <a id="a955832840de786a7a22798f0ef451c5d"></a>
  425. <h2 class="memtitle"><span class="permalink"><a href="#a955832840de786a7a22798f0ef451c5d">&#9670;&nbsp;</a></span>getMaker()</h2>
  426. <div class="memitem">
  427. <div class="memproto">
  428. <table class="mlabels">
  429. <tr>
  430. <td class="mlabels-left">
  431. <table class="memname">
  432. <tr>
  433. <td class="memname">virtual const char* Plugin::getMaker </td>
  434. <td>(</td>
  435. <td class="paramname"></td><td>)</td>
  436. <td> const</td>
  437. </tr>
  438. </table>
  439. </td>
  440. <td class="mlabels-right">
  441. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  442. </tr>
  443. </table>
  444. </div><div class="memdoc">
  445. <p>Get the plugin author/maker. </p>
  446. </div>
  447. </div>
  448. <a id="ad12c681ce31004da0badd609763f45c5"></a>
  449. <h2 class="memtitle"><span class="permalink"><a href="#ad12c681ce31004da0badd609763f45c5">&#9670;&nbsp;</a></span>getHomePage()</h2>
  450. <div class="memitem">
  451. <div class="memproto">
  452. <table class="mlabels">
  453. <tr>
  454. <td class="mlabels-left">
  455. <table class="memname">
  456. <tr>
  457. <td class="memname">virtual const char* Plugin::getHomePage </td>
  458. <td>(</td>
  459. <td class="paramname"></td><td>)</td>
  460. <td> const</td>
  461. </tr>
  462. </table>
  463. </td>
  464. <td class="mlabels-right">
  465. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  466. </tr>
  467. </table>
  468. </div><div class="memdoc">
  469. <p>Get the plugin homepage.<br />
  470. Optional, returns nothing by default. </p>
  471. </div>
  472. </div>
  473. <a id="a686a3c92a376a185d6fd97efd59125d1"></a>
  474. <h2 class="memtitle"><span class="permalink"><a href="#a686a3c92a376a185d6fd97efd59125d1">&#9670;&nbsp;</a></span>getLicense()</h2>
  475. <div class="memitem">
  476. <div class="memproto">
  477. <table class="mlabels">
  478. <tr>
  479. <td class="mlabels-left">
  480. <table class="memname">
  481. <tr>
  482. <td class="memname">virtual const char* Plugin::getLicense </td>
  483. <td>(</td>
  484. <td class="paramname"></td><td>)</td>
  485. <td> const</td>
  486. </tr>
  487. </table>
  488. </td>
  489. <td class="mlabels-right">
  490. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  491. </tr>
  492. </table>
  493. </div><div class="memdoc">
  494. <p>Get the plugin license (a single line of text or a URL).<br />
  495. For commercial plugins this should return some short copyright information. </p>
  496. </div>
  497. </div>
  498. <a id="abae540dd93caf4834270358a8aad334a"></a>
  499. <h2 class="memtitle"><span class="permalink"><a href="#abae540dd93caf4834270358a8aad334a">&#9670;&nbsp;</a></span>getVersion()</h2>
  500. <div class="memitem">
  501. <div class="memproto">
  502. <table class="mlabels">
  503. <tr>
  504. <td class="mlabels-left">
  505. <table class="memname">
  506. <tr>
  507. <td class="memname">virtual uint32_t Plugin::getVersion </td>
  508. <td>(</td>
  509. <td class="paramname"></td><td>)</td>
  510. <td> const</td>
  511. </tr>
  512. </table>
  513. </td>
  514. <td class="mlabels-right">
  515. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  516. </tr>
  517. </table>
  518. </div><div class="memdoc">
  519. <p>Get the plugin version, in hexadecimal. </p><dl class="section see"><dt>See also</dt><dd>d_version() </dd></dl>
  520. </div>
  521. </div>
  522. <a id="ad6ff8c80227d5ceebd40b96f3be29a66"></a>
  523. <h2 class="memtitle"><span class="permalink"><a href="#ad6ff8c80227d5ceebd40b96f3be29a66">&#9670;&nbsp;</a></span>getUniqueId()</h2>
  524. <div class="memitem">
  525. <div class="memproto">
  526. <table class="mlabels">
  527. <tr>
  528. <td class="mlabels-left">
  529. <table class="memname">
  530. <tr>
  531. <td class="memname">virtual int64_t Plugin::getUniqueId </td>
  532. <td>(</td>
  533. <td class="paramname"></td><td>)</td>
  534. <td> const</td>
  535. </tr>
  536. </table>
  537. </td>
  538. <td class="mlabels-right">
  539. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  540. </tr>
  541. </table>
  542. </div><div class="memdoc">
  543. <p>Get the plugin unique Id.<br />
  544. 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>
  545. </div>
  546. </div>
  547. <a id="a75f30935198a0acba25f4ea92af72dc4"></a>
  548. <h2 class="memtitle"><span class="permalink"><a href="#a75f30935198a0acba25f4ea92af72dc4">&#9670;&nbsp;</a></span>initAudioPort()</h2>
  549. <div class="memitem">
  550. <div class="memproto">
  551. <table class="mlabels">
  552. <tr>
  553. <td class="mlabels-left">
  554. <table class="memname">
  555. <tr>
  556. <td class="memname">virtual void Plugin::initAudioPort </td>
  557. <td>(</td>
  558. <td class="paramtype">bool&#160;</td>
  559. <td class="paramname"><em>input</em>, </td>
  560. </tr>
  561. <tr>
  562. <td class="paramkey"></td>
  563. <td></td>
  564. <td class="paramtype">uint32_t&#160;</td>
  565. <td class="paramname"><em>index</em>, </td>
  566. </tr>
  567. <tr>
  568. <td class="paramkey"></td>
  569. <td></td>
  570. <td class="paramtype"><a class="el" href="structAudioPort.html">AudioPort</a> &amp;&#160;</td>
  571. <td class="paramname"><em>port</em>&#160;</td>
  572. </tr>
  573. <tr>
  574. <td></td>
  575. <td>)</td>
  576. <td></td><td></td>
  577. </tr>
  578. </table>
  579. </td>
  580. <td class="mlabels-right">
  581. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  582. </tr>
  583. </table>
  584. </div><div class="memdoc">
  585. <p>Initialize the audio port <em>index</em>.<br />
  586. This function will be called once, shortly after the plugin is created. </p>
  587. </div>
  588. </div>
  589. <a id="a5b0ec59527a1c2f4b01f17fc8c18ea8b"></a>
  590. <h2 class="memtitle"><span class="permalink"><a href="#a5b0ec59527a1c2f4b01f17fc8c18ea8b">&#9670;&nbsp;</a></span>initParameter()</h2>
  591. <div class="memitem">
  592. <div class="memproto">
  593. <table class="mlabels">
  594. <tr>
  595. <td class="mlabels-left">
  596. <table class="memname">
  597. <tr>
  598. <td class="memname">virtual void Plugin::initParameter </td>
  599. <td>(</td>
  600. <td class="paramtype">uint32_t&#160;</td>
  601. <td class="paramname"><em>index</em>, </td>
  602. </tr>
  603. <tr>
  604. <td class="paramkey"></td>
  605. <td></td>
  606. <td class="paramtype"><a class="el" href="structParameter.html">Parameter</a> &amp;&#160;</td>
  607. <td class="paramname"><em>parameter</em>&#160;</td>
  608. </tr>
  609. <tr>
  610. <td></td>
  611. <td>)</td>
  612. <td></td><td></td>
  613. </tr>
  614. </table>
  615. </td>
  616. <td class="mlabels-right">
  617. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  618. </tr>
  619. </table>
  620. </div><div class="memdoc">
  621. <p>Initialize the parameter <em>index</em>.<br />
  622. This function will be called once, shortly after the plugin is created. </p>
  623. </div>
  624. </div>
  625. <a id="a54d66af3111541b7c118f9749ef0231b"></a>
  626. <h2 class="memtitle"><span class="permalink"><a href="#a54d66af3111541b7c118f9749ef0231b">&#9670;&nbsp;</a></span>initProgramName()</h2>
  627. <div class="memitem">
  628. <div class="memproto">
  629. <table class="mlabels">
  630. <tr>
  631. <td class="mlabels-left">
  632. <table class="memname">
  633. <tr>
  634. <td class="memname">virtual void Plugin::initProgramName </td>
  635. <td>(</td>
  636. <td class="paramtype">uint32_t&#160;</td>
  637. <td class="paramname"><em>index</em>, </td>
  638. </tr>
  639. <tr>
  640. <td class="paramkey"></td>
  641. <td></td>
  642. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  643. <td class="paramname"><em>programName</em>&#160;</td>
  644. </tr>
  645. <tr>
  646. <td></td>
  647. <td>)</td>
  648. <td></td><td></td>
  649. </tr>
  650. </table>
  651. </td>
  652. <td class="mlabels-right">
  653. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  654. </tr>
  655. </table>
  656. </div><div class="memdoc">
  657. <p>Set the name of the program <em>index</em>.<br />
  658. This function will be called once, shortly after the plugin is created.<br />
  659. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  660. </div>
  661. </div>
  662. <a id="ae301a970a8b5cff3c7ecef927ea20080"></a>
  663. <h2 class="memtitle"><span class="permalink"><a href="#ae301a970a8b5cff3c7ecef927ea20080">&#9670;&nbsp;</a></span>initState()</h2>
  664. <div class="memitem">
  665. <div class="memproto">
  666. <table class="mlabels">
  667. <tr>
  668. <td class="mlabels-left">
  669. <table class="memname">
  670. <tr>
  671. <td class="memname">virtual void Plugin::initState </td>
  672. <td>(</td>
  673. <td class="paramtype">uint32_t&#160;</td>
  674. <td class="paramname"><em>index</em>, </td>
  675. </tr>
  676. <tr>
  677. <td class="paramkey"></td>
  678. <td></td>
  679. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  680. <td class="paramname"><em>stateKey</em>, </td>
  681. </tr>
  682. <tr>
  683. <td class="paramkey"></td>
  684. <td></td>
  685. <td class="paramtype"><a class="el" href="classString.html">String</a> &amp;&#160;</td>
  686. <td class="paramname"><em>defaultStateValue</em>&#160;</td>
  687. </tr>
  688. <tr>
  689. <td></td>
  690. <td>)</td>
  691. <td></td><td></td>
  692. </tr>
  693. </table>
  694. </td>
  695. <td class="mlabels-right">
  696. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  697. </tr>
  698. </table>
  699. </div><div class="memdoc">
  700. <p>Set the state key and default value of <em>index</em>.<br />
  701. This function will be called once, shortly after the plugin is created.<br />
  702. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  703. </div>
  704. </div>
  705. <a id="a2d1da98c90568bb4547662bc4f02c31f"></a>
  706. <h2 class="memtitle"><span class="permalink"><a href="#a2d1da98c90568bb4547662bc4f02c31f">&#9670;&nbsp;</a></span>getParameterValue()</h2>
  707. <div class="memitem">
  708. <div class="memproto">
  709. <table class="mlabels">
  710. <tr>
  711. <td class="mlabels-left">
  712. <table class="memname">
  713. <tr>
  714. <td class="memname">virtual float Plugin::getParameterValue </td>
  715. <td>(</td>
  716. <td class="paramtype">uint32_t&#160;</td>
  717. <td class="paramname"><em>index</em></td><td>)</td>
  718. <td> const</td>
  719. </tr>
  720. </table>
  721. </td>
  722. <td class="mlabels-right">
  723. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  724. </tr>
  725. </table>
  726. </div><div class="memdoc">
  727. <p>Get the current value of a parameter.<br />
  728. The host may call this function from any context, including realtime processing. </p>
  729. </div>
  730. </div>
  731. <a id="a6911a881fabb9eca9daf0eadbaad8599"></a>
  732. <h2 class="memtitle"><span class="permalink"><a href="#a6911a881fabb9eca9daf0eadbaad8599">&#9670;&nbsp;</a></span>setParameterValue()</h2>
  733. <div class="memitem">
  734. <div class="memproto">
  735. <table class="mlabels">
  736. <tr>
  737. <td class="mlabels-left">
  738. <table class="memname">
  739. <tr>
  740. <td class="memname">virtual void Plugin::setParameterValue </td>
  741. <td>(</td>
  742. <td class="paramtype">uint32_t&#160;</td>
  743. <td class="paramname"><em>index</em>, </td>
  744. </tr>
  745. <tr>
  746. <td class="paramkey"></td>
  747. <td></td>
  748. <td class="paramtype">float&#160;</td>
  749. <td class="paramname"><em>value</em>&#160;</td>
  750. </tr>
  751. <tr>
  752. <td></td>
  753. <td>)</td>
  754. <td></td><td></td>
  755. </tr>
  756. </table>
  757. </td>
  758. <td class="mlabels-right">
  759. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  760. </tr>
  761. </table>
  762. </div><div class="memdoc">
  763. <p>Change a parameter value.<br />
  764. The host may call this function from any context, including realtime processing.<br />
  765. 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>
  766. </div>
  767. </div>
  768. <a id="ab629f35c60406d6f2c0b9d530e67cf09"></a>
  769. <h2 class="memtitle"><span class="permalink"><a href="#ab629f35c60406d6f2c0b9d530e67cf09">&#9670;&nbsp;</a></span>loadProgram()</h2>
  770. <div class="memitem">
  771. <div class="memproto">
  772. <table class="mlabels">
  773. <tr>
  774. <td class="mlabels-left">
  775. <table class="memname">
  776. <tr>
  777. <td class="memname">virtual void Plugin::loadProgram </td>
  778. <td>(</td>
  779. <td class="paramtype">uint32_t&#160;</td>
  780. <td class="paramname"><em>index</em></td><td>)</td>
  781. <td></td>
  782. </tr>
  783. </table>
  784. </td>
  785. <td class="mlabels-right">
  786. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  787. </tr>
  788. </table>
  789. </div><div class="memdoc">
  790. <p>Load a program.<br />
  791. The host may call this function from any context, including realtime processing.<br />
  792. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_PROGRAMS is enabled. </p>
  793. </div>
  794. </div>
  795. <a id="a84af70cd84fa4c3054caaa8affaab8f1"></a>
  796. <h2 class="memtitle"><span class="permalink"><a href="#a84af70cd84fa4c3054caaa8affaab8f1">&#9670;&nbsp;</a></span>getState()</h2>
  797. <div class="memitem">
  798. <div class="memproto">
  799. <table class="mlabels">
  800. <tr>
  801. <td class="mlabels-left">
  802. <table class="memname">
  803. <tr>
  804. <td class="memname">virtual <a class="el" href="classString.html">String</a> Plugin::getState </td>
  805. <td>(</td>
  806. <td class="paramtype">const char *&#160;</td>
  807. <td class="paramname"><em>key</em></td><td>)</td>
  808. <td> const</td>
  809. </tr>
  810. </table>
  811. </td>
  812. <td class="mlabels-right">
  813. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  814. </tr>
  815. </table>
  816. </div><div class="memdoc">
  817. <p>Get the value of an internal state.<br />
  818. The host may call this function from any non-realtime context.<br />
  819. 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>
  820. </div>
  821. </div>
  822. <a id="ad25ed64a2f00f48c86d2ae0016ea3e59"></a>
  823. <h2 class="memtitle"><span class="permalink"><a href="#ad25ed64a2f00f48c86d2ae0016ea3e59">&#9670;&nbsp;</a></span>setState()</h2>
  824. <div class="memitem">
  825. <div class="memproto">
  826. <table class="mlabels">
  827. <tr>
  828. <td class="mlabels-left">
  829. <table class="memname">
  830. <tr>
  831. <td class="memname">virtual void Plugin::setState </td>
  832. <td>(</td>
  833. <td class="paramtype">const char *&#160;</td>
  834. <td class="paramname"><em>key</em>, </td>
  835. </tr>
  836. <tr>
  837. <td class="paramkey"></td>
  838. <td></td>
  839. <td class="paramtype">const char *&#160;</td>
  840. <td class="paramname"><em>value</em>&#160;</td>
  841. </tr>
  842. <tr>
  843. <td></td>
  844. <td>)</td>
  845. <td></td><td></td>
  846. </tr>
  847. </table>
  848. </td>
  849. <td class="mlabels-right">
  850. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  851. </tr>
  852. </table>
  853. </div><div class="memdoc">
  854. <p>Change an internal state <em>key</em> to <em>value</em>.<br />
  855. Must be implemented by your plugin class only if DISTRHO_PLUGIN_WANT_STATE is enabled. </p>
  856. </div>
  857. </div>
  858. <a id="aa5c1262f5ca20536bb5850fdd6faa22c"></a>
  859. <h2 class="memtitle"><span class="permalink"><a href="#aa5c1262f5ca20536bb5850fdd6faa22c">&#9670;&nbsp;</a></span>activate()</h2>
  860. <div class="memitem">
  861. <div class="memproto">
  862. <table class="mlabels">
  863. <tr>
  864. <td class="mlabels-left">
  865. <table class="memname">
  866. <tr>
  867. <td class="memname">virtual void Plugin::activate </td>
  868. <td>(</td>
  869. <td class="paramname"></td><td>)</td>
  870. <td></td>
  871. </tr>
  872. </table>
  873. </td>
  874. <td class="mlabels-right">
  875. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  876. </tr>
  877. </table>
  878. </div><div class="memdoc">
  879. <p>Activate this plugin. </p>
  880. </div>
  881. </div>
  882. <a id="aa089a56572bc8f1cb7e4b538c0d19c46"></a>
  883. <h2 class="memtitle"><span class="permalink"><a href="#aa089a56572bc8f1cb7e4b538c0d19c46">&#9670;&nbsp;</a></span>deactivate()</h2>
  884. <div class="memitem">
  885. <div class="memproto">
  886. <table class="mlabels">
  887. <tr>
  888. <td class="mlabels-left">
  889. <table class="memname">
  890. <tr>
  891. <td class="memname">virtual void Plugin::deactivate </td>
  892. <td>(</td>
  893. <td class="paramname"></td><td>)</td>
  894. <td></td>
  895. </tr>
  896. </table>
  897. </td>
  898. <td class="mlabels-right">
  899. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  900. </tr>
  901. </table>
  902. </div><div class="memdoc">
  903. <p>Deactivate this plugin. </p>
  904. </div>
  905. </div>
  906. <a id="a0a969c78f8455ac6ba65fa42e8c498f6"></a>
  907. <h2 class="memtitle"><span class="permalink"><a href="#a0a969c78f8455ac6ba65fa42e8c498f6">&#9670;&nbsp;</a></span>run()</h2>
  908. <div class="memitem">
  909. <div class="memproto">
  910. <table class="mlabels">
  911. <tr>
  912. <td class="mlabels-left">
  913. <table class="memname">
  914. <tr>
  915. <td class="memname">virtual void Plugin::run </td>
  916. <td>(</td>
  917. <td class="paramtype">const float **&#160;</td>
  918. <td class="paramname"><em>inputs</em>, </td>
  919. </tr>
  920. <tr>
  921. <td class="paramkey"></td>
  922. <td></td>
  923. <td class="paramtype">float **&#160;</td>
  924. <td class="paramname"><em>outputs</em>, </td>
  925. </tr>
  926. <tr>
  927. <td class="paramkey"></td>
  928. <td></td>
  929. <td class="paramtype">uint32_t&#160;</td>
  930. <td class="paramname"><em>frames</em>, </td>
  931. </tr>
  932. <tr>
  933. <td class="paramkey"></td>
  934. <td></td>
  935. <td class="paramtype">const <a class="el" href="structMidiEvent.html">MidiEvent</a> *&#160;</td>
  936. <td class="paramname"><em>midiEvents</em>, </td>
  937. </tr>
  938. <tr>
  939. <td class="paramkey"></td>
  940. <td></td>
  941. <td class="paramtype">uint32_t&#160;</td>
  942. <td class="paramname"><em>midiEventCount</em>&#160;</td>
  943. </tr>
  944. <tr>
  945. <td></td>
  946. <td>)</td>
  947. <td></td><td></td>
  948. </tr>
  949. </table>
  950. </td>
  951. <td class="mlabels-right">
  952. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">pure virtual</span></span> </td>
  953. </tr>
  954. </table>
  955. </div><div class="memdoc">
  956. <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>
  957. </div>
  958. </div>
  959. <a id="a9f6c8ad6b054056649d0250e527e1297"></a>
  960. <h2 class="memtitle"><span class="permalink"><a href="#a9f6c8ad6b054056649d0250e527e1297">&#9670;&nbsp;</a></span>bufferSizeChanged()</h2>
  961. <div class="memitem">
  962. <div class="memproto">
  963. <table class="mlabels">
  964. <tr>
  965. <td class="mlabels-left">
  966. <table class="memname">
  967. <tr>
  968. <td class="memname">virtual void Plugin::bufferSizeChanged </td>
  969. <td>(</td>
  970. <td class="paramtype">uint32_t&#160;</td>
  971. <td class="paramname"><em>newBufferSize</em></td><td>)</td>
  972. <td></td>
  973. </tr>
  974. </table>
  975. </td>
  976. <td class="mlabels-right">
  977. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  978. </tr>
  979. </table>
  980. </div><div class="memdoc">
  981. <p>Optional callback to inform the plugin about a buffer size change.<br />
  982. 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 />
  983. Hosts might call <a class="el" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run()</a> with a higher or lower number of frames. </dd></dl>
  984. <dl class="section see"><dt>See also</dt><dd><a class="el" href="classPlugin.html#a2643e638f62cfd4990247ec66bed60d2">getBufferSize()</a> </dd></dl>
  985. </div>
  986. </div>
  987. <a id="a2fcbfa1893f44e661d0d8cd53391dadc"></a>
  988. <h2 class="memtitle"><span class="permalink"><a href="#a2fcbfa1893f44e661d0d8cd53391dadc">&#9670;&nbsp;</a></span>sampleRateChanged()</h2>
  989. <div class="memitem">
  990. <div class="memproto">
  991. <table class="mlabels">
  992. <tr>
  993. <td class="mlabels-left">
  994. <table class="memname">
  995. <tr>
  996. <td class="memname">virtual void Plugin::sampleRateChanged </td>
  997. <td>(</td>
  998. <td class="paramtype">double&#160;</td>
  999. <td class="paramname"><em>newSampleRate</em></td><td>)</td>
  1000. <td></td>
  1001. </tr>
  1002. </table>
  1003. </td>
  1004. <td class="mlabels-right">
  1005. <span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
  1006. </tr>
  1007. </table>
  1008. </div><div class="memdoc">
  1009. <p>Optional callback to inform the plugin about a sample rate change.<br />
  1010. 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>
  1011. </div>
  1012. </div>
  1013. <hr/>The documentation for this class was generated from the following file:<ul>
  1014. <li>distrho/<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a></li>
  1015. </ul>
  1016. </div><!-- contents -->
  1017. <!-- start footer part -->
  1018. <hr class="footer"/><address class="footer"><small>
  1019. Generated on Sun Apr 7 2019 05:47:58 for DISTRHO Plugin Framework by &#160;<a href="http://www.doxygen.org/index.html">
  1020. <img class="footer" src="doxygen.png" alt="doxygen"/>
  1021. </a> 1.8.13
  1022. </small></address>
  1023. </body>
  1024. </html>