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.

388 lines
17KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.9.1"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>DISTRHO Plugin Framework: Math related functions</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  13. <script type="text/javascript" src="search/searchdata.js"></script>
  14. <script type="text/javascript" src="search/search.js"></script>
  15. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  16. </head>
  17. <body>
  18. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  19. <div id="titlearea">
  20. <table cellspacing="0" cellpadding="0">
  21. <tbody>
  22. <tr style="height: 56px;">
  23. <td id="projectalign" style="padding-left: 0.5em;">
  24. <div id="projectname">DISTRHO Plugin Framework
  25. </div>
  26. </td>
  27. </tr>
  28. </tbody>
  29. </table>
  30. </div>
  31. <!-- end header part -->
  32. <!-- Generated by Doxygen 1.9.1 -->
  33. <script type="text/javascript">
  34. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  35. var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
  36. /* @license-end */
  37. </script>
  38. <script type="text/javascript" src="menudata.js"></script>
  39. <script type="text/javascript" src="menu.js"></script>
  40. <script type="text/javascript">
  41. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  42. $(function() {
  43. initMenu('',true,false,'search.php','Search');
  44. $(document).ready(function() { init_search(); });
  45. });
  46. /* @license-end */</script>
  47. <div id="main-nav"></div>
  48. </div><!-- top -->
  49. <!-- window showing the filter options -->
  50. <div id="MSearchSelectWindow"
  51. onmouseover="return searchBox.OnSearchSelectShow()"
  52. onmouseout="return searchBox.OnSearchSelectHide()"
  53. onkeydown="return searchBox.OnSearchSelectKey(event)">
  54. </div>
  55. <!-- iframe showing the search results (closed by default) -->
  56. <div id="MSearchResultsWindow">
  57. <iframe src="javascript:void(0)" frameborder="0"
  58. name="MSearchResults" id="MSearchResults">
  59. </iframe>
  60. </div>
  61. <div class="header">
  62. <div class="summary">
  63. <a href="#func-members">Functions</a> </div>
  64. <div class="headertitle">
  65. <div class="title">Math related functions</div> </div>
  66. </div><!--header-->
  67. <div class="contents">
  68. <table class="memberdecls">
  69. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
  70. Functions</h2></td></tr>
  71. <tr class="memitem:ga81d4bbe1b2730cfc30aec9b347ef9360"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  72. <tr class="memitem:ga81d4bbe1b2730cfc30aec9b347ef9360"><td class="memTemplItemLeft" align="right" valign="top">static constexpr bool&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#ga81d4bbe1b2730cfc30aec9b347ef9360">d_isEqual</a> (const T &amp;v1, const T &amp;v2)</td></tr>
  73. <tr class="separator:ga81d4bbe1b2730cfc30aec9b347ef9360"><td class="memSeparator" colspan="2">&#160;</td></tr>
  74. <tr class="memitem:ga3d70c97c300b9fb2792ba4fbb2fb501e"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  75. <tr class="memitem:ga3d70c97c300b9fb2792ba4fbb2fb501e"><td class="memTemplItemLeft" align="right" valign="top">static constexpr bool&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#ga3d70c97c300b9fb2792ba4fbb2fb501e">d_isNotEqual</a> (const T &amp;v1, const T &amp;v2)</td></tr>
  76. <tr class="separator:ga3d70c97c300b9fb2792ba4fbb2fb501e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  77. <tr class="memitem:gaf5526b06989c47f21bdff3cd99af8353"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  78. <tr class="memitem:gaf5526b06989c47f21bdff3cd99af8353"><td class="memTemplItemLeft" align="right" valign="top">static constexpr bool&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#gaf5526b06989c47f21bdff3cd99af8353">d_isZero</a> (const T &amp;value)</td></tr>
  79. <tr class="separator:gaf5526b06989c47f21bdff3cd99af8353"><td class="memSeparator" colspan="2">&#160;</td></tr>
  80. <tr class="memitem:gad891a20280e4f41017e7247d6e5a1f13"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  81. <tr class="memitem:gad891a20280e4f41017e7247d6e5a1f13"><td class="memTemplItemLeft" align="right" valign="top">static constexpr bool&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#gad891a20280e4f41017e7247d6e5a1f13">d_isNotZero</a> (const T &amp;value)</td></tr>
  82. <tr class="separator:gad891a20280e4f41017e7247d6e5a1f13"><td class="memSeparator" colspan="2">&#160;</td></tr>
  83. <tr class="memitem:gaded8dbdc7ff99c70e7361b3f1a32b584"><td class="memItemLeft" align="right" valign="top">static uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#gaded8dbdc7ff99c70e7361b3f1a32b584">d_nextPowerOf2</a> (uint32_t size) noexcept</td></tr>
  84. <tr class="separator:gaded8dbdc7ff99c70e7361b3f1a32b584"><td class="memSeparator" colspan="2">&#160;</td></tr>
  85. <tr class="memitem:ga3de0a572416cb38ca424094b595954ae"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  86. <tr class="memitem:ga3de0a572416cb38ca424094b595954ae"><td class="memTemplItemLeft" align="right" valign="top">static constexpr int32_t&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#ga3de0a572416cb38ca424094b595954ae">d_roundToIntPositive</a> (const T &amp;value)</td></tr>
  87. <tr class="separator:ga3de0a572416cb38ca424094b595954ae"><td class="memSeparator" colspan="2">&#160;</td></tr>
  88. <tr class="memitem:ga10abb07d21f97c5fbc0ec0b5fa0ab721"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  89. <tr class="memitem:ga10abb07d21f97c5fbc0ec0b5fa0ab721"><td class="memTemplItemLeft" align="right" valign="top">static constexpr uint32_t&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#ga10abb07d21f97c5fbc0ec0b5fa0ab721">d_roundToUnsignedInt</a> (const T &amp;value)</td></tr>
  90. <tr class="separator:ga10abb07d21f97c5fbc0ec0b5fa0ab721"><td class="memSeparator" colspan="2">&#160;</td></tr>
  91. <tr class="memitem:gadd62923031cb7d9e06d01957b3bcf3a6"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  92. <tr class="memitem:gadd62923031cb7d9e06d01957b3bcf3a6"><td class="memTemplItemLeft" align="right" valign="top">static constexpr int32_t&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#gadd62923031cb7d9e06d01957b3bcf3a6">d_roundToIntNegative</a> (const T &amp;value)</td></tr>
  93. <tr class="separator:gadd62923031cb7d9e06d01957b3bcf3a6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  94. <tr class="memitem:ga981676558e521894c2ec4ca56b2ec8af"><td class="memTemplParams" colspan="2">template&lt;typename T &gt; </td></tr>
  95. <tr class="memitem:ga981676558e521894c2ec4ca56b2ec8af"><td class="memTemplItemLeft" align="right" valign="top">static constexpr int32_t&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="group__MathFunctions.html#ga981676558e521894c2ec4ca56b2ec8af">d_roundToInt</a> (const T &amp;value)</td></tr>
  96. <tr class="separator:ga981676558e521894c2ec4ca56b2ec8af"><td class="memSeparator" colspan="2">&#160;</td></tr>
  97. </table>
  98. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  99. <h2 class="groupheader">Function Documentation</h2>
  100. <a id="ga81d4bbe1b2730cfc30aec9b347ef9360"></a>
  101. <h2 class="memtitle"><span class="permalink"><a href="#ga81d4bbe1b2730cfc30aec9b347ef9360">&#9670;&nbsp;</a></span>d_isEqual()</h2>
  102. <div class="memitem">
  103. <div class="memproto">
  104. <div class="memtemplate">
  105. template&lt;typename T &gt; </div>
  106. <table class="mlabels">
  107. <tr>
  108. <td class="mlabels-left">
  109. <table class="memname">
  110. <tr>
  111. <td class="memname">static constexpr bool d_isEqual </td>
  112. <td>(</td>
  113. <td class="paramtype">const T &amp;&#160;</td>
  114. <td class="paramname"><em>v1</em>, </td>
  115. </tr>
  116. <tr>
  117. <td class="paramkey"></td>
  118. <td></td>
  119. <td class="paramtype">const T &amp;&#160;</td>
  120. <td class="paramname"><em>v2</em>&#160;</td>
  121. </tr>
  122. <tr>
  123. <td></td>
  124. <td>)</td>
  125. <td></td><td></td>
  126. </tr>
  127. </table>
  128. </td>
  129. <td class="mlabels-right">
  130. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  131. </tr>
  132. </table>
  133. </div><div class="memdoc">
  134. <p>Safely compare two floating point numbers. Returns true if they match. </p>
  135. </div>
  136. </div>
  137. <a id="ga3d70c97c300b9fb2792ba4fbb2fb501e"></a>
  138. <h2 class="memtitle"><span class="permalink"><a href="#ga3d70c97c300b9fb2792ba4fbb2fb501e">&#9670;&nbsp;</a></span>d_isNotEqual()</h2>
  139. <div class="memitem">
  140. <div class="memproto">
  141. <div class="memtemplate">
  142. template&lt;typename T &gt; </div>
  143. <table class="mlabels">
  144. <tr>
  145. <td class="mlabels-left">
  146. <table class="memname">
  147. <tr>
  148. <td class="memname">static constexpr bool d_isNotEqual </td>
  149. <td>(</td>
  150. <td class="paramtype">const T &amp;&#160;</td>
  151. <td class="paramname"><em>v1</em>, </td>
  152. </tr>
  153. <tr>
  154. <td class="paramkey"></td>
  155. <td></td>
  156. <td class="paramtype">const T &amp;&#160;</td>
  157. <td class="paramname"><em>v2</em>&#160;</td>
  158. </tr>
  159. <tr>
  160. <td></td>
  161. <td>)</td>
  162. <td></td><td></td>
  163. </tr>
  164. </table>
  165. </td>
  166. <td class="mlabels-right">
  167. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  168. </tr>
  169. </table>
  170. </div><div class="memdoc">
  171. <p>Safely compare two floating point numbers. Returns true if they don't match. </p>
  172. </div>
  173. </div>
  174. <a id="gaf5526b06989c47f21bdff3cd99af8353"></a>
  175. <h2 class="memtitle"><span class="permalink"><a href="#gaf5526b06989c47f21bdff3cd99af8353">&#9670;&nbsp;</a></span>d_isZero()</h2>
  176. <div class="memitem">
  177. <div class="memproto">
  178. <div class="memtemplate">
  179. template&lt;typename T &gt; </div>
  180. <table class="mlabels">
  181. <tr>
  182. <td class="mlabels-left">
  183. <table class="memname">
  184. <tr>
  185. <td class="memname">static constexpr bool d_isZero </td>
  186. <td>(</td>
  187. <td class="paramtype">const T &amp;&#160;</td>
  188. <td class="paramname"><em>value</em></td><td>)</td>
  189. <td></td>
  190. </tr>
  191. </table>
  192. </td>
  193. <td class="mlabels-right">
  194. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  195. </tr>
  196. </table>
  197. </div><div class="memdoc">
  198. <p>Safely check if a floating point number is zero. </p>
  199. </div>
  200. </div>
  201. <a id="gad891a20280e4f41017e7247d6e5a1f13"></a>
  202. <h2 class="memtitle"><span class="permalink"><a href="#gad891a20280e4f41017e7247d6e5a1f13">&#9670;&nbsp;</a></span>d_isNotZero()</h2>
  203. <div class="memitem">
  204. <div class="memproto">
  205. <div class="memtemplate">
  206. template&lt;typename T &gt; </div>
  207. <table class="mlabels">
  208. <tr>
  209. <td class="mlabels-left">
  210. <table class="memname">
  211. <tr>
  212. <td class="memname">static constexpr bool d_isNotZero </td>
  213. <td>(</td>
  214. <td class="paramtype">const T &amp;&#160;</td>
  215. <td class="paramname"><em>value</em></td><td>)</td>
  216. <td></td>
  217. </tr>
  218. </table>
  219. </td>
  220. <td class="mlabels-right">
  221. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  222. </tr>
  223. </table>
  224. </div><div class="memdoc">
  225. <p>Safely check if a floating point number is not zero. </p>
  226. </div>
  227. </div>
  228. <a id="gaded8dbdc7ff99c70e7361b3f1a32b584"></a>
  229. <h2 class="memtitle"><span class="permalink"><a href="#gaded8dbdc7ff99c70e7361b3f1a32b584">&#9670;&nbsp;</a></span>d_nextPowerOf2()</h2>
  230. <div class="memitem">
  231. <div class="memproto">
  232. <table class="mlabels">
  233. <tr>
  234. <td class="mlabels-left">
  235. <table class="memname">
  236. <tr>
  237. <td class="memname">static uint32_t d_nextPowerOf2 </td>
  238. <td>(</td>
  239. <td class="paramtype">uint32_t&#160;</td>
  240. <td class="paramname"><em>size</em></td><td>)</td>
  241. <td></td>
  242. </tr>
  243. </table>
  244. </td>
  245. <td class="mlabels-right">
  246. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">noexcept</span></span> </td>
  247. </tr>
  248. </table>
  249. </div><div class="memdoc">
  250. <p>Get next power of 2. </p>
  251. </div>
  252. </div>
  253. <a id="ga3de0a572416cb38ca424094b595954ae"></a>
  254. <h2 class="memtitle"><span class="permalink"><a href="#ga3de0a572416cb38ca424094b595954ae">&#9670;&nbsp;</a></span>d_roundToIntPositive()</h2>
  255. <div class="memitem">
  256. <div class="memproto">
  257. <div class="memtemplate">
  258. template&lt;typename T &gt; </div>
  259. <table class="mlabels">
  260. <tr>
  261. <td class="mlabels-left">
  262. <table class="memname">
  263. <tr>
  264. <td class="memname">static constexpr int32_t d_roundToIntPositive </td>
  265. <td>(</td>
  266. <td class="paramtype">const T &amp;&#160;</td>
  267. <td class="paramname"><em>value</em></td><td>)</td>
  268. <td></td>
  269. </tr>
  270. </table>
  271. </td>
  272. <td class="mlabels-right">
  273. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  274. </tr>
  275. </table>
  276. </div><div class="memdoc">
  277. <p>Round a floating point number to an integer. Fast operation for values known to be 0 or positive. </p>
  278. </div>
  279. </div>
  280. <a id="ga10abb07d21f97c5fbc0ec0b5fa0ab721"></a>
  281. <h2 class="memtitle"><span class="permalink"><a href="#ga10abb07d21f97c5fbc0ec0b5fa0ab721">&#9670;&nbsp;</a></span>d_roundToUnsignedInt()</h2>
  282. <div class="memitem">
  283. <div class="memproto">
  284. <div class="memtemplate">
  285. template&lt;typename T &gt; </div>
  286. <table class="mlabels">
  287. <tr>
  288. <td class="mlabels-left">
  289. <table class="memname">
  290. <tr>
  291. <td class="memname">static constexpr uint32_t d_roundToUnsignedInt </td>
  292. <td>(</td>
  293. <td class="paramtype">const T &amp;&#160;</td>
  294. <td class="paramname"><em>value</em></td><td>)</td>
  295. <td></td>
  296. </tr>
  297. </table>
  298. </td>
  299. <td class="mlabels-right">
  300. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  301. </tr>
  302. </table>
  303. </div><div class="memdoc">
  304. <p>Round a floating point number to an unsigned integer. Fast operation for values known to be 0 or positive. </p>
  305. </div>
  306. </div>
  307. <a id="gadd62923031cb7d9e06d01957b3bcf3a6"></a>
  308. <h2 class="memtitle"><span class="permalink"><a href="#gadd62923031cb7d9e06d01957b3bcf3a6">&#9670;&nbsp;</a></span>d_roundToIntNegative()</h2>
  309. <div class="memitem">
  310. <div class="memproto">
  311. <div class="memtemplate">
  312. template&lt;typename T &gt; </div>
  313. <table class="mlabels">
  314. <tr>
  315. <td class="mlabels-left">
  316. <table class="memname">
  317. <tr>
  318. <td class="memname">static constexpr int32_t d_roundToIntNegative </td>
  319. <td>(</td>
  320. <td class="paramtype">const T &amp;&#160;</td>
  321. <td class="paramname"><em>value</em></td><td>)</td>
  322. <td></td>
  323. </tr>
  324. </table>
  325. </td>
  326. <td class="mlabels-right">
  327. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  328. </tr>
  329. </table>
  330. </div><div class="memdoc">
  331. <p>Round a floating point number to an integer. Fast operation for values known to be 0 or negative. </p>
  332. </div>
  333. </div>
  334. <a id="ga981676558e521894c2ec4ca56b2ec8af"></a>
  335. <h2 class="memtitle"><span class="permalink"><a href="#ga981676558e521894c2ec4ca56b2ec8af">&#9670;&nbsp;</a></span>d_roundToInt()</h2>
  336. <div class="memitem">
  337. <div class="memproto">
  338. <div class="memtemplate">
  339. template&lt;typename T &gt; </div>
  340. <table class="mlabels">
  341. <tr>
  342. <td class="mlabels-left">
  343. <table class="memname">
  344. <tr>
  345. <td class="memname">static constexpr int32_t d_roundToInt </td>
  346. <td>(</td>
  347. <td class="paramtype">const T &amp;&#160;</td>
  348. <td class="paramname"><em>value</em></td><td>)</td>
  349. <td></td>
  350. </tr>
  351. </table>
  352. </td>
  353. <td class="mlabels-right">
  354. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">constexpr</span></span> </td>
  355. </tr>
  356. </table>
  357. </div><div class="memdoc">
  358. <p>Round a floating point number to integer. </p>
  359. </div>
  360. </div>
  361. </div><!-- contents -->
  362. <!-- start footer part -->
  363. <hr class="footer"/><address class="footer"><small>
  364. Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
  365. </small></address>
  366. </body>
  367. </html>