falkTX
/
Carla
mirror of https://github.com/falkTX/Carla
1
0
Fork 0
Code Releases 43 Activity
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.
2706 Commits
17 Branches
116MB
Tree: 1ce3132801
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '1ce3132801'
${ noResults }
Carla/source/backend/CarlaStandalone.cpp

2290 lines
81KB
Raw Blame History 

  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. 

  18. // TODO:

  19. // Check carla_stderr2("Engine is not running"); <= prepend func name and args

  20. 

  21. #include "CarlaHost.h"

  22. #include "CarlaMIDI.h"

  23. 

  24. #include "CarlaEngine.hpp"

  25. #include "CarlaPlugin.hpp"

  26. 

  27. #include "CarlaBackendUtils.hpp"

  28. #include "CarlaBase64Utils.hpp"

  29. 

  30. #ifdef HAVE_LIBLO

  31. # include "CarlaOscUtils.hpp"

  32. #endif

  33. 

  34. #include "juce_audio_formats.h"

  35. 

  36. #if defined(CARLA_OS_MAC) || defined(CARLA_OS_WIN)

  37. # include "juce_gui_basics.h"

  38. #else

  39. namespace juce {

  40. # include "juce_events/messages/juce_Initialisation.h"

  41. } // namespace juce

  42. #endif

  43. 

  44. namespace CB = CarlaBackend;

  45. using CB::EngineOptions;

  46. 

  47. // -------------------------------------------------------------------------------------------------------------------

  48. // Single, standalone engine

  49. 

  50. struct CarlaBackendStandalone {

  51.     CarlaEngine*       engine;

  52.     EngineCallbackFunc engineCallback;

  53.     void*              engineCallbackPtr;

  54. #ifndef BUILD_BRIDGE

  55.     EngineOptions      engineOptions;

  56. #endif

  57. 

  58.     FileCallbackFunc fileCallback;

  59.     void*            fileCallbackPtr;

  60. 

  61.     CarlaString lastError;

  62. 

  63.     CarlaBackendStandalone() noexcept

  64.         : engine(nullptr),

  65.           engineCallback(nullptr),

  66.           engineCallbackPtr(nullptr),

  67. #ifndef BUILD_BRIDGE

  68.           engineOptions(),

  69. #endif

  70.           fileCallback(nullptr),

  71.           fileCallbackPtr(nullptr),

  72.           lastError() {}

  73. 

  74.     ~CarlaBackendStandalone() noexcept

  75.     {

  76.         CARLA_SAFE_ASSERT(engine == nullptr);

  77.     }

  78. 

  79.     CARLA_PREVENT_HEAP_ALLOCATION

  80.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  81. };

  82. 

  83. static CarlaBackendStandalone gStandalone;

  84. 

  85. #ifdef HAVE_LIBLO

  86. // -------------------------------------------------------------------------------------------------------------------

  87. // NSM support

  88. 

  89. #define NSM_API_VERSION_MAJOR 1

  90. #define NSM_API_VERSION_MINOR 2

  91. 

  92. #define NSM_CLIENT_FEATURES ":switch:"

  93. //#define NSM_CLIENT_FEATURES ":switch:optional-gui:"

  94. 

  95. class CarlaNSM

  96. {

  97. public:

  98.     CarlaNSM() noexcept

  99.         : fOscAddress(nullptr),

  100.           fOscServer(nullptr),

  101.           fOscServerThread(nullptr),

  102.           fProjectPath(),

  103.           fHasBroadcast(false),

  104.           fHasOptionalGui(false),

  105.           fHasServerControl(false),

  106.           fStarted() {}

  107. 

  108.     ~CarlaNSM()

  109.     {

  110.         if (fOscServerThread != nullptr)

  111.         {

  112.             lo_server_thread_stop(fOscServerThread);

  113.             lo_server_thread_free(fOscServerThread);

  114.             fOscServerThread = nullptr;

  115.             fOscServer = nullptr;

  116.         }

  117. 

  118.         if (fOscAddress != nullptr)

  119.         {

  120.             lo_address_free(fOscAddress);

  121.             fOscAddress = nullptr;

  122.         }

  123.     }

  124. 

  125.     bool announce(const int pid, const char* const executableName)

  126.     {

  127.         CARLA_SAFE_ASSERT_RETURN(pid != 0, false);

  128.         CARLA_SAFE_ASSERT_RETURN(executableName != nullptr && executableName[0] != '\0', false);

  129. 

  130.         const char* const NSM_URL(std::getenv("NSM_URL"));

  131. 

  132.         if (NSM_URL == nullptr)

  133.             return false;

  134. 

  135.         const lo_address addr = lo_address_new_from_url(NSM_URL);

  136.         CARLA_SAFE_ASSERT_RETURN(addr != nullptr, false);

  137. 

  138.         const int proto = lo_address_get_protocol(addr);

  139. 

  140.         if (fOscServerThread == nullptr)

  141.         {

  142.             // create new OSC server

  143.             fOscServerThread = lo_server_thread_new_with_proto(nullptr, proto, _osc_error_handler);

  144.             CARLA_SAFE_ASSERT_RETURN(fOscServerThread != nullptr, false);

  145. 

  146.             // register message handlers

  147.             lo_server_thread_add_method(fOscServerThread, "/error",                       "sis",    _error_handler,     this);

  148.             lo_server_thread_add_method(fOscServerThread, "/reply",                       "ssss",   _reply_handler,     this);

  149.             lo_server_thread_add_method(fOscServerThread, "/nsm/client/open",             "sss",    _open_handler,      this);

  150.             lo_server_thread_add_method(fOscServerThread, "/nsm/client/save",              "",      _save_handler,      this);

  151.             lo_server_thread_add_method(fOscServerThread, "/nsm/client/session_is_loaded", "",      _loaded_handler,    this);

  152.             lo_server_thread_add_method(fOscServerThread, "/nsm/client/show_optional_gui", "",      _show_gui_handler,  this);

  153.             lo_server_thread_add_method(fOscServerThread, "/nsm/client/hide_optional_gui", "",      _hide_gui_handler,  this);

  154.             lo_server_thread_add_method(fOscServerThread, nullptr,                         nullptr, _broadcast_handler, this);

  155. 

  156.             fOscServer = lo_server_thread_get_server(fOscServerThread);

  157.         }

  158. 

  159. #ifndef BUILD_ANSI_TEST

  160.         lo_send_from(addr, fOscServer, LO_TT_IMMEDIATE, "/nsm/server/announce", "sssiii",

  161.                      "Carla", NSM_CLIENT_FEATURES, executableName, NSM_API_VERSION_MAJOR, NSM_API_VERSION_MINOR, pid);

  162. #endif

  163. 

  164.         lo_address_free(addr);

  165. 

  166.         return true;

  167.     }

  168. 

  169.     void start()

  170.     {

  171.         CARLA_SAFE_ASSERT_RETURN(fOscServerThread != nullptr,);

  172.         CARLA_SAFE_ASSERT_RETURN(! fStarted,);

  173. 

  174.         fStarted = true;

  175.         lo_server_thread_start(fOscServerThread);

  176.     }

  177. 

  178.     static CarlaNSM& getInstance()

  179.     {

  180.         static CarlaNSM sInstance;

  181.         return sInstance;

  182.     }

  183. 

  184. protected:

  185.     int handleError(const char* const method, const int code, const char* const message)

  186.     {

  187.         carla_stdout("CarlaNSM::handleError(\"%s\", %i, \"%s\")", method, code, message);

  188. 

  189.         if (gStandalone.engineCallback != nullptr)

  190.             gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 0, code, 0.0f, message);

  191. 

  192.         return 1;

  193. 

  194.         // may be unused

  195.         (void)method;

  196.     }

  197. 

  198.     int handleReply(const char* const method, const char* const message, const char* const smName, const char* const features,

  199.                     const lo_message msg)

  200.     {

  201.         CARLA_SAFE_ASSERT_RETURN(fOscServerThread != nullptr, 1);

  202.         carla_stdout("CarlaNSM::handleReply(\"%s\", \"%s\", \"%s\", \"%s\")", method, message, smName, features);

  203. 

  204.         if (std::strcmp(method, "/nsm/server/announce") == 0)

  205.         {

  206.             char* const addressURL(lo_address_get_url(lo_message_get_source(msg)));

  207.             CARLA_SAFE_ASSERT_RETURN(addressURL != nullptr, 0);

  208. 

  209.             if (fOscAddress != nullptr)

  210.                 lo_address_free(fOscAddress);

  211. 

  212.             fOscAddress = lo_address_new_from_url(addressURL);

  213.             CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 0);

  214. 

  215.             fHasBroadcast     = std::strstr(features, ":broadcast:")      != nullptr;

  216.             fHasOptionalGui   = std::strstr(features, ":optional-gui:")   != nullptr;

  217.             fHasServerControl = std::strstr(features, ":server_control:") != nullptr;

  218. 

  219.             carla_stdout("Carla started via '%s', message: %s", smName, message);

  220. 

  221.             if (gStandalone.engineCallback != nullptr)

  222.                 gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 1, 0, 0.0f, smName);

  223. 

  224.             // UI starts visible

  225.             lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/nsm/client/gui_is_shown", "");

  226.         }

  227.         else

  228.         {

  229.             carla_stdout("Got unknown NSM reply method '%s'", method);

  230.         }

  231. 

  232.         return 0;

  233.     }

  234. 

  235.     int handleOpen(const char* const projectPath, const char* const displayName, const char* const clientNameId)

  236.     {

  237.         CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);

  238.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);

  239.         carla_stdout("CarlaNSM::handleOpen(\"%s\", \"%s\", \"%s\")", projectPath, displayName, clientNameId);

  240. 

  241.         if (carla_is_engine_running())

  242.             carla_engine_close();

  243. 

  244.         carla_engine_init("JACK", clientNameId);

  245. 

  246.         fProjectPath  = projectPath;

  247.         fProjectPath += ".carxp";

  248. 

  249.         using namespace juce;

  250. 

  251.         const String jfilename = String(CharPointer_UTF8(fProjectPath));

  252. 

  253.         if (File(jfilename).existsAsFile())

  254.             carla_load_project(fProjectPath);

  255. 

  256.         lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/reply", "ss", "/nsm/client/open", "OK");

  257. 

  258.         if (gStandalone.engineCallback != nullptr)

  259.             gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 2, 0, 0.0f, projectPath);

  260. 

  261.         return 0;

  262.     }

  263. 

  264.     int handleSave()

  265.     {

  266.         CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);

  267.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);

  268.         CARLA_SAFE_ASSERT_RETURN(fProjectPath.isNotEmpty(), 0);

  269.         carla_stdout("CarlaNSM::handleSave()");

  270. 

  271.         carla_save_project(fProjectPath);

  272. 

  273.         lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/reply", "ss", "/nsm/client/save", "OK");

  274. 

  275.         if (gStandalone.engineCallback != nullptr)

  276.             gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 3, 0, 0.0f, nullptr);

  277. 

  278.         return 0;

  279.     }

  280. 

  281.     int handleSessionIsLoaded()

  282.     {

  283.         CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);

  284.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);

  285.         carla_stdout("CarlaNSM::handleSessionIsLoaded()");

  286. 

  287.         if (gStandalone.engineCallback != nullptr)

  288.             gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 4, 0, 0.0f, nullptr);

  289. 

  290.         return 0;

  291.     }

  292. 

  293.     int handleShowOptionalGui()

  294.     {

  295.         CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);

  296.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);

  297.         carla_stdout("CarlaNSM::handleShowOptionalGui()");

  298. 

  299.         lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/nsm/client/gui_is_shown", "");

  300. 

  301.         if (gStandalone.engineCallback != nullptr)

  302.             gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 5, 0, 0.0f, nullptr);

  303. 

  304.         return 0;

  305.     }

  306. 

  307.     int handleHideOptionalGui()

  308.     {

  309.         CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);

  310.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);

  311.         carla_stdout("CarlaNSM::handleHideOptionalGui()");

  312. 

  313.         lo_send_from(fOscAddress, fOscServer, LO_TT_IMMEDIATE, "/nsm/client/gui_is_hidden", "");

  314. 

  315.         if (gStandalone.engineCallback != nullptr)

  316.             gStandalone.engineCallback(gStandalone.engineCallbackPtr, CB::ENGINE_CALLBACK_NSM, 0, 6, 0, 0.0f, nullptr);

  317. 

  318.         return 0;

  319.     }

  320. 

  321.     int handleBroadcast(const char* const types, lo_arg** const argv, const int argc)

  322.     {

  323.         CARLA_SAFE_ASSERT_RETURN(fOscAddress != nullptr, 1);

  324.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 1);

  325.         carla_stdout("CarlaNSM::handleBroadcast(%s, %p, %i)", types, argv, argc);

  326. 

  327.         // TODO

  328. 

  329.         return 0;

  330.     }

  331. 

  332. private:

  333.     lo_address       fOscAddress;

  334.     lo_server        fOscServer;

  335.     lo_server_thread fOscServerThread;

  336.     CarlaString      fProjectPath;

  337. 

  338.     bool fHasBroadcast;

  339.     bool fHasOptionalGui;

  340.     bool fHasServerControl;

  341.     bool fStarted;

  342. 

  343.     #define handlePtr ((CarlaNSM*)data)

  344. 

  345.     static void _osc_error_handler(int num, const char* msg, const char* path)

  346.     {

  347.         carla_stderr2("CarlaNSM::_osc_error_handler(%i, \"%s\", \"%s\")", num, msg, path);

  348.     }

  349. 

  350.     static int _error_handler(const char*, const char* types, lo_arg** argv, int argc, lo_message, void* data)

  351.     {

  352.         CARLA_SAFE_ASSERT_RETURN(argc == 3, 1);

  353.         CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "sis") == 0, 1);

  354. 

  355.         const char* const method  = &argv[0]->s;

  356.         const int         code    =  argv[1]->i;

  357.         const char* const message = &argv[2]->s;

  358. 

  359.         return handlePtr->handleError(method, code, message);

  360.     }

  361. 

  362.     static int _reply_handler(const char*, const char* types, lo_arg** argv, int argc, lo_message msg, void* data)

  363.     {

  364.         CARLA_SAFE_ASSERT_RETURN(argc == 4, 1);

  365.         CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "ssss") == 0, 1);

  366. 

  367.         const char* const method   = &argv[0]->s;

  368.         const char* const message  = &argv[1]->s;

  369.         const char* const smName   = &argv[2]->s;

  370.         const char* const features = &argv[3]->s;

  371. 

  372.         return handlePtr->handleReply(method, message, smName, features, msg);

  373.     }

  374. 

  375.     static int _open_handler(const char*, const char* types, lo_arg** argv, int argc, lo_message, void* data)

  376.     {

  377.         CARLA_SAFE_ASSERT_RETURN(argc == 3, 1);

  378.         CARLA_SAFE_ASSERT_RETURN(std::strcmp(types, "sss") == 0, 1);

  379. 

  380.         const char* const projectPath  = &argv[0]->s;

  381.         const char* const displayName  = &argv[1]->s;

  382.         const char* const clientNameId = &argv[2]->s;

  383. 

  384.         return handlePtr->handleOpen(projectPath, displayName, clientNameId);

  385.     }

  386. 

  387.     static int _save_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)

  388.     {

  389.         CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);

  390. 

  391.         return handlePtr->handleSave();

  392.     }

  393. 

  394.     static int _loaded_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)

  395.     {

  396.         CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);

  397. 

  398.         return handlePtr->handleSessionIsLoaded();

  399.     }

  400. 

  401.     static int _show_gui_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)

  402.     {

  403.         CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);

  404. 

  405.         return handlePtr->handleShowOptionalGui();

  406.     }

  407. 

  408.     static int _hide_gui_handler(const char*, const char*, lo_arg**, int argc, lo_message, void* data)

  409.     {

  410.         CARLA_SAFE_ASSERT_RETURN(argc == 0, 1);

  411. 

  412.         return handlePtr->handleHideOptionalGui();

  413.     }

  414. 

  415.     static int _broadcast_handler(const char* path, const char* types, lo_arg** argv, int argc, lo_message, void* data)

  416.     {

  417.         return handlePtr->handleBroadcast(types, argv, argc);

  418.     }

  419. 

  420.     #undef handlePtr

  421. 

  422.     CARLA_PREVENT_HEAP_ALLOCATION

  423.     CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)

  424. };

  425. 

  426. #endif // HAVE_LIBLO

  427. 

  428. // -------------------------------------------------------------------------------------------------------------------

  429. // API

  430. 

  431. #define CARLA_COMMON_NEED_CHECKSTRINGPTR

  432. #include "CarlaHostCommon.cpp"

  433. 

  434. // -------------------------------------------------------------------------------------------------------------------

  435. 

  436. uint carla_get_engine_driver_count()

  437. {

  438.     carla_debug("carla_get_engine_driver_count()");

  439. 

  440.     return CarlaEngine::getDriverCount();

  441. }

  442. 

  443. const char* carla_get_engine_driver_name(uint index)

  444. {

  445.     carla_debug("carla_get_engine_driver_name(%i)", index);

  446. 

  447.     return CarlaEngine::getDriverName(index);

  448. }

  449. 

  450. const char* const* carla_get_engine_driver_device_names(uint index)

  451. {

  452.     carla_debug("carla_get_engine_driver_device_names(%i)", index);

  453. 

  454.     return CarlaEngine::getDriverDeviceNames(index);

  455. }

  456. 

  457. const EngineDriverDeviceInfo* carla_get_engine_driver_device_info(uint index, const char* name)

  458. {

  459.     CARLA_SAFE_ASSERT_RETURN(name != nullptr && name[0] != '\0', nullptr);

  460.     carla_debug("carla_get_engine_driver_device_info(%i, \"%s\")", index, name);

  461. 

  462.     if (const EngineDriverDeviceInfo* const ret = CarlaEngine::getDriverDeviceInfo(index, name))

  463.     {

  464.         static EngineDriverDeviceInfo devInfo;

  465.         static const uint32_t nullBufferSizes[] = { 0   };

  466.         static const double   nullSampleRates[] = { 0.0 };

  467. 

  468.         devInfo.hints       = ret->hints;

  469.         devInfo.bufferSizes = (ret->bufferSizes != nullptr) ? ret->bufferSizes : nullBufferSizes;

  470.         devInfo.sampleRates = (ret->sampleRates != nullptr) ? ret->sampleRates : nullSampleRates;

  471.         return &devInfo;

  472.     }

  473. 

  474.     return nullptr;

  475. }

  476. 

  477. // -------------------------------------------------------------------------------------------------------------------

  478. 

  479. CarlaEngine* carla_get_engine()

  480. {

  481.     carla_debug("carla_get_engine()");

  482. 

  483.     return gStandalone.engine;

  484. }

  485. 

  486. // -------------------------------------------------------------------------------------------------------------------

  487. 

  488. static void carla_engine_init_common()

  489. {

  490.     gStandalone.engine->setCallback(gStandalone.engineCallback, gStandalone.engineCallbackPtr);

  491.     gStandalone.engine->setFileCallback(gStandalone.fileCallback, gStandalone.fileCallbackPtr);

  492. 

  493. #ifdef BUILD_BRIDGE

  494.     using juce::File;

  495.     File juceBinaryDir(File::getSpecialLocation(File::currentExecutableFile).getParentDirectory());

  496. 

  497.     /*

  498.     if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_FORCE_STEREO"))

  499.         gStandalone.engine->setOption(CB::ENGINE_OPTION_FORCE_STEREO, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);

  500. 

  501.     if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_PREFER_PLUGIN_BRIDGES"))

  502.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);

  503. 

  504.     if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_PREFER_UI_BRIDGES"))

  505.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_UI_BRIDGES, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);

  506.     */

  507. 

  508.     if (const char* const uisAlwaysOnTop = std::getenv("ENGINE_OPTION_UIS_ALWAYS_ON_TOP"))

  509.         gStandalone.engine->setOption(CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP, (std::strcmp(uisAlwaysOnTop, "true") == 0) ? 1 : 0, nullptr);

  510. 

  511.     if (const char* const maxParameters = std::getenv("ENGINE_OPTION_MAX_PARAMETERS"))

  512.         gStandalone.engine->setOption(CB::ENGINE_OPTION_MAX_PARAMETERS,     std::atoi(maxParameters), nullptr);

  513. 

  514.     if (const char* const uiBridgesTimeout = std::getenv("ENGINE_OPTION_UI_BRIDGES_TIMEOUT"))

  515.         gStandalone.engine->setOption(CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT, std::atoi(uiBridgesTimeout), nullptr);

  516. 

  517.     if (const char* const pathLADSPA = std::getenv("ENGINE_OPTION_PLUGIN_PATH_LADSPA"))

  518.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_LADSPA, pathLADSPA);

  519. 

  520.     if (const char* const pathDSSI = std::getenv("ENGINE_OPTION_PLUGIN_PATH_DSSI"))

  521.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_DSSI, pathDSSI);

  522. 

  523.     if (const char* const pathLV2 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_LV2"))

  524.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_LV2, pathLV2);

  525. 

  526.     if (const char* const pathVST2 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_VST2"))

  527.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST2, pathVST2);

  528. 

  529.     if (const char* const pathVST3 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_VST3"))

  530.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST3, pathVST3);

  531. 

  532.     if (const char* const pathAU = std::getenv("ENGINE_OPTION_PLUGIN_PATH_AU"))

  533.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_AU, pathAU);

  534. 

  535.     if (const char* const pathGIG = std::getenv("ENGINE_OPTION_PLUGIN_PATH_GIG"))

  536.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_GIG, pathGIG);

  537. 

  538.     if (const char* const pathSF2 = std::getenv("ENGINE_OPTION_PLUGIN_PATH_SF2"))

  539.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_SF2, pathSF2);

  540. 

  541.     if (const char* const pathSFZ = std::getenv("ENGINE_OPTION_PLUGIN_PATH_SFZ"))

  542.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_SFZ, pathSFZ);

  543. 

  544.     if (const char* const binaryDir = std::getenv("ENGINE_OPTION_PATH_BINARIES"))

  545.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_BINARIES,   0, binaryDir);

  546.     else

  547.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_BINARIES,   0, juceBinaryDir.getFullPathName().toRawUTF8());

  548. 

  549.     if (const char* const resourceDir = std::getenv("ENGINE_OPTION_PATH_RESOURCES"))

  550.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_RESOURCES,  0, resourceDir);

  551.     else

  552.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_RESOURCES,  0, juceBinaryDir.getChildFile("resources").getFullPathName().toRawUTF8());

  553. 

  554.     if (const char* const preventBadBehaviour = std::getenv("ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR"))

  555.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR, (std::strcmp(preventBadBehaviour, "true") == 0) ? 1 : 0, nullptr);

  556. 

  557.     if (const char* const frontendWinId = std::getenv("ENGINE_OPTION_FRONTEND_WIN_ID"))

  558.         gStandalone.engine->setOption(CB::ENGINE_OPTION_FRONTEND_WIN_ID, 0, frontendWinId);

  559. #else

  560.     gStandalone.engine->setOption(CB::ENGINE_OPTION_FORCE_STEREO,          gStandalone.engineOptions.forceStereo         ? 1 : 0,        nullptr);

  561.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES, gStandalone.engineOptions.preferPluginBridges ? 1 : 0,        nullptr);

  562.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_UI_BRIDGES,     gStandalone.engineOptions.preferUiBridges     ? 1 : 0,        nullptr);

  563.     gStandalone.engine->setOption(CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP,     gStandalone.engineOptions.uisAlwaysOnTop      ? 1 : 0,        nullptr);

  564.     gStandalone.engine->setOption(CB::ENGINE_OPTION_MAX_PARAMETERS,        static_cast<int>(gStandalone.engineOptions.maxParameters),    nullptr);

  565.     gStandalone.engine->setOption(CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT,    static_cast<int>(gStandalone.engineOptions.uiBridgesTimeout), nullptr);

  566.     gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_NUM_PERIODS,     static_cast<int>(gStandalone.engineOptions.audioNumPeriods),  nullptr);

  567.     gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE,     static_cast<int>(gStandalone.engineOptions.audioBufferSize),  nullptr);

  568.     gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE,     static_cast<int>(gStandalone.engineOptions.audioSampleRate),  nullptr);

  569. 

  570.     if (gStandalone.engineOptions.audioDevice != nullptr)

  571.         gStandalone.engine->setOption(CB::ENGINE_OPTION_AUDIO_DEVICE,      0, gStandalone.engineOptions.audioDevice);

  572. 

  573.     if (gStandalone.engineOptions.pathLADSPA != nullptr)

  574.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_LADSPA, gStandalone.engineOptions.pathLADSPA);

  575. 

  576.     if (gStandalone.engineOptions.pathDSSI != nullptr)

  577.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_DSSI, gStandalone.engineOptions.pathDSSI);

  578. 

  579.     if (gStandalone.engineOptions.pathLV2 != nullptr)

  580.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_LV2, gStandalone.engineOptions.pathLV2);

  581. 

  582.     if (gStandalone.engineOptions.pathVST2 != nullptr)

  583.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_VST2, gStandalone.engineOptions.pathVST2);

  584. 

  585.     if (gStandalone.engineOptions.pathVST3 != nullptr)

  586.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_VST3, gStandalone.engineOptions.pathVST3);

  587. 

  588.     if (gStandalone.engineOptions.pathAU != nullptr)

  589.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_AU, gStandalone.engineOptions.pathAU);

  590. 

  591.     if (gStandalone.engineOptions.pathGIG != nullptr)

  592.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_GIG, gStandalone.engineOptions.pathGIG);

  593. 

  594.     if (gStandalone.engineOptions.pathSF2 != nullptr)

  595.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_SF2, gStandalone.engineOptions.pathSF2);

  596. 

  597.     if (gStandalone.engineOptions.pathSFZ != nullptr)

  598.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,       CB::PLUGIN_SFZ, gStandalone.engineOptions.pathSFZ);

  599. 

  600.     if (gStandalone.engineOptions.binaryDir != nullptr && gStandalone.engineOptions.binaryDir[0] != '\0')

  601.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_BINARIES,     0, gStandalone.engineOptions.binaryDir);

  602. 

  603.     if (gStandalone.engineOptions.resourceDir != nullptr && gStandalone.engineOptions.resourceDir[0] != '\0')

  604.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PATH_RESOURCES,    0, gStandalone.engineOptions.resourceDir);

  605. 

  606.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR,    gStandalone.engineOptions.preventBadBehaviour ? 1 : 0,  nullptr);

  607. 

  608.     if (gStandalone.engineOptions.frontendWinId != 0)

  609.     {

  610.         char strBuf[STR_MAX+1];

  611.         strBuf[STR_MAX] = '\0';

  612.         std::snprintf(strBuf, STR_MAX, P_UINTPTR, gStandalone.engineOptions.frontendWinId);

  613.         gStandalone.engine->setOption(CB::ENGINE_OPTION_FRONTEND_WIN_ID, 0, strBuf);

  614.     }

  615.     else

  616.         gStandalone.engine->setOption(CB::ENGINE_OPTION_FRONTEND_WIN_ID, 0, "0");

  617. #endif

  618. }

  619. 

  620. bool carla_engine_init(const char* driverName, const char* clientName)

  621. {

  622.     CARLA_SAFE_ASSERT_RETURN(driverName != nullptr && driverName[0] != '\0', false);

  623.     CARLA_SAFE_ASSERT_RETURN(clientName != nullptr && clientName[0] != '\0', false);

  624.     carla_debug("carla_engine_init(\"%s\", \"%s\")", driverName, clientName);

  625. 

  626.     if (gStandalone.engine != nullptr)

  627.     {

  628.         carla_stderr2("Engine is already running");

  629.         gStandalone.lastError = "Engine is already running";

  630.         return false;

  631.     }

  632. 

  633. #ifdef CARLA_OS_WIN

  634.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  635. #endif

  636. 

  637.     // TODO: make this an option, put somewhere else

  638.     if (std::getenv("WINE_RT") == nullptr)

  639.     {

  640.         carla_setenv("WINE_RT", "15");

  641.         carla_setenv("WINE_SVR_RT", "10");

  642.     }

  643. 

  644.     gStandalone.engine = CarlaEngine::newDriverByName(driverName);

  645. 

  646.     if (gStandalone.engine == nullptr)

  647.     {

  648.         carla_stderr2("The seleted audio driver is not available");

  649.         gStandalone.lastError = "The seleted audio driver is not available";

  650.         return false;

  651.     }

  652. 

  653. #ifdef BUILD_BRIDGE

  654.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PROCESS_MODE,          CB::ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS,                  nullptr);

  655.     gStandalone.engine->setOption(CB::ENGINE_OPTION_TRANSPORT_MODE,        CB::ENGINE_TRANSPORT_MODE_JACK,                            nullptr);

  656.     gStandalone.engine->setOption(CB::ENGINE_OPTION_FORCE_STEREO,          false,                                                     nullptr);

  657.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES, false,                                                     nullptr);

  658.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PREFER_UI_BRIDGES,     false,                                                     nullptr);

  659. #else

  660.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PROCESS_MODE,          static_cast<int>(gStandalone.engineOptions.processMode),   nullptr);

  661.     gStandalone.engine->setOption(CB::ENGINE_OPTION_TRANSPORT_MODE,        static_cast<int>(gStandalone.engineOptions.transportMode), nullptr);

  662. #endif

  663. 

  664.     carla_engine_init_common();

  665. 

  666.     if (gStandalone.engine->init(clientName))

  667.     {

  668. #ifndef BUILD_BRIDGE

  669.         juce::initialiseJuce_GUI();

  670. #endif

  671.         gStandalone.lastError = "No error";

  672.         return true;

  673.     }

  674.     else

  675.     {

  676.         gStandalone.lastError = gStandalone.engine->getLastError();

  677.         delete gStandalone.engine;

  678.         gStandalone.engine = nullptr;

  679.         return false;

  680.     }

  681. }

  682. 

  683. #ifdef BUILD_BRIDGE

  684. bool carla_engine_init_bridge(const char audioBaseName[6+1], const char rtClientBaseName[6+1], const char nonRtClientBaseName[6+1],

  685.                               const char nonRtServerBaseName[6+1], const char* clientName)

  686. {

  687.     CARLA_SAFE_ASSERT_RETURN(audioBaseName != nullptr && audioBaseName[0] != '\0', false);

  688.     CARLA_SAFE_ASSERT_RETURN(rtClientBaseName != nullptr && rtClientBaseName[0] != '\0', false);

  689.     CARLA_SAFE_ASSERT_RETURN(nonRtClientBaseName != nullptr && nonRtClientBaseName[0] != '\0', false);

  690.     CARLA_SAFE_ASSERT_RETURN(nonRtServerBaseName != nullptr && nonRtServerBaseName[0] != '\0', false);

  691.     CARLA_SAFE_ASSERT_RETURN(clientName != nullptr && clientName[0] != '\0', false);

  692.     carla_debug("carla_engine_init_bridge(\"%s\", \"%s\", \"%s\", \"%s\", \"%s\")", audioBaseName, rtClientBaseName, nonRtClientBaseName, nonRtServerBaseName, clientName);

  693. 

  694.     if (gStandalone.engine != nullptr)

  695.     {

  696.         carla_stderr2("Engine is already running");

  697.         gStandalone.lastError = "Engine is already running";

  698.         return false;

  699.     }

  700. 

  701.     gStandalone.engine = CarlaEngine::newBridge(audioBaseName, rtClientBaseName, nonRtClientBaseName, nonRtServerBaseName);

  702. 

  703.     if (gStandalone.engine == nullptr)

  704.     {

  705.         carla_stderr2("The seleted audio driver is not available!");

  706.         gStandalone.lastError = "The seleted audio driver is not available!";

  707.         return false;

  708.     }

  709. 

  710.     carla_engine_init_common();

  711. 

  712.     gStandalone.engine->setOption(CB::ENGINE_OPTION_PROCESS_MODE,   CB::ENGINE_PROCESS_MODE_BRIDGE,   nullptr);

  713.     gStandalone.engine->setOption(CB::ENGINE_OPTION_TRANSPORT_MODE, CB::ENGINE_TRANSPORT_MODE_BRIDGE, nullptr);

  714. 

  715.     if (gStandalone.engine->init(clientName))

  716.     {

  717.         gStandalone.lastError = "No error";

  718.         return true;

  719.     }

  720.     else

  721.     {

  722.         gStandalone.lastError = gStandalone.engine->getLastError();

  723.         delete gStandalone.engine;

  724.         gStandalone.engine = nullptr;

  725.         return false;

  726.     }

  727. }

  728. #endif

  729. 

  730. bool carla_engine_close()

  731. {

  732.     carla_debug("carla_engine_close()");

  733. 

  734.     if (gStandalone.engine == nullptr)

  735.     {

  736.         carla_stderr2("Engine is not running");

  737.         gStandalone.lastError = "Engine is not running";

  738.         return false;

  739.     }

  740. 

  741.     gStandalone.engine->setAboutToClose();

  742.     gStandalone.engine->removeAllPlugins();

  743. 

  744.     const bool closed(gStandalone.engine->close());

  745. 

  746.     if (! closed)

  747.         gStandalone.lastError = gStandalone.engine->getLastError();

  748. 

  749. #ifndef BUILD_BRIDGE

  750.     juce::shutdownJuce_GUI();

  751. #endif

  752.     delete gStandalone.engine;

  753.     gStandalone.engine = nullptr;

  754. 

  755.     return closed;

  756. }

  757. 

  758. void carla_engine_idle()

  759. {

  760.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  761. 

  762.     gStandalone.engine->idle();

  763. }

  764. 

  765. bool carla_is_engine_running()

  766. {

  767.     return (gStandalone.engine != nullptr && gStandalone.engine->isRunning());

  768. }

  769. 

  770. void carla_set_engine_about_to_close()

  771. {

  772.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  773.     carla_debug("carla_set_engine_about_to_close()");

  774. 

  775.     gStandalone.engine->setAboutToClose();

  776. }

  777. 

  778. void carla_set_engine_callback(EngineCallbackFunc func, void* ptr)

  779. {

  780.     carla_debug("carla_set_engine_callback(%p, %p)", func, ptr);

  781. 

  782.     gStandalone.engineCallback    = func;

  783.     gStandalone.engineCallbackPtr = ptr;

  784. 

  785.     if (gStandalone.engine != nullptr)

  786.         gStandalone.engine->setCallback(func, ptr);

  787. 

  788. //#ifdef WANT_LOGS

  789. //    gLogThread.setCallback(func, ptr);

  790. //#endif

  791. }

  792. 

  793. #ifndef BUILD_BRIDGE

  794. void carla_set_engine_option(EngineOption option, int value, const char* valueStr)

  795. {

  796.     carla_debug("carla_set_engine_option(%i:%s, %i, \"%s\")", option, CB::EngineOption2Str(option), value, valueStr);

  797. 

  798.     switch (option)

  799.     {

  800.     case CB::ENGINE_OPTION_DEBUG:

  801.         break;

  802. 

  803.     case CB::ENGINE_OPTION_PROCESS_MODE:

  804.         CARLA_SAFE_ASSERT_RETURN(value >= CB::ENGINE_PROCESS_MODE_SINGLE_CLIENT && value < CB::ENGINE_PROCESS_MODE_BRIDGE,);

  805.         gStandalone.engineOptions.processMode = static_cast<CB::EngineProcessMode>(value);

  806.         break;

  807. 

  808.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

  809.         CARLA_SAFE_ASSERT_RETURN(value >= CB::ENGINE_TRANSPORT_MODE_INTERNAL && value < CB::ENGINE_TRANSPORT_MODE_BRIDGE,);

  810.         gStandalone.engineOptions.transportMode = static_cast<CB::EngineTransportMode>(value);

  811.         break;

  812. 

  813.     case CB::ENGINE_OPTION_FORCE_STEREO:

  814.         CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);

  815.         gStandalone.engineOptions.forceStereo = (value != 0);

  816.         break;

  817. 

  818.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

  819.         CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);

  820.         gStandalone.engineOptions.preferPluginBridges = (value != 0);

  821.         break;

  822. 

  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. 

  828.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

  829.         CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);

  830.         gStandalone.engineOptions.uisAlwaysOnTop = (value != 0);

  831.         break;

  832. 

  833.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  834.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

  835.         gStandalone.engineOptions.maxParameters = static_cast<uint>(value);

  836.         break;

  837. 

  838.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  839.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

  840.         gStandalone.engineOptions.uiBridgesTimeout = static_cast<uint>(value);

  841.         break;

  842. 

  843.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

  844.         CARLA_SAFE_ASSERT_RETURN(value >= 2 && value <= 3,);

  845.         gStandalone.engineOptions.audioNumPeriods = static_cast<uint>(value);

  846.         break;

  847. 

  848.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  849.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

  850.         gStandalone.engineOptions.audioBufferSize = static_cast<uint>(value);

  851.         break;

  852. 

  853.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  854.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

  855.         gStandalone.engineOptions.audioSampleRate = static_cast<uint>(value);

  856.         break;

  857. 

  858.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  859.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  860. 

  861.         if (gStandalone.engineOptions.audioDevice != nullptr)

  862.             delete[] gStandalone.engineOptions.audioDevice;

  863. 

  864.         gStandalone.engineOptions.audioDevice = carla_strdup_safe(valueStr);

  865.         break;

  866. 

  867.     case CB::ENGINE_OPTION_PLUGIN_PATH:

  868.         CARLA_SAFE_ASSERT_RETURN(value > CB::PLUGIN_NONE,);

  869.         CARLA_SAFE_ASSERT_RETURN(value <= CB::PLUGIN_SFZ,);

  870.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  871. 

  872.         switch (value)

  873.         {

  874.         case CB::PLUGIN_LADSPA:

  875.             if (gStandalone.engineOptions.pathLADSPA != nullptr)

  876.                 delete[] gStandalone.engineOptions.pathLADSPA;

  877.             gStandalone.engineOptions.pathLADSPA = carla_strdup_safe(valueStr);

  878.             break;

  879.         case CB::PLUGIN_DSSI:

  880.             if (gStandalone.engineOptions.pathDSSI != nullptr)

  881.                 delete[] gStandalone.engineOptions.pathDSSI;

  882.             gStandalone.engineOptions.pathDSSI = carla_strdup_safe(valueStr);

  883.             break;

  884.         case CB::PLUGIN_LV2:

  885.             if (gStandalone.engineOptions.pathLV2 != nullptr)

  886.                 delete[] gStandalone.engineOptions.pathLV2;

  887.             gStandalone.engineOptions.pathLV2 = carla_strdup_safe(valueStr);

  888.             break;

  889.         case CB::PLUGIN_VST2:

  890.             if (gStandalone.engineOptions.pathVST2 != nullptr)

  891.                 delete[] gStandalone.engineOptions.pathVST2;

  892.             gStandalone.engineOptions.pathVST2 = carla_strdup_safe(valueStr);

  893.             break;

  894.         case CB::PLUGIN_VST3:

  895.             if (gStandalone.engineOptions.pathVST3 != nullptr)

  896.                 delete[] gStandalone.engineOptions.pathVST3;

  897.             gStandalone.engineOptions.pathVST3 = carla_strdup_safe(valueStr);

  898.             break;

  899.         case CB::PLUGIN_AU:

  900.             if (gStandalone.engineOptions.pathAU != nullptr)

  901.                 delete[] gStandalone.engineOptions.pathAU;

  902.             gStandalone.engineOptions.pathAU = carla_strdup_safe(valueStr);

  903.             break;

  904.         case CB::PLUGIN_GIG:

  905.             if (gStandalone.engineOptions.pathGIG != nullptr)

  906.                 delete[] gStandalone.engineOptions.pathGIG;

  907.             gStandalone.engineOptions.pathGIG = carla_strdup_safe(valueStr);

  908.             break;

  909.         case CB::PLUGIN_SF2:

  910.             if (gStandalone.engineOptions.pathSF2 != nullptr)

  911.                 delete[] gStandalone.engineOptions.pathSF2;

  912.             gStandalone.engineOptions.pathSF2 = carla_strdup_safe(valueStr);

  913.             break;

  914.         case CB::PLUGIN_SFZ:

  915.             if (gStandalone.engineOptions.pathSFZ != nullptr)

  916.                 delete[] gStandalone.engineOptions.pathSFZ;

  917.             gStandalone.engineOptions.pathSFZ = carla_strdup_safe(valueStr);

  918.             break;

  919.         }

  920.         break;

  921. 

  922.     case CB::ENGINE_OPTION_PATH_BINARIES:

  923.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr && valueStr[0] != '\0',);

  924. 

  925.         if (gStandalone.engineOptions.binaryDir != nullptr)

  926.             delete[] gStandalone.engineOptions.binaryDir;

  927. 

  928.         gStandalone.engineOptions.binaryDir = carla_strdup_safe(valueStr);

  929.         break;

  930. 

  931.     case CB::ENGINE_OPTION_PATH_RESOURCES:

  932.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr && valueStr[0] != '\0',);

  933. 

  934.         if (gStandalone.engineOptions.resourceDir != nullptr)

  935.             delete[] gStandalone.engineOptions.resourceDir;

  936. 

  937.         gStandalone.engineOptions.resourceDir = carla_strdup_safe(valueStr);

  938.         break;

  939. 

  940.     case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

  941.         CARLA_SAFE_ASSERT_RETURN(value == 0 || value == 1,);

  942.         gStandalone.engineOptions.preventBadBehaviour = (value != 0);

  943.         break;

  944. 

  945.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

  946.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr && valueStr[0] != '\0',);

  947.         const long long winId(std::strtoll(valueStr, nullptr, 16));

  948.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

  949.         gStandalone.engineOptions.frontendWinId = static_cast<uintptr_t>(winId);

  950.         break;

  951.     }

  952. 

  953.     if (gStandalone.engine != nullptr)

  954.         gStandalone.engine->setOption(option, value, valueStr);

  955. }

  956. #endif

  957. 

  958. void carla_set_file_callback(FileCallbackFunc func, void* ptr)

  959. {

  960.     carla_debug("carla_set_file_callback(%p, %p)", func, ptr);

  961. 

  962.     gStandalone.fileCallback    = func;

  963.     gStandalone.fileCallbackPtr = ptr;

  964. 

  965.     if (gStandalone.engine != nullptr)

  966.         gStandalone.engine->setFileCallback(func, ptr);

  967. }

  968. 

  969. // -------------------------------------------------------------------------------------------------------------------

  970. 

  971. bool carla_load_file(const char* filename)

  972. {

  973.     CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);

  974.     carla_debug("carla_load_file(\"%s\")", filename);

  975. 

  976.     if (gStandalone.engine != nullptr)

  977.         return gStandalone.engine->loadFile(filename);

  978. 

  979.     carla_stderr2("Engine is not running");

  980.     gStandalone.lastError = "Engine is not running";

  981.     return false;

  982. }

  983. 

  984. bool carla_load_project(const char* filename)

  985. {

  986.     CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);

  987.     carla_debug("carla_load_project(\"%s\")", filename);

  988. 

  989.     if (gStandalone.engine != nullptr)

  990.         return gStandalone.engine->loadProject(filename);

  991. 

  992.     carla_stderr2("Engine is not running");

  993.     gStandalone.lastError = "Engine is not running";

  994.     return false;

  995. }

  996. 

  997. bool carla_save_project(const char* filename)

  998. {

  999.     CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);

  1000.     carla_debug("carla_save_project(\"%s\")", filename);

  1001. 

  1002.     if (gStandalone.engine != nullptr)

  1003.         return gStandalone.engine->saveProject(filename);

  1004. 

  1005.     carla_stderr2("Engine was never initiated");

  1006.     gStandalone.lastError = "Engine was never initiated";

  1007.     return false;

  1008. }

  1009. 

  1010. #ifndef BUILD_BRIDGE

  1011. // -------------------------------------------------------------------------------------------------------------------

  1012. 

  1013. bool carla_patchbay_connect(uint groupIdA, uint portIdA, uint groupIdB, uint portIdB)

  1014. {

  1015.     carla_debug("carla_patchbay_connect(%u, %u, %u, %u)", groupIdA, portIdA, groupIdB, portIdB);

  1016. 

  1017.     if (gStandalone.engine != nullptr)

  1018.         return gStandalone.engine->patchbayConnect(groupIdA, portIdA, groupIdB, portIdB);

  1019. 

  1020.     carla_stderr2("Engine is not running");

  1021.     gStandalone.lastError = "Engine is not running";

  1022.     return false;

  1023. }

  1024. 

  1025. bool carla_patchbay_disconnect(uint connectionId)

  1026. {

  1027.     carla_debug("carla_patchbay_disconnect(%i)", connectionId);

  1028. 

  1029.     if (gStandalone.engine != nullptr)

  1030.         return gStandalone.engine->patchbayDisconnect(connectionId);

  1031. 

  1032.     carla_stderr2("Engine is not running");

  1033.     gStandalone.lastError = "Engine is not running";

  1034.     return false;

  1035. }

  1036. 

  1037. bool carla_patchbay_refresh(bool external)

  1038. {

  1039.     carla_debug("carla_patchbay_refresh(%s)", bool2str(external));

  1040. 

  1041.     if (gStandalone.engine != nullptr)

  1042.         return gStandalone.engine->patchbayRefresh(external);

  1043. 

  1044.     carla_stderr2("Engine is not running");

  1045.     gStandalone.lastError = "Engine is not running";

  1046.     return false;

  1047. }

  1048. 

  1049. // -------------------------------------------------------------------------------------------------------------------

  1050. 

  1051. void carla_transport_play()

  1052. {

  1053.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);

  1054.     carla_debug("carla_transport_play()");

  1055. 

  1056.     gStandalone.engine->transportPlay();

  1057. }

  1058. 

  1059. void carla_transport_pause()

  1060. {

  1061.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);

  1062.     carla_debug("carla_transport_pause()");

  1063. 

  1064.     gStandalone.engine->transportPause();

  1065. }

  1066. 

  1067. void carla_transport_relocate(uint64_t frame)

  1068. {

  1069.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);

  1070.     carla_debug("carla_transport_relocate(%i)", frame);

  1071. 

  1072.     gStandalone.engine->transportRelocate(frame);

  1073. }

  1074. 

  1075. uint64_t carla_get_current_transport_frame()

  1076. {

  1077.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(), 0);

  1078. 

  1079.     const CB::EngineTimeInfo& timeInfo(gStandalone.engine->getTimeInfo());

  1080.     return timeInfo.frame;

  1081. }

  1082. 

  1083. const CarlaTransportInfo* carla_get_transport_info()

  1084. {

  1085.     static CarlaTransportInfo retInfo;

  1086. 

  1087.     // reset

  1088.     retInfo.playing = false;

  1089.     retInfo.frame   = 0;

  1090.     retInfo.bar     = 0;

  1091.     retInfo.beat    = 0;

  1092.     retInfo.tick    = 0;

  1093.     retInfo.bpm     = 0.0;

  1094. 

  1095.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(), &retInfo);

  1096. 

  1097.     const CB::EngineTimeInfo& timeInfo(gStandalone.engine->getTimeInfo());

  1098. 

  1099.     retInfo.playing = timeInfo.playing;

  1100.     retInfo.frame   = timeInfo.frame;

  1101. 

  1102.     if (timeInfo.valid & CB::EngineTimeInfo::kValidBBT)

  1103.     {

  1104.         retInfo.bar  = timeInfo.bbt.bar;

  1105.         retInfo.beat = timeInfo.bbt.beat;

  1106.         retInfo.tick = timeInfo.bbt.tick;

  1107.         retInfo.bpm  = timeInfo.bbt.beatsPerMinute;

  1108.     }

  1109. 

  1110.     return &retInfo;

  1111. }

  1112. #endif

  1113. 

  1114. // -------------------------------------------------------------------------------------------------------------------

  1115. 

  1116. uint32_t carla_get_current_plugin_count()

  1117. {

  1118.     if (gStandalone.engine != nullptr)

  1119.         return gStandalone.engine->getCurrentPluginCount();

  1120. 

  1121.     return 0;

  1122. }

  1123. 

  1124. uint32_t carla_get_max_plugin_number()

  1125. {

  1126.     if (gStandalone.engine != nullptr)

  1127.         return gStandalone.engine->getMaxPluginNumber();

  1128. 

  1129.     return 0;

  1130. }

  1131. 

  1132. // -------------------------------------------------------------------------------------------------------------------

  1133. 

  1134. 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)

  1135. {

  1136.     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);

  1137. 

  1138.     if (gStandalone.engine != nullptr)

  1139.         return gStandalone.engine->addPlugin(btype, ptype, filename, name, label, uniqueId, extraPtr, options);

  1140. 

  1141.     carla_stderr2("Engine is not running");

  1142.     gStandalone.lastError = "Engine is not running";

  1143.     return false;

  1144. }

  1145. 

  1146. bool carla_remove_plugin(uint pluginId)

  1147. {

  1148.     carla_debug("carla_remove_plugin(%i)", pluginId);

  1149. 

  1150.     if (gStandalone.engine != nullptr)

  1151.         return gStandalone.engine->removePlugin(pluginId);

  1152. 

  1153.     carla_stderr2("Engine is not running");

  1154.     gStandalone.lastError = "Engine is not running";

  1155.     return false;

  1156. }

  1157. 

  1158. bool carla_remove_all_plugins()

  1159. {

  1160.     carla_debug("carla_remove_all_plugins()");

  1161. 

  1162.     if (gStandalone.engine != nullptr)

  1163.         return gStandalone.engine->removeAllPlugins();

  1164. 

  1165.     carla_stderr2("Engine is not running");

  1166.     gStandalone.lastError = "Engine is not running";

  1167.     return false;

  1168. }

  1169. 

  1170. #ifndef BUILD_BRIDGE

  1171. const char* carla_rename_plugin(uint pluginId, const char* newName)

  1172. {

  1173.     CARLA_SAFE_ASSERT_RETURN(newName != nullptr && newName[0] != '\0', nullptr);

  1174.     carla_debug("carla_rename_plugin(%i, \"%s\")", pluginId, newName);

  1175. 

  1176.     if (gStandalone.engine != nullptr)

  1177.         return gStandalone.engine->renamePlugin(pluginId, newName);

  1178. 

  1179.     carla_stderr2("Engine is not running");

  1180.     gStandalone.lastError = "Engine is not running";

  1181.     return nullptr;

  1182. }

  1183. 

  1184. bool carla_clone_plugin(uint pluginId)

  1185. {

  1186.     carla_debug("carla_clone_plugin(%i)", pluginId);

  1187. 

  1188.     if (gStandalone.engine != nullptr)

  1189.         return gStandalone.engine->clonePlugin(pluginId);

  1190. 

  1191.     carla_stderr2("Engine is not running");

  1192.     gStandalone.lastError = "Engine is not running";

  1193.     return false;

  1194. }

  1195. 

  1196. bool carla_replace_plugin(uint pluginId)

  1197. {

  1198.     carla_debug("carla_replace_plugin(%i)", pluginId);

  1199. 

  1200.     if (gStandalone.engine != nullptr)

  1201.         return gStandalone.engine->replacePlugin(pluginId);

  1202. 

  1203.     carla_stderr2("Engine is not running");

  1204.     gStandalone.lastError = "Engine is not running";

  1205.     return false;

  1206. }

  1207. 

  1208. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1209. {

  1210.     CARLA_SAFE_ASSERT_RETURN(pluginIdA != pluginIdB, false);

  1211.     carla_debug("carla_switch_plugins(%i, %i)", pluginIdA, pluginIdB);

  1212. 

  1213.     if (gStandalone.engine != nullptr)

  1214.         return gStandalone.engine->switchPlugins(pluginIdA, pluginIdB);

  1215. 

  1216.     carla_stderr2("Engine is not running");

  1217.     gStandalone.lastError = "Engine is not running";

  1218.     return false;

  1219. }

  1220. #endif

  1221. 

  1222. // -------------------------------------------------------------------------------------------------------------------

  1223. 

  1224. bool carla_load_plugin_state(uint pluginId, const char* filename)

  1225. {

  1226.     CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);

  1227.     carla_debug("carla_load_plugin_state(%i, \"%s\")", pluginId, filename);

  1228. 

  1229.     if (gStandalone.engine == nullptr || ! gStandalone.engine->isRunning())

  1230.     {

  1231.         carla_stderr2("Engine is not running");

  1232.         gStandalone.lastError = "Engine is not running";

  1233.         return false;

  1234.     }

  1235. 

  1236.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1237.         return plugin->loadStateFromFile(filename);

  1238. 

  1239.     carla_stderr2("carla_load_plugin_state(%i, \"%s\") - could not find plugin", pluginId, filename);

  1240.     return false;

  1241. }

  1242. 

  1243. bool carla_save_plugin_state(uint pluginId, const char* filename)

  1244. {

  1245.     CARLA_SAFE_ASSERT_RETURN(filename != nullptr && filename[0] != '\0', false);

  1246.     carla_debug("carla_save_plugin_state(%i, \"%s\")", pluginId, filename);

  1247. 

  1248.     if (gStandalone.engine == nullptr)

  1249.     {

  1250.         carla_stderr2("Engine is not running");

  1251.         gStandalone.lastError = "Engine is not running";

  1252.         return false;

  1253.     }

  1254. 

  1255.     // allow to save even if engine isn't running

  1256. 

  1257.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1258.         return plugin->saveStateToFile(filename);

  1259. 

  1260.     carla_stderr2("carla_save_plugin_state(%i, \"%s\") - could not find plugin", pluginId, filename);

  1261.     return false;

  1262. }

  1263. 

  1264. // -------------------------------------------------------------------------------------------------------------------

  1265. 

  1266. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1267. {

  1268.     carla_debug("carla_get_plugin_info(%i)", pluginId);

  1269. 

  1270.     static CarlaPluginInfo info;

  1271. 

  1272.     // reset

  1273.     info.type             = CB::PLUGIN_NONE;

  1274.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1275.     info.hints            = 0x0;

  1276.     info.optionsAvailable = 0x0;

  1277.     info.optionsEnabled   = 0x0;

  1278.     info.filename         = gNullCharPtr;

  1279.     info.name             = gNullCharPtr;

  1280.     info.iconName         = gNullCharPtr;

  1281.     info.uniqueId         = 0;

  1282. 

  1283.     // cleanup

  1284.     if (info.label != gNullCharPtr)

  1285.     {

  1286.         delete[] info.label;

  1287.         info.label = gNullCharPtr;

  1288.     }

  1289. 

  1290.     if (info.maker != gNullCharPtr)

  1291.     {

  1292.         delete[] info.maker;

  1293.         info.maker = gNullCharPtr;

  1294.     }

  1295. 

  1296.     if (info.copyright != gNullCharPtr)

  1297.     {

  1298.         delete[] info.copyright;

  1299.         info.copyright = gNullCharPtr;

  1300.     }

  1301. 

  1302.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);

  1303. 

  1304.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1305.     {

  1306.         char strBufLabel[STR_MAX+1];

  1307.         char strBufMaker[STR_MAX+1];

  1308.         char strBufCopyright[STR_MAX+1];

  1309. 

  1310.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1311.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1312.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1313. 

  1314.         info.type     = plugin->getType();

  1315.         info.category = plugin->getCategory();

  1316.         info.hints    = plugin->getHints();

  1317.         info.filename = plugin->getFilename();

  1318.         info.name     = plugin->getName();

  1319.         info.iconName = plugin->getIconName();

  1320.         info.uniqueId = plugin->getUniqueId();

  1321. 

  1322.         info.optionsAvailable = plugin->getOptionsAvailable();

  1323.         info.optionsEnabled   = plugin->getOptionsEnabled();

  1324. 

  1325.         plugin->getLabel(strBufLabel);

  1326.         info.label = carla_strdup_safe(strBufLabel);

  1327. 

  1328.         plugin->getMaker(strBufMaker);

  1329.         info.maker = carla_strdup_safe(strBufMaker);

  1330. 

  1331.         plugin->getCopyright(strBufCopyright);

  1332.         info.copyright = carla_strdup_safe(strBufCopyright);

  1333. 

  1334.         checkStringPtr(info.filename);

  1335.         checkStringPtr(info.name);

  1336.         checkStringPtr(info.iconName);

  1337.         checkStringPtr(info.label);

  1338.         checkStringPtr(info.maker);

  1339.         checkStringPtr(info.copyright);

  1340. 

  1341.         return &info;

  1342.     }

  1343. 

  1344.     carla_stderr2("carla_get_plugin_info(%i) - could not find plugin", pluginId);

  1345.     return &info;

  1346. }

  1347. 

  1348. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1349. {

  1350.     carla_debug("carla_get_audio_port_count_info(%i)", pluginId);

  1351. 

  1352.     static CarlaPortCountInfo info;

  1353. 

  1354.     // reset

  1355.     info.ins   = 0;

  1356.     info.outs  = 0;

  1357. 

  1358.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);

  1359. 

  1360.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1361.     {

  1362.         info.ins   = plugin->getAudioInCount();

  1363.         info.outs  = plugin->getAudioOutCount();

  1364.         return &info;

  1365.     }

  1366. 

  1367.     carla_stderr2("carla_get_audio_port_count_info(%i) - could not find plugin", pluginId);

  1368.     return &info;

  1369. }

  1370. 

  1371. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1372. {

  1373.     carla_debug("carla_get_midi_port_count_info(%i)", pluginId);

  1374. 

  1375.     static CarlaPortCountInfo info;

  1376. 

  1377.     // reset

  1378.     info.ins   = 0;

  1379.     info.outs  = 0;

  1380. 

  1381.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);

  1382. 

  1383.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1384.     {

  1385.         info.ins   = plugin->getMidiInCount();

  1386.         info.outs  = plugin->getMidiOutCount();

  1387.         return &info;

  1388.     }

  1389. 

  1390.     carla_stderr2("carla_get_midi_port_count_info(%i) - could not find plugin", pluginId);

  1391.     return &info;

  1392. }

  1393. 

  1394. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1395. {

  1396.     carla_debug("carla_get_parameter_count_info(%i)", pluginId);

  1397. 

  1398.     static CarlaPortCountInfo info;

  1399. 

  1400.     // reset

  1401.     info.ins   = 0;

  1402.     info.outs  = 0;

  1403. 

  1404.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);

  1405. 

  1406.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1407.     {

  1408.         plugin->getParameterCountInfo(info.ins, info.outs);

  1409.         return &info;

  1410.     }

  1411. 

  1412.     carla_stderr2("carla_get_parameter_count_info(%i) - could not find plugin", pluginId);

  1413.     return &info;

  1414. }

  1415. 

  1416. const CarlaParameterInfo* carla_get_parameter_info(uint pluginId, uint32_t parameterId)

  1417. {

  1418.     carla_debug("carla_get_parameter_info(%i, %i)", pluginId, parameterId);

  1419. 

  1420.     static CarlaParameterInfo info;

  1421. 

  1422.     // reset

  1423.     info.scalePointCount = 0;

  1424. 

  1425.     // cleanup

  1426.     if (info.name != gNullCharPtr)

  1427.     {

  1428.         delete[] info.name;

  1429.         info.name = gNullCharPtr;

  1430.     }

  1431. 

  1432.     if (info.symbol != gNullCharPtr)

  1433.     {

  1434.         delete[] info.symbol;

  1435.         info.symbol = gNullCharPtr;

  1436.     }

  1437. 

  1438.     if (info.unit != gNullCharPtr)

  1439.     {

  1440.         delete[] info.unit;

  1441.         info.unit = gNullCharPtr;

  1442.     }

  1443. 

  1444.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);

  1445. 

  1446.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1447.     {

  1448.         if (parameterId < plugin->getParameterCount())

  1449.         {

  1450.             char strBufName[STR_MAX+1];

  1451.             char strBufSymbol[STR_MAX+1];

  1452.             char strBufUnit[STR_MAX+1];

  1453. 

  1454.             carla_zeroChar(strBufName, STR_MAX+1);

  1455.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1456.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1457. 

  1458.             info.scalePointCount = plugin->getParameterScalePointCount(parameterId);

  1459. 

  1460.             plugin->getParameterName(parameterId, strBufName);

  1461.             info.name = carla_strdup_safe(strBufName);

  1462. 

  1463.             plugin->getParameterSymbol(parameterId, strBufSymbol);

  1464.             info.symbol = carla_strdup_safe(strBufSymbol);

  1465. 

  1466.             plugin->getParameterUnit(parameterId, strBufUnit);

  1467.             info.unit = carla_strdup_safe(strBufUnit);

  1468. 

  1469.             checkStringPtr(info.name);

  1470.             checkStringPtr(info.symbol);

  1471.             checkStringPtr(info.unit);

  1472.         }

  1473.         else

  1474.             carla_stderr2("carla_get_parameter_info(%i, %i) - parameterId out of bounds", pluginId, parameterId);

  1475. 

  1476.         return &info;

  1477.     }

  1478. 

  1479.     carla_stderr2("carla_get_parameter_info(%i, %i) - could not find plugin", pluginId, parameterId);

  1480.     return &info;

  1481. }

  1482. 

  1483. const CarlaScalePointInfo* carla_get_parameter_scalepoint_info(uint pluginId, uint32_t parameterId, uint32_t scalePointId)

  1484. {

  1485.     carla_debug("carla_get_parameter_scalepoint_info(%i, %i, %i)", pluginId, parameterId, scalePointId);

  1486.     CARLA_ASSERT(gStandalone.engine != nullptr);

  1487. 

  1488.     static CarlaScalePointInfo info;

  1489. 

  1490.     // reset

  1491.     info.value = 0.0f;

  1492. 

  1493.     // cleanup

  1494.     if (info.label != gNullCharPtr)

  1495.     {

  1496.         delete[] info.label;

  1497.         info.label = gNullCharPtr;

  1498.     }

  1499. 

  1500.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &info);

  1501. 

  1502.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1503.     {

  1504.         if (parameterId < plugin->getParameterCount())

  1505.         {

  1506.             if (scalePointId < plugin->getParameterScalePointCount(parameterId))

  1507.             {

  1508.                 char strBufLabel[STR_MAX+1];

  1509.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1510. 

  1511.                 info.value = plugin->getParameterScalePointValue(parameterId, scalePointId);

  1512. 

  1513.                 plugin->getParameterScalePointLabel(parameterId, scalePointId, strBufLabel);

  1514.                 info.label = carla_strdup_safe(strBufLabel);

  1515.                 checkStringPtr(info.label);

  1516.             }

  1517.             else

  1518.                 carla_stderr2("carla_get_parameter_scalepoint_info(%i, %i, %i) - scalePointId out of bounds", pluginId, parameterId, scalePointId);

  1519.         }

  1520.         else

  1521.             carla_stderr2("carla_get_parameter_scalepoint_info(%i, %i, %i) - parameterId out of bounds", pluginId, parameterId, scalePointId);

  1522. 

  1523.         return &info;

  1524.     }

  1525. 

  1526.     carla_stderr2("carla_get_parameter_scalepoint_info(%i, %i, %i) - could not find plugin", pluginId, parameterId, scalePointId);

  1527.     return &info;

  1528. }

  1529. 

  1530. // -------------------------------------------------------------------------------------------------------------------

  1531. 

  1532. const ParameterData* carla_get_parameter_data(uint pluginId, uint32_t parameterId)

  1533. {

  1534.     carla_debug("carla_get_parameter_data(%i, %i)", pluginId, parameterId);

  1535. 

  1536.     static const ParameterData fallbackParameterData = { CB::PARAMETER_UNKNOWN, 0x0, CB::PARAMETER_NULL, -1, -1, 0 };

  1537. 

  1538.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &fallbackParameterData);

  1539. 

  1540.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1541.     {

  1542.         if (parameterId < plugin->getParameterCount())

  1543.             return &plugin->getParameterData(parameterId);

  1544. 

  1545.         carla_stderr2("carla_get_parameter_data(%i, %i) - parameterId out of bounds", pluginId, parameterId);

  1546.         return &fallbackParameterData;

  1547.     }

  1548. 

  1549.     carla_stderr2("carla_get_parameter_data(%i, %i) - could not find plugin", pluginId, parameterId);

  1550.     return &fallbackParameterData;

  1551. }

  1552. 

  1553. const ParameterRanges* carla_get_parameter_ranges(uint pluginId, uint32_t parameterId)

  1554. {

  1555.     carla_debug("carla_get_parameter_ranges(%i, %i)", pluginId, parameterId);

  1556. 

  1557.     static const ParameterRanges fallbackParamRanges = { 0.0f, 0.0f, 1.0f, 0.01f, 0.0001f, 0.1f };

  1558. 

  1559.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &fallbackParamRanges);

  1560. 

  1561.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1562.     {

  1563.         if (parameterId < plugin->getParameterCount())

  1564.             return &plugin->getParameterRanges(parameterId);

  1565. 

  1566.         carla_stderr2("carla_get_parameter_ranges(%i, %i) - parameterId out of bounds", pluginId, parameterId);

  1567.         return &fallbackParamRanges;

  1568.     }

  1569. 

  1570.     carla_stderr2("carla_get_parameter_ranges(%i, %i) - could not find plugin", pluginId, parameterId);

  1571.     return &fallbackParamRanges;

  1572. }

  1573. 

  1574. const MidiProgramData* carla_get_midi_program_data(uint pluginId, uint32_t midiProgramId)

  1575. {

  1576.     carla_debug("carla_get_midi_program_data(%i, %i)", pluginId, midiProgramId);

  1577. 

  1578.     static MidiProgramData midiProgData;

  1579. 

  1580.     // reset

  1581.     midiProgData.bank    = 0;

  1582.     midiProgData.program = 0;

  1583.     midiProgData.name    = gNullCharPtr;

  1584. 

  1585.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &midiProgData);

  1586. 

  1587.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1588.     {

  1589.         if (midiProgramId < plugin->getMidiProgramCount())

  1590.         {

  1591.             const MidiProgramData& ret(plugin->getMidiProgramData(midiProgramId));

  1592.             carla_copyStruct<MidiProgramData>(midiProgData, ret);

  1593.             checkStringPtr(midiProgData.name);

  1594.             return &midiProgData;

  1595.         }

  1596. 

  1597.         carla_stderr2("carla_get_midi_program_data(%i, %i) - midiProgramId out of bounds", pluginId, midiProgramId);

  1598.         return &midiProgData;

  1599.     }

  1600. 

  1601.     carla_stderr2("carla_get_midi_program_data(%i, %i) - could not find plugin", pluginId, midiProgramId);

  1602.     return &midiProgData;

  1603. }

  1604. 

  1605. const CustomData* carla_get_custom_data(uint pluginId, uint32_t customDataId)

  1606. {

  1607.     carla_debug("carla_get_custom_data(%i, %i)", pluginId, customDataId);

  1608. 

  1609.     static CustomData customData;

  1610. 

  1611.     // reset

  1612.     customData.type  = gNullCharPtr;

  1613.     customData.key   = gNullCharPtr;

  1614.     customData.value = gNullCharPtr;

  1615. 

  1616.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, &customData);

  1617. 

  1618.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1619.     {

  1620.         if (customDataId < plugin->getCustomDataCount())

  1621.         {

  1622.             const CustomData& ret(plugin->getCustomData(customDataId));

  1623.             carla_copyStruct<CustomData>(customData, ret);

  1624.             checkStringPtr(customData.type);

  1625.             checkStringPtr(customData.key);

  1626.             checkStringPtr(customData.value);

  1627.             return &customData;

  1628.         }

  1629. 

  1630.         carla_stderr2("carla_get_custom_data(%i, %i) - customDataId out of bounds", pluginId, customDataId);

  1631.         return &customData;

  1632.     }

  1633. 

  1634.     carla_stderr2("carla_get_custom_data(%i, %i) - could not find plugin", pluginId, customDataId);

  1635.     return &customData;

  1636. }

  1637. 

  1638. const char* carla_get_chunk_data(uint pluginId)

  1639. {

  1640.     carla_debug("carla_get_chunk_data(%i)", pluginId);

  1641. 

  1642.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);

  1643. 

  1644.     static CarlaString chunkData;

  1645. 

  1646.     // cleanup

  1647.     chunkData.clear();

  1648. 

  1649.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1650.     {

  1651.         if (plugin->getOptionsEnabled() & CB::PLUGIN_OPTION_USE_CHUNKS)

  1652.         {

  1653.             void* data = nullptr;

  1654.             const std::size_t dataSize(plugin->getChunkData(&data));

  1655. 

  1656.             if (data != nullptr && dataSize > 0)

  1657.             {

  1658.                 chunkData = CarlaString::asBase64(data, static_cast<std::size_t>(dataSize));

  1659.                 return chunkData;

  1660.             }

  1661.             else

  1662.                 carla_stderr2("carla_get_chunk_data(%i) - got invalid chunk data", pluginId);

  1663.         }

  1664.         else

  1665.             carla_stderr2("carla_get_chunk_data(%i) - plugin does not use chunks", pluginId);

  1666. 

  1667.         return nullptr;

  1668.     }

  1669. 

  1670.     carla_stderr2("carla_get_chunk_data(%i) - could not find plugin", pluginId);

  1671.     return nullptr;

  1672. }

  1673. 

  1674. // -------------------------------------------------------------------------------------------------------------------

  1675. 

  1676. uint32_t carla_get_parameter_count(uint pluginId)

  1677. {

  1678.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);

  1679.     carla_debug("carla_get_parameter_count(%i)", pluginId);

  1680. 

  1681.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1682.         return plugin->getParameterCount();

  1683. 

  1684.     carla_stderr2("carla_get_parameter_count(%i) - could not find plugin", pluginId);

  1685.     return 0;

  1686. }

  1687. 

  1688. uint32_t carla_get_program_count(uint pluginId)

  1689. {

  1690.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);

  1691.     carla_debug("carla_get_program_count(%i)", pluginId);

  1692. 

  1693.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1694.         return plugin->getProgramCount();

  1695. 

  1696.     carla_stderr2("carla_get_program_count(%i) - could not find plugin", pluginId);

  1697.     return 0;

  1698. }

  1699. 

  1700. uint32_t carla_get_midi_program_count(uint pluginId)

  1701. {

  1702.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);

  1703.     carla_debug("carla_get_midi_program_count(%i)", pluginId);

  1704. 

  1705.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1706.         return plugin->getMidiProgramCount();

  1707. 

  1708.     carla_stderr2("carla_get_midi_program_count(%i) - could not find plugin", pluginId);

  1709.     return 0;

  1710. }

  1711. 

  1712. uint32_t carla_get_custom_data_count(uint pluginId)

  1713. {

  1714.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);

  1715.     carla_debug("carla_get_custom_data_count(%i)", pluginId);

  1716. 

  1717.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1718.         return plugin->getCustomDataCount();

  1719. 

  1720.     carla_stderr2("carla_get_custom_data_count(%i) - could not find plugin", pluginId);

  1721.     return 0;

  1722. }

  1723. 

  1724. // -------------------------------------------------------------------------------------------------------------------

  1725. 

  1726. const char* carla_get_parameter_text(uint pluginId, uint32_t parameterId)

  1727. {

  1728.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);

  1729.     carla_debug("carla_get_parameter_text(%i, %i)", pluginId, parameterId);

  1730. 

  1731.     static char textBuf[STR_MAX+1];

  1732. 

  1733.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1734.     {

  1735.         if (parameterId < plugin->getParameterCount())

  1736.         {

  1737.             carla_zeroChar(textBuf, STR_MAX+1);

  1738.             plugin->getParameterText(parameterId, textBuf);

  1739.             return textBuf;

  1740.         }

  1741. 

  1742.         carla_stderr2("carla_get_parameter_text(%i, %i) - parameterId out of bounds", pluginId, parameterId);

  1743.         return nullptr;

  1744.     }

  1745. 

  1746.     carla_stderr2("carla_get_parameter_text(%i, %i) - could not find plugin", pluginId, parameterId);

  1747.     return nullptr;

  1748. }

  1749. 

  1750. const char* carla_get_program_name(uint pluginId, uint32_t programId)

  1751. {

  1752.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);

  1753.     carla_debug("carla_get_program_name(%i, %i)", pluginId, programId);

  1754. 

  1755.     static char programName[STR_MAX+1];

  1756. 

  1757.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1758.     {

  1759.         if (programId < plugin->getProgramCount())

  1760.         {

  1761.             carla_zeroChar(programName, STR_MAX+1);

  1762.             plugin->getProgramName(programId, programName);

  1763.             return programName;

  1764.         }

  1765. 

  1766.         carla_stderr2("carla_get_program_name(%i, %i) - programId out of bounds", pluginId, programId);

  1767.         return nullptr;

  1768.     }

  1769. 

  1770.     carla_stderr2("carla_get_program_name(%i, %i) - could not find plugin", pluginId, programId);

  1771.     return nullptr;

  1772. }

  1773. 

  1774. const char* carla_get_midi_program_name(uint pluginId, uint32_t midiProgramId)

  1775. {

  1776.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);

  1777.     carla_debug("carla_get_midi_program_name(%i, %i)", pluginId, midiProgramId);

  1778. 

  1779.     static char midiProgramName[STR_MAX+1];

  1780. 

  1781.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1782.     {

  1783.         if (midiProgramId < plugin->getMidiProgramCount())

  1784.         {

  1785.             carla_zeroChar(midiProgramName, STR_MAX+1);

  1786.             plugin->getMidiProgramName(midiProgramId, midiProgramName);

  1787.             return midiProgramName;

  1788.         }

  1789. 

  1790.         carla_stderr2("carla_get_midi_program_name(%i, %i) - midiProgramId out of bounds", pluginId, midiProgramId);

  1791.         return nullptr;

  1792.     }

  1793. 

  1794.     carla_stderr2("carla_get_midi_program_name(%i, %i) - could not find plugin", pluginId, midiProgramId);

  1795.     return nullptr;

  1796. }

  1797. 

  1798. const char* carla_get_real_plugin_name(uint pluginId)

  1799. {

  1800.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, nullptr);

  1801.     carla_debug("carla_get_real_plugin_name(%i)", pluginId);

  1802. 

  1803.     static char realPluginName[STR_MAX+1];

  1804. 

  1805.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1806.     {

  1807.         carla_zeroChar(realPluginName, STR_MAX+1);

  1808.         plugin->getRealName(realPluginName);

  1809.         return realPluginName;

  1810.     }

  1811. 

  1812.     carla_stderr2("carla_get_real_plugin_name(%i) - could not find plugin", pluginId);

  1813.     return nullptr;

  1814. }

  1815. 

  1816. // -------------------------------------------------------------------------------------------------------------------

  1817. 

  1818. int32_t carla_get_current_program_index(uint pluginId)

  1819. {

  1820.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, -1);

  1821.     carla_debug("carla_get_current_program_index(%i)", pluginId);

  1822. 

  1823.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1824.         return plugin->getCurrentProgram();

  1825. 

  1826.     carla_stderr2("carla_get_current_program_index(%i) - could not find plugin", pluginId);

  1827.     return -1;

  1828. }

  1829. 

  1830. int32_t carla_get_current_midi_program_index(uint pluginId)

  1831. {

  1832.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, -1);

  1833.     carla_debug("carla_get_current_midi_program_index(%i)", pluginId);

  1834. 

  1835.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1836.         return plugin->getCurrentMidiProgram();

  1837. 

  1838.     carla_stderr2("carla_get_current_midi_program_index(%i) - could not find plugin", pluginId);

  1839.     return -1;

  1840. }

  1841. 

  1842. // -------------------------------------------------------------------------------------------------------------------

  1843. 

  1844. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  1845. {

  1846.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);

  1847.     carla_debug("carla_get_default_parameter_value(%i, %i)", pluginId, parameterId);

  1848. 

  1849.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1850.     {

  1851.         if (parameterId < plugin->getParameterCount())

  1852.             return plugin->getParameterRanges(parameterId).def;

  1853. 

  1854.         carla_stderr2("carla_get_default_parameter_value(%i, %i) - parameterId out of bounds", pluginId, parameterId);

  1855.         return 0.0f;

  1856.     }

  1857. 

  1858.     carla_stderr2("carla_get_default_parameter_value(%i, %i) - could not find plugin", pluginId, parameterId);

  1859.     return 0.0f;

  1860. }

  1861. 

  1862. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  1863. {

  1864.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);

  1865. 

  1866.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1867.     {

  1868.         if (parameterId < plugin->getParameterCount())

  1869.             return plugin->getParameterValue(parameterId);

  1870. 

  1871.         carla_stderr2("carla_get_current_parameter_value(%i, %i) - parameterId out of bounds", pluginId, parameterId);

  1872.         return 0.0f;

  1873.     }

  1874. 

  1875.     carla_stderr2("carla_get_current_parameter_value(%i, %i) - could not find plugin", pluginId, parameterId);

  1876.     return 0.0f;

  1877. }

  1878. 

  1879. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  1880. {

  1881. #ifdef BUILD_BRIDGE

  1882.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);

  1883. #else

  1884.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, (parameterId == CB::PARAMETER_CTRL_CHANNEL) ? -1.0f : 0.0f);

  1885. #endif

  1886.     CARLA_SAFE_ASSERT_RETURN(parameterId != CB::PARAMETER_NULL && parameterId > CB::PARAMETER_MAX, 0.0f);

  1887. 

  1888.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1889.         return plugin->getInternalParameterValue(parameterId);

  1890. 

  1891.     carla_stderr2("carla_get_internal_parameter_value(%i, %i) - could not find plugin", pluginId, parameterId);

  1892.     return 0.0f;

  1893. }

  1894. 

  1895. // -------------------------------------------------------------------------------------------------------------------

  1896. 

  1897. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  1898. {

  1899.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);

  1900. 

  1901.     return gStandalone.engine->getInputPeak(pluginId, isLeft);

  1902. }

  1903. 

  1904. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  1905. {

  1906.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0f);

  1907. 

  1908.     return gStandalone.engine->getOutputPeak(pluginId, isLeft);

  1909. }

  1910. 

  1911. // -------------------------------------------------------------------------------------------------------------------

  1912. 

  1913. void carla_set_active(uint pluginId, bool onOff)

  1914. {

  1915.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1916.     carla_debug("carla_set_active(%i, %s)", pluginId, bool2str(onOff));

  1917. 

  1918.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1919.         return plugin->setActive(onOff, true, false);

  1920. 

  1921.     carla_stderr2("carla_set_active(%i, %s) - could not find plugin", pluginId, bool2str(onOff));

  1922. }

  1923. 

  1924. #ifndef BUILD_BRIDGE

  1925. void carla_set_drywet(uint pluginId, float value)

  1926. {

  1927.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1928.     carla_debug("carla_set_drywet(%i, %f)", pluginId, value);

  1929. 

  1930.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1931.         return plugin->setDryWet(value, true, false);

  1932. 

  1933.     carla_stderr2("carla_set_drywet(%i, %f) - could not find plugin", pluginId, value);

  1934. }

  1935. 

  1936. void carla_set_volume(uint pluginId, float value)

  1937. {

  1938.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1939.     carla_debug("carla_set_volume(%i, %f)", pluginId, value);

  1940. 

  1941.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1942.         return plugin->setVolume(value, true, false);

  1943. 

  1944.     carla_stderr2("carla_set_volume(%i, %f) - could not find plugin", pluginId, value);

  1945. }

  1946. 

  1947. void carla_set_balance_left(uint pluginId, float value)

  1948. {

  1949.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1950.     carla_debug("carla_set_balance_left(%i, %f)", pluginId, value);

  1951. 

  1952.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1953.         return plugin->setBalanceLeft(value, true, false);

  1954. 

  1955.     carla_stderr2("carla_set_balance_left(%i, %f) - could not find plugin", pluginId, value);

  1956. }

  1957. 

  1958. void carla_set_balance_right(uint pluginId, float value)

  1959. {

  1960.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1961.     carla_debug("carla_set_balance_right(%i, %f)", pluginId, value);

  1962. 

  1963.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1964.         return plugin->setBalanceRight(value, true, false);

  1965. 

  1966.     carla_stderr2("carla_set_balance_right(%i, %f) - could not find plugin", pluginId, value);

  1967. }

  1968. 

  1969. void carla_set_panning(uint pluginId, float value)

  1970. {

  1971.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1972.     carla_debug("carla_set_panning(%i, %f)", pluginId, value);

  1973. 

  1974.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1975.         return plugin->setPanning(value, true, false);

  1976. 

  1977.     carla_stderr2("carla_set_panning(%i, %f) - could not find plugin", pluginId, value);

  1978. }

  1979. 

  1980. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  1981. {

  1982.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1983.     CARLA_SAFE_ASSERT_RETURN(channel >= -1 && channel < MAX_MIDI_CHANNELS,);

  1984.     carla_debug("carla_set_ctrl_channel(%i, %i)", pluginId, channel);

  1985. 

  1986.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1987.         return plugin->setCtrlChannel(channel, true, false);

  1988. 

  1989.     carla_stderr2("carla_set_ctrl_channel(%i, %i) - could not find plugin", pluginId, channel);

  1990. }

  1991. 

  1992. void carla_set_option(uint pluginId, uint option, bool yesNo)

  1993. {

  1994.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  1995.     carla_debug("carla_set_option(%i, %i, %s)", pluginId, option, bool2str(yesNo));

  1996. 

  1997.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  1998.         return plugin->setOption(option, yesNo, false);

  1999. 

  2000.     carla_stderr2("carla_set_option(%i, %i, %s) - could not find plugin", pluginId, option, bool2str(yesNo));

  2001. }

  2002. #endif

  2003. 

  2004. // -------------------------------------------------------------------------------------------------------------------

  2005. 

  2006. void carla_set_parameter_value(uint pluginId, uint32_t parameterId, float value)

  2007. {

  2008.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2009.     carla_debug("carla_set_parameter_value(%i, %i, %f)", pluginId, parameterId, value);

  2010. 

  2011.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2012.     {

  2013.         if (parameterId < plugin->getParameterCount())

  2014.             return plugin->setParameterValue(parameterId, value, true, true, false);

  2015. 

  2016.         carla_stderr2("carla_set_parameter_value(%i, %i, %f) - parameterId out of bounds", pluginId, parameterId, value);

  2017.         return;

  2018.     }

  2019. 

  2020.     carla_stderr2("carla_set_parameter_value(%i, %i, %f) - could not find plugin", pluginId, parameterId, value);

  2021. }

  2022. 

  2023. #ifndef BUILD_BRIDGE

  2024. void carla_set_parameter_midi_channel(uint pluginId, uint32_t parameterId, uint8_t channel)

  2025. {

  2026.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2027.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2028.     carla_debug("carla_set_parameter_midi_channel(%i, %i, %i)", pluginId, parameterId, channel);

  2029. 

  2030.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2031.     {

  2032.         if (parameterId < plugin->getParameterCount())

  2033.             return plugin->setParameterMidiChannel(parameterId, channel, true, false);

  2034. 

  2035.         carla_stderr2("carla_set_parameter_midi_channel(%i, %i, %i) - parameterId out of bounds", pluginId, parameterId, channel);

  2036.         return;

  2037.     }

  2038. 

  2039.     carla_stderr2("carla_set_parameter_midi_channel(%i, %i, %i) - could not find plugin", pluginId, parameterId, channel);

  2040. }

  2041. 

  2042. void carla_set_parameter_midi_cc(uint pluginId, uint32_t parameterId, int16_t cc)

  2043. {

  2044.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2045.     CARLA_SAFE_ASSERT_RETURN(cc >= -1 && cc < MAX_MIDI_CONTROL,);

  2046.     carla_debug("carla_set_parameter_midi_cc(%i, %i, %i)", pluginId, parameterId, cc);

  2047. 

  2048.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2049.     {

  2050.         if (parameterId < plugin->getParameterCount())

  2051.             return plugin->setParameterMidiCC(parameterId, cc, true, false);

  2052. 

  2053.         carla_stderr2("carla_set_parameter_midi_cc(%i, %i, %i) - parameterId out of bounds", pluginId, parameterId, cc);

  2054.         return;

  2055.     }

  2056. 

  2057.     carla_stderr2("carla_set_parameter_midi_cc(%i, %i, %i) - could not find plugin", pluginId, parameterId, cc);

  2058. }

  2059. #endif

  2060. 

  2061. // -------------------------------------------------------------------------------------------------------------------

  2062. 

  2063. void carla_set_program(uint pluginId, uint32_t programId)

  2064. {

  2065.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2066.     carla_debug("carla_set_program(%i, %i)", pluginId, programId);

  2067. 

  2068.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2069.     {

  2070.         if (programId < plugin->getProgramCount())

  2071.             return plugin->setProgram(static_cast<int32_t>(programId), true, true, false);

  2072. 

  2073.         carla_stderr2("carla_set_program(%i, %i) - programId out of bounds", pluginId, programId);

  2074.         return;

  2075.     }

  2076. 

  2077.     carla_stderr2("carla_set_program(%i, %i) - could not find plugin", pluginId, programId);

  2078. }

  2079. 

  2080. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2081. {

  2082.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2083.     carla_debug("carla_set_midi_program(%i, %i)", pluginId, midiProgramId);

  2084. 

  2085.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2086.     {

  2087.         if (midiProgramId < plugin->getMidiProgramCount())

  2088.             return plugin->setMidiProgram(static_cast<int32_t>(midiProgramId), true, true, false);

  2089. 

  2090.         carla_stderr2("carla_set_midi_program(%i, %i) - midiProgramId out of bounds", pluginId, midiProgramId);

  2091.         return;

  2092.     }

  2093. 

  2094.     carla_stderr2("carla_set_midi_program(%i, %i) - could not find plugin", pluginId, midiProgramId);

  2095. }

  2096. 

  2097. // -------------------------------------------------------------------------------------------------------------------

  2098. 

  2099. void carla_set_custom_data(uint pluginId, const char* type, const char* key, const char* value)

  2100. {

  2101.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2102.     CARLA_SAFE_ASSERT_RETURN(type != nullptr && type[0] != '\0',);

  2103.     CARLA_SAFE_ASSERT_RETURN(key != nullptr && key[0] != '\0',);

  2104.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

  2105.     carla_debug("carla_set_custom_data(%i, \"%s\", \"%s\", \"%s\")", pluginId, type, key, value);

  2106. 

  2107.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2108.         return plugin->setCustomData(type, key, value, true);

  2109. 

  2110.     carla_stderr2("carla_set_custom_data(%i, \"%s\", \"%s\", \"%s\") - could not find plugin", pluginId, type, key, value);

  2111. }

  2112. 

  2113. void carla_set_chunk_data(uint pluginId, const char* chunkData)

  2114. {

  2115.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2116.     CARLA_SAFE_ASSERT_RETURN(chunkData != nullptr && chunkData[0] != '\0',);

  2117.     carla_debug("carla_set_chunk_data(%i, \"%s\")", pluginId, chunkData);

  2118. 

  2119.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2120.     {

  2121.         if (plugin->getOptionsEnabled() & CB::PLUGIN_OPTION_USE_CHUNKS)

  2122.         {

  2123.             std::vector<uint8_t> chunk(carla_getChunkFromBase64String(chunkData));

  2124.             return plugin->setChunkData(chunk.data(), chunk.size());

  2125.         }

  2126. 

  2127.         carla_stderr2("carla_set_chunk_data(%i, \"%s\") - plugin does not use chunks", pluginId, chunkData);

  2128.         return;

  2129.     }

  2130. 

  2131.     carla_stderr2("carla_set_chunk_data(%i, \"%s\") - could not find plugin", pluginId, chunkData);

  2132. }

  2133. 

  2134. // -------------------------------------------------------------------------------------------------------------------

  2135. 

  2136. void carla_prepare_for_save(uint pluginId)

  2137. {

  2138.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2139.     carla_debug("carla_prepare_for_save(%i)", pluginId);

  2140. 

  2141.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2142.         return plugin->prepareForSave();

  2143. 

  2144.     carla_stderr2("carla_prepare_for_save(%i) - could not find plugin", pluginId);

  2145. }

  2146. 

  2147. void carla_reset_parameters(uint pluginId)

  2148. {

  2149.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2150.     carla_debug("carla_reset_parameters(%i)", pluginId);

  2151. 

  2152.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2153.         return plugin->resetParameters();

  2154. 

  2155.     carla_stderr2("carla_reset_parameters(%i) - could not find plugin", pluginId);

  2156. }

  2157. 

  2158. void carla_randomize_parameters(uint pluginId)

  2159. {

  2160.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2161.     carla_debug("carla_randomize_parameters(%i)", pluginId);

  2162. 

  2163.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2164.         return plugin->randomizeParameters();

  2165. 

  2166.     carla_stderr2("carla_randomize_parameters(%i) - could not find plugin", pluginId);

  2167. }

  2168. 

  2169. #ifndef BUILD_BRIDGE

  2170. void carla_send_midi_note(uint pluginId, uint8_t channel, uint8_t note, uint8_t velocity)

  2171. {

  2172.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr && gStandalone.engine->isRunning(),);

  2173.     carla_debug("carla_send_midi_note(%i, %i, %i, %i)", pluginId, channel, note, velocity);

  2174. 

  2175.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2176.         return plugin->sendMidiSingleNote(channel, note, velocity, true, true, false);

  2177. 

  2178.     carla_stderr2("carla_send_midi_note(%i, %i, %i, %i) - could not find plugin", pluginId, channel, note, velocity);

  2179. }

  2180. #endif

  2181. 

  2182. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2183. {

  2184.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr,);

  2185.     carla_debug("carla_show_custom_ui(%i, %s)", pluginId, bool2str(yesNo));

  2186. 

  2187.     if (CarlaPlugin* const plugin = gStandalone.engine->getPlugin(pluginId))

  2188.         return plugin->showCustomUI(yesNo);

  2189. 

  2190.     carla_stderr2("carla_show_custom_ui(%i, %s) - could not find plugin", pluginId, bool2str(yesNo));

  2191. }

  2192. 

  2193. // -------------------------------------------------------------------------------------------------------------------

  2194. 

  2195. uint32_t carla_get_buffer_size()

  2196. {

  2197.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0);

  2198.     carla_debug("carla_get_buffer_size()");

  2199. 

  2200.     return gStandalone.engine->getBufferSize();

  2201. }

  2202. 

  2203. double carla_get_sample_rate()

  2204. {

  2205.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, 0.0);

  2206.     carla_debug("carla_get_sample_rate()");

  2207. 

  2208.     return gStandalone.engine->getSampleRate();

  2209. }

  2210. 

  2211. // -------------------------------------------------------------------------------------------------------------------

  2212. 

  2213. const char* carla_get_last_error()

  2214. {

  2215.     carla_debug("carla_get_last_error()");

  2216. 

  2217.     if (gStandalone.engine != nullptr)

  2218.         return gStandalone.engine->getLastError();

  2219. 

  2220.     return gStandalone.lastError;

  2221. }

  2222. 

  2223. const char* carla_get_host_osc_url_tcp()

  2224. {

  2225.     carla_debug("carla_get_host_osc_url_tcp()");

  2226. 

  2227. #ifdef HAVE_LIBLO

  2228.     if (gStandalone.engine == nullptr)

  2229.     {

  2230.         carla_stderr2("Engine is not running");

  2231.         gStandalone.lastError = "Engine is not running";

  2232.         return nullptr;

  2233.     }

  2234. 

  2235.     return gStandalone.engine->getOscServerPathTCP();

  2236. #else

  2237.     return nullptr;

  2238. #endif

  2239. }

  2240. 

  2241. const char* carla_get_host_osc_url_udp()

  2242. {

  2243.     carla_debug("carla_get_host_osc_url_udp()");

  2244. 

  2245. #ifdef HAVE_LIBLO

  2246.     if (gStandalone.engine == nullptr)

  2247.     {

  2248.         carla_stderr2("Engine is not running");

  2249.         gStandalone.lastError = "Engine is not running";

  2250.         return nullptr;

  2251.     }

  2252. 

  2253.     return gStandalone.engine->getOscServerPathUDP();

  2254. #else

  2255.     return nullptr;

  2256. #endif

  2257. }

  2258. 

  2259. // -------------------------------------------------------------------------------------------------------------------

  2260. 

  2261. bool carla_nsm_init(int pid, const char* executableName)

  2262. {

  2263. #ifdef HAVE_LIBLO

  2264.     return CarlaNSM::getInstance().announce(pid, executableName);

  2265. #else

  2266.     return false;

  2267. 

  2268.     // unused

  2269.     (void)pid; (void)executableName;

  2270. #endif

  2271. }

  2272. 

  2273. void carla_nsm_ready()

  2274. {

  2275. #ifdef HAVE_LIBLO

  2276.     CarlaNSM::getInstance().start();

  2277. #endif

  2278. }

  2279. 

  2280. // -------------------------------------------------------------------------------------------------------------------

  2281. 

  2282. #include "CarlaPluginUI.cpp"

  2283. #include "CarlaDssiUtils.cpp"

  2284. #include "CarlaPatchbayUtils.cpp"

  2285. #include "CarlaPipeUtils.cpp"

  2286. #include "CarlaStateUtils.cpp"

  2287. #include "CarlaJuceEvents.cpp"

  2288. 

  2289. // -------------------------------------------------------------------------------------------------------------------