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.

2541 lines
90KB

  1. /*
  2. * Carla Standalone
  3. * Copyright (C) 2011-2014 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 doc/GPL.txt file.
  16. */
  17. // TODO:
  18. // Check carla_stderr2("Engine is not running"); <= prepend func name and args
  19. #include "CarlaHost.h"
  20. #include "CarlaMIDI.h"
  21. #include "CarlaEngine.hpp"
  22. #include "CarlaPlugin.hpp"
  23. #include "CarlaBackendUtils.hpp"
  24. #include "CarlaBase64Utils.hpp"
  25. #ifdef HAVE_LIBLO
  26. # include "CarlaOscUtils.hpp"
  27. #endif
  28. #include "juce_audio_formats.h"
  29. #if defined(CARLA_OS_MAC) || defined(CARLA_OS_WIN)
  30. # include "juce_gui_basics.h"
  31. #else
  32. namespace juce {
  33. # include "juce_events/messages/juce_Initialisation.h"
  34. } // namespace juce
  35. #endif
  36. namespace CB = CarlaBackend;
  37. using CB::EngineOptions;
  38. // -------------------------------------------------------------------------------------------------------------------
  39. // Single, standalone engine
  40. struct CarlaBackendStandalone {
  41. CarlaEngine* engine;
  42. EngineCallbackFunc engineCallback;
  43. void* engineCallbackPtr;
  44. #ifndef BUILD_BRIDGE
  45. EngineOptions engineOptions;
  46. #endif
  47. FileCallbackFunc fileCallback;
  48. void* fileCallbackPtr;
  49. CarlaString lastError;
  50. CarlaBackendStandalone() noexcept
  51. : engine(nullptr),
  52. engineCallback(nullptr),
  53. engineCallbackPtr(nullptr),
  54. #ifndef BUILD_BRIDGE
  55. engineOptions(),
  56. #endif
  57. fileCallback(nullptr),
  58. fileCallbackPtr(nullptr),
  59. lastError() {}
  60. ~CarlaBackendStandalone() noexcept
  61. {
  62. CARLA_SAFE_ASSERT(engine == nullptr);
  63. }
  64. CARLA_PREVENT_HEAP_ALLOCATION
  65. CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)
  66. };
  67. static CarlaBackendStandalone gStandalone;
  68. #ifdef HAVE_LIBLO
  69. // -------------------------------------------------------------------------------------------------------------------
  70. // NSM support
  71. #define NSM_API_VERSION_MAJOR 1
  72. #define NSM_API_VERSION_MINOR 2
  73. #define NSM_CLIENT_FEATURES ":switch:"
  74. //#define NSM_CLIENT_FEATURES ":switch:optional-gui:"
  75. class CarlaNSM
  76. {
  77. public:
  78. CarlaNSM() noexcept
  79. : fOscAddress(nullptr),
  80. fOscServer(nullptr),
  81. fOscServerThread(nullptr),
  82. fClientNameId(),
  83. fProjectPath(),
  84. fHasBroadcast(false),
  85. fHasOptionalGui(false),
  86. fHasServerControl(false),
  87. fStarted() {}
  88. ~CarlaNSM()
  89. {
  90. if (fOscServerThread != nullptr)
  91. {
  92. lo_server_thread_stop(fOscServerThread);
  93. lo_server_thread_free(fOscServerThread);
  94. fOscServerThread = nullptr;
  95. fOscServer = nullptr;
  96. }
  97. if (fOscAddress != nullptr)
  98. {
  99. lo_address_free(fOscAddress);
  100. fOscAddress = nullptr;
  101. }
  102. }
  103. bool announce(const int pid, const char* const executableName)
  104. {
  105. CARLA_SAFE_ASSERT_RETURN(pid != 0, false);
  106. CARLA_SAFE_ASSERT_RETURN(executableName != nullptr && executableName[0] != '\0', false);
  107. const char* const NSM_URL(std::getenv("NSM_URL"));
  108. if (NSM_URL == nullptr)
  109. return false;
  110. const lo_address addr = lo_address_new_from_url(NSM_URL);
  111. CARLA_SAFE_ASSERT_RETURN(addr != nullptr, false);
  112. const int proto = lo_address_get_protocol(addr);
  113. if (fOscServerThread == nullptr)
  114. {
  115. // create new OSC server
  116. fOscServerThread = lo_server_thread_new_with_proto(nullptr, proto, _osc_error_handler);
  117. CARLA_SAFE_ASSERT_RETURN(fOscServerThread != nullptr, false);
  118. // register message handlers
  119. lo_server_thread_add_method(fOscServerThread, "/error", "sis", _error_handler, this);
  120. lo_server_thread_add_method(fOscServerThread, "/reply", "ssss", _reply_handler, this);
  121. lo_server_thread_add_method(fOscServerThread, "/nsm/client/open", "sss", _open_handler, this);
  122. lo_server_thread_add_method(fOscServerThread, "/nsm/client/save", "", _save_handler, this);
  123. lo_server_thread_add_method(fOscServerThread, "/nsm/client/session_is_loaded", "", _loaded_handler, this);
  124. lo_server_thread_add_method(fOscServerThread, "/nsm/client/show_optional_gui", "", _show_gui_handler, this);
  125. lo_server_thread_add_method(fOscServerThread, "/nsm/client/hide_optional_gui", "", _hide_gui_handler, this);
  126. lo_server_thread_add_method(fOscServerThread, nullptr, nullptr, _broadcast_handler, this);
  127. fOscServer = lo_server_thread_get_server(fOscServerThread);
  128. }
  129. #ifndef BUILD_ANSI_TEST
  130. lo_send_from(addr, fOscServer, LO_TT_IMMEDIATE, "/nsm/server/announce", "sssiii",
  131. "Carla", NSM_CLIENT_FEATURES, executableName, NSM_API_VERSION_MAJOR, NSM_API_VERSION_MINOR, pid);
  132. #endif
  133. lo_address_free(addr);
  134. return true;
  135. }
  136. void start()
  137. {
  138. CARLA_SAFE_ASSERT_RETURN(fOscServerThread != nullptr,);
  139. CARLA_SAFE_ASSERT_RETURN(! fStarted,);
  140. fStarted = true;
  141. lo_server_thread_start(fOscServerThread);
  142. }
  143. static CarlaNSM& getInstance()
  144. {
  145. static CarlaNSM sInstance;
  146. return sInstance;
  147. }
  148. protected:
  149. int handleError(const char* const method, const int code, const char* const message)
  150. {
  151. carla_stdout("CarlaNSM::handleError(\"%s\", %i, \"%s\")", method, code, message);
  152. if (gStandalone.engineCallback != nullptr)
  153. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 0, code, 0.0f, message);
  154. return 1;
  155. // may be unused
  156. (void)method;
  157. }
  158. int handleReply(const char* const method, const char* const message, const char* const smName, const char* const features,
  159. const lo_message msg)
  160. {
  161. CARLA_SAFE_ASSERT_RETURN(fOscServerThread != nullptr, 1);
  162. carla_stdout("CarlaNSM::handleReply(\"%s\", \"%s\", \"%s\", \"%s\")", method, message, smName, features);
  163. if (std::strcmp(method, "/nsm/server/announce") == 0)
  164. {
  165. char* const addressURL(lo_address_get_url(lo_message_get_source(msg)));
  166. CARLA_SAFE_ASSERT_RETURN(addressURL != nullptr, 0);
  167. if (fOscAddress != nullptr)
  168. lo_address_free(fOscAddress);
  169. fOscAddress = lo_address_new_from_url(addressURL);
  170. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 0);
  171. fHasBroadcast = std::strstr(features, ":broadcast:") != nullptr;
  172. fHasOptionalGui = std::strstr(features, ":optional-gui:") != nullptr;
  173. fHasServerControl = std::strstr(features, ":server_control:") != nullptr;
  174. // UI starts visible
  175. if (fHasOptionalGui)
  176. lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/nsm/client/gui_is_shown", "");
  177. carla_stdout("Carla started via '%s', message: %s", smName, message);
  178. if (gStandalone.engineCallback != nullptr)
  179. {
  180. int flags = 0;
  181. if (fHasBroadcast)
  182. flags |= 1 << 0;
  183. if (fHasOptionalGui)
  184. flags |= 1 << 1;
  185. if (fHasServerControl)
  186. flags |= 1 << 2;
  187. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 1, flags, 0.0f, smName);
  188. }
  189. }
  190. else
  191. {
  192. carla_stdout("Got unknown NSM reply method '%s'", method);
  193. }
  194. return 0;
  195. }
  196. int handleOpen(const char* const projectPath, const char* const displayName, const char* const clientNameId)
  197. {
  198. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);
  199. CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);
  200. carla_stdout("CarlaNSM::handleOpen(\"%s\", \"%s\", \"%s\")", projectPath, displayName, clientNameId);
  201. if (carla_is_engine_running())
  202. carla_engine_close();
  203. carla_engine_init("JACK", clientNameId);
  204. fProjectPath = projectPath;
  205. fProjectPath += ".carxp";
  206. fClientNameId = clientNameId;
  207. using namespace juce;
  208. const String jfilename = String(CharPointer_UTF8(fProjectPath));
  209. if (File(jfilename).existsAsFile())
  210. carla_load_project(fProjectPath);
  211. lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/reply", "ss", "/nsm/client/open", "OK");
  212. if (gStandalone.engineCallback != nullptr)
  213. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 2, 0, 0.0f, projectPath);
  214. // Broadcast ourselves
  215. if (fHasBroadcast)
  216. {
  217. char* const oscServerAddress(lo_server_get_url(fOscServer));
  218. if (lo_message msg = lo_message_new())
  219. {
  220. lo_message_add(msg, "sssss",
  221. "/non/hello",
  222. oscServerAddress,
  223. "Carla",
  224. CARLA_VERSION_STRING,
  225. fClientNameId.buffer());
  226. lo_send_message_from(fOscAddress, fOscServer, "/nsm/server/broadcast", msg);
  227. lo_message_free(msg);
  228. }
  229. std::free(oscServerAddress);
  230. }
  231. return 0;
  232. }
  233. int handleSave()
  234. {
  235. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);
  236. CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);
  237. CARLA_SAFE_ASSERT_RETURN(fProjectPath.isNotEmpty(), 0);
  238. carla_stdout("CarlaNSM::handleSave()");
  239. carla_save_project(fProjectPath);
  240. lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/reply", "ss", "/nsm/client/save", "OK");
  241. if (gStandalone.engineCallback != nullptr)
  242. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 3, 0, 0.0f, nullptr);
  243. return 0;
  244. }
  245. int handleSessionIsLoaded()
  246. {
  247. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);
  248. CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);
  249. carla_stdout("CarlaNSM::handleSessionIsLoaded()");
  250. if (gStandalone.engineCallback != nullptr)
  251. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 4, 0, 0.0f, nullptr);
  252. return 0;
  253. }
  254. int handleShowOptionalGui()
  255. {
  256. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);
  257. CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);
  258. carla_stdout("CarlaNSM::handleShowOptionalGui()");
  259. lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/nsm/client/gui_is_shown", "");
  260. if (gStandalone.engineCallback != nullptr)
  261. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 5, 0, 0.0f, nullptr);
  262. return 0;
  263. }
  264. int handleHideOptionalGui()
  265. {
  266. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);
  267. CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);
  268. carla_stdout("CarlaNSM::handleHideOptionalGui()");
  269. lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/nsm/client/gui_is_hidden", "");
  270. if (gStandalone.engineCallback != nullptr)
  271. gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 6, 0, 0.0f, nullptr);
  272. return 0;
  273. }
  274. int handleBroadcast(const char* const path, const char* const types, lo_arg** const argv, const int argc,
  275. const lo_message msg)
  276. {
  277. CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);
  278. CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);
  279. CARLA_SAFE_ASSERT_RETURN(argc >= 0, 0);
  280. carla_stdout("CarlaNSM::handleBroadcast(%s, %s, %p, %i)", path, types, argv, argc);
  281. if (std::strcmp(path, "/non/hello") == 0)
  282. {
  283. CARLA_SAFE_ASSERT_RETURN(argc == 4, 0);
  284. CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "ssss") == 0, 0);
  285. const char* const url = &argv[0]->s;
  286. //const char* const name = &argv[1]->s;
  287. //const char* const version = &argv[2]->s;
  288. //const char* const clientId = &argv[3]->s;
  289. const lo_address targetAddress(lo_address_new_from_url(url));
  290. CARLA_SAFE_ASSERT_RETURN(targetAddress != nullptr, 0);
  291. char* const oscServerAddress(lo_server_get_url(fOscServer));
  292. CARLA_SAFE_ASSERT_RETURN(oscServerAddress != nullptr, 0);
  293. if (lo_message msg2 = lo_message_new())
  294. {
  295. lo_message_add(msg2, "ss",
  296. fClientNameId.buffer(),
  297. oscServerAddress);
  298. lo_send_message_from(targetAddress, fOscServer, "/signal/hello", msg2);
  299. lo_message_free(msg2);
  300. carla_stdout("CarlaNSM::handleBroadcast - sent hello");
  301. }
  302. lo_address_free(targetAddress);
  303. std::free(oscServerAddress);
  304. return 0;
  305. }
  306. if (std::strcmp(path, "/signal/hello") == 0)
  307. {
  308. carla_stdout("CarlaNSM::handleBroadcast - got hello");
  309. //const char* const name = &argv[0]->s;
  310. const char* const url = &argv[1]->s;
  311. const lo_address targetAddress(lo_address_new_from_url(url));
  312. CARLA_SAFE_ASSERT_RETURN(targetAddress != nullptr, 0);
  313. char* const oscServerAddress(lo_server_get_url(fOscServer));
  314. CARLA_SAFE_ASSERT_RETURN(oscServerAddress != nullptr, 0);
  315. //lo_send_from(targetAddress, fOscServer, LO_TT_IMMEDIATE, "/signal/list", "");
  316. if (lo_message msg2 = lo_message_new())
  317. {
  318. lo_message_add(msg2, "ss",
  319. fClientNameId.buffer(),
  320. oscServerAddress);
  321. lo_send_message_from(targetAddress, fOscServer, "/signal/hello", msg2);
  322. lo_message_free(msg2);
  323. carla_stdout("CarlaNSM::handleBroadcast - sent hello");
  324. }
  325. lo_address_free(targetAddress);
  326. std::free(oscServerAddress);
  327. return 0;
  328. }
  329. if (std::strcmp(path, "/signal/list") == 0)
  330. {
  331. carla_stdout("CarlaNSM::handleBroadcast - got list");
  332. CARLA_SAFE_ASSERT_RETURN(carla_is_engine_running(), 0);
  333. //const char* prefix = nullptr;
  334. //if (argc > 0)
  335. //prefix = &argv[0]->s;
  336. const lo_address targetAddress(lo_message_get_source(msg));
  337. CARLA_SAFE_ASSERT_RETURN(targetAddress != nullptr, 0);
  338. CarlaString stripName;
  339. for (uint32_t i = 0, pluginCount = carla_get_current_plugin_count(); i < pluginCount; ++i)
  340. {
  341. const CarlaPluginInfo* const pluginInfo(carla_get_plugin_info(i));
  342. CARLA_SAFE_ASSERT_CONTINUE(pluginInfo != nullptr);
  343. for (uint32_t j=0, paramCount = carla_get_parameter_count(i); j < paramCount; ++j)
  344. {
  345. const CarlaParameterInfo* const paramInfo(carla_get_parameter_info(i, j));
  346. CARLA_SAFE_ASSERT_CONTINUE(paramInfo != nullptr);
  347. const ParameterData* const paramData(carla_get_parameter_data(i, j));
  348. CARLA_SAFE_ASSERT_CONTINUE(paramData != nullptr);
  349. const ParameterRanges* const paramRanges(carla_get_parameter_ranges(i, j));
  350. CARLA_SAFE_ASSERT_CONTINUE(paramRanges != nullptr);
  351. if (paramData->type != CB::PARAMETER_INPUT && paramData->type != CB::PARAMETER_OUTPUT)
  352. continue;
  353. if ((paramData->hints & CB::PARAMETER_IS_ENABLED) == 0)
  354. continue;
  355. if ((paramData->hints & CB::PARAMETER_IS_AUTOMABLE) == 0)
  356. continue;
  357. if (paramData->hints & CB::PARAMETER_IS_READ_ONLY)
  358. continue;
  359. if (lo_message msg2 = lo_message_new())
  360. {
  361. stripName = fClientNameId + "/strip/Unnamed/" + pluginInfo->name + "/" + paramInfo->name;
  362. stripName.replace(' ','_');
  363. lo_message_add(msg2, "sssfff",
  364. path,
  365. stripName.buffer(),
  366. paramData->type == CB::PARAMETER_INPUT ? "in" : "out",
  367. paramRanges->min,
  368. paramRanges->max,
  369. paramRanges->def);
  370. lo_send_message_from(targetAddress, fOscServer, "/reply", msg2);
  371. lo_message_free(msg2);
  372. carla_stdout("CarlaNSM::handleBroadcast - sent list at %i : %i, path: %s", i+1, j+1, stripName.buffer());
  373. }
  374. #if 0
  375. if (prefix == nullptr /*|| strncmp(o->path(), prefix, std::strlen(prefix)) == 0*/)
  376. {
  377. lo_send_from(targetAddress, fOscServer, LO_TT_IMMEDIATE, "/reply", "sssfff",
  378. path,
  379. paramInfo->name,
  380. paramData->type == CB::PARAMETER_INPUT ? "in" : "out",
  381. paramRanges->min,
  382. paramRanges->max,
  383. paramRanges->def);
  384. }
  385. #endif
  386. }
  387. }
  388. if (lo_message msg2 = lo_message_new())
  389. {
  390. lo_message_add(msg2, "s", path);
  391. lo_send_message_from(targetAddress, fOscServer, "/reply", msg2);
  392. lo_message_free(msg2);
  393. carla_stdout("CarlaNSM::handleBroadcast - sent list final");
  394. }
  395. //lo_send_from(targetAddress, fOscServer, LO_TT_IMMEDIATE, "/reply", "s", path);
  396. //return 0;
  397. }
  398. #if 0
  399. if (std::strcmp(path, "/reply") == 0)
  400. {
  401. CARLA_SAFE_ASSERT_RETURN(argc > 0, 0);
  402. const char* const method = &argv[0]->s;
  403. if (std::strcmp(method, "/signal/list") == 0)
  404. {
  405. carla_stdout("CarlaNSM::handleBroadcast - got new list");
  406. if (argc == 1)
  407. return 0;
  408. CARLA_SAFE_ASSERT_RETURN(argc == 6, 0);
  409. const lo_address targetAddress(lo_message_get_source(msg));
  410. CARLA_SAFE_ASSERT_RETURN(targetAddress != nullptr, 0);
  411. const char* const stripName = &argv[1]->s;
  412. const char* const orientation = &argv[2]->s;
  413. const float min = argv[3]->f;
  414. const float max = argv[4]->f;
  415. const float def = argv[5]->f;
  416. if (lo_message msg2 = lo_message_new())
  417. {
  418. lo_message_add(msg2, "sssfff",
  419. method,
  420. stripName,
  421. orientation,
  422. min,
  423. max,
  424. def);
  425. lo_send_message_from(targetAddress, fOscServer, "/reply", msg2);
  426. lo_message_free(msg2);
  427. }
  428. }
  429. else
  430. {
  431. CARLA_SAFE_ASSERT(false);
  432. }
  433. return 0;
  434. }
  435. #endif
  436. // check if all args are strings
  437. for (int i=0; i<argc; ++i)
  438. {
  439. if (types[i] != 's')
  440. return 0;
  441. }
  442. for (int i=0; i<argc; ++i)
  443. carla_stdout("%i: %s", i+1, &argv[i]->s);
  444. return 0;
  445. }
  446. private:
  447. lo_address fOscAddress;
  448. lo_server fOscServer;
  449. lo_server_thread fOscServerThread;
  450. CarlaString fClientNameId;
  451. CarlaString fProjectPath;
  452. bool fHasBroadcast;
  453. bool fHasOptionalGui;
  454. bool fHasServerControl;
  455. bool fStarted;
  456. #define handlePtr ((CarlaNSM*)data)
  457. static void _osc_error_handler(int num, const char* msg, const char* path)
  458. {
  459. carla_stderr2("CarlaNSM::_osc_error_handler(%i, \"%s\", \"%s\")", num, msg, path);
  460. }
  461. static int _error_handler(const char*, const char* types, lo_arg** argv, int argc, lo_message, void* data)
  462. {
  463. CARLA_SAFE_ASSERT_RETURN(argc == 3, 1);
  464. CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "sis") == 0, 1);
  465. const char* const method = &argv[0]->s;
  466. const int code = argv[1]->i;
  467. const char* const message = &argv[2]->s;
  468. return handlePtr->handleError(method, code, message);
  469. }
  470. static int _reply_handler(const char*, const char* types, lo_arg** argv, int argc, lo_message msg, void* data)
  471. {
  472. CARLA_SAFE_ASSERT_RETURN(argc == 4, 1);
  473. CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "ssss") == 0, 1);
  474. const char* const method = &argv[0]->s;
  475. const char* const message = &argv[1]->s;
  476. const char* const smName = &argv[2]->s;
  477. const char* const features = &argv[3]->s;
  478. return handlePtr->handleReply(method, message, smName, features, msg);
  479. }
  480. static int _open_handler(const char*, const char* types, lo_arg** argv, int argc, lo_message, void* data)
  481. {
  482. CARLA_SAFE_ASSERT_RETURN(argc == 3, 1);
  483. CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "sss") == 0, 1);
  484. const char* const projectPath = &argv[0]->s;
  485. const char* const displayName = &argv[1]->s;
  486. const char* const clientNameId = &argv[2]->s;
  487. return handlePtr->handleOpen(projectPath, displayName, clientNameId);
  488. }
  489. static int _save_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)
  490. {
  491. CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);
  492. return handlePtr->handleSave();
  493. }
  494. static int _loaded_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)
  495. {
  496. CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);
  497. return handlePtr->handleSessionIsLoaded();
  498. }
  499. static int _show_gui_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)
  500. {
  501. CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);
  502. return handlePtr->handleShowOptionalGui();
  503. }
  504. static int _hide_gui_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)
  505. {
  506. CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);
  507. return handlePtr->handleHideOptionalGui();
  508. }
  509. static int _broadcast_handler(const char* path, const char* types, lo_arg** argv, int argc, lo_message msg, void* data)
  510. {
  511. return handlePtr->handleBroadcast(path, types, argv, argc, msg);
  512. }
  513. #undef handlePtr
  514. CARLA_PREVENT_HEAP_ALLOCATION
  515. CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)
  516. };
  517. #endif // HAVE_LIBLO
  518. // -------------------------------------------------------------------------------------------------------------------
  519. // API
  520. #define CARLA_COMMON_NEED_CHECKSTRINGPTR
  521. #include "CarlaHostCommon.cpp"
  522. // -------------------------------------------------------------------------------------------------------------------
  523. uint carla_get_engine_driver_count()
  524. {
  525. carla_debug("carla_get_engine_driver_count()");
  526. return CarlaEngine::getDriverCount();
  527. }
  528. const char* carla_get_engine_driver_name(uint index)
  529. {
  530. carla_debug("carla_get_engine_driver_name(%i)", index);
  531. return CarlaEngine::getDriverName(index);
  532. }
  533. const char* const* carla_get_engine_driver_device_names(uint index)
  534. {
  535. carla_debug("carla_get_engine_driver_device_names(%i)", index);
  536. return CarlaEngine::getDriverDeviceNames(index);
  537. }
  538. const EngineDriverDeviceInfo* carla_get_engine_driver_device_info(uint index, const char* name)
  539. {
  540. CARLA_SAFE_ASSERT_RETURN(name != nullptr && name[0] != '\0', nullptr);
  541. carla_debug("carla_get_engine_driver_device_info(%i, \"%s\")", index, name);
  542. if (const EngineDriverDeviceInfo* const ret = CarlaEngine::getDriverDeviceInfo(index, name))
  543. {
  544. static EngineDriverDeviceInfo devInfo;
  545. static const uint32_t nullBufferSizes[] = { 0 };
  546. static const double nullSampleRates[] = { 0.0 };
  547. devInfo.hints = ret->hints;
  548. devInfo.bufferSizes = (ret->bufferSizes != nullptr) ? ret->bufferSizes : nullBufferSizes;
  549. devInfo.sampleRates = (ret->sampleRates != nullptr) ? ret->sampleRates : nullSampleRates;
  550. return &devInfo;
  551. }
  552. return nullptr;
  553. }
  554. // -------------------------------------------------------------------------------------------------------------------
  555. CarlaEngine* carla_get_engine()
  556. {
  557. carla_debug("carla_get_engine()");
  558. return gStandalone.engine;
  559. }
  560. // -------------------------------------------------------------------------------------------------------------------
  561. static void carla_engine_init_common()
  562. {
  563. gStandalone.engine->setCallback(gStandalone.engineCallback, gStandalone.engineCallbackPtr);
  564. gStandalone.engine->setFileCallback(gStandalone.fileCallback, gStandalone.fileCallbackPtr);
  565. #ifdef BUILD_BRIDGE
  566. using juce::File;
  567. File juceBinaryDir(File::getSpecialLocation(File::currentExecutableFile).getParentDirectory());
  568. /*
  569. if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_FORCE_STEREO"))
  570. gStandalone.engine->setOption(CB::ENGINE_OPTION_FORCE_STEREO, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);
  571. if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_PREFER_PLUGIN_BRIDGES"))
  572. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);
  573. if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_PREFER_UI_BRIDGES"))
  574. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_UI_BRIDGES, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);
  575. */
  576. if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_UIS_ALWAYS_ON_TOP"))
  577. gStandalone.engine->setOption(CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);
  578. if (const char* const maxParameters = std::getenv("ENGINE_OPTION_MAX_PARAMETERS"))
  579. gStandalone.engine->setOption(CB::ENGINE_OPTION_MAX_PARAMETERS, std::atoi(maxParameters), nullptr);
  580. if (const char* const uiBridgesTimeout = std::getenv("ENGINE_OPTION_UI_BRIDGES_TIMEOUT"))
  581. gStandalone.engine->setOption(CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT, std::atoi(uiBridgesTimeout), nullptr);
  582. if (const char* const pathLADSPA = std::getenv("ENGINE_OPTION_PLUGIN_PATH_LADSPA"))
  583. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_LADSPA, pathLADSPA);
  584. if (const char* const pathDSSI = std::getenv("ENGINE_OPTION_PLUGIN_PATH_DSSI"))
  585. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_DSSI, pathDSSI);
  586. if (const char* const pathLV2 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_LV2"))
  587. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_LV2, pathLV2);
  588. if (const char* const pathVST2 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_VST2"))
  589. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST2, pathVST2);
  590. if (const char* const pathVST3 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_VST3"))
  591. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST3, pathVST3);
  592. if (const char* const pathAU = std::getenv("ENGINE_OPTION_PLUGIN_PATH_AU"))
  593. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_AU, pathAU);
  594. if (const char* const pathGIG = std::getenv("ENGINE_OPTION_PLUGIN_PATH_GIG"))
  595. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_GIG, pathGIG);
  596. if (const char* const pathSF2 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_SF2"))
  597. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_SF2, pathSF2);
  598. if (const char* const pathSFZ = std::getenv("ENGINE_OPTION_PLUGIN_PATH_SFZ"))
  599. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_SFZ, pathSFZ);
  600. if (const char* const binaryDir = std::getenv("ENGINE_OPTION_PATH_BINARIES"))
  601. gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_BINARIES, 0, binaryDir);
  602. else
  603. gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_BINARIES, 0, juceBinaryDir.getFullPathName().toRawUTF8());
  604. if (const char* const resourceDir = std::getenv("ENGINE_OPTION_PATH_RESOURCES"))
  605. gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_RESOURCES, 0, resourceDir);
  606. else
  607. gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_RESOURCES, 0, juceBinaryDir.getChildFile("resources").getFullPathName().toRawUTF8());
  608. if (const char* const preventBadBehaviour = std::getenv("ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR"))
  609. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR, (std::strcmp(preventBadBehaviour, "true") == 0) ? 1 : 0, nullptr);
  610. if (const char* const frontendWinId = std::getenv("ENGINE_OPTION_FRONTEND_WIN_ID"))
  611. gStandalone.engine->setOption(CB::ENGINE_OPTION_FRONTEND_WIN_ID, 0, frontendWinId);
  612. #else
  613. gStandalone.engine->setOption(CB::ENGINE_OPTION_FORCE_STEREO, gStandalone.engineOptions.forceStereo ? 1 : 0, nullptr);
  614. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES, gStandalone.engineOptions.preferPluginBridges ? 1 : 0, nullptr);
  615. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_UI_BRIDGES, gStandalone.engineOptions.preferUiBridges ? 1 : 0, nullptr);
  616. gStandalone.engine->setOption(CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP, gStandalone.engineOptions.uisAlwaysOnTop ? 1 : 0, nullptr);
  617. gStandalone.engine->setOption(CB::ENGINE_OPTION_MAX_PARAMETERS, static_cast<int>(gStandalone.engineOptions.maxParameters), nullptr);
  618. gStandalone.engine->setOption(CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT, static_cast<int>(gStandalone.engineOptions.uiBridgesTimeout), nullptr);
  619. gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_NUM_PERIODS, static_cast<int>(gStandalone.engineOptions.audioNumPeriods), nullptr);
  620. gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE, static_cast<int>(gStandalone.engineOptions.audioBufferSize), nullptr);
  621. gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE, static_cast<int>(gStandalone.engineOptions.audioSampleRate), nullptr);
  622. if (gStandalone.engineOptions.audioDevice != nullptr)
  623. gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_DEVICE, 0, gStandalone.engineOptions.audioDevice);
  624. if (gStandalone.engineOptions.pathLADSPA != nullptr)
  625. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_LADSPA, gStandalone.engineOptions.pathLADSPA);
  626. if (gStandalone.engineOptions.pathDSSI != nullptr)
  627. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_DSSI, gStandalone.engineOptions.pathDSSI);
  628. if (gStandalone.engineOptions.pathLV2 != nullptr)
  629. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_LV2, gStandalone.engineOptions.pathLV2);
  630. if (gStandalone.engineOptions.pathVST2 != nullptr)
  631. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST2, gStandalone.engineOptions.pathVST2);
  632. if (gStandalone.engineOptions.pathVST3 != nullptr)
  633. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST3, gStandalone.engineOptions.pathVST3);
  634. if (gStandalone.engineOptions.pathAU != nullptr)
  635. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_AU, gStandalone.engineOptions.pathAU);
  636. if (gStandalone.engineOptions.pathGIG != nullptr)
  637. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_GIG, gStandalone.engineOptions.pathGIG);
  638. if (gStandalone.engineOptions.pathSF2 != nullptr)
  639. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_SF2, gStandalone.engineOptions.pathSF2);
  640. if (gStandalone.engineOptions.pathSFZ != nullptr)
  641. gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_SFZ, gStandalone.engineOptions.pathSFZ);
  642. if (gStandalone.engineOptions.binaryDir != nullptr && gStandalone.engineOptions.binaryDir[0] != '\0')
  643. gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_BINARIES, 0, gStandalone.engineOptions.binaryDir);
  644. if (gStandalone.engineOptions.resourceDir != nullptr && gStandalone.engineOptions.resourceDir[0] != '\0')
  645. gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_RESOURCES, 0, gStandalone.engineOptions.resourceDir);
  646. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR, gStandalone.engineOptions.preventBadBehaviour ? 1 : 0, nullptr);
  647. if (gStandalone.engineOptions.frontendWinId != 0)
  648. {
  649. char strBuf[STR_MAX+1];
  650. strBuf[STR_MAX] = '\0';
  651. std::snprintf(strBuf, STR_MAX, P_UINTPTR, gStandalone.engineOptions.frontendWinId);
  652. gStandalone.engine->setOption(CB::ENGINE_OPTION_FRONTEND_WIN_ID, 0, strBuf);
  653. }
  654. else
  655. gStandalone.engine->setOption(CB::ENGINE_OPTION_FRONTEND_WIN_ID, 0, "0");
  656. #endif
  657. }
  658. bool carla_engine_init(const char* driverName, const char* clientName)
  659. {
  660. CARLA_SAFE_ASSERT_RETURN(driverName != nullptr && driverName[0] != '\0', false);
  661. CARLA_SAFE_ASSERT_RETURN(clientName != nullptr && clientName[0] != '\0', false);
  662. carla_debug("carla_engine_init(\"%s\", \"%s\")", driverName, clientName);
  663. if (gStandalone.engine != nullptr)
  664. {
  665. carla_stderr2("Engine is already running");
  666. gStandalone.lastError = "Engine is already running";
  667. return false;
  668. }
  669. #ifdef CARLA_OS_WIN
  670. carla_setenv("WINEASIO_CLIENT_NAME", clientName);
  671. #endif
  672. // TODO: make this an option, put somewhere else
  673. if (std::getenv("WINE_RT") == nullptr)
  674. {
  675. carla_setenv("WINE_RT", "15");
  676. carla_setenv("WINE_SVR_RT", "10");
  677. }
  678. gStandalone.engine = CarlaEngine::newDriverByName(driverName);
  679. if (gStandalone.engine == nullptr)
  680. {
  681. carla_stderr2("The seleted audio driver is not available");
  682. gStandalone.lastError = "The seleted audio driver is not available";
  683. return false;
  684. }
  685. #ifdef BUILD_BRIDGE
  686. gStandalone.engine->setOption(CB::ENGINE_OPTION_PROCESS_MODE, CB::ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS, nullptr);
  687. gStandalone.engine->setOption(CB::ENGINE_OPTION_TRANSPORT_MODE, CB::ENGINE_TRANSPORT_MODE_JACK, nullptr);
  688. gStandalone.engine->setOption(CB::ENGINE_OPTION_FORCE_STEREO, false, nullptr);
  689. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES, false, nullptr);
  690. gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_UI_BRIDGES, false, nullptr);
  691. #else
  692. gStandalone.engine->setOption(CB::ENGINE_OPTION_PROCESS_MODE, static_cast<int>(gStandalone.engineOptions.processMode), nullptr);
  693. gStandalone.engine->setOption(CB::ENGINE_OPTION_TRANSPORT_MODE, static_cast<int>(gStandalone.engineOptions.transportMode), nullptr);
  694. #endif
  695. carla_engine_init_common();
  696. if (gStandalone.engine->init(clientName))
  697. {
  698. #ifndef BUILD_BRIDGE
  699. juce::initialiseJuce_GUI();
  700. #endif
  701. gStandalone.lastError = "No error";
  702. return true;
  703. }
  704. else
  705. {
  706. gStandalone.lastError = gStandalone.engine->getLastError();
  707. delete gStandalone.engine;
  708. gStandalone.engine = nullptr;
  709. return false;
  710. }
  711. }
  712. #ifdef BUILD_BRIDGE
  713. bool carla_engine_init_bridge(const char audioBaseName[6+1], const char rtClientBaseName[6+1], const char nonRtClientBaseName[6+1],
  714. const char nonRtServerBaseName[6+1], const char* clientName)
  715. {
  716. CARLA_SAFE_ASSERT_RETURN(audioBaseName != nullptr && audioBaseName[0] != '\0', false);
  717. CARLA_SAFE_ASSERT_RETURN(rtClientBaseName != nullptr && rtClientBaseName[0] != '\0', false);
  718. CARLA_SAFE_ASSERT_RETURN(nonRtClientBaseName != nullptr && nonRtClientBaseName[0] != '\0', false);
  719. CARLA_SAFE_ASSERT_RETURN(nonRtServerBaseName != nullptr && nonRtServerBaseName[0] != '\0', false);
  720. CARLA_SAFE_ASSERT_RETURN(clientName != nullptr && clientName[0] != '\0', false);
  721. carla_debug("carla_engine_init_bridge(\"%s\", \"%s\", \"%s\", \"%s\", \"%s\")", audioBaseName, rtClientBaseName, nonRtClientBaseName, nonRtServerBaseName, clientName);
  722. if (gStandalone.engine != nullptr)
  723. {
  724. carla_stderr2("Engine is already running");
  725. gStandalone.lastError = "Engine is already running";
  726. return false;
  727. }
  728. gStandalone.engine = CarlaEngine::newBridge(audioBaseName, rtClientBaseName, nonRtClientBaseName, nonRtServerBaseName);
  729. if (gStandalone.engine == nullptr)
  730. {
  731. carla_stderr2("The seleted audio driver is not available!");
  732. gStandalone.lastError = "The seleted audio driver is not available!";
  733. return false;
  734. }
  735. carla_engine_init_common();
  736. gStandalone.engine->setOption(CB::ENGINE_OPTION_PROCESS_MODE, CB::ENGINE_PROCESS_MODE_BRIDGE, nullptr);
  737. gStandalone.engine->setOption(CB::ENGINE_OPTION_TRANSPORT_MODE, CB::ENGINE_TRANSPORT_MODE_BRIDGE, nullptr);
  738. if (gStandalone.engine->init(clientName))
  739. {
  740. gStandalone.lastError = "No error";
  741. return true;
  742. }
  743. else
  744. {
  745. gStandalone.lastError = gStandalone.engine->getLastError();
  746. delete gStandalone.engine;
  747. gStandalone.engine = nullptr;
  748. return false;
  749. }
  750. }
  751. #endif
  752. bool carla_engine_close()
  753. {
  754. carla_debug("carla_engine_close()");
  755. if (gStandalone.engine == nullptr)
  756. {
  757. carla_stderr2("Engine is not running");
  758. gStandalone.lastError = "Engine is not running";
  759. return false;
  760. }
  761. gStandalone.engine->setAboutToClose();
  762. gStandalone.engine->removeAllPlugins();
  763. const bool closed(gStandalone.engine->close());
  764. if (! closed)
  765. gStandalone.lastError = gStandalone.engine->getLastError();
  766. #ifndef BUILD_BRIDGE
  767. juce::shutdownJuce_GUI();
  768. #endif
  769. delete gStandalone.engine;
  770. gStandalone.engine = nullptr;
  771. return closed;
  772. }
  773. void carla_engine_idle()
  774. {
  775. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  776. gStandalone.engine->idle();
  777. }
  778. bool carla_is_engine_running()
  779. {
  780. return (gStandalone.engine != nullptr && gStandalone.engine->isRunning());
  781. }
  782. void carla_set_engine_about_to_close()
  783. {
  784. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  785. carla_debug("carla_set_engine_about_to_close()");
  786. gStandalone.engine->setAboutToClose();
  787. }
  788. void carla_set_engine_callback(EngineCallbackFunc func, void* ptr)
  789. {
  790. carla_debug("carla_set_engine_callback(%p, %p)", func, ptr);
  791. gStandalone.engineCallback = func;
  792. gStandalone.engineCallbackPtr = ptr;
  793. if (gStandalone.engine != nullptr)
  794. gStandalone.engine->setCallback(func, ptr);
  795. //#ifdef WANT_LOGS
  796. // gLogThread.setCallback(func, ptr);
  797. //#endif
  798. }
  799. #ifndef BUILD_BRIDGE
  800. void carla_set_engine_option(EngineOption option, int value, const char* valueStr)
  801. {
  802. carla_debug("carla_set_engine_option(%i:%s, %i, \"%s\")", option, CB::EngineOption2Str(option), value, valueStr);
  803. switch (option)
  804. {
  805. case CB::ENGINE_OPTION_DEBUG:
  806. break;
  807. case CB::ENGINE_OPTION_PROCESS_MODE:
  808. CARLA_SAFE_ASSERT_RETURN(value >= CB::ENGINE_PROCESS_MODE_SINGLE_CLIENT && value < CB::ENGINE_PROCESS_MODE_BRIDGE,);
  809. gStandalone.engineOptions.processMode = static_cast<CB::EngineProcessMode>(value);
  810. break;
  811. case CB::ENGINE_OPTION_TRANSPORT_MODE:
  812. CARLA_SAFE_ASSERT_RETURN(value >= CB::ENGINE_TRANSPORT_MODE_INTERNAL && value < CB::ENGINE_TRANSPORT_MODE_BRIDGE,);
  813. gStandalone.engineOptions.transportMode = static_cast<CB::EngineTransportMode>(value);
  814. break;
  815. case CB::ENGINE_OPTION_FORCE_STEREO:
  816. CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);
  817. gStandalone.engineOptions.forceStereo = (value != 0);
  818. break;
  819. case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:
  820. CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);
  821. gStandalone.engineOptions.preferPluginBridges = (value != 0);
  822. break;
  823. case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:
  824. CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);
  825. gStandalone.engineOptions.preferUiBridges = (value != 0);
  826. break;
  827. case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:
  828. CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);
  829. gStandalone.engineOptions.uisAlwaysOnTop = (value != 0);
  830. break;
  831. case CB::ENGINE_OPTION_MAX_PARAMETERS:
  832. CARLA_SAFE_ASSERT_RETURN(value >= 0,);
  833. gStandalone.engineOptions.maxParameters = static_cast<uint>(value);
  834. break;
  835. case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:
  836. CARLA_SAFE_ASSERT_RETURN(value >= 0,);
  837. gStandalone.engineOptions.uiBridgesTimeout = static_cast<uint>(value);
  838. break;
  839. case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:
  840. CARLA_SAFE_ASSERT_RETURN(value >= 2 && value <= 3,);
  841. gStandalone.engineOptions.audioNumPeriods = static_cast<uint>(value);
  842. break;
  843. case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:
  844. CARLA_SAFE_ASSERT_RETURN(value >= 8,);
  845. gStandalone.engineOptions.audioBufferSize = static_cast<uint>(value);
  846. break;
  847. case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:
  848. CARLA_SAFE_ASSERT_RETURN(value >= 22050,);
  849. gStandalone.engineOptions.audioSampleRate = static_cast<uint>(value);
  850. break;
  851. case CB::ENGINE_OPTION_AUDIO_DEVICE:
  852. CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);
  853. if (gStandalone.engineOptions.audioDevice != nullptr)
  854. delete[] gStandalone.engineOptions.audioDevice;
  855. gStandalone.engineOptions.audioDevice = carla_strdup_safe(valueStr);
  856. break;
  857. case CB::ENGINE_OPTION_PLUGIN_PATH:
  858. CARLA_SAFE_ASSERT_RETURN(value > CB::PLUGIN_NONE,);
  859. CARLA_SAFE_ASSERT_RETURN(value <= CB::PLUGIN_SFZ,);
  860. CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);
  861. switch (value)
  862. {
  863. case CB::PLUGIN_LADSPA:
  864. if (gStandalone.engineOptions.pathLADSPA != nullptr)
  865. delete[] gStandalone.engineOptions.pathLADSPA;
  866. gStandalone.engineOptions.pathLADSPA = carla_strdup_safe(valueStr);
  867. break;
  868. case CB::PLUGIN_DSSI:
  869. if (gStandalone.engineOptions.pathDSSI != nullptr)
  870. delete[] gStandalone.engineOptions.pathDSSI;
  871. gStandalone.engineOptions.pathDSSI = carla_strdup_safe(valueStr);
  872. break;
  873. case CB::PLUGIN_LV2:
  874. if (gStandalone.engineOptions.pathLV2 != nullptr)
  875. delete[] gStandalone.engineOptions.pathLV2;
  876. gStandalone.engineOptions.pathLV2 = carla_strdup_safe(valueStr);
  877. break;
  878. case CB::PLUGIN_VST2:
  879. if (gStandalone.engineOptions.pathVST2 != nullptr)
  880. delete[] gStandalone.engineOptions.pathVST2;
  881. gStandalone.engineOptions.pathVST2 = carla_strdup_safe(valueStr);
  882. break;
  883. case CB::PLUGIN_VST3:
  884. if (gStandalone.engineOptions.pathVST3 != nullptr)
  885. delete[] gStandalone.engineOptions.pathVST3;
  886. gStandalone.engineOptions.pathVST3 = carla_strdup_safe(valueStr);
  887. break;
  888. case CB::PLUGIN_AU:
  889. if (gStandalone.engineOptions.pathAU != nullptr)
  890. delete[] gStandalone.engineOptions.pathAU;
  891. gStandalone.engineOptions.pathAU = carla_strdup_safe(valueStr);
  892. break;
  893. case CB::PLUGIN_GIG:
  894. if (gStandalone.engineOptions.pathGIG != nullptr)
  895. delete[] gStandalone.engineOptions.pathGIG;
  896. gStandalone.engineOptions.pathGIG = carla_strdup_safe(valueStr);
  897. break;
  898. case CB::PLUGIN_SF2:
  899. if (gStandalone.engineOptions.pathSF2 != nullptr)
  900. delete[] gStandalone.engineOptions.pathSF2;
  901. gStandalone.engineOptions.pathSF2 = carla_strdup_safe(valueStr);
  902. break;
  903. case CB::PLUGIN_SFZ:
  904. if (gStandalone.engineOptions.pathSFZ != nullptr)
  905. delete[] gStandalone.engineOptions.pathSFZ;
  906. gStandalone.engineOptions.pathSFZ = carla_strdup_safe(valueStr);
  907. break;
  908. }
  909. break;
  910. case CB::ENGINE_OPTION_PATH_BINARIES:
  911. CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr && valueStr[0] != '\0',);
  912. if (gStandalone.engineOptions.binaryDir != nullptr)
  913. delete[] gStandalone.engineOptions.binaryDir;
  914. gStandalone.engineOptions.binaryDir = carla_strdup_safe(valueStr);
  915. break;
  916. case CB::ENGINE_OPTION_PATH_RESOURCES:
  917. CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr && valueStr[0] != '\0',);
  918. if (gStandalone.engineOptions.resourceDir != nullptr)
  919. delete[] gStandalone.engineOptions.resourceDir;
  920. gStandalone.engineOptions.resourceDir = carla_strdup_safe(valueStr);
  921. break;
  922. case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:
  923. CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);
  924. gStandalone.engineOptions.preventBadBehaviour = (value != 0);
  925. break;
  926. case CB::ENGINE_OPTION_FRONTEND_WIN_ID:
  927. CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr && valueStr[0] != '\0',);
  928. const long long winId(std::strtoll(valueStr, nullptr, 16));
  929. CARLA_SAFE_ASSERT_RETURN(winId >= 0,);
  930. gStandalone.engineOptions.frontendWinId = static_cast<uintptr_t>(winId);
  931. break;
  932. }
  933. if (gStandalone.engine != nullptr)
  934. gStandalone.engine->setOption(option, value, valueStr);
  935. }
  936. #endif
  937. void carla_set_file_callback(FileCallbackFunc func, void* ptr)
  938. {
  939. carla_debug("carla_set_file_callback(%p, %p)", func, ptr);
  940. gStandalone.fileCallback = func;
  941. gStandalone.fileCallbackPtr = ptr;
  942. if (gStandalone.engine != nullptr)
  943. gStandalone.engine->setFileCallback(func, ptr);
  944. }
  945. // -------------------------------------------------------------------------------------------------------------------
  946. bool carla_load_file(const char* filename)
  947. {
  948. CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);
  949. carla_debug("carla_load_file(\"%s\")", filename);
  950. if (gStandalone.engine != nullptr)
  951. return gStandalone.engine->loadFile(filename);
  952. carla_stderr2("Engine is not running");
  953. gStandalone.lastError = "Engine is not running";
  954. return false;
  955. }
  956. bool carla_load_project(const char* filename)
  957. {
  958. CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);
  959. carla_debug("carla_load_project(\"%s\")", filename);
  960. if (gStandalone.engine != nullptr)
  961. return gStandalone.engine->loadProject(filename);
  962. carla_stderr2("Engine is not running");
  963. gStandalone.lastError = "Engine is not running";
  964. return false;
  965. }
  966. bool carla_save_project(const char* filename)
  967. {
  968. CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);
  969. carla_debug("carla_save_project(\"%s\")", filename);
  970. if (gStandalone.engine != nullptr)
  971. return gStandalone.engine->saveProject(filename);
  972. carla_stderr2("Engine was never initiated");
  973. gStandalone.lastError = "Engine was never initiated";
  974. return false;
  975. }
  976. #ifndef BUILD_BRIDGE
  977. // -------------------------------------------------------------------------------------------------------------------
  978. bool carla_patchbay_connect(uint groupIdA, uint portIdA, uint groupIdB, uint portIdB)
  979. {
  980. carla_debug("carla_patchbay_connect(%u, %u, %u, %u)", groupIdA, portIdA, groupIdB, portIdB);
  981. if (gStandalone.engine != nullptr)
  982. return gStandalone.engine->patchbayConnect(groupIdA, portIdA, groupIdB, portIdB);
  983. carla_stderr2("Engine is not running");
  984. gStandalone.lastError = "Engine is not running";
  985. return false;
  986. }
  987. bool carla_patchbay_disconnect(uint connectionId)
  988. {
  989. carla_debug("carla_patchbay_disconnect(%i)", connectionId);
  990. if (gStandalone.engine != nullptr)
  991. return gStandalone.engine->patchbayDisconnect(connectionId);
  992. carla_stderr2("Engine is not running");
  993. gStandalone.lastError = "Engine is not running";
  994. return false;
  995. }
  996. bool carla_patchbay_refresh(bool external)
  997. {
  998. carla_debug("carla_patchbay_refresh(%s)", bool2str(external));
  999. if (gStandalone.engine != nullptr)
  1000. return gStandalone.engine->patchbayRefresh(external);
  1001. carla_stderr2("Engine is not running");
  1002. gStandalone.lastError = "Engine is not running";
  1003. return false;
  1004. }
  1005. // -------------------------------------------------------------------------------------------------------------------
  1006. void carla_transport_play()
  1007. {
  1008. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);
  1009. carla_debug("carla_transport_play()");
  1010. gStandalone.engine->transportPlay();
  1011. }
  1012. void carla_transport_pause()
  1013. {
  1014. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);
  1015. carla_debug("carla_transport_pause()");
  1016. gStandalone.engine->transportPause();
  1017. }
  1018. void carla_transport_relocate(uint64_t frame)
  1019. {
  1020. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);
  1021. carla_debug("carla_transport_relocate(%i)", frame);
  1022. gStandalone.engine->transportRelocate(frame);
  1023. }
  1024. uint64_t carla_get_current_transport_frame()
  1025. {
  1026. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(), 0);
  1027. const CB::EngineTimeInfo& timeInfo(gStandalone.engine->getTimeInfo());
  1028. return timeInfo.frame;
  1029. }
  1030. const CarlaTransportInfo* carla_get_transport_info()
  1031. {
  1032. static CarlaTransportInfo retInfo;
  1033. // reset
  1034. retInfo.playing = false;
  1035. retInfo.frame = 0;
  1036. retInfo.bar = 0;
  1037. retInfo.beat = 0;
  1038. retInfo.tick = 0;
  1039. retInfo.bpm = 0.0;
  1040. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(), &retInfo);
  1041. const CB::EngineTimeInfo& timeInfo(gStandalone.engine->getTimeInfo());
  1042. retInfo.playing = timeInfo.playing;
  1043. retInfo.frame = timeInfo.frame;
  1044. if (timeInfo.valid & CB::EngineTimeInfo::kValidBBT)
  1045. {
  1046. retInfo.bar = timeInfo.bbt.bar;
  1047. retInfo.beat = timeInfo.bbt.beat;
  1048. retInfo.tick = timeInfo.bbt.tick;
  1049. retInfo.bpm = timeInfo.bbt.beatsPerMinute;
  1050. }
  1051. return &retInfo;
  1052. }
  1053. #endif
  1054. // -------------------------------------------------------------------------------------------------------------------
  1055. uint32_t carla_get_current_plugin_count()
  1056. {
  1057. if (gStandalone.engine != nullptr)
  1058. return gStandalone.engine->getCurrentPluginCount();
  1059. return 0;
  1060. }
  1061. uint32_t carla_get_max_plugin_number()
  1062. {
  1063. if (gStandalone.engine != nullptr)
  1064. return gStandalone.engine->getMaxPluginNumber();
  1065. return 0;
  1066. }
  1067. // -------------------------------------------------------------------------------------------------------------------
  1068. bool carla_add_plugin(BinaryType btype, PluginType ptype, const char* filename, const char* name, const char* label, int64_t uniqueId, const void* extraPtr, uint options)
  1069. {
  1070. carla_debug("carla_add_plugin(%i:%s, %i:%s, \"%s\", \"%s\", \"%s\", " P_INT64 ", %p, %u)", btype, CB::BinaryType2Str(btype), ptype, CB::PluginType2Str(ptype), filename, name, label, uniqueId, extraPtr, options);
  1071. if (gStandalone.engine != nullptr)
  1072. return gStandalone.engine->addPlugin(btype, ptype, filename, name, label, uniqueId, extraPtr, options);
  1073. carla_stderr2("Engine is not running");
  1074. gStandalone.lastError = "Engine is not running";
  1075. return false;
  1076. }
  1077. bool carla_remove_plugin(uint pluginId)
  1078. {
  1079. carla_debug("carla_remove_plugin(%i)", pluginId);
  1080. if (gStandalone.engine != nullptr)
  1081. return gStandalone.engine->removePlugin(pluginId);
  1082. carla_stderr2("Engine is not running");
  1083. gStandalone.lastError = "Engine is not running";
  1084. return false;
  1085. }
  1086. bool carla_remove_all_plugins()
  1087. {
  1088. carla_debug("carla_remove_all_plugins()");
  1089. if (gStandalone.engine != nullptr)
  1090. return gStandalone.engine->removeAllPlugins();
  1091. carla_stderr2("Engine is not running");
  1092. gStandalone.lastError = "Engine is not running";
  1093. return false;
  1094. }
  1095. #ifndef BUILD_BRIDGE
  1096. const char* carla_rename_plugin(uint pluginId, const char* newName)
  1097. {
  1098. CARLA_SAFE_ASSERT_RETURN(newName != nullptr && newName[0] != '\0', nullptr);
  1099. carla_debug("carla_rename_plugin(%i, \"%s\")", pluginId, newName);
  1100. if (gStandalone.engine != nullptr)
  1101. return gStandalone.engine->renamePlugin(pluginId, newName);
  1102. carla_stderr2("Engine is not running");
  1103. gStandalone.lastError = "Engine is not running";
  1104. return nullptr;
  1105. }
  1106. bool carla_clone_plugin(uint pluginId)
  1107. {
  1108. carla_debug("carla_clone_plugin(%i)", pluginId);
  1109. if (gStandalone.engine != nullptr)
  1110. return gStandalone.engine->clonePlugin(pluginId);
  1111. carla_stderr2("Engine is not running");
  1112. gStandalone.lastError = "Engine is not running";
  1113. return false;
  1114. }
  1115. bool carla_replace_plugin(uint pluginId)
  1116. {
  1117. carla_debug("carla_replace_plugin(%i)", pluginId);
  1118. if (gStandalone.engine != nullptr)
  1119. return gStandalone.engine->replacePlugin(pluginId);
  1120. carla_stderr2("Engine is not running");
  1121. gStandalone.lastError = "Engine is not running";
  1122. return false;
  1123. }
  1124. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)
  1125. {
  1126. CARLA_SAFE_ASSERT_RETURN(pluginIdA != pluginIdB, false);
  1127. carla_debug("carla_switch_plugins(%i, %i)", pluginIdA, pluginIdB);
  1128. if (gStandalone.engine != nullptr)
  1129. return gStandalone.engine->switchPlugins(pluginIdA, pluginIdB);
  1130. carla_stderr2("Engine is not running");
  1131. gStandalone.lastError = "Engine is not running";
  1132. return false;
  1133. }
  1134. #endif
  1135. // -------------------------------------------------------------------------------------------------------------------
  1136. bool carla_load_plugin_state(uint pluginId, const char* filename)
  1137. {
  1138. CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);
  1139. carla_debug("carla_load_plugin_state(%i, \"%s\")", pluginId, filename);
  1140. if (gStandalone.engine == nullptr || ! gStandalone.engine->isRunning())
  1141. {
  1142. carla_stderr2("Engine is not running");
  1143. gStandalone.lastError = "Engine is not running";
  1144. return false;
  1145. }
  1146. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1147. return plugin->loadStateFromFile(filename);
  1148. carla_stderr2("carla_load_plugin_state(%i, \"%s\") - could not find plugin", pluginId, filename);
  1149. return false;
  1150. }
  1151. bool carla_save_plugin_state(uint pluginId, const char* filename)
  1152. {
  1153. CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);
  1154. carla_debug("carla_save_plugin_state(%i, \"%s\")", pluginId, filename);
  1155. if (gStandalone.engine == nullptr)
  1156. {
  1157. carla_stderr2("Engine is not running");
  1158. gStandalone.lastError = "Engine is not running";
  1159. return false;
  1160. }
  1161. // allow to save even if engine isn't running
  1162. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1163. return plugin->saveStateToFile(filename);
  1164. carla_stderr2("carla_save_plugin_state(%i, \"%s\") - could not find plugin", pluginId, filename);
  1165. return false;
  1166. }
  1167. // -------------------------------------------------------------------------------------------------------------------
  1168. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)
  1169. {
  1170. carla_debug("carla_get_plugin_info(%i)", pluginId);
  1171. static CarlaPluginInfo info;
  1172. // reset
  1173. info.type = CB::PLUGIN_NONE;
  1174. info.category = CB::PLUGIN_CATEGORY_NONE;
  1175. info.hints = 0x0;
  1176. info.optionsAvailable = 0x0;
  1177. info.optionsEnabled = 0x0;
  1178. info.filename = gNullCharPtr;
  1179. info.name = gNullCharPtr;
  1180. info.iconName = gNullCharPtr;
  1181. info.uniqueId = 0;
  1182. // cleanup
  1183. if (info.label != gNullCharPtr)
  1184. {
  1185. delete[] info.label;
  1186. info.label = gNullCharPtr;
  1187. }
  1188. if (info.maker != gNullCharPtr)
  1189. {
  1190. delete[] info.maker;
  1191. info.maker = gNullCharPtr;
  1192. }
  1193. if (info.copyright != gNullCharPtr)
  1194. {
  1195. delete[] info.copyright;
  1196. info.copyright = gNullCharPtr;
  1197. }
  1198. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);
  1199. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1200. {
  1201. char strBufLabel[STR_MAX+1];
  1202. char strBufMaker[STR_MAX+1];
  1203. char strBufCopyright[STR_MAX+1];
  1204. carla_zeroChar(strBufLabel, STR_MAX+1);
  1205. carla_zeroChar(strBufMaker, STR_MAX+1);
  1206. carla_zeroChar(strBufCopyright, STR_MAX+1);
  1207. info.type = plugin->getType();
  1208. info.category = plugin->getCategory();
  1209. info.hints = plugin->getHints();
  1210. info.filename = plugin->getFilename();
  1211. info.name = plugin->getName();
  1212. info.iconName = plugin->getIconName();
  1213. info.uniqueId = plugin->getUniqueId();
  1214. info.optionsAvailable = plugin->getOptionsAvailable();
  1215. info.optionsEnabled = plugin->getOptionsEnabled();
  1216. plugin->getLabel(strBufLabel);
  1217. info.label = carla_strdup_safe(strBufLabel);
  1218. plugin->getMaker(strBufMaker);
  1219. info.maker = carla_strdup_safe(strBufMaker);
  1220. plugin->getCopyright(strBufCopyright);
  1221. info.copyright = carla_strdup_safe(strBufCopyright);
  1222. checkStringPtr(info.filename);
  1223. checkStringPtr(info.name);
  1224. checkStringPtr(info.iconName);
  1225. checkStringPtr(info.label);
  1226. checkStringPtr(info.maker);
  1227. checkStringPtr(info.copyright);
  1228. return &info;
  1229. }
  1230. carla_stderr2("carla_get_plugin_info(%i) - could not find plugin", pluginId);
  1231. return &info;
  1232. }
  1233. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)
  1234. {
  1235. carla_debug("carla_get_audio_port_count_info(%i)", pluginId);
  1236. static CarlaPortCountInfo info;
  1237. // reset
  1238. info.ins = 0;
  1239. info.outs = 0;
  1240. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);
  1241. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1242. {
  1243. info.ins = plugin->getAudioInCount();
  1244. info.outs = plugin->getAudioOutCount();
  1245. return &info;
  1246. }
  1247. carla_stderr2("carla_get_audio_port_count_info(%i) - could not find plugin", pluginId);
  1248. return &info;
  1249. }
  1250. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)
  1251. {
  1252. carla_debug("carla_get_midi_port_count_info(%i)", pluginId);
  1253. static CarlaPortCountInfo info;
  1254. // reset
  1255. info.ins = 0;
  1256. info.outs = 0;
  1257. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);
  1258. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1259. {
  1260. info.ins = plugin->getMidiInCount();
  1261. info.outs = plugin->getMidiOutCount();
  1262. return &info;
  1263. }
  1264. carla_stderr2("carla_get_midi_port_count_info(%i) - could not find plugin", pluginId);
  1265. return &info;
  1266. }
  1267. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)
  1268. {
  1269. carla_debug("carla_get_parameter_count_info(%i)", pluginId);
  1270. static CarlaPortCountInfo info;
  1271. // reset
  1272. info.ins = 0;
  1273. info.outs = 0;
  1274. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);
  1275. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1276. {
  1277. plugin->getParameterCountInfo(info.ins, info.outs);
  1278. return &info;
  1279. }
  1280. carla_stderr2("carla_get_parameter_count_info(%i) - could not find plugin", pluginId);
  1281. return &info;
  1282. }
  1283. const CarlaParameterInfo* carla_get_parameter_info(uint pluginId, uint32_t parameterId)
  1284. {
  1285. carla_debug("carla_get_parameter_info(%i, %i)", pluginId, parameterId);
  1286. static CarlaParameterInfo info;
  1287. // reset
  1288. info.scalePointCount = 0;
  1289. // cleanup
  1290. if (info.name != gNullCharPtr)
  1291. {
  1292. delete[] info.name;
  1293. info.name = gNullCharPtr;
  1294. }
  1295. if (info.symbol != gNullCharPtr)
  1296. {
  1297. delete[] info.symbol;
  1298. info.symbol = gNullCharPtr;
  1299. }
  1300. if (info.unit != gNullCharPtr)
  1301. {
  1302. delete[] info.unit;
  1303. info.unit = gNullCharPtr;
  1304. }
  1305. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);
  1306. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1307. {
  1308. if (parameterId < plugin->getParameterCount())
  1309. {
  1310. char strBufName[STR_MAX+1];
  1311. char strBufSymbol[STR_MAX+1];
  1312. char strBufUnit[STR_MAX+1];
  1313. carla_zeroChar(strBufName, STR_MAX+1);
  1314. carla_zeroChar(strBufSymbol, STR_MAX+1);
  1315. carla_zeroChar(strBufUnit, STR_MAX+1);
  1316. info.scalePointCount = plugin->getParameterScalePointCount(parameterId);
  1317. plugin->getParameterName(parameterId, strBufName);
  1318. info.name = carla_strdup_safe(strBufName);
  1319. plugin->getParameterSymbol(parameterId, strBufSymbol);
  1320. info.symbol = carla_strdup_safe(strBufSymbol);
  1321. plugin->getParameterUnit(parameterId, strBufUnit);
  1322. info.unit = carla_strdup_safe(strBufUnit);
  1323. checkStringPtr(info.name);
  1324. checkStringPtr(info.symbol);
  1325. checkStringPtr(info.unit);
  1326. }
  1327. else
  1328. carla_stderr2("carla_get_parameter_info(%i, %i) - parameterId out of bounds", pluginId, parameterId);
  1329. return &info;
  1330. }
  1331. carla_stderr2("carla_get_parameter_info(%i, %i) - could not find plugin", pluginId, parameterId);
  1332. return &info;
  1333. }
  1334. const CarlaScalePointInfo* carla_get_parameter_scalepoint_info(uint pluginId, uint32_t parameterId, uint32_t scalePointId)
  1335. {
  1336. carla_debug("carla_get_parameter_scalepoint_info(%i, %i, %i)", pluginId, parameterId, scalePointId);
  1337. CARLA_ASSERT(gStandalone.engine != nullptr);
  1338. static CarlaScalePointInfo info;
  1339. // reset
  1340. info.value = 0.0f;
  1341. // cleanup
  1342. if (info.label != gNullCharPtr)
  1343. {
  1344. delete[] info.label;
  1345. info.label = gNullCharPtr;
  1346. }
  1347. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);
  1348. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1349. {
  1350. if (parameterId < plugin->getParameterCount())
  1351. {
  1352. if (scalePointId < plugin->getParameterScalePointCount(parameterId))
  1353. {
  1354. char strBufLabel[STR_MAX+1];
  1355. carla_zeroChar(strBufLabel, STR_MAX+1);
  1356. info.value = plugin->getParameterScalePointValue(parameterId, scalePointId);
  1357. plugin->getParameterScalePointLabel(parameterId, scalePointId, strBufLabel);
  1358. info.label = carla_strdup_safe(strBufLabel);
  1359. checkStringPtr(info.label);
  1360. }
  1361. else
  1362. carla_stderr2("carla_get_parameter_scalepoint_info(%i, %i, %i) - scalePointId out of bounds", pluginId, parameterId, scalePointId);
  1363. }
  1364. else
  1365. carla_stderr2("carla_get_parameter_scalepoint_info(%i, %i, %i) - parameterId out of bounds", pluginId, parameterId, scalePointId);
  1366. return &info;
  1367. }
  1368. carla_stderr2("carla_get_parameter_scalepoint_info(%i, %i, %i) - could not find plugin", pluginId, parameterId, scalePointId);
  1369. return &info;
  1370. }
  1371. // -------------------------------------------------------------------------------------------------------------------
  1372. const ParameterData* carla_get_parameter_data(uint pluginId, uint32_t parameterId)
  1373. {
  1374. carla_debug("carla_get_parameter_data(%i, %i)", pluginId, parameterId);
  1375. static const ParameterData fallbackParameterData = { CB::PARAMETER_UNKNOWN, 0x0, CB::PARAMETER_NULL, -1, -1, 0 };
  1376. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &fallbackParameterData);
  1377. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1378. {
  1379. if (parameterId < plugin->getParameterCount())
  1380. return &plugin->getParameterData(parameterId);
  1381. carla_stderr2("carla_get_parameter_data(%i, %i) - parameterId out of bounds", pluginId, parameterId);
  1382. return &fallbackParameterData;
  1383. }
  1384. carla_stderr2("carla_get_parameter_data(%i, %i) - could not find plugin", pluginId, parameterId);
  1385. return &fallbackParameterData;
  1386. }
  1387. const ParameterRanges* carla_get_parameter_ranges(uint pluginId, uint32_t parameterId)
  1388. {
  1389. carla_debug("carla_get_parameter_ranges(%i, %i)", pluginId, parameterId);
  1390. static const ParameterRanges fallbackParamRanges = { 0.0f, 0.0f, 1.0f, 0.01f, 0.0001f, 0.1f };
  1391. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &fallbackParamRanges);
  1392. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1393. {
  1394. if (parameterId < plugin->getParameterCount())
  1395. return &plugin->getParameterRanges(parameterId);
  1396. carla_stderr2("carla_get_parameter_ranges(%i, %i) - parameterId out of bounds", pluginId, parameterId);
  1397. return &fallbackParamRanges;
  1398. }
  1399. carla_stderr2("carla_get_parameter_ranges(%i, %i) - could not find plugin", pluginId, parameterId);
  1400. return &fallbackParamRanges;
  1401. }
  1402. const MidiProgramData* carla_get_midi_program_data(uint pluginId, uint32_t midiProgramId)
  1403. {
  1404. carla_debug("carla_get_midi_program_data(%i, %i)", pluginId, midiProgramId);
  1405. static MidiProgramData midiProgData;
  1406. // reset
  1407. midiProgData.bank = 0;
  1408. midiProgData.program = 0;
  1409. midiProgData.name = gNullCharPtr;
  1410. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &midiProgData);
  1411. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1412. {
  1413. if (midiProgramId < plugin->getMidiProgramCount())
  1414. {
  1415. const MidiProgramData& ret(plugin->getMidiProgramData(midiProgramId));
  1416. carla_copyStruct<MidiProgramData>(midiProgData, ret);
  1417. checkStringPtr(midiProgData.name);
  1418. return &midiProgData;
  1419. }
  1420. carla_stderr2("carla_get_midi_program_data(%i, %i) - midiProgramId out of bounds", pluginId, midiProgramId);
  1421. return &midiProgData;
  1422. }
  1423. carla_stderr2("carla_get_midi_program_data(%i, %i) - could not find plugin", pluginId, midiProgramId);
  1424. return &midiProgData;
  1425. }
  1426. const CustomData* carla_get_custom_data(uint pluginId, uint32_t customDataId)
  1427. {
  1428. carla_debug("carla_get_custom_data(%i, %i)", pluginId, customDataId);
  1429. static CustomData customData;
  1430. // reset
  1431. customData.type = gNullCharPtr;
  1432. customData.key = gNullCharPtr;
  1433. customData.value = gNullCharPtr;
  1434. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &customData);
  1435. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1436. {
  1437. if (customDataId < plugin->getCustomDataCount())
  1438. {
  1439. const CustomData& ret(plugin->getCustomData(customDataId));
  1440. carla_copyStruct<CustomData>(customData, ret);
  1441. checkStringPtr(customData.type);
  1442. checkStringPtr(customData.key);
  1443. checkStringPtr(customData.value);
  1444. return &customData;
  1445. }
  1446. carla_stderr2("carla_get_custom_data(%i, %i) - customDataId out of bounds", pluginId, customDataId);
  1447. return &customData;
  1448. }
  1449. carla_stderr2("carla_get_custom_data(%i, %i) - could not find plugin", pluginId, customDataId);
  1450. return &customData;
  1451. }
  1452. const char* carla_get_chunk_data(uint pluginId)
  1453. {
  1454. carla_debug("carla_get_chunk_data(%i)", pluginId);
  1455. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);
  1456. static CarlaString chunkData;
  1457. // cleanup
  1458. chunkData.clear();
  1459. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1460. {
  1461. if (plugin->getOptionsEnabled() & CB::PLUGIN_OPTION_USE_CHUNKS)
  1462. {
  1463. void* data = nullptr;
  1464. const std::size_t dataSize(plugin->getChunkData(&data));
  1465. if (data != nullptr && dataSize > 0)
  1466. {
  1467. chunkData = CarlaString::asBase64(data, static_cast<std::size_t>(dataSize));
  1468. return chunkData;
  1469. }
  1470. else
  1471. carla_stderr2("carla_get_chunk_data(%i) - got invalid chunk data", pluginId);
  1472. }
  1473. else
  1474. carla_stderr2("carla_get_chunk_data(%i) - plugin does not use chunks", pluginId);
  1475. return nullptr;
  1476. }
  1477. carla_stderr2("carla_get_chunk_data(%i) - could not find plugin", pluginId);
  1478. return nullptr;
  1479. }
  1480. // -------------------------------------------------------------------------------------------------------------------
  1481. uint32_t carla_get_parameter_count(uint pluginId)
  1482. {
  1483. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);
  1484. carla_debug("carla_get_parameter_count(%i)", pluginId);
  1485. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1486. return plugin->getParameterCount();
  1487. carla_stderr2("carla_get_parameter_count(%i) - could not find plugin", pluginId);
  1488. return 0;
  1489. }
  1490. uint32_t carla_get_program_count(uint pluginId)
  1491. {
  1492. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);
  1493. carla_debug("carla_get_program_count(%i)", pluginId);
  1494. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1495. return plugin->getProgramCount();
  1496. carla_stderr2("carla_get_program_count(%i) - could not find plugin", pluginId);
  1497. return 0;
  1498. }
  1499. uint32_t carla_get_midi_program_count(uint pluginId)
  1500. {
  1501. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);
  1502. carla_debug("carla_get_midi_program_count(%i)", pluginId);
  1503. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1504. return plugin->getMidiProgramCount();
  1505. carla_stderr2("carla_get_midi_program_count(%i) - could not find plugin", pluginId);
  1506. return 0;
  1507. }
  1508. uint32_t carla_get_custom_data_count(uint pluginId)
  1509. {
  1510. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);
  1511. carla_debug("carla_get_custom_data_count(%i)", pluginId);
  1512. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1513. return plugin->getCustomDataCount();
  1514. carla_stderr2("carla_get_custom_data_count(%i) - could not find plugin", pluginId);
  1515. return 0;
  1516. }
  1517. // -------------------------------------------------------------------------------------------------------------------
  1518. const char* carla_get_parameter_text(uint pluginId, uint32_t parameterId)
  1519. {
  1520. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);
  1521. carla_debug("carla_get_parameter_text(%i, %i)", pluginId, parameterId);
  1522. static char textBuf[STR_MAX+1];
  1523. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1524. {
  1525. if (parameterId < plugin->getParameterCount())
  1526. {
  1527. carla_zeroChar(textBuf, STR_MAX+1);
  1528. plugin->getParameterText(parameterId, textBuf);
  1529. return textBuf;
  1530. }
  1531. carla_stderr2("carla_get_parameter_text(%i, %i) - parameterId out of bounds", pluginId, parameterId);
  1532. return nullptr;
  1533. }
  1534. carla_stderr2("carla_get_parameter_text(%i, %i) - could not find plugin", pluginId, parameterId);
  1535. return nullptr;
  1536. }
  1537. const char* carla_get_program_name(uint pluginId, uint32_t programId)
  1538. {
  1539. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);
  1540. carla_debug("carla_get_program_name(%i, %i)", pluginId, programId);
  1541. static char programName[STR_MAX+1];
  1542. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1543. {
  1544. if (programId < plugin->getProgramCount())
  1545. {
  1546. carla_zeroChar(programName, STR_MAX+1);
  1547. plugin->getProgramName(programId, programName);
  1548. return programName;
  1549. }
  1550. carla_stderr2("carla_get_program_name(%i, %i) - programId out of bounds", pluginId, programId);
  1551. return nullptr;
  1552. }
  1553. carla_stderr2("carla_get_program_name(%i, %i) - could not find plugin", pluginId, programId);
  1554. return nullptr;
  1555. }
  1556. const char* carla_get_midi_program_name(uint pluginId, uint32_t midiProgramId)
  1557. {
  1558. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);
  1559. carla_debug("carla_get_midi_program_name(%i, %i)", pluginId, midiProgramId);
  1560. static char midiProgramName[STR_MAX+1];
  1561. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1562. {
  1563. if (midiProgramId < plugin->getMidiProgramCount())
  1564. {
  1565. carla_zeroChar(midiProgramName, STR_MAX+1);
  1566. plugin->getMidiProgramName(midiProgramId, midiProgramName);
  1567. return midiProgramName;
  1568. }
  1569. carla_stderr2("carla_get_midi_program_name(%i, %i) - midiProgramId out of bounds", pluginId, midiProgramId);
  1570. return nullptr;
  1571. }
  1572. carla_stderr2("carla_get_midi_program_name(%i, %i) - could not find plugin", pluginId, midiProgramId);
  1573. return nullptr;
  1574. }
  1575. const char* carla_get_real_plugin_name(uint pluginId)
  1576. {
  1577. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);
  1578. carla_debug("carla_get_real_plugin_name(%i)", pluginId);
  1579. static char realPluginName[STR_MAX+1];
  1580. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1581. {
  1582. carla_zeroChar(realPluginName, STR_MAX+1);
  1583. plugin->getRealName(realPluginName);
  1584. return realPluginName;
  1585. }
  1586. carla_stderr2("carla_get_real_plugin_name(%i) - could not find plugin", pluginId);
  1587. return nullptr;
  1588. }
  1589. // -------------------------------------------------------------------------------------------------------------------
  1590. int32_t carla_get_current_program_index(uint pluginId)
  1591. {
  1592. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, -1);
  1593. carla_debug("carla_get_current_program_index(%i)", pluginId);
  1594. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1595. return plugin->getCurrentProgram();
  1596. carla_stderr2("carla_get_current_program_index(%i) - could not find plugin", pluginId);
  1597. return -1;
  1598. }
  1599. int32_t carla_get_current_midi_program_index(uint pluginId)
  1600. {
  1601. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, -1);
  1602. carla_debug("carla_get_current_midi_program_index(%i)", pluginId);
  1603. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1604. return plugin->getCurrentMidiProgram();
  1605. carla_stderr2("carla_get_current_midi_program_index(%i) - could not find plugin", pluginId);
  1606. return -1;
  1607. }
  1608. // -------------------------------------------------------------------------------------------------------------------
  1609. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)
  1610. {
  1611. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);
  1612. carla_debug("carla_get_default_parameter_value(%i, %i)", pluginId, parameterId);
  1613. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1614. {
  1615. if (parameterId < plugin->getParameterCount())
  1616. return plugin->getParameterRanges(parameterId).def;
  1617. carla_stderr2("carla_get_default_parameter_value(%i, %i) - parameterId out of bounds", pluginId, parameterId);
  1618. return 0.0f;
  1619. }
  1620. carla_stderr2("carla_get_default_parameter_value(%i, %i) - could not find plugin", pluginId, parameterId);
  1621. return 0.0f;
  1622. }
  1623. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)
  1624. {
  1625. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);
  1626. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1627. {
  1628. if (parameterId < plugin->getParameterCount())
  1629. return plugin->getParameterValue(parameterId);
  1630. carla_stderr2("carla_get_current_parameter_value(%i, %i) - parameterId out of bounds", pluginId, parameterId);
  1631. return 0.0f;
  1632. }
  1633. carla_stderr2("carla_get_current_parameter_value(%i, %i) - could not find plugin", pluginId, parameterId);
  1634. return 0.0f;
  1635. }
  1636. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)
  1637. {
  1638. #ifdef BUILD_BRIDGE
  1639. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);
  1640. #else
  1641. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, (parameterId == CB::PARAMETER_CTRL_CHANNEL) ? -1.0f : 0.0f);
  1642. #endif
  1643. CARLA_SAFE_ASSERT_RETURN(parameterId != CB::PARAMETER_NULL && parameterId > CB::PARAMETER_MAX, 0.0f);
  1644. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1645. return plugin->getInternalParameterValue(parameterId);
  1646. carla_stderr2("carla_get_internal_parameter_value(%i, %i) - could not find plugin", pluginId, parameterId);
  1647. return 0.0f;
  1648. }
  1649. // -------------------------------------------------------------------------------------------------------------------
  1650. float carla_get_input_peak_value(uint pluginId, bool isLeft)
  1651. {
  1652. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);
  1653. return gStandalone.engine->getInputPeak(pluginId, isLeft);
  1654. }
  1655. float carla_get_output_peak_value(uint pluginId, bool isLeft)
  1656. {
  1657. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);
  1658. return gStandalone.engine->getOutputPeak(pluginId, isLeft);
  1659. }
  1660. // -------------------------------------------------------------------------------------------------------------------
  1661. void carla_set_active(uint pluginId, bool onOff)
  1662. {
  1663. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1664. carla_debug("carla_set_active(%i, %s)", pluginId, bool2str(onOff));
  1665. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1666. return plugin->setActive(onOff, true, false);
  1667. carla_stderr2("carla_set_active(%i, %s) - could not find plugin", pluginId, bool2str(onOff));
  1668. }
  1669. #ifndef BUILD_BRIDGE
  1670. void carla_set_drywet(uint pluginId, float value)
  1671. {
  1672. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1673. carla_debug("carla_set_drywet(%i, %f)", pluginId, value);
  1674. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1675. return plugin->setDryWet(value, true, false);
  1676. carla_stderr2("carla_set_drywet(%i, %f) - could not find plugin", pluginId, value);
  1677. }
  1678. void carla_set_volume(uint pluginId, float value)
  1679. {
  1680. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1681. carla_debug("carla_set_volume(%i, %f)", pluginId, value);
  1682. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1683. return plugin->setVolume(value, true, false);
  1684. carla_stderr2("carla_set_volume(%i, %f) - could not find plugin", pluginId, value);
  1685. }
  1686. void carla_set_balance_left(uint pluginId, float value)
  1687. {
  1688. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1689. carla_debug("carla_set_balance_left(%i, %f)", pluginId, value);
  1690. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1691. return plugin->setBalanceLeft(value, true, false);
  1692. carla_stderr2("carla_set_balance_left(%i, %f) - could not find plugin", pluginId, value);
  1693. }
  1694. void carla_set_balance_right(uint pluginId, float value)
  1695. {
  1696. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1697. carla_debug("carla_set_balance_right(%i, %f)", pluginId, value);
  1698. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1699. return plugin->setBalanceRight(value, true, false);
  1700. carla_stderr2("carla_set_balance_right(%i, %f) - could not find plugin", pluginId, value);
  1701. }
  1702. void carla_set_panning(uint pluginId, float value)
  1703. {
  1704. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1705. carla_debug("carla_set_panning(%i, %f)", pluginId, value);
  1706. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1707. return plugin->setPanning(value, true, false);
  1708. carla_stderr2("carla_set_panning(%i, %f) - could not find plugin", pluginId, value);
  1709. }
  1710. void carla_set_ctrl_channel(uint pluginId, int8_t channel)
  1711. {
  1712. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1713. CARLA_SAFE_ASSERT_RETURN(channel >= -1 && channel < MAX_MIDI_CHANNELS,);
  1714. carla_debug("carla_set_ctrl_channel(%i, %i)", pluginId, channel);
  1715. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1716. return plugin->setCtrlChannel(channel, true, false);
  1717. carla_stderr2("carla_set_ctrl_channel(%i, %i) - could not find plugin", pluginId, channel);
  1718. }
  1719. void carla_set_option(uint pluginId, uint option, bool yesNo)
  1720. {
  1721. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1722. carla_debug("carla_set_option(%i, %i, %s)", pluginId, option, bool2str(yesNo));
  1723. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1724. return plugin->setOption(option, yesNo, false);
  1725. carla_stderr2("carla_set_option(%i, %i, %s) - could not find plugin", pluginId, option, bool2str(yesNo));
  1726. }
  1727. #endif
  1728. // -------------------------------------------------------------------------------------------------------------------
  1729. void carla_set_parameter_value(uint pluginId, uint32_t parameterId, float value)
  1730. {
  1731. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1732. carla_debug("carla_set_parameter_value(%i, %i, %f)", pluginId, parameterId, value);
  1733. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1734. {
  1735. if (parameterId < plugin->getParameterCount())
  1736. return plugin->setParameterValue(parameterId, value, true, true, false);
  1737. carla_stderr2("carla_set_parameter_value(%i, %i, %f) - parameterId out of bounds", pluginId, parameterId, value);
  1738. return;
  1739. }
  1740. carla_stderr2("carla_set_parameter_value(%i, %i, %f) - could not find plugin", pluginId, parameterId, value);
  1741. }
  1742. #ifndef BUILD_BRIDGE
  1743. void carla_set_parameter_midi_channel(uint pluginId, uint32_t parameterId, uint8_t channel)
  1744. {
  1745. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1746. CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);
  1747. carla_debug("carla_set_parameter_midi_channel(%i, %i, %i)", pluginId, parameterId, channel);
  1748. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1749. {
  1750. if (parameterId < plugin->getParameterCount())
  1751. return plugin->setParameterMidiChannel(parameterId, channel, true, false);
  1752. carla_stderr2("carla_set_parameter_midi_channel(%i, %i, %i) - parameterId out of bounds", pluginId, parameterId, channel);
  1753. return;
  1754. }
  1755. carla_stderr2("carla_set_parameter_midi_channel(%i, %i, %i) - could not find plugin", pluginId, parameterId, channel);
  1756. }
  1757. void carla_set_parameter_midi_cc(uint pluginId, uint32_t parameterId, int16_t cc)
  1758. {
  1759. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1760. CARLA_SAFE_ASSERT_RETURN(cc >= -1 && cc < MAX_MIDI_CONTROL,);
  1761. carla_debug("carla_set_parameter_midi_cc(%i, %i, %i)", pluginId, parameterId, cc);
  1762. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1763. {
  1764. if (parameterId < plugin->getParameterCount())
  1765. return plugin->setParameterMidiCC(parameterId, cc, true, false);
  1766. carla_stderr2("carla_set_parameter_midi_cc(%i, %i, %i) - parameterId out of bounds", pluginId, parameterId, cc);
  1767. return;
  1768. }
  1769. carla_stderr2("carla_set_parameter_midi_cc(%i, %i, %i) - could not find plugin", pluginId, parameterId, cc);
  1770. }
  1771. #endif
  1772. // -------------------------------------------------------------------------------------------------------------------
  1773. void carla_set_program(uint pluginId, uint32_t programId)
  1774. {
  1775. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1776. carla_debug("carla_set_program(%i, %i)", pluginId, programId);
  1777. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1778. {
  1779. if (programId < plugin->getProgramCount())
  1780. return plugin->setProgram(static_cast<int32_t>(programId), true, true, false);
  1781. carla_stderr2("carla_set_program(%i, %i) - programId out of bounds", pluginId, programId);
  1782. return;
  1783. }
  1784. carla_stderr2("carla_set_program(%i, %i) - could not find plugin", pluginId, programId);
  1785. }
  1786. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)
  1787. {
  1788. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1789. carla_debug("carla_set_midi_program(%i, %i)", pluginId, midiProgramId);
  1790. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1791. {
  1792. if (midiProgramId < plugin->getMidiProgramCount())
  1793. return plugin->setMidiProgram(static_cast<int32_t>(midiProgramId), true, true, false);
  1794. carla_stderr2("carla_set_midi_program(%i, %i) - midiProgramId out of bounds", pluginId, midiProgramId);
  1795. return;
  1796. }
  1797. carla_stderr2("carla_set_midi_program(%i, %i) - could not find plugin", pluginId, midiProgramId);
  1798. }
  1799. // -------------------------------------------------------------------------------------------------------------------
  1800. void carla_set_custom_data(uint pluginId, const char* type, const char* key, const char* value)
  1801. {
  1802. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1803. CARLA_SAFE_ASSERT_RETURN(type != nullptr && type[0] != '\0',);
  1804. CARLA_SAFE_ASSERT_RETURN(key != nullptr && key[0] != '\0',);
  1805. CARLA_SAFE_ASSERT_RETURN(value != nullptr,);
  1806. carla_debug("carla_set_custom_data(%i, \"%s\", \"%s\", \"%s\")", pluginId, type, key, value);
  1807. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1808. return plugin->setCustomData(type, key, value, true);
  1809. carla_stderr2("carla_set_custom_data(%i, \"%s\", \"%s\", \"%s\") - could not find plugin", pluginId, type, key, value);
  1810. }
  1811. void carla_set_chunk_data(uint pluginId, const char* chunkData)
  1812. {
  1813. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1814. CARLA_SAFE_ASSERT_RETURN(chunkData != nullptr && chunkData[0] != '\0',);
  1815. carla_debug("carla_set_chunk_data(%i, \"%s\")", pluginId, chunkData);
  1816. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1817. {
  1818. if (plugin->getOptionsEnabled() & CB::PLUGIN_OPTION_USE_CHUNKS)
  1819. {
  1820. std::vector<uint8_t> chunk(carla_getChunkFromBase64String(chunkData));
  1821. return plugin->setChunkData(chunk.data(), chunk.size());
  1822. }
  1823. carla_stderr2("carla_set_chunk_data(%i, \"%s\") - plugin does not use chunks", pluginId, chunkData);
  1824. return;
  1825. }
  1826. carla_stderr2("carla_set_chunk_data(%i, \"%s\") - could not find plugin", pluginId, chunkData);
  1827. }
  1828. // -------------------------------------------------------------------------------------------------------------------
  1829. void carla_prepare_for_save(uint pluginId)
  1830. {
  1831. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1832. carla_debug("carla_prepare_for_save(%i)", pluginId);
  1833. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1834. return plugin->prepareForSave();
  1835. carla_stderr2("carla_prepare_for_save(%i) - could not find plugin", pluginId);
  1836. }
  1837. void carla_reset_parameters(uint pluginId)
  1838. {
  1839. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1840. carla_debug("carla_reset_parameters(%i)", pluginId);
  1841. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1842. return plugin->resetParameters();
  1843. carla_stderr2("carla_reset_parameters(%i) - could not find plugin", pluginId);
  1844. }
  1845. void carla_randomize_parameters(uint pluginId)
  1846. {
  1847. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1848. carla_debug("carla_randomize_parameters(%i)", pluginId);
  1849. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1850. return plugin->randomizeParameters();
  1851. carla_stderr2("carla_randomize_parameters(%i) - could not find plugin", pluginId);
  1852. }
  1853. #ifndef BUILD_BRIDGE
  1854. void carla_send_midi_note(uint pluginId, uint8_t channel, uint8_t note, uint8_t velocity)
  1855. {
  1856. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);
  1857. carla_debug("carla_send_midi_note(%i, %i, %i, %i)", pluginId, channel, note, velocity);
  1858. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1859. return plugin->sendMidiSingleNote(channel, note, velocity, true, true, false);
  1860. carla_stderr2("carla_send_midi_note(%i, %i, %i, %i) - could not find plugin", pluginId, channel, note, velocity);
  1861. }
  1862. #endif
  1863. void carla_show_custom_ui(uint pluginId, bool yesNo)
  1864. {
  1865. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);
  1866. carla_debug("carla_show_custom_ui(%i, %s)", pluginId, bool2str(yesNo));
  1867. if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))
  1868. return plugin->showCustomUI(yesNo);
  1869. carla_stderr2("carla_show_custom_ui(%i, %s) - could not find plugin", pluginId, bool2str(yesNo));
  1870. }
  1871. // -------------------------------------------------------------------------------------------------------------------
  1872. uint32_t carla_get_buffer_size()
  1873. {
  1874. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);
  1875. carla_debug("carla_get_buffer_size()");
  1876. return gStandalone.engine->getBufferSize();
  1877. }
  1878. double carla_get_sample_rate()
  1879. {
  1880. CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0);
  1881. carla_debug("carla_get_sample_rate()");
  1882. return gStandalone.engine->getSampleRate();
  1883. }
  1884. // -------------------------------------------------------------------------------------------------------------------
  1885. const char* carla_get_last_error()
  1886. {
  1887. carla_debug("carla_get_last_error()");
  1888. if (gStandalone.engine != nullptr)
  1889. return gStandalone.engine->getLastError();
  1890. return gStandalone.lastError;
  1891. }
  1892. const char* carla_get_host_osc_url_tcp()
  1893. {
  1894. carla_debug("carla_get_host_osc_url_tcp()");
  1895. #ifdef HAVE_LIBLO
  1896. if (gStandalone.engine == nullptr)
  1897. {
  1898. carla_stderr2("Engine is not running");
  1899. gStandalone.lastError = "Engine is not running";
  1900. return nullptr;
  1901. }
  1902. return gStandalone.engine->getOscServerPathTCP();
  1903. #else
  1904. return nullptr;
  1905. #endif
  1906. }
  1907. const char* carla_get_host_osc_url_udp()
  1908. {
  1909. carla_debug("carla_get_host_osc_url_udp()");
  1910. #ifdef HAVE_LIBLO
  1911. if (gStandalone.engine == nullptr)
  1912. {
  1913. carla_stderr2("Engine is not running");
  1914. gStandalone.lastError = "Engine is not running";
  1915. return nullptr;
  1916. }
  1917. return gStandalone.engine->getOscServerPathUDP();
  1918. #else
  1919. return nullptr;
  1920. #endif
  1921. }
  1922. // -------------------------------------------------------------------------------------------------------------------
  1923. bool carla_nsm_init(int pid, const char* executableName)
  1924. {
  1925. #ifdef HAVE_LIBLO
  1926. return CarlaNSM::getInstance().announce(pid, executableName);
  1927. #else
  1928. return false;
  1929. // unused
  1930. (void)pid; (void)executableName;
  1931. #endif
  1932. }
  1933. void carla_nsm_ready()
  1934. {
  1935. #ifdef HAVE_LIBLO
  1936. CarlaNSM::getInstance().start();
  1937. #endif
  1938. }
  1939. // -------------------------------------------------------------------------------------------------------------------
  1940. #include "CarlaPluginUI.cpp"
  1941. #include "CarlaDssiUtils.cpp"
  1942. #include "CarlaPatchbayUtils.cpp"
  1943. #include "CarlaPipeUtils.cpp"
  1944. #include "CarlaStateUtils.cpp"
  1945. #include "CarlaJuceEvents.cpp"
  1946. // -------------------------------------------------------------------------------------------------------------------