|
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
- <meta http-equiv="X-UA-Compatible" content="IE=9"/>
- <meta name="generator" content="Doxygen 1.9.1"/>
- <meta name="viewport" content="width=device-width, initial-scale=1"/>
- <title>DISTRHO Plugin Framework: DISTRHO Plugin Framework</title>
- <link href="tabs.css" rel="stylesheet" type="text/css"/>
- <script type="text/javascript" src="jquery.js"></script>
- <script type="text/javascript" src="dynsections.js"></script>
- <link href="search/search.css" rel="stylesheet" type="text/css"/>
- <script type="text/javascript" src="search/searchdata.js"></script>
- <script type="text/javascript" src="search/search.js"></script>
- <link href="doxygen.css" rel="stylesheet" type="text/css" />
- </head>
- <body>
- <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
- <div id="titlearea">
- <table cellspacing="0" cellpadding="0">
- <tbody>
- <tr style="height: 56px;">
- <td id="projectalign" style="padding-left: 0.5em;">
- <div id="projectname">DISTRHO Plugin Framework
- </div>
- </td>
- </tr>
- </tbody>
- </table>
- </div>
- <!-- end header part -->
- <!-- Generated by Doxygen 1.9.1 -->
- <script type="text/javascript">
- /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
- var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
- /* @license-end */
- </script>
- <script type="text/javascript" src="menudata.js"></script>
- <script type="text/javascript" src="menu.js"></script>
- <script type="text/javascript">
- /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
- $(function() {
- initMenu('',true,false,'search.php','Search');
- $(document).ready(function() { init_search(); });
- });
- /* @license-end */</script>
- <div id="main-nav"></div>
- </div><!-- top -->
- <!-- window showing the filter options -->
- <div id="MSearchSelectWindow"
- onmouseover="return searchBox.OnSearchSelectShow()"
- onmouseout="return searchBox.OnSearchSelectHide()"
- onkeydown="return searchBox.OnSearchSelectKey(event)">
- </div>
-
- <!-- iframe showing the search results (closed by default) -->
- <div id="MSearchResultsWindow">
- <iframe src="javascript:void(0)" frameborder="0"
- name="MSearchResults" id="MSearchResults">
- </iframe>
- </div>
-
- <div class="PageDoc"><div class="header">
- <div class="headertitle">
- <div class="title">DISTRHO Plugin Framework </div> </div>
- </div><!--header-->
- <div class="contents">
- <div class="textblock"><p>DISTRHO Plugin Framework (or <b>DPF</b> for short) is a plugin framework designed to make development of new plugins an easy and enjoyable task.<br />
- It allows developers to create plugins with custom UIs using a simple C++ API.<br />
- The framework facilitates exporting various different plugin formats from the same code-base.</p>
- <p>DPF can build for LADSPA, DSSI, LV2, VST2, VST3 and CLAP formats.<br />
- A JACK/Standalone mode is also available, allowing you to quickly test plugins.</p>
- <h1><a class="anchor" id="Macros"></a>
- Macros</h1>
- <p>You start by creating a "DistrhoPluginInfo.h" file describing the plugin via macros, see PluginMacros.<br />
- This file is included during compilation of the main DPF code to select which features to activate for each plugin format.</p>
- <p>For example, a plugin (with UI) that use states will require LV2 hosts to support Atom and Worker extensions for message passing from the UI to the (DSP) plugin.<br />
- If your plugin does not make use of states, the Worker extension is not set as a required feature.</p>
- <h1><a class="anchor" id="Plugin"></a>
- Plugin</h1>
- <p>The next step is to create your plugin code by subclassing DPF's <a class="el" href="classPlugin.html">Plugin</a> class.<br />
- You need to pass the number of parameters in the constructor and also the number of programs and states, if any.</p>
- <p>Do note all of DPF code is within its own C++ namespace (<b>DISTRHO</b> for DSP/plugin stuff, <b>DGL</b> for <a class="el" href="classUI.html">UI</a> stuff).<br />
- You can use <a class="el" href="group__NamespaceMacros.html#gac4cb97c393d20c28ba19365d844341cd">START_NAMESPACE_DISTRHO</a> / <a class="el" href="group__NamespaceMacros.html#ga3ff541a449593e069a29e92d21e38ef3">END_NAMESPACE_DISTRHO</a> combo around your code, or globally set USE_NAMESPACE_DISTRHO.<br />
- These are defined as compiler macros so that you can override the namespace name during build. When in doubt, just follow the examples.</p>
- <h1><a class="anchor" id="Examples"></a>
- Examples</h1>
- <p>Let's begin with some examples.<br />
- Here is one of a stereo audio plugin that simply mutes the host output: </p><div class="fragment"><div class="line"><span class="comment">/* DPF plugin include */</span></div>
- <div class="line"><span class="preprocessor">#include "DistrhoPlugin.hpp"</span></div>
- <div class="line"> </div>
- <div class="line"><span class="comment">/* Make DPF related classes available for us to use without any extra namespace references */</span></div>
- <div class="line"><a class="code" href="group__NamespaceMacros.html#gadcd7e7d900fbae0fa1a71d6fbab4d59c">USE_NAMESPACE_DISTRHO</a>;</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment">/**</span></div>
- <div class="line"><span class="comment"> Our custom plugin class.</span></div>
- <div class="line"><span class="comment"> Subclassing `Plugin` from DPF is how this all works.</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> By default, only information-related functions and `run` are pure virtual (that is, must be reimplemented).</span></div>
- <div class="line"><span class="comment"> When enabling certain features (such as programs or states, more on that below), a few extra functions also need to be reimplemented.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"><span class="keyword">class </span>MutePlugin : <span class="keyword">public</span> <a class="code" href="classPlugin.html">Plugin</a></div>
- <div class="line">{</div>
- <div class="line"><span class="keyword">public</span>:<span class="comment"></span></div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Plugin class constructor.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> MutePlugin()</div>
- <div class="line"> : <a class="code" href="classPlugin.html">Plugin</a>(0, 0, 0) <span class="comment">// 0 parameters, 0 programs and 0 states</span></div>
- <div class="line"> {</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"><span class="keyword">protected</span>:</div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Information */</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the plugin label.</span></div>
- <div class="line"><span class="comment"> This label is a short restricted name consisting of only _, a-z, A-Z and 0-9 characters.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a00f7945c16149db6845fbcc2af729f4f">getLabel</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"Mute"</span>;</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the plugin author/maker.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a955832840de786a7a22798f0ef451c5d">getMaker</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"DPF"</span>;</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the plugin license name (a single line of text).</span></div>
- <div class="line"><span class="comment"> For commercial plugins this should return some short copyright information.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a686a3c92a376a185d6fd97efd59125d1">getLicense</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"MIT"</span>;</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the plugin version, in hexadecimal.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> uint32_t <a class="code" href="classPlugin.html#abae540dd93caf4834270358a8aad334a">getVersion</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <a class="code" href="group__MiscellaneousFunctions.html#ga95d67ff74d46b2c80f15c7790a523154">d_version</a>(1, 0, 0);</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the plugin unique Id.</span></div>
- <div class="line"><span class="comment"> This value is used by LADSPA, DSSI, VST2 and VST3 plugin formats.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> int64_t <a class="code" href="classPlugin.html#ad6ff8c80227d5ceebd40b96f3be29a66">getUniqueId</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <a class="code" href="group__MiscellaneousFunctions.html#ga6827e90feb9bdcb6f76175a245fbf12c">d_cconst</a>(<span class="charliteral">'M'</span>, <span class="charliteral">'u'</span>, <span class="charliteral">'t'</span>, <span class="charliteral">'e'</span>);</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Audio/MIDI Processing */</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Run/process function for plugins without MIDI input.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run</a>(<span class="keyword">const</span> <span class="keywordtype">float</span>**, <span class="keywordtype">float</span>** outputs, uint32_t frames)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="comment">// get the left and right audio outputs</span></div>
- <div class="line"> <span class="keywordtype">float</span>* <span class="keyword">const</span> outL = outputs[0];</div>
- <div class="line"> <span class="keywordtype">float</span>* <span class="keyword">const</span> outR = outputs[1];</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">// mute audio</span></div>
- <div class="line"> std::memset(outL, 0, <span class="keyword">sizeof</span>(<span class="keywordtype">float</span>)*frames);</div>
- <div class="line"> std::memset(outR, 0, <span class="keyword">sizeof</span>(<span class="keywordtype">float</span>)*frames);</div>
- <div class="line"> }</div>
- <div class="line">};</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment">/**</span></div>
- <div class="line"><span class="comment"> Create an instance of the Plugin class.</span></div>
- <div class="line"><span class="comment"> This is the entry point for DPF plugins.</span></div>
- <div class="line"><span class="comment"> DPF will call this to either create an instance of your plugin for the host or to fetch some initial information for internal caching.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"><a class="code" href="classPlugin.html">Plugin</a>* <a class="code" href="group__EntryPoints.html#ga87f1fa9084f2490ca04ea733292c6dee">createPlugin</a>()</div>
- <div class="line">{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="keyword">new</span> MutePlugin();</div>
- <div class="line">}</div>
- <div class="ttc" id="aclassPlugin_html"><div class="ttname"><a href="classPlugin.html">Plugin</a></div><div class="ttdef"><b>Definition:</b> DistrhoPlugin.hpp:61</div></div>
- <div class="ttc" id="aclassPlugin_html_a00f7945c16149db6845fbcc2af729f4f"><div class="ttname"><a href="classPlugin.html#a00f7945c16149db6845fbcc2af729f4f">Plugin::getLabel</a></div><div class="ttdeci">virtual const char * getLabel() const =0</div></div>
- <div class="ttc" id="aclassPlugin_html_a0a969c78f8455ac6ba65fa42e8c498f6"><div class="ttname"><a href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">Plugin::run</a></div><div class="ttdeci">virtual void run(const float **inputs, float **outputs, uint32_t frames, const MidiEvent *midiEvents, uint32_t midiEventCount)=0</div></div>
- <div class="ttc" id="aclassPlugin_html_a686a3c92a376a185d6fd97efd59125d1"><div class="ttname"><a href="classPlugin.html#a686a3c92a376a185d6fd97efd59125d1">Plugin::getLicense</a></div><div class="ttdeci">virtual const char * getLicense() const =0</div></div>
- <div class="ttc" id="aclassPlugin_html_a955832840de786a7a22798f0ef451c5d"><div class="ttname"><a href="classPlugin.html#a955832840de786a7a22798f0ef451c5d">Plugin::getMaker</a></div><div class="ttdeci">virtual const char * getMaker() const =0</div></div>
- <div class="ttc" id="aclassPlugin_html_abae540dd93caf4834270358a8aad334a"><div class="ttname"><a href="classPlugin.html#abae540dd93caf4834270358a8aad334a">Plugin::getVersion</a></div><div class="ttdeci">virtual uint32_t getVersion() const =0</div></div>
- <div class="ttc" id="aclassPlugin_html_ad6ff8c80227d5ceebd40b96f3be29a66"><div class="ttname"><a href="classPlugin.html#ad6ff8c80227d5ceebd40b96f3be29a66">Plugin::getUniqueId</a></div><div class="ttdeci">virtual int64_t getUniqueId() const =0</div></div>
- <div class="ttc" id="agroup__EntryPoints_html_ga87f1fa9084f2490ca04ea733292c6dee"><div class="ttname"><a href="group__EntryPoints.html#ga87f1fa9084f2490ca04ea733292c6dee">createPlugin</a></div><div class="ttdeci">Plugin * createPlugin()</div></div>
- <div class="ttc" id="agroup__MiscellaneousFunctions_html_ga6827e90feb9bdcb6f76175a245fbf12c"><div class="ttname"><a href="group__MiscellaneousFunctions.html#ga6827e90feb9bdcb6f76175a245fbf12c">d_cconst</a></div><div class="ttdeci">static constexpr int64_t d_cconst(const uint8_t a, const uint8_t b, const uint8_t c, const uint8_t d) noexcept</div><div class="ttdef"><b>Definition:</b> DistrhoUtils.hpp:72</div></div>
- <div class="ttc" id="agroup__MiscellaneousFunctions_html_ga95d67ff74d46b2c80f15c7790a523154"><div class="ttname"><a href="group__MiscellaneousFunctions.html#ga95d67ff74d46b2c80f15c7790a523154">d_version</a></div><div class="ttdeci">static constexpr uint32_t d_version(const uint8_t major, const uint8_t minor, const uint8_t micro) noexcept</div><div class="ttdef"><b>Definition:</b> DistrhoUtils.hpp:90</div></div>
- <div class="ttc" id="agroup__NamespaceMacros_html_gadcd7e7d900fbae0fa1a71d6fbab4d59c"><div class="ttname"><a href="group__NamespaceMacros.html#gadcd7e7d900fbae0fa1a71d6fbab4d59c">USE_NAMESPACE_DISTRHO</a></div><div class="ttdeci">#define USE_NAMESPACE_DISTRHO</div><div class="ttdef"><b>Definition:</b> DistrhoInfo.hpp:955</div></div>
- </div><!-- fragment --><p>See the <a class="el" href="classPlugin.html">Plugin</a> class for more information.</p>
- <h1><a class="anchor" id="Parameters"></a>
- Parameters</h1>
- <p>A plugin is nothing without parameters.<br />
- In DPF parameters can be inputs or outputs.<br />
- They have hints to describe how they behave plus a name and a symbol identifying them.<br />
- Parameters also have 'ranges' - a minimum, maximum and default value.</p>
- <p>Input parameters are by default "read-only": the plugin can read them but not change them. (there are exceptions and possibly a request to the host to change values, more on that below)<br />
- It's the host responsibility to save, restore and set input parameters.</p>
- <p>Output parameters can be changed at anytime by the plugin.<br />
- The host will simply read their values and never change them.</p>
- <p>Here's an example of an audio plugin that has 1 input parameter: </p><div class="fragment"><div class="line"><span class="keyword">class </span>GainPlugin : <span class="keyword">public</span> <a class="code" href="classPlugin.html">Plugin</a></div>
- <div class="line">{</div>
- <div class="line"><span class="keyword">public</span>:<span class="comment"></span></div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Plugin class constructor.</span></div>
- <div class="line"><span class="comment"> You must set all parameter values to their defaults, matching ParameterRanges::def.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> GainPlugin()</div>
- <div class="line"> : <a class="code" href="classPlugin.html">Plugin</a>(1, 0, 0), <span class="comment">// 1 parameter, 0 programs and 0 states</span></div>
- <div class="line"> fGain(1.0f)</div>
- <div class="line"> {</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"><span class="keyword">protected</span>:</div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Information */</span></div>
- <div class="line"> </div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a00f7945c16149db6845fbcc2af729f4f">getLabel</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"Gain"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a955832840de786a7a22798f0ef451c5d">getMaker</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"DPF"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a686a3c92a376a185d6fd97efd59125d1">getLicense</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"MIT"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> uint32_t <a class="code" href="classPlugin.html#abae540dd93caf4834270358a8aad334a">getVersion</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <a class="code" href="group__MiscellaneousFunctions.html#ga95d67ff74d46b2c80f15c7790a523154">d_version</a>(1, 0, 0);</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> int64_t <a class="code" href="classPlugin.html#ad6ff8c80227d5ceebd40b96f3be29a66">getUniqueId</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <a class="code" href="group__MiscellaneousFunctions.html#ga6827e90feb9bdcb6f76175a245fbf12c">d_cconst</a>(<span class="charliteral">'G'</span>, <span class="charliteral">'a'</span>, <span class="charliteral">'i'</span>, <span class="charliteral">'n'</span>);</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Init */</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Initialize a parameter.</span></div>
- <div class="line"><span class="comment"> This function will be called once, shortly after the plugin is created.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#aacf87bd0037efeb3b60d204940f3f4a0">initParameter</a>(uint32_t index, <a class="code" href="structParameter.html">Parameter</a>& parameter)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="comment">// we only have one parameter so we can skip checking the index</span></div>
- <div class="line"> </div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a397fb977f0c6cbec31df4f141ca3f5b3">hints</a> = <a class="code" href="group__ParameterHints.html#gaf82d83a105dc418877ef91e84ac6efd3">kParameterIsAutomatable</a>;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#ae63c1fcfb20e320bada1f58c04ff18da">name</a> = <span class="stringliteral">"Gain"</span>;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a3e546efd8dbd0d77351208b670719468">symbol</a> = <span class="stringliteral">"gain"</span>;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a>.<a class="code" href="structParameterRanges.html#a63c40988463a8ace9d0e9e55a00f3c7b">min</a> = 0.0f;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a>.<a class="code" href="structParameterRanges.html#a175c78c905c598df929a4450e4d2a2a0">max</a> = 2.0f;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a>.<a class="code" href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">def</a> = 1.0f;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Internal data */</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the current value of a parameter.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">float</span> <a class="code" href="classPlugin.html#af9e9f5438e2e0c2352052eb5f95832aa">getParameterValue</a>(uint32_t index)<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="comment">// same as before, ignore index check</span></div>
- <div class="line"> </div>
- <div class="line"> <span class="keywordflow">return</span> fGain;</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Change a parameter value.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a7e9e26ceafc7603ef6163483a9dc39be">setParameterValue</a>(uint32_t index, <span class="keywordtype">float</span> value)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="comment">// same as before, ignore index check</span></div>
- <div class="line"> </div>
- <div class="line"> fGain = value;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Audio/MIDI Processing */</span></div>
- <div class="line"> </div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run</a>(<span class="keyword">const</span> <span class="keywordtype">float</span>**, <span class="keywordtype">float</span>** outputs, uint32_t frames)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="comment">// get the mono input and output</span></div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">float</span>* <span class="keyword">const</span> in = inputs[0];</div>
- <div class="line"> <span class="comment">/* */</span> <span class="keywordtype">float</span>* <span class="keyword">const</span> out = outputs[0];</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">// apply gain against all samples</span></div>
- <div class="line"> <span class="keywordflow">for</span> (uint32_t i=0; i < frames; ++i)</div>
- <div class="line"> out[i] = in[i] * fGain;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"><span class="keyword">private</span>:</div>
- <div class="line"> <span class="keywordtype">float</span> fGain;</div>
- <div class="line">};</div>
- <div class="ttc" id="aclassPlugin_html_a7e9e26ceafc7603ef6163483a9dc39be"><div class="ttname"><a href="classPlugin.html#a7e9e26ceafc7603ef6163483a9dc39be">Plugin::setParameterValue</a></div><div class="ttdeci">virtual void setParameterValue(uint32_t index, float value)</div></div>
- <div class="ttc" id="aclassPlugin_html_aacf87bd0037efeb3b60d204940f3f4a0"><div class="ttname"><a href="classPlugin.html#aacf87bd0037efeb3b60d204940f3f4a0">Plugin::initParameter</a></div><div class="ttdeci">virtual void initParameter(uint32_t index, Parameter &parameter)</div></div>
- <div class="ttc" id="aclassPlugin_html_af9e9f5438e2e0c2352052eb5f95832aa"><div class="ttname"><a href="classPlugin.html#af9e9f5438e2e0c2352052eb5f95832aa">Plugin::getParameterValue</a></div><div class="ttdeci">virtual float getParameterValue(uint32_t index) const</div></div>
- <div class="ttc" id="agroup__ParameterHints_html_gaf82d83a105dc418877ef91e84ac6efd3"><div class="ttname"><a href="group__ParameterHints.html#gaf82d83a105dc418877ef91e84ac6efd3">kParameterIsAutomatable</a></div><div class="ttdeci">static constexpr const uint32_t kParameterIsAutomatable</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:96</div></div>
- <div class="ttc" id="astructParameterRanges_html_a175c78c905c598df929a4450e4d2a2a0"><div class="ttname"><a href="structParameterRanges.html#a175c78c905c598df929a4450e4d2a2a0">ParameterRanges::max</a></div><div class="ttdeci">float max</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:338</div></div>
- <div class="ttc" id="astructParameterRanges_html_a63c40988463a8ace9d0e9e55a00f3c7b"><div class="ttname"><a href="structParameterRanges.html#a63c40988463a8ace9d0e9e55a00f3c7b">ParameterRanges::min</a></div><div class="ttdeci">float min</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:333</div></div>
- <div class="ttc" id="astructParameterRanges_html_aa0aba68115bcfff25c35b2da2f7aed4c"><div class="ttname"><a href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">ParameterRanges::def</a></div><div class="ttdeci">float def</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:328</div></div>
- <div class="ttc" id="astructParameter_html"><div class="ttname"><a href="structParameter.html">Parameter</a></div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:588</div></div>
- <div class="ttc" id="astructParameter_html_a2d0c81e4fb8fad18d920ef6ecd4a64db"><div class="ttname"><a href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">Parameter::ranges</a></div><div class="ttdeci">ParameterRanges ranges</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:634</div></div>
- <div class="ttc" id="astructParameter_html_a397fb977f0c6cbec31df4f141ca3f5b3"><div class="ttname"><a href="structParameter.html#a397fb977f0c6cbec31df4f141ca3f5b3">Parameter::hints</a></div><div class="ttdeci">uint32_t hints</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:593</div></div>
- <div class="ttc" id="astructParameter_html_a3e546efd8dbd0d77351208b670719468"><div class="ttname"><a href="structParameter.html#a3e546efd8dbd0d77351208b670719468">Parameter::symbol</a></div><div class="ttdeci">String symbol</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:615</div></div>
- <div class="ttc" id="astructParameter_html_ae63c1fcfb20e320bada1f58c04ff18da"><div class="ttname"><a href="structParameter.html#ae63c1fcfb20e320bada1f58c04ff18da">Parameter::name</a></div><div class="ttdeci">String name</div><div class="ttdef"><b>Definition:</b> DistrhoDetails.hpp:600</div></div>
- </div><!-- fragment --><p>See the <a class="el" href="structParameter.html">Parameter</a> struct for more information about parameters.</p>
- <h1><a class="anchor" id="Programs"></a>
- Programs</h1>
- <p>Programs in DPF refer to plugin-side presets (usually called "factory presets").<br />
- This is meant as an initial set of presets provided by plugin authors included in the actual plugin.</p>
- <p>To use programs you must first enable them by setting <a class="el" href="group__PluginMacros.html#gad95e24b17f196260cee15255fdb5b677">DISTRHO_PLUGIN_WANT_PROGRAMS</a> to 1 in your DistrhoPluginInfo.h file.<br />
- When enabled you'll need to override 2 new function in your plugin code, <a class="el" href="classPlugin.html#a54d66af3111541b7c118f9749ef0231b">Plugin::initProgramName(uint32_t, String&)</a> and <a class="el" href="classPlugin.html#a44eb1bfcc3a3e5949ad053fc9ce55ce8">Plugin::loadProgram(uint32_t)</a>.</p>
- <p>Here's an example of a plugin with a "default" program: </p><div class="fragment"><div class="line"><span class="keyword">class </span>PluginWithPresets : <span class="keyword">public</span> <a class="code" href="classPlugin.html">Plugin</a></div>
- <div class="line">{</div>
- <div class="line"><span class="keyword">public</span>:</div>
- <div class="line"> PluginWithPresets()</div>
- <div class="line"> : <a class="code" href="classPlugin.html">Plugin</a>(2, 1, 0), <span class="comment">// 2 parameters, 1 program and 0 states</span></div>
- <div class="line"> fGainL(1.0f),</div>
- <div class="line"> fGainR(1.0f),</div>
- <div class="line"> {</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"><span class="keyword">protected</span>:</div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Information */</span></div>
- <div class="line"> </div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a00f7945c16149db6845fbcc2af729f4f">getLabel</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"Prog"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a955832840de786a7a22798f0ef451c5d">getMaker</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"DPF"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classPlugin.html#a686a3c92a376a185d6fd97efd59125d1">getLicense</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <span class="stringliteral">"MIT"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> uint32_t <a class="code" href="classPlugin.html#abae540dd93caf4834270358a8aad334a">getVersion</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <a class="code" href="group__MiscellaneousFunctions.html#ga95d67ff74d46b2c80f15c7790a523154">d_version</a>(1, 0, 0);</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> int64_t <a class="code" href="classPlugin.html#ad6ff8c80227d5ceebd40b96f3be29a66">getUniqueId</a>()<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">return</span> <a class="code" href="group__MiscellaneousFunctions.html#ga6827e90feb9bdcb6f76175a245fbf12c">d_cconst</a>(<span class="charliteral">'P'</span>, <span class="charliteral">'r'</span>, <span class="charliteral">'o'</span>, <span class="charliteral">'g'</span>);</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Init */</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Initialize a parameter.</span></div>
- <div class="line"><span class="comment"> This function will be called once, shortly after the plugin is created.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#aacf87bd0037efeb3b60d204940f3f4a0">initParameter</a>(uint32_t index, <a class="code" href="structParameter.html">Parameter</a>& parameter)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a397fb977f0c6cbec31df4f141ca3f5b3">hints</a> = <a class="code" href="group__ParameterHints.html#gaf82d83a105dc418877ef91e84ac6efd3">kParameterIsAutomatable</a>;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a>.<a class="code" href="structParameterRanges.html#a63c40988463a8ace9d0e9e55a00f3c7b">min</a> = 0.0f;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a>.<a class="code" href="structParameterRanges.html#a175c78c905c598df929a4450e4d2a2a0">max</a> = 2.0f;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a>.<a class="code" href="structParameterRanges.html#aa0aba68115bcfff25c35b2da2f7aed4c">def</a> = 1.0f;</div>
- <div class="line"> </div>
- <div class="line"> <span class="keywordflow">switch</span> (index)</div>
- <div class="line"> {</div>
- <div class="line"> <span class="keywordflow">case</span> 0:</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#ae63c1fcfb20e320bada1f58c04ff18da">name</a> = <span class="stringliteral">"Gain Right"</span>;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a3e546efd8dbd0d77351208b670719468">symbol</a> = <span class="stringliteral">"gainR"</span>;</div>
- <div class="line"> <span class="keywordflow">break</span>;</div>
- <div class="line"> <span class="keywordflow">case</span> 1:</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#ae63c1fcfb20e320bada1f58c04ff18da">name</a> = <span class="stringliteral">"Gain Left"</span>;</div>
- <div class="line"> parameter.<a class="code" href="structParameter.html#a3e546efd8dbd0d77351208b670719468">symbol</a> = <span class="stringliteral">"gainL"</span>;</div>
- <div class="line"> <span class="keywordflow">break</span>;</div>
- <div class="line"> }</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Set the name of the program @a index.</span></div>
- <div class="line"><span class="comment"> This function will be called once, shortly after the plugin is created.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a54d66af3111541b7c118f9749ef0231b">initProgramName</a>(uint32_t index, <a class="code" href="classString.html">String</a>& programName)</div>
- <div class="line"> {</div>
- <div class="line"> <span class="comment">// we only have one program so we can skip checking the index</span></div>
- <div class="line"> </div>
- <div class="line"> programName = <span class="stringliteral">"Default"</span>;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Internal data */</span></div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Get the current value of a parameter.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">float</span> <a class="code" href="classPlugin.html#af9e9f5438e2e0c2352052eb5f95832aa">getParameterValue</a>(uint32_t index)<span class="keyword"> const override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">switch</span> (index)</div>
- <div class="line"> {</div>
- <div class="line"> <span class="keywordflow">case</span> 0:</div>
- <div class="line"> <span class="keywordflow">return</span> fGainL;</div>
- <div class="line"> <span class="keywordflow">case</span> 1:</div>
- <div class="line"> <span class="keywordflow">return</span> fGainR;</div>
- <div class="line"> <span class="keywordflow">default</span>:</div>
- <div class="line"> <span class="keywordflow">return</span> 0.f;</div>
- <div class="line"> }</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Change a parameter value.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a7e9e26ceafc7603ef6163483a9dc39be">setParameterValue</a>(uint32_t index, <span class="keywordtype">float</span> value)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="keywordflow">switch</span> (index)</div>
- <div class="line"> {</div>
- <div class="line"> <span class="keywordflow">case</span> 0:</div>
- <div class="line"> fGainL = value;</div>
- <div class="line"> <span class="keywordflow">break</span>;</div>
- <div class="line"> <span class="keywordflow">case</span> 1:</div>
- <div class="line"> fGainR = value;</div>
- <div class="line"> <span class="keywordflow">break</span>;</div>
- <div class="line"> }</div>
- <div class="line"> }</div>
- <div class="line"><span class="comment"></span> </div>
- <div class="line"><span class="comment"> /**</span></div>
- <div class="line"><span class="comment"> Load a program.</span></div>
- <div class="line"><span class="comment"> */</span></div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a44eb1bfcc3a3e5949ad053fc9ce55ce8">loadProgram</a>(uint32_t index)</div>
- <div class="line"> {</div>
- <div class="line"> <span class="comment">// same as before, ignore index check</span></div>
- <div class="line"> </div>
- <div class="line"> fGainL = 1.0f;</div>
- <div class="line"> fGainR = 1.0f;</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">/* ----------------------------------------------------------------------------------------</span></div>
- <div class="line"><span class="comment"> * Audio/MIDI Processing */</span></div>
- <div class="line"> </div>
- <div class="line"> <span class="keywordtype">void</span> <a class="code" href="classPlugin.html#a0a969c78f8455ac6ba65fa42e8c498f6">run</a>(<span class="keyword">const</span> <span class="keywordtype">float</span>**, <span class="keywordtype">float</span>** outputs, uint32_t frames)<span class="keyword"> override</span></div>
- <div class="line"><span class="keyword"> </span>{</div>
- <div class="line"> <span class="comment">// get the left and right audio buffers</span></div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">float</span>* <span class="keyword">const</span> inL = inputs[0];</div>
- <div class="line"> <span class="keyword">const</span> <span class="keywordtype">float</span>* <span class="keyword">const</span> inR = inputs[0];</div>
- <div class="line"> <span class="comment">/* */</span> <span class="keywordtype">float</span>* <span class="keyword">const</span> outL = outputs[0];</div>
- <div class="line"> <span class="comment">/* */</span> <span class="keywordtype">float</span>* <span class="keyword">const</span> outR = outputs[0];</div>
- <div class="line"> </div>
- <div class="line"> <span class="comment">// apply gain against all samples</span></div>
- <div class="line"> <span class="keywordflow">for</span> (uint32_t i=0; i < frames; ++i)</div>
- <div class="line"> {</div>
- <div class="line"> outL[i] = inL[i] * fGainL;</div>
- <div class="line"> outR[i] = inR[i] * fGainR;</div>
- <div class="line"> }</div>
- <div class="line"> }</div>
- <div class="line"> </div>
- <div class="line"><span class="keyword">private</span>:</div>
- <div class="line"> <span class="keywordtype">float</span> fGainL, fGainR;</div>
- <div class="line">};</div>
- <div class="ttc" id="aclassPlugin_html_a44eb1bfcc3a3e5949ad053fc9ce55ce8"><div class="ttname"><a href="classPlugin.html#a44eb1bfcc3a3e5949ad053fc9ce55ce8">Plugin::loadProgram</a></div><div class="ttdeci">virtual void loadProgram(uint32_t index)</div></div>
- <div class="ttc" id="aclassPlugin_html_a54d66af3111541b7c118f9749ef0231b"><div class="ttname"><a href="classPlugin.html#a54d66af3111541b7c118f9749ef0231b">Plugin::initProgramName</a></div><div class="ttdeci">virtual void initProgramName(uint32_t index, String &programName)=0</div></div>
- <div class="ttc" id="aclassString_html"><div class="ttname"><a href="classString.html">String</a></div><div class="ttdef"><b>Definition:</b> String.hpp:35</div></div>
- </div><!-- fragment --><p>This is a work-in-progress documentation page. States, MIDI, Latency, Time-Position and <a class="el" href="classUI.html">UI</a> are still TODO. </p>
- </div></div><!-- PageDoc -->
- </div><!-- contents -->
- <!-- start footer part -->
- <hr class="footer"/><address class="footer"><small>
- Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
- </small></address>
- </body>
- </html>
|