Collection of tools useful for audio production
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.

460 lines
13KB

  1. /*
  2. * Carla Backend
  3. * Copyright (C) 2011-2012 Filipe Coelho <falktx@falktx.com>
  4. *
  5. * This program is free software; you can redistribute it and/or modify
  6. * it under the terms of the GNU General Public License as published by
  7. * the Free Software Foundation; either version 2 of the License, or
  8. * any later version.
  9. *
  10. * This program is distributed in the hope that it will be useful,
  11. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13. * GNU General Public License for more details.
  14. *
  15. * For a full copy of the GNU General Public License see the COPYING file
  16. */
  17. #ifndef CARLA_BACKEND_UTILS_HPP
  18. #define CARLA_BACKEND_UTILS_HPP
  19. #include "carla_backend.hpp"
  20. #include "carla_utils.hpp"
  21. CARLA_BACKEND_START_NAMESPACE
  22. /*!
  23. * @defgroup CarlaBackendUtils Carla Backend Utils
  24. *
  25. * Carla Backend Utils
  26. *
  27. * @{
  28. */
  29. static inline
  30. const char* BinaryType2Str(const BinaryType& type)
  31. {
  32. switch (type)
  33. {
  34. case BINARY_NONE:
  35. return "BINARY_NONE";
  36. case BINARY_POSIX32:
  37. return "BINARY_POSIX32";
  38. case BINARY_POSIX64:
  39. return "BINARY_POSIX64";
  40. case BINARY_WIN32:
  41. return "BINARY_WIN32";
  42. case BINARY_WIN64:
  43. return "BINARY_WIN64";
  44. case BINARY_OTHER:
  45. return "BINARY_OTHER";
  46. }
  47. qWarning("CarlaBackend::BinaryType2Str(%i) - invalid type", type);
  48. return nullptr;
  49. }
  50. static inline
  51. const char* PluginType2Str(const PluginType& type)
  52. {
  53. switch (type)
  54. {
  55. case PLUGIN_NONE:
  56. return "PLUGIN_NONE";
  57. case PLUGIN_INTERNAL:
  58. return "PLUGIN_INTERNAL";
  59. case PLUGIN_LADSPA:
  60. return "PLUGIN_LADSPA";
  61. case PLUGIN_DSSI:
  62. return "PLUGIN_DSSI";
  63. case PLUGIN_LV2:
  64. return "PLUGIN_LV2";
  65. case PLUGIN_VST:
  66. return "PLUGIN_VST";
  67. case PLUGIN_GIG:
  68. return "PLUGIN_GIG";
  69. case PLUGIN_SF2:
  70. return "PLUGIN_SF2";
  71. case PLUGIN_SFZ:
  72. return "PLUGIN_SFZ";
  73. }
  74. qWarning("CarlaBackend::PluginType2Str(%i) - invalid type", type);
  75. return nullptr;
  76. }
  77. static inline
  78. const char* PluginCategory2Str(const PluginCategory& category)
  79. {
  80. switch (category)
  81. {
  82. case PLUGIN_CATEGORY_NONE:
  83. return "PLUGIN_CATEGORY_NONE";
  84. case PLUGIN_CATEGORY_SYNTH:
  85. return "PLUGIN_CATEGORY_SYNTH";
  86. case PLUGIN_CATEGORY_DELAY:
  87. return "PLUGIN_CATEGORY_DELAY";
  88. case PLUGIN_CATEGORY_EQ:
  89. return "PLUGIN_CATEGORY_EQ";
  90. case PLUGIN_CATEGORY_FILTER:
  91. return "PLUGIN_CATEGORY_FILTER";
  92. case PLUGIN_CATEGORY_DYNAMICS:
  93. return "PLUGIN_CATEGORY_DYNAMICS";
  94. case PLUGIN_CATEGORY_MODULATOR:
  95. return "PLUGIN_CATEGORY_MODULATOR";
  96. case PLUGIN_CATEGORY_UTILITY:
  97. return "PLUGIN_CATEGORY_UTILITY";
  98. case PLUGIN_CATEGORY_OTHER:
  99. return "PLUGIN_CATEGORY_OTHER";
  100. }
  101. qWarning("CarlaBackend::PluginCategory2Str(%i) - invalid category", category);
  102. return nullptr;
  103. }
  104. static inline
  105. const char* ParameterType2Str(const ParameterType& type)
  106. {
  107. switch (type)
  108. {
  109. case PARAMETER_UNKNOWN:
  110. return "PARAMETER_UNKNOWN";
  111. case PARAMETER_INPUT:
  112. return "PARAMETER_INPUT";
  113. case PARAMETER_OUTPUT:
  114. return "PARAMETER_OUTPUT";
  115. case PARAMETER_LATENCY:
  116. return "PARAMETER_LATENCY";
  117. case PARAMETER_SAMPLE_RATE:
  118. return "PARAMETER_SAMPLE_RATE";
  119. case PARAMETER_LV2_FREEWHEEL:
  120. return "PARAMETER_LV2_FREEWHEEL";
  121. case PARAMETER_LV2_TIME:
  122. return "PARAMETER_LV2_TIME";
  123. }
  124. qWarning("CarlaBackend::ParameterType2Str(%i) - invalid type", type);
  125. return nullptr;
  126. }
  127. static inline
  128. const char* InternalParametersIndex2Str(const InternalParametersIndex& index)
  129. {
  130. switch (index)
  131. {
  132. case PARAMETER_NULL:
  133. return "PARAMETER_NULL";
  134. case PARAMETER_ACTIVE:
  135. return "PARAMETER_ACTIVE";
  136. case PARAMETER_DRYWET:
  137. return "PARAMETER_DRYWET";
  138. case PARAMETER_VOLUME:
  139. return "PARAMETER_VOLUME";
  140. case PARAMETER_BALANCE_LEFT:
  141. return "PARAMETER_BALANCE_LEFT";
  142. case PARAMETER_BALANCE_RIGHT:
  143. return "PARAMETER_BALANCE_RIGHT";
  144. }
  145. qWarning("CarlaBackend::InternalParametersIndex2Str(%i) - invalid index", index);
  146. return nullptr;
  147. }
  148. static inline
  149. const char* GuiType2Str(const GuiType& type)
  150. {
  151. switch (type)
  152. {
  153. case GUI_NONE:
  154. return "GUI_NONE";
  155. case GUI_INTERNAL_QT4:
  156. return "GUI_INTERNAL_QT4";
  157. case GUI_INTERNAL_COCOA:
  158. return "GUI_INTERNAL_COCOA";
  159. case GUI_INTERNAL_HWND:
  160. return "GUI_INTERNAL_HWND";
  161. case GUI_INTERNAL_X11:
  162. return "GUI_INTERNAL_X11";
  163. case GUI_EXTERNAL_LV2:
  164. return "GUI_EXTERNAL_LV2";
  165. case GUI_EXTERNAL_SUIL:
  166. return "GUI_EXTERNAL_SUIL";
  167. case GUI_EXTERNAL_OSC:
  168. return "GUI_EXTERNAL_OSC";
  169. }
  170. qWarning("CarlaBackend::GuiType2Str(%i) - invalid type", type);
  171. return nullptr;
  172. }
  173. static inline
  174. const char* OptionsType2Str(const OptionsType& type)
  175. {
  176. switch (type)
  177. {
  178. case OPTION_PROCESS_NAME:
  179. return "OPTION_PROCESS_NAME";
  180. case OPTION_PROCESS_MODE:
  181. return "OPTION_PROCESS_MODE";
  182. case OPTION_PROCESS_HIGH_PRECISION:
  183. return "OPTION_PROCESS_HIGH_PRECISION";
  184. case OPTION_MAX_PARAMETERS:
  185. return "OPTION_MAX_PARAMETERS";
  186. case OPTION_PREFERRED_BUFFER_SIZE:
  187. return "OPTION_PREFERRED_BUFFER_SIZE";
  188. case OPTION_PREFERRED_SAMPLE_RATE:
  189. return "OPTION_PREFERRED_SAMPLE_RATE";
  190. case OPTION_FORCE_STEREO:
  191. return "OPTION_FORCE_STEREO";
  192. case OPTION_USE_DSSI_VST_CHUNKS:
  193. return "OPTION_USE_DSSI_VST_CHUNKS";
  194. case OPTION_PREFER_PLUGIN_BRIDGES:
  195. return "OPTION_PREFER_PLUGIN_BRIDGES";
  196. case OPTION_PREFER_UI_BRIDGES:
  197. return "OPTION_PREFER_UI_BRIDGES";
  198. case OPTION_OSC_UI_TIMEOUT:
  199. return "OPTION_OSC_UI_TIMEOUT";
  200. case OPTION_PATH_BRIDGE_POSIX32:
  201. return "OPTION_PATH_BRIDGE_POSIX32";
  202. case OPTION_PATH_BRIDGE_POSIX64:
  203. return "OPTION_PATH_BRIDGE_POSIX64";
  204. case OPTION_PATH_BRIDGE_WIN32:
  205. return "OPTION_PATH_BRIDGE_WIN32";
  206. case OPTION_PATH_BRIDGE_WIN64:
  207. return "OPTION_PATH_BRIDGE_WIN64";
  208. case OPTION_PATH_BRIDGE_LV2_GTK2:
  209. return "OPTION_PATH_BRIDGE_LV2_GTK2";
  210. case OPTION_PATH_BRIDGE_LV2_GTK3:
  211. return "OPTION_PATH_BRIDGE_LV2_GTK3";
  212. case OPTION_PATH_BRIDGE_LV2_QT4:
  213. return "OPTION_PATH_BRIDGE_LV2_QT4";
  214. case OPTION_PATH_BRIDGE_LV2_QT5:
  215. return "OPTION_PATH_BRIDGE_LV2_QT5";
  216. case OPTION_PATH_BRIDGE_LV2_COCOA:
  217. return "OPTION_PATH_BRIDGE_LV2_COCOA";
  218. case OPTION_PATH_BRIDGE_LV2_WINDOWS:
  219. return "OPTION_PATH_BRIDGE_LV2_WINDOWS";
  220. case OPTION_PATH_BRIDGE_LV2_X11:
  221. return "OPTION_PATH_BRIDGE_LV2_X11";
  222. case OPTION_PATH_BRIDGE_VST_COCOA:
  223. return "OPTION_PATH_BRIDGE_VST_COCOA";
  224. case OPTION_PATH_BRIDGE_VST_HWND:
  225. return "OPTION_PATH_BRIDGE_VST_HWND";
  226. case OPTION_PATH_BRIDGE_VST_X11:
  227. return "OPTION_PATH_BRIDGE_VST_X11";
  228. }
  229. qWarning("CarlaBackend::OptionsType2Str(%i) - invalid type", type);
  230. return nullptr;
  231. }
  232. static inline
  233. const char* CallbackType2Str(const CallbackType& type)
  234. {
  235. switch (type)
  236. {
  237. case CALLBACK_DEBUG:
  238. return "CALLBACK_DEBUG";
  239. case CALLBACK_PARAMETER_VALUE_CHANGED:
  240. return "CALLBACK_PARAMETER_VALUE_CHANGED";
  241. case CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:
  242. return "CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";
  243. case CALLBACK_PARAMETER_MIDI_CC_CHANGED:
  244. return "CALLBACK_PARAMETER_MIDI_CC_CHANGED";
  245. case CALLBACK_PROGRAM_CHANGED:
  246. return "CALLBACK_PROGRAM_CHANGED";
  247. case CALLBACK_MIDI_PROGRAM_CHANGED:
  248. return "CALLBACK_MIDI_PROGRAM_CHANGED";
  249. case CALLBACK_NOTE_ON:
  250. return "CALLBACK_NOTE_ON";
  251. case CALLBACK_NOTE_OFF:
  252. return "CALLBACK_NOTE_OFF";
  253. case CALLBACK_SHOW_GUI:
  254. return "CALLBACK_SHOW_GUI";
  255. case CALLBACK_RESIZE_GUI:
  256. return "CALLBACK_RESIZE_GUI";
  257. case CALLBACK_UPDATE:
  258. return "CALLBACK_UPDATE";
  259. case CALLBACK_RELOAD_INFO:
  260. return "CALLBACK_RELOAD_INFO";
  261. case CALLBACK_RELOAD_PARAMETERS:
  262. return "CALLBACK_RELOAD_PARAMETERS";
  263. case CALLBACK_RELOAD_PROGRAMS:
  264. return "CALLBACK_RELOAD_PROGRAMS";
  265. case CALLBACK_RELOAD_ALL:
  266. return "CALLBACK_RELOAD_ALL";
  267. case CALLBACK_NSM_ANNOUNCE:
  268. return "CALLBACK_NSM_ANNOUNCE";
  269. case CALLBACK_NSM_OPEN1:
  270. return "CALLBACK_NSM_OPEN1";
  271. case CALLBACK_NSM_OPEN2:
  272. return "CALLBACK_NSM_OPEN2";
  273. case CALLBACK_NSM_SAVE:
  274. return "CALLBACK_NSM_SAVE";
  275. case CALLBACK_ERROR:
  276. return "CALLBACK_ERROR";
  277. case CALLBACK_QUIT:
  278. return "CALLBACK_QUIT";
  279. }
  280. qWarning("CarlaBackend::CallbackType2Str(%i) - invalid type", type);
  281. return nullptr;
  282. }
  283. static inline
  284. const char* ProcessMode2Str(const ProcessMode& mode)
  285. {
  286. switch (mode)
  287. {
  288. case PROCESS_MODE_SINGLE_CLIENT:
  289. return "PROCESS_MODE_SINGLE_CLIENT";
  290. case PROCESS_MODE_MULTIPLE_CLIENTS:
  291. return "PROCESS_MODE_MULTIPLE_CLIENTS";
  292. case PROCESS_MODE_CONTINUOUS_RACK:
  293. return "PROCESS_MODE_CONTINUOUS_RACK";
  294. case PROCESS_MODE_PATCHBAY:
  295. return "PROCESS_MODE_PATCHBAY";
  296. }
  297. qWarning("CarlaBackend::ProcessModeType2Str(%i) - invalid type", mode);
  298. return nullptr;
  299. }
  300. // -------------------------------------------------------------------------------------------------------------------
  301. static inline
  302. const char* getPluginTypeString(const PluginType& type)
  303. {
  304. qDebug("CarlaBackend::getPluginTypeString(%s)", PluginType2Str(type));
  305. switch (type)
  306. {
  307. case PLUGIN_NONE:
  308. return "NONE";
  309. case PLUGIN_INTERNAL:
  310. return "INTERNAL";
  311. case PLUGIN_LADSPA:
  312. return "LADSPA";
  313. case PLUGIN_DSSI:
  314. return "DSSI";
  315. case PLUGIN_LV2:
  316. return "LV2";
  317. case PLUGIN_VST:
  318. return "VST";
  319. case PLUGIN_GIG:
  320. return "GIG";
  321. case PLUGIN_SF2:
  322. return "SF2";
  323. case PLUGIN_SFZ:
  324. return "SFZ";
  325. }
  326. return "NONE";
  327. }
  328. // -------------------------------------------------------------------------------------------------------------------
  329. static inline
  330. uintptr_t getAddressFromPointer(void* const ptr)
  331. {
  332. qDebug("CarlaBackend::getAddressFromPointer(%p)", ptr);
  333. CARLA_ASSERT(ptr != nullptr);
  334. uintptr_t* addr = (uintptr_t*)&ptr;
  335. return *addr;
  336. }
  337. static inline
  338. void* getPointerFromAddress(const uintptr_t& addr)
  339. {
  340. CARLA_ASSERT(addr != 0);
  341. uintptr_t** const ptr = (uintptr_t**)&addr;
  342. return *ptr;
  343. }
  344. static inline
  345. PluginCategory getPluginCategoryFromName(const char* const name)
  346. {
  347. qDebug("CarlaBackend::getPluginCategoryFromName(\"%s\")", name);
  348. CARLA_ASSERT(name);
  349. if (! name)
  350. return PLUGIN_CATEGORY_NONE;
  351. CarlaString sname(name);
  352. if (sname.isEmpty())
  353. return PLUGIN_CATEGORY_NONE;
  354. sname.toLower();
  355. // generic tags first
  356. if (sname.contains("delay"))
  357. return PLUGIN_CATEGORY_DELAY;
  358. if (sname.contains("reverb"))
  359. return PLUGIN_CATEGORY_DELAY;
  360. // filter
  361. if (sname.contains("filter"))
  362. return PLUGIN_CATEGORY_FILTER;
  363. // dynamics
  364. if (sname.contains("dynamics"))
  365. return PLUGIN_CATEGORY_DYNAMICS;
  366. if (sname.contains("amplifier"))
  367. return PLUGIN_CATEGORY_DYNAMICS;
  368. if (sname.contains("compressor"))
  369. return PLUGIN_CATEGORY_DYNAMICS;
  370. if (sname.contains("enhancer"))
  371. return PLUGIN_CATEGORY_DYNAMICS;
  372. if (sname.contains("exciter"))
  373. return PLUGIN_CATEGORY_DYNAMICS;
  374. if (sname.contains("gate"))
  375. return PLUGIN_CATEGORY_DYNAMICS;
  376. if (sname.contains("limiter"))
  377. return PLUGIN_CATEGORY_DYNAMICS;
  378. // modulator
  379. if (sname.contains("modulator"))
  380. return PLUGIN_CATEGORY_MODULATOR;
  381. if (sname.contains("chorus"))
  382. return PLUGIN_CATEGORY_MODULATOR;
  383. if (sname.contains("flanger"))
  384. return PLUGIN_CATEGORY_MODULATOR;
  385. if (sname.contains("phaser"))
  386. return PLUGIN_CATEGORY_MODULATOR;
  387. if (sname.contains("saturator"))
  388. return PLUGIN_CATEGORY_MODULATOR;
  389. // utility
  390. if (sname.contains("utility"))
  391. return PLUGIN_CATEGORY_UTILITY;
  392. if (sname.contains("analyzer"))
  393. return PLUGIN_CATEGORY_UTILITY;
  394. if (sname.contains("converter"))
  395. return PLUGIN_CATEGORY_UTILITY;
  396. if (sname.contains("deesser"))
  397. return PLUGIN_CATEGORY_UTILITY;
  398. if (sname.contains("mixer"))
  399. return PLUGIN_CATEGORY_UTILITY;
  400. // common tags
  401. if (sname.contains("verb"))
  402. return PLUGIN_CATEGORY_DELAY;
  403. if (sname.contains("eq"))
  404. return PLUGIN_CATEGORY_EQ;
  405. if (sname.contains("tool"))
  406. return PLUGIN_CATEGORY_UTILITY;
  407. return PLUGIN_CATEGORY_NONE;
  408. }
  409. /**@}*/
  410. CARLA_BACKEND_END_NAMESPACE
  411. #endif // CARLA_BACKEND_UTILS_HPP