Audio plugin host https://kx.studio/carla
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.

538 lines
16KB

  1. /*
  2. * Carla Backend utils
  3. * Copyright (C) 2011-2013 Filipe Coelho <falktx@falktx.com>
  4. *
  5. * This program is free software; you can redistribute it and/or
  6. * modify it under the terms of the GNU General Public License as
  7. * published by the Free Software Foundation; either version 2 of
  8. * the License, or 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 GPL.txt file
  16. */
  17. #ifndef __CARLA_BACKEND_UTILS_HPP__
  18. #define __CARLA_BACKEND_UTILS_HPP__
  19. #include "CarlaBackend.hpp"
  20. #include "CarlaString.hpp"
  21. CARLA_BACKEND_START_NAMESPACE
  22. // -------------------------------------------------
  23. static inline
  24. const char* PluginOption2Str(const unsigned int& option)
  25. {
  26. switch (option)
  27. {
  28. case PLUGIN_OPTION_FIXED_BUFFER:
  29. return "PLUGIN_OPTION_FIXED_BUFFER";
  30. case PLUGIN_OPTION_FORCE_STEREO:
  31. return "PLUGIN_OPTION_FORCE_STEREO";
  32. case PLUGIN_OPTION_MAP_PROGRAM_CHANGES:
  33. return "PLUGIN_OPTION_MAP_PROGRAM_CHANGES";
  34. case PLUGIN_OPTION_USE_CHUNKS:
  35. return "PLUGIN_OPTION_USE_CHUNKS";
  36. case PLUGIN_OPTION_SEND_CONTROL_CHANGES:
  37. return "PLUGIN_OPTION_SEND_CONTROL_CHANGES";
  38. case PLUGIN_OPTION_SEND_CHANNEL_PRESSURE:
  39. return "PLUGIN_OPTION_SEND_CHANNEL_PRESSURE";
  40. case PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH:
  41. return "PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH";
  42. case PLUGIN_OPTION_SEND_PITCHBEND:
  43. return "PLUGIN_OPTION_SEND_PITCHBEND";
  44. case PLUGIN_OPTION_SEND_ALL_SOUND_OFF:
  45. return "PLUGIN_OPTION_SEND_ALL_SOUND_OFF";
  46. }
  47. carla_stderr("CarlaBackend::PluginOption2Str(%i) - invalid type", option);
  48. return nullptr;
  49. }
  50. // -------------------------------------------------
  51. static inline
  52. const char* BinaryType2Str(const BinaryType& type)
  53. {
  54. switch (type)
  55. {
  56. case BINARY_NONE:
  57. return "BINARY_NONE";
  58. case BINARY_POSIX32:
  59. return "BINARY_POSIX32";
  60. case BINARY_POSIX64:
  61. return "BINARY_POSIX64";
  62. case BINARY_WIN32:
  63. return "BINARY_WIN32";
  64. case BINARY_WIN64:
  65. return "BINARY_WIN64";
  66. case BINARY_OTHER:
  67. return "BINARY_OTHER";
  68. }
  69. carla_stderr("CarlaBackend::BinaryType2Str(%i) - invalid type", type);
  70. return nullptr;
  71. }
  72. static inline
  73. const char* PluginType2Str(const PluginType& type)
  74. {
  75. switch (type)
  76. {
  77. case PLUGIN_NONE:
  78. return "PLUGIN_NONE";
  79. case PLUGIN_INTERNAL:
  80. return "PLUGIN_INTERNAL";
  81. case PLUGIN_LADSPA:
  82. return "PLUGIN_LADSPA";
  83. case PLUGIN_DSSI:
  84. return "PLUGIN_DSSI";
  85. case PLUGIN_LV2:
  86. return "PLUGIN_LV2";
  87. case PLUGIN_VST:
  88. return "PLUGIN_VST";
  89. case PLUGIN_VST3:
  90. return "PLUGIN_VST3";
  91. case PLUGIN_GIG:
  92. return "PLUGIN_GIG";
  93. case PLUGIN_SF2:
  94. return "PLUGIN_SF2";
  95. case PLUGIN_SFZ:
  96. return "PLUGIN_SFZ";
  97. }
  98. carla_stderr("CarlaBackend::PluginType2Str(%i) - invalid type", type);
  99. return nullptr;
  100. }
  101. static inline
  102. const char* PluginCategory2Str(const PluginCategory& category)
  103. {
  104. switch (category)
  105. {
  106. case PLUGIN_CATEGORY_NONE:
  107. return "PLUGIN_CATEGORY_NONE";
  108. case PLUGIN_CATEGORY_SYNTH:
  109. return "PLUGIN_CATEGORY_SYNTH";
  110. case PLUGIN_CATEGORY_DELAY:
  111. return "PLUGIN_CATEGORY_DELAY";
  112. case PLUGIN_CATEGORY_EQ:
  113. return "PLUGIN_CATEGORY_EQ";
  114. case PLUGIN_CATEGORY_FILTER:
  115. return "PLUGIN_CATEGORY_FILTER";
  116. case PLUGIN_CATEGORY_DYNAMICS:
  117. return "PLUGIN_CATEGORY_DYNAMICS";
  118. case PLUGIN_CATEGORY_MODULATOR:
  119. return "PLUGIN_CATEGORY_MODULATOR";
  120. case PLUGIN_CATEGORY_UTILITY:
  121. return "PLUGIN_CATEGORY_UTILITY";
  122. case PLUGIN_CATEGORY_OTHER:
  123. return "PLUGIN_CATEGORY_OTHER";
  124. }
  125. carla_stderr("CarlaBackend::PluginCategory2Str(%i) - invalid category", category);
  126. return nullptr;
  127. }
  128. static inline
  129. const char* ParameterType2Str(const ParameterType& type)
  130. {
  131. switch (type)
  132. {
  133. case PARAMETER_UNKNOWN:
  134. return "PARAMETER_UNKNOWN";
  135. case PARAMETER_INPUT:
  136. return "PARAMETER_INPUT";
  137. case PARAMETER_OUTPUT:
  138. return "PARAMETER_OUTPUT";
  139. case PARAMETER_LATENCY:
  140. return "PARAMETER_LATENCY";
  141. case PARAMETER_SAMPLE_RATE:
  142. return "PARAMETER_SAMPLE_RATE";
  143. #ifdef WANT_LV2
  144. case PARAMETER_LV2_FREEWHEEL:
  145. return "PARAMETER_LV2_FREEWHEEL";
  146. case PARAMETER_LV2_TIME:
  147. return "PARAMETER_LV2_TIME";
  148. #endif
  149. }
  150. carla_stderr("CarlaBackend::ParameterType2Str(%i) - invalid type", type);
  151. return nullptr;
  152. }
  153. static inline
  154. const char* InternalParametersIndex2Str(const InternalParametersIndex& index)
  155. {
  156. switch (index)
  157. {
  158. case PARAMETER_NULL:
  159. return "PARAMETER_NULL";
  160. case PARAMETER_ACTIVE:
  161. return "PARAMETER_ACTIVE";
  162. case PARAMETER_DRYWET:
  163. return "PARAMETER_DRYWET";
  164. case PARAMETER_VOLUME:
  165. return "PARAMETER_VOLUME";
  166. case PARAMETER_BALANCE_LEFT:
  167. return "PARAMETER_BALANCE_LEFT";
  168. case PARAMETER_BALANCE_RIGHT:
  169. return "PARAMETER_BALANCE_RIGHT";
  170. case PARAMETER_PANNING:
  171. return "PARAMETER_PANNING";
  172. case PARAMETER_CTRL_CHANNEL:
  173. return "PARAMETER_CTRL_CHANNEL";
  174. case PARAMETER_MAX:
  175. return "PARAMETER_MAX";
  176. }
  177. carla_stderr("CarlaBackend::InternalParametersIndex2Str(%i) - invalid index", index);
  178. return nullptr;
  179. }
  180. static inline
  181. const char* OptionsType2Str(const OptionsType& type)
  182. {
  183. switch (type)
  184. {
  185. case OPTION_PROCESS_NAME:
  186. return "OPTION_PROCESS_NAME";
  187. case OPTION_PROCESS_MODE:
  188. return "OPTION_PROCESS_MODE";
  189. case OPTION_TRANSPORT_MODE:
  190. return "OPTION_TRANSPORT_MODE";
  191. case OPTION_FORCE_STEREO:
  192. return "OPTION_FORCE_STEREO";
  193. case OPTION_PREFER_PLUGIN_BRIDGES:
  194. return "OPTION_PREFER_PLUGIN_BRIDGES";
  195. case OPTION_PREFER_UI_BRIDGES:
  196. return "OPTION_PREFER_UI_BRIDGES";
  197. #ifdef WANT_DSSI
  198. case OPTION_USE_DSSI_VST_CHUNKS:
  199. return "OPTION_USE_DSSI_VST_CHUNKS";
  200. #endif
  201. case OPTION_MAX_PARAMETERS:
  202. return "OPTION_MAX_PARAMETERS";
  203. case OPTION_OSC_UI_TIMEOUT:
  204. return "OPTION_OSC_UI_TIMEOUT";
  205. case OPTION_PREFERRED_BUFFER_SIZE:
  206. return "OPTION_PREFERRED_BUFFER_SIZE";
  207. case OPTION_PREFERRED_SAMPLE_RATE:
  208. return "OPTION_PREFERRED_SAMPLE_RATE";
  209. #ifndef BUILD_BRIDGE
  210. case OPTION_PATH_BRIDGE_NATIVE:
  211. return "OPTION_PATH_BRIDGE_NATIVE";
  212. case OPTION_PATH_BRIDGE_POSIX32:
  213. return "OPTION_PATH_BRIDGE_POSIX32";
  214. case OPTION_PATH_BRIDGE_POSIX64:
  215. return "OPTION_PATH_BRIDGE_POSIX64";
  216. case OPTION_PATH_BRIDGE_WIN32:
  217. return "OPTION_PATH_BRIDGE_WIN32";
  218. case OPTION_PATH_BRIDGE_WIN64:
  219. return "OPTION_PATH_BRIDGE_WIN64";
  220. #endif
  221. #ifdef WANT_LV2
  222. case OPTION_PATH_BRIDGE_LV2_GTK2:
  223. return "OPTION_PATH_BRIDGE_LV2_GTK2";
  224. case OPTION_PATH_BRIDGE_LV2_GTK3:
  225. return "OPTION_PATH_BRIDGE_LV2_GTK3";
  226. case OPTION_PATH_BRIDGE_LV2_QT4:
  227. return "OPTION_PATH_BRIDGE_LV2_QT4";
  228. case OPTION_PATH_BRIDGE_LV2_QT5:
  229. return "OPTION_PATH_BRIDGE_LV2_QT5";
  230. case OPTION_PATH_BRIDGE_LV2_COCOA:
  231. return "OPTION_PATH_BRIDGE_LV2_COCOA";
  232. case OPTION_PATH_BRIDGE_LV2_WINDOWS:
  233. return "OPTION_PATH_BRIDGE_LV2_WINDOWS";
  234. case OPTION_PATH_BRIDGE_LV2_X11:
  235. return "OPTION_PATH_BRIDGE_LV2_X11";
  236. #endif
  237. #ifdef WANT_VST
  238. case OPTION_PATH_BRIDGE_VST_COCOA:
  239. return "OPTION_PATH_BRIDGE_VST_COCOA";
  240. case OPTION_PATH_BRIDGE_VST_HWND:
  241. return "OPTION_PATH_BRIDGE_VST_HWND";
  242. case OPTION_PATH_BRIDGE_VST_X11:
  243. return "OPTION_PATH_BRIDGE_VST_X11";
  244. #endif
  245. }
  246. carla_stderr("CarlaBackend::OptionsType2Str(%i) - invalid type", type);
  247. return nullptr;
  248. }
  249. static inline
  250. const char* CallbackType2Str(const CallbackType& type)
  251. {
  252. switch (type)
  253. {
  254. case CALLBACK_DEBUG:
  255. return "CALLBACK_DEBUG";
  256. case CALLBACK_PLUGIN_ADDED:
  257. return "CALLBACK_PLUGIN_ADDED";
  258. case CALLBACK_PLUGIN_REMOVED:
  259. return "CALLBACK_PLUGIN_REMOVED";
  260. case CALLBACK_PLUGIN_RENAMED:
  261. return "CALLBACK_PLUGIN_RENAMED";
  262. case CALLBACK_PARAMETER_VALUE_CHANGED:
  263. return "CALLBACK_PARAMETER_VALUE_CHANGED";
  264. case CALLBACK_PARAMETER_DEFAULT_CHANGED:
  265. return "CALLBACK_PARAMETER_DEFAULT_CHANGED";
  266. case CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:
  267. return "CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";
  268. case CALLBACK_PARAMETER_MIDI_CC_CHANGED:
  269. return "CALLBACK_PARAMETER_MIDI_CC_CHANGED";
  270. case CALLBACK_PROGRAM_CHANGED:
  271. return "CALLBACK_PROGRAM_CHANGED";
  272. case CALLBACK_MIDI_PROGRAM_CHANGED:
  273. return "CALLBACK_MIDI_PROGRAM_CHANGED";
  274. case CALLBACK_NOTE_ON:
  275. return "CALLBACK_NOTE_ON";
  276. case CALLBACK_NOTE_OFF:
  277. return "CALLBACK_NOTE_OFF";
  278. case CALLBACK_SHOW_GUI:
  279. return "CALLBACK_SHOW_GUI";
  280. case CALLBACK_UPDATE:
  281. return "CALLBACK_UPDATE";
  282. case CALLBACK_PATCHBAY_CLIENT_ADDED:
  283. return "CALLBACK_PATCHBAY_CLIENT_ADDED";
  284. case CALLBACK_PATCHBAY_CLIENT_REMOVED:
  285. return "CALLBACK_PATCHBAY_CLIENT_REMOVED";
  286. case CALLBACK_PATCHBAY_CLIENT_RENAMED:
  287. return "CALLBACK_PATCHBAY_CLIENT_RENAMED";
  288. case CALLBACK_PATCHBAY_PORT_ADDED:
  289. return "CALLBACK_PATCHBAY_PORT_ADDED";
  290. case CALLBACK_PATCHBAY_PORT_REMOVED:
  291. return "CALLBACK_PATCHBAY_PORT_REMOVED";
  292. case CALLBACK_PATCHBAY_PORT_RENAMED:
  293. return "CALLBACK_PATCHBAY_PORT_RENAMED";
  294. case CALLBACK_PATCHBAY_CONNECTION_ADDED:
  295. return "CALLBACK_PATCHBAY_CONNECTION_ADDED";
  296. case CALLBACK_PATCHBAY_CONNECTION_REMOVED:
  297. return "CALLBACK_PATCHBAY_CONNECTION_REMOVED";
  298. case CALLBACK_RELOAD_INFO:
  299. return "CALLBACK_RELOAD_INFO";
  300. case CALLBACK_RELOAD_PARAMETERS:
  301. return "CALLBACK_RELOAD_PARAMETERS";
  302. case CALLBACK_RELOAD_PROGRAMS:
  303. return "CALLBACK_RELOAD_PROGRAMS";
  304. case CALLBACK_RELOAD_ALL:
  305. return "CALLBACK_RELOAD_ALL";
  306. case CALLBACK_NSM_ANNOUNCE:
  307. return "CALLBACK_NSM_ANNOUNCE";
  308. case CALLBACK_NSM_OPEN1:
  309. return "CALLBACK_NSM_OPEN1";
  310. case CALLBACK_NSM_OPEN2:
  311. return "CALLBACK_NSM_OPEN2";
  312. case CALLBACK_NSM_SAVE:
  313. return "CALLBACK_NSM_SAVE";
  314. case CALLBACK_ERROR:
  315. return "CALLBACK_ERROR";
  316. case CALLBACK_QUIT:
  317. return "CALLBACK_QUIT";
  318. }
  319. carla_stderr("CarlaBackend::CallbackType2Str(%i) - invalid type", type);
  320. return nullptr;
  321. }
  322. static inline
  323. const char* ProcessMode2Str(const ProcessMode& mode)
  324. {
  325. switch (mode)
  326. {
  327. case PROCESS_MODE_SINGLE_CLIENT:
  328. return "PROCESS_MODE_SINGLE_CLIENT";
  329. case PROCESS_MODE_MULTIPLE_CLIENTS:
  330. return "PROCESS_MODE_MULTIPLE_CLIENTS";
  331. case PROCESS_MODE_CONTINUOUS_RACK:
  332. return "PROCESS_MODE_CONTINUOUS_RACK";
  333. case PROCESS_MODE_PATCHBAY:
  334. return "PROCESS_MODE_PATCHBAY";
  335. case PROCESS_MODE_BRIDGE:
  336. return "PROCESS_MODE_BRIDGE";
  337. }
  338. carla_stderr("CarlaBackend::ProcessModeType2Str(%i) - invalid type", mode);
  339. return nullptr;
  340. }
  341. // -------------------------------------------------
  342. static inline
  343. uintptr_t getAddressFromPointer(void* ptr)
  344. {
  345. CARLA_ASSERT(ptr != nullptr);
  346. uintptr_t* addr = (uintptr_t*)&ptr;
  347. return *addr;
  348. }
  349. static inline
  350. void* getPointerFromAddress(uintptr_t& addr)
  351. {
  352. CARLA_ASSERT(addr != 0);
  353. uintptr_t** const ptr = (uintptr_t**)&addr;
  354. return *ptr;
  355. }
  356. // -------------------------------------------------
  357. static inline
  358. const char* getPluginTypeAsString(const PluginType& type)
  359. {
  360. carla_debug("CarlaBackend::getPluginTypeAsString(%s)", PluginType2Str(type));
  361. switch (type)
  362. {
  363. case PLUGIN_NONE:
  364. return "NONE";
  365. case PLUGIN_INTERNAL:
  366. return "INTERNAL";
  367. case PLUGIN_LADSPA:
  368. return "LADSPA";
  369. case PLUGIN_DSSI:
  370. return "DSSI";
  371. case PLUGIN_LV2:
  372. return "LV2";
  373. case PLUGIN_VST:
  374. return "VST";
  375. case PLUGIN_VST3:
  376. return "VST3";
  377. case PLUGIN_GIG:
  378. return "GIG";
  379. case PLUGIN_SF2:
  380. return "SF2";
  381. case PLUGIN_SFZ:
  382. return "SFZ";
  383. }
  384. carla_stderr("CarlaBackend::getPluginTypeAsString(%i) - invalid type", type);
  385. return "NONE";
  386. }
  387. static inline
  388. PluginType getPluginTypeFromString(const char* const stype)
  389. {
  390. carla_debug("CarlaBackend::getPluginTypeFromString(%s)", stype);
  391. if (stype == nullptr)
  392. {
  393. carla_stderr("CarlaBackend::getPluginTypeFromString() - null string type");
  394. return PLUGIN_NONE;
  395. }
  396. if (std::strcmp(stype, "NONE") == 0)
  397. return PLUGIN_NONE;
  398. if (std::strcmp(stype, "INTERNAL") == 0 || std::strcmp(stype, "Internal") == 0)
  399. return PLUGIN_INTERNAL;
  400. if (std::strcmp(stype, "LADSPA") == 0)
  401. return PLUGIN_LADSPA;
  402. if (std::strcmp(stype, "DSSI") == 0)
  403. return PLUGIN_DSSI;
  404. if (std::strcmp(stype, "LV2") == 0)
  405. return PLUGIN_LV2;
  406. if (std::strcmp(stype, "VST") == 0)
  407. return PLUGIN_VST;
  408. if (std::strcmp(stype, "GIG") == 0)
  409. return PLUGIN_GIG;
  410. if (std::strcmp(stype, "SF2") == 0)
  411. return PLUGIN_SF2;
  412. if (std::strcmp(stype, "SFZ") == 0)
  413. return PLUGIN_SFZ;
  414. carla_stderr("CarlaBackend::getPluginTypeFromString(%s) - invalid string type", stype);
  415. return PLUGIN_NONE;
  416. }
  417. // -------------------------------------------------
  418. static inline
  419. PluginCategory getPluginCategoryFromName(const char* const name)
  420. {
  421. carla_debug("CarlaBackend::getPluginCategoryFromName(\"%s\")", name);
  422. CARLA_ASSERT(name);
  423. if (! name)
  424. return PLUGIN_CATEGORY_NONE;
  425. CarlaString sname(name);
  426. if (sname.isEmpty())
  427. return PLUGIN_CATEGORY_NONE;
  428. sname.toLower();
  429. // generic tags first
  430. if (sname.contains("delay"))
  431. return PLUGIN_CATEGORY_DELAY;
  432. if (sname.contains("reverb"))
  433. return PLUGIN_CATEGORY_DELAY;
  434. // filter
  435. if (sname.contains("filter"))
  436. return PLUGIN_CATEGORY_FILTER;
  437. // dynamics
  438. if (sname.contains("dynamics"))
  439. return PLUGIN_CATEGORY_DYNAMICS;
  440. if (sname.contains("amplifier"))
  441. return PLUGIN_CATEGORY_DYNAMICS;
  442. if (sname.contains("compressor"))
  443. return PLUGIN_CATEGORY_DYNAMICS;
  444. if (sname.contains("enhancer"))
  445. return PLUGIN_CATEGORY_DYNAMICS;
  446. if (sname.contains("exciter"))
  447. return PLUGIN_CATEGORY_DYNAMICS;
  448. if (sname.contains("gate"))
  449. return PLUGIN_CATEGORY_DYNAMICS;
  450. if (sname.contains("limiter"))
  451. return PLUGIN_CATEGORY_DYNAMICS;
  452. // modulator
  453. if (sname.contains("modulator"))
  454. return PLUGIN_CATEGORY_MODULATOR;
  455. if (sname.contains("chorus"))
  456. return PLUGIN_CATEGORY_MODULATOR;
  457. if (sname.contains("flanger"))
  458. return PLUGIN_CATEGORY_MODULATOR;
  459. if (sname.contains("phaser"))
  460. return PLUGIN_CATEGORY_MODULATOR;
  461. if (sname.contains("saturator"))
  462. return PLUGIN_CATEGORY_MODULATOR;
  463. // utility
  464. if (sname.contains("utility"))
  465. return PLUGIN_CATEGORY_UTILITY;
  466. if (sname.contains("analyzer"))
  467. return PLUGIN_CATEGORY_UTILITY;
  468. if (sname.contains("converter"))
  469. return PLUGIN_CATEGORY_UTILITY;
  470. if (sname.contains("deesser"))
  471. return PLUGIN_CATEGORY_UTILITY;
  472. if (sname.contains("mixer"))
  473. return PLUGIN_CATEGORY_UTILITY;
  474. // common tags
  475. if (sname.contains("verb"))
  476. return PLUGIN_CATEGORY_DELAY;
  477. if (sname.contains("eq"))
  478. return PLUGIN_CATEGORY_EQ;
  479. if (sname.contains("tool"))
  480. return PLUGIN_CATEGORY_UTILITY;
  481. return PLUGIN_CATEGORY_NONE;
  482. }
  483. CARLA_BACKEND_END_NAMESPACE
  484. #endif // __CARLA_BACKEND_UTILS_HPP__