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.

372 lines
18KB

  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.6"/>
  7. <title>DISTRHO Plugin Framework: Parameter Struct Reference</title>
  8. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  9. <script type="text/javascript" src="jquery.js"></script>
  10. <script type="text/javascript" src="dynsections.js"></script>
  11. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  12. <script type="text/javascript" src="search/search.js"></script>
  13. <script type="text/javascript">
  14. $(document).ready(function() { searchBox.OnSelectItem(0); });
  15. </script>
  16. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  17. </head>
  18. <body>
  19. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  20. <div id="titlearea">
  21. <table cellspacing="0" cellpadding="0">
  22. <tbody>
  23. <tr style="height: 56px;">
  24. <td style="padding-left: 0.5em;">
  25. <div id="projectname">DISTRHO Plugin Framework
  26. </div>
  27. </td>
  28. </tr>
  29. </tbody>
  30. </table>
  31. </div>
  32. <!-- end header part -->
  33. <!-- Generated by Doxygen 1.8.6 -->
  34. <script type="text/javascript">
  35. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  36. </script>
  37. <div id="navrow1" class="tabs">
  38. <ul class="tablist">
  39. <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  40. <li><a href="modules.html"><span>Modules</span></a></li>
  41. <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
  42. <li><a href="files.html"><span>Files</span></a></li>
  43. <li>
  44. <div id="MSearchBox" class="MSearchBoxInactive">
  45. <span class="left">
  46. <img id="MSearchSelect" src="search/mag_sel.png"
  47. onmouseover="return searchBox.OnSearchSelectShow()"
  48. onmouseout="return searchBox.OnSearchSelectHide()"
  49. alt=""/>
  50. <input type="text" id="MSearchField" value="Search" accesskey="S"
  51. onfocus="searchBox.OnSearchFieldFocus(true)"
  52. onblur="searchBox.OnSearchFieldFocus(false)"
  53. onkeyup="searchBox.OnSearchFieldChange(event)"/>
  54. </span><span class="right">
  55. <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
  56. </span>
  57. </div>
  58. </li>
  59. </ul>
  60. </div>
  61. <div id="navrow2" class="tabs2">
  62. <ul class="tablist">
  63. <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
  64. <li><a href="classes.html"><span>Class&#160;Index</span></a></li>
  65. <li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
  66. <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
  67. </ul>
  68. </div>
  69. <!-- window showing the filter options -->
  70. <div id="MSearchSelectWindow"
  71. onmouseover="return searchBox.OnSearchSelectShow()"
  72. onmouseout="return searchBox.OnSearchSelectHide()"
  73. onkeydown="return searchBox.OnSearchSelectKey(event)">
  74. <a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Pages</a></div>
  75. <!-- iframe showing the search results (closed by default) -->
  76. <div id="MSearchResultsWindow">
  77. <iframe src="javascript:void(0)" frameborder="0"
  78. name="MSearchResults" id="MSearchResults">
  79. </iframe>
  80. </div>
  81. </div><!-- top -->
  82. <div class="header">
  83. <div class="summary">
  84. <a href="#pub-methods">Public Member Functions</a> &#124;
  85. <a href="#pub-attribs">Public Attributes</a> &#124;
  86. <a href="structParameter-members.html">List of all members</a> </div>
  87. <div class="headertitle">
  88. <div class="title">Parameter Struct Reference<div class="ingroups"><a class="el" href="group__BasePluginStructs.html">Base Plugin Structs</a></div></div> </div>
  89. </div><!--header-->
  90. <div class="contents">
  91. <p><code>#include &lt;<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a>&gt;</code></p>
  92. <table class="memberdecls">
  93. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  94. Public Member Functions</h2></td></tr>
  95. <tr class="memitem:a12ced87d6d832deccb6c8ce2c8313b2e"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a12ced87d6d832deccb6c8ce2c8313b2e">Parameter</a> () noexcept</td></tr>
  96. <tr class="separator:a12ced87d6d832deccb6c8ce2c8313b2e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  97. <tr class="memitem:af0c5eeebedfe0058775a7ff4d904b6ab"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#af0c5eeebedfe0058775a7ff4d904b6ab">Parameter</a> (uint32_t h, const char *n, const char *s, const char *u, float def, float min, float max) noexcept</td></tr>
  98. <tr class="separator:af0c5eeebedfe0058775a7ff4d904b6ab"><td class="memSeparator" colspan="2">&#160;</td></tr>
  99. <tr class="memitem:ad959d31bcfaa056908406bbf37c134bf"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#ad959d31bcfaa056908406bbf37c134bf">initDesignation</a> (<a class="el" href="group__BasePluginStructs.html#ga9a7e733c40008f92e96e2ccf24f890de">ParameterDesignation</a> d) noexcept</td></tr>
  100. <tr class="separator:ad959d31bcfaa056908406bbf37c134bf"><td class="memSeparator" colspan="2">&#160;</td></tr>
  101. </table><table class="memberdecls">
  102. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
  103. Public Attributes</h2></td></tr>
  104. <tr class="memitem:a397fb977f0c6cbec31df4f141ca3f5b3"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a397fb977f0c6cbec31df4f141ca3f5b3">hints</a></td></tr>
  105. <tr class="separator:a397fb977f0c6cbec31df4f141ca3f5b3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  106. <tr class="memitem:ae63c1fcfb20e320bada1f58c04ff18da"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classString.html">String</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#ae63c1fcfb20e320bada1f58c04ff18da">name</a></td></tr>
  107. <tr class="separator:ae63c1fcfb20e320bada1f58c04ff18da"><td class="memSeparator" colspan="2">&#160;</td></tr>
  108. <tr class="memitem:a3e546efd8dbd0d77351208b670719468"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classString.html">String</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a3e546efd8dbd0d77351208b670719468">symbol</a></td></tr>
  109. <tr class="separator:a3e546efd8dbd0d77351208b670719468"><td class="memSeparator" colspan="2">&#160;</td></tr>
  110. <tr class="memitem:a2f79574998d34504e3a694163b4599a1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classString.html">String</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a2f79574998d34504e3a694163b4599a1">unit</a></td></tr>
  111. <tr class="separator:a2f79574998d34504e3a694163b4599a1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  112. <tr class="memitem:a2d0c81e4fb8fad18d920ef6ecd4a64db"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structParameterRanges.html">ParameterRanges</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a2d0c81e4fb8fad18d920ef6ecd4a64db">ranges</a></td></tr>
  113. <tr class="separator:a2d0c81e4fb8fad18d920ef6ecd4a64db"><td class="memSeparator" colspan="2">&#160;</td></tr>
  114. <tr class="memitem:ab94ec79aad8e8f6e4bc33d046f029358"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structParameterEnumerationValues.html">ParameterEnumerationValues</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#ab94ec79aad8e8f6e4bc33d046f029358">enumValues</a></td></tr>
  115. <tr class="separator:ab94ec79aad8e8f6e4bc33d046f029358"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <tr class="memitem:a3bbf6f7d5ccea9a13504bd6ee3713986"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__BasePluginStructs.html#ga9a7e733c40008f92e96e2ccf24f890de">ParameterDesignation</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a3bbf6f7d5ccea9a13504bd6ee3713986">designation</a></td></tr>
  117. <tr class="separator:a3bbf6f7d5ccea9a13504bd6ee3713986"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:a5389731e4cd95cac10af9aec9aa7b202"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structParameter.html#a5389731e4cd95cac10af9aec9aa7b202">midiCC</a></td></tr>
  119. <tr class="separator:a5389731e4cd95cac10af9aec9aa7b202"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. </table>
  121. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  122. <div class="textblock"><p><a class="el" href="structParameter.html">Parameter</a>. </p>
  123. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  124. <a class="anchor" id="a12ced87d6d832deccb6c8ce2c8313b2e"></a>
  125. <div class="memitem">
  126. <div class="memproto">
  127. <table class="mlabels">
  128. <tr>
  129. <td class="mlabels-left">
  130. <table class="memname">
  131. <tr>
  132. <td class="memname">Parameter::Parameter </td>
  133. <td>(</td>
  134. <td class="paramname"></td><td>)</td>
  135. <td></td>
  136. </tr>
  137. </table>
  138. </td>
  139. <td class="mlabels-right">
  140. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">noexcept</span></span> </td>
  141. </tr>
  142. </table>
  143. </div><div class="memdoc">
  144. <p>Default constructor for a null parameter. </p>
  145. </div>
  146. </div>
  147. <a class="anchor" id="af0c5eeebedfe0058775a7ff4d904b6ab"></a>
  148. <div class="memitem">
  149. <div class="memproto">
  150. <table class="mlabels">
  151. <tr>
  152. <td class="mlabels-left">
  153. <table class="memname">
  154. <tr>
  155. <td class="memname">Parameter::Parameter </td>
  156. <td>(</td>
  157. <td class="paramtype">uint32_t&#160;</td>
  158. <td class="paramname"><em>h</em>, </td>
  159. </tr>
  160. <tr>
  161. <td class="paramkey"></td>
  162. <td></td>
  163. <td class="paramtype">const char *&#160;</td>
  164. <td class="paramname"><em>n</em>, </td>
  165. </tr>
  166. <tr>
  167. <td class="paramkey"></td>
  168. <td></td>
  169. <td class="paramtype">const char *&#160;</td>
  170. <td class="paramname"><em>s</em>, </td>
  171. </tr>
  172. <tr>
  173. <td class="paramkey"></td>
  174. <td></td>
  175. <td class="paramtype">const char *&#160;</td>
  176. <td class="paramname"><em>u</em>, </td>
  177. </tr>
  178. <tr>
  179. <td class="paramkey"></td>
  180. <td></td>
  181. <td class="paramtype">float&#160;</td>
  182. <td class="paramname"><em>def</em>, </td>
  183. </tr>
  184. <tr>
  185. <td class="paramkey"></td>
  186. <td></td>
  187. <td class="paramtype">float&#160;</td>
  188. <td class="paramname"><em>min</em>, </td>
  189. </tr>
  190. <tr>
  191. <td class="paramkey"></td>
  192. <td></td>
  193. <td class="paramtype">float&#160;</td>
  194. <td class="paramname"><em>max</em>&#160;</td>
  195. </tr>
  196. <tr>
  197. <td></td>
  198. <td>)</td>
  199. <td></td><td></td>
  200. </tr>
  201. </table>
  202. </td>
  203. <td class="mlabels-right">
  204. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">noexcept</span></span> </td>
  205. </tr>
  206. </table>
  207. </div><div class="memdoc">
  208. <p>Constructor using custom values. </p>
  209. </div>
  210. </div>
  211. <h2 class="groupheader">Member Function Documentation</h2>
  212. <a class="anchor" id="ad959d31bcfaa056908406bbf37c134bf"></a>
  213. <div class="memitem">
  214. <div class="memproto">
  215. <table class="mlabels">
  216. <tr>
  217. <td class="mlabels-left">
  218. <table class="memname">
  219. <tr>
  220. <td class="memname">void Parameter::initDesignation </td>
  221. <td>(</td>
  222. <td class="paramtype"><a class="el" href="group__BasePluginStructs.html#ga9a7e733c40008f92e96e2ccf24f890de">ParameterDesignation</a>&#160;</td>
  223. <td class="paramname"><em>d</em></td><td>)</td>
  224. <td></td>
  225. </tr>
  226. </table>
  227. </td>
  228. <td class="mlabels-right">
  229. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">noexcept</span></span> </td>
  230. </tr>
  231. </table>
  232. </div><div class="memdoc">
  233. <p>Initialize a parameter for a specific designation. </p>
  234. </div>
  235. </div>
  236. <h2 class="groupheader">Member Data Documentation</h2>
  237. <a class="anchor" id="a397fb977f0c6cbec31df4f141ca3f5b3"></a>
  238. <div class="memitem">
  239. <div class="memproto">
  240. <table class="memname">
  241. <tr>
  242. <td class="memname">uint32_t Parameter::hints</td>
  243. </tr>
  244. </table>
  245. </div><div class="memdoc">
  246. <p>Hints describing this parameter. </p>
  247. <dl class="section see"><dt>See Also</dt><dd><a class="el" href="group__ParameterHints.html">Parameter Hints</a> </dd></dl>
  248. </div>
  249. </div>
  250. <a class="anchor" id="ae63c1fcfb20e320bada1f58c04ff18da"></a>
  251. <div class="memitem">
  252. <div class="memproto">
  253. <table class="memname">
  254. <tr>
  255. <td class="memname"><a class="el" href="classString.html">String</a> Parameter::name</td>
  256. </tr>
  257. </table>
  258. </div><div class="memdoc">
  259. <p>The name of this parameter.<br/>
  260. A parameter name can contain any character, but hosts might have a hard time with non-ascii ones.<br/>
  261. The name doesn't have to be unique within a plugin instance, but it's recommended. </p>
  262. </div>
  263. </div>
  264. <a class="anchor" id="a3e546efd8dbd0d77351208b670719468"></a>
  265. <div class="memitem">
  266. <div class="memproto">
  267. <table class="memname">
  268. <tr>
  269. <td class="memname"><a class="el" href="classString.html">String</a> Parameter::symbol</td>
  270. </tr>
  271. </table>
  272. </div><div class="memdoc">
  273. <p>The symbol of this parameter.<br/>
  274. A parameter symbol is a short restricted name used as a machine and human readable identifier.<br/>
  275. The first character must be one of _, a-z or A-Z and subsequent characters can be from _, a-z, A-Z and 0-9. </p>
  276. <dl class="section note"><dt>Note</dt><dd><a class="el" href="structParameter.html">Parameter</a> symbols MUST be unique within a plugin instance. </dd></dl>
  277. </div>
  278. </div>
  279. <a class="anchor" id="a2f79574998d34504e3a694163b4599a1"></a>
  280. <div class="memitem">
  281. <div class="memproto">
  282. <table class="memname">
  283. <tr>
  284. <td class="memname"><a class="el" href="classString.html">String</a> Parameter::unit</td>
  285. </tr>
  286. </table>
  287. </div><div class="memdoc">
  288. <p>The unit of this parameter.<br/>
  289. This means something like "dB", "kHz" and "ms".<br/>
  290. Can be left blank if a unit does not apply to this parameter. </p>
  291. </div>
  292. </div>
  293. <a class="anchor" id="a2d0c81e4fb8fad18d920ef6ecd4a64db"></a>
  294. <div class="memitem">
  295. <div class="memproto">
  296. <table class="memname">
  297. <tr>
  298. <td class="memname"><a class="el" href="structParameterRanges.html">ParameterRanges</a> Parameter::ranges</td>
  299. </tr>
  300. </table>
  301. </div><div class="memdoc">
  302. <p>Ranges of this parameter.<br/>
  303. The ranges describe the default, minimum and maximum values. </p>
  304. </div>
  305. </div>
  306. <a class="anchor" id="ab94ec79aad8e8f6e4bc33d046f029358"></a>
  307. <div class="memitem">
  308. <div class="memproto">
  309. <table class="memname">
  310. <tr>
  311. <td class="memname"><a class="el" href="structParameterEnumerationValues.html">ParameterEnumerationValues</a> Parameter::enumValues</td>
  312. </tr>
  313. </table>
  314. </div><div class="memdoc">
  315. <p>Enumeration values.<br/>
  316. Can be used to give meaning to parameter values, working as an enumeration. </p>
  317. </div>
  318. </div>
  319. <a class="anchor" id="a3bbf6f7d5ccea9a13504bd6ee3713986"></a>
  320. <div class="memitem">
  321. <div class="memproto">
  322. <table class="memname">
  323. <tr>
  324. <td class="memname"><a class="el" href="group__BasePluginStructs.html#ga9a7e733c40008f92e96e2ccf24f890de">ParameterDesignation</a> Parameter::designation</td>
  325. </tr>
  326. </table>
  327. </div><div class="memdoc">
  328. <p>Designation for this parameter. </p>
  329. </div>
  330. </div>
  331. <a class="anchor" id="a5389731e4cd95cac10af9aec9aa7b202"></a>
  332. <div class="memitem">
  333. <div class="memproto">
  334. <table class="memname">
  335. <tr>
  336. <td class="memname">uint8_t Parameter::midiCC</td>
  337. </tr>
  338. </table>
  339. </div><div class="memdoc">
  340. <p>MIDI CC to use by default on this parameter.<br/>
  341. A value of 0 or 32 (bank change) is considered invalid.<br/>
  342. Must also be less or equal to 120. </p>
  343. <dl class="section note"><dt>Note</dt><dd>This value is only a hint! Hosts might map it automatically or completely ignore it. </dd></dl>
  344. </div>
  345. </div>
  346. <hr/>The documentation for this struct was generated from the following file:<ul>
  347. <li>distrho/<a class="el" href="DistrhoPlugin_8hpp_source.html">DistrhoPlugin.hpp</a></li>
  348. </ul>
  349. </div><!-- contents -->
  350. <!-- start footer part -->
  351. <hr class="footer"/><address class="footer"><small>
  352. Generated on Mon Jun 24 2019 11:54:44 for DISTRHO Plugin Framework by &#160;<a href="http://www.doxygen.org/index.html">
  353. <img class="footer" src="doxygen.png" alt="doxygen"/>
  354. </a> 1.8.6
  355. </small></address>
  356. </body>
  357. </html>