falkTX
/
Carla
mirror of https://github.com/falkTX/Carla
1
0
Fork 0
Code Releases 42 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.
2691 Commits
16 Branches
141MB
Tree: 15a33efb90
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '15a33efb90'
${ noResults }
Carla/source/backend/CarlaStandalone.cpp

2206 lines
78KB
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:optional-gui:"

  93. #define NSM_CLIENT_FEATURES ":switch:"

  94. 

  95. class CarlaNSM

  96. {

  97. public:

  98.     CarlaNSM() noexcept

  99.         : fOscServer(nullptr),

  100.           fClientId(),

  101.           fProjectPath(),

  102.           fHasBroadcast(false),

  103.           fHasShowHideUI(false) {}

  104. 

  105.     ~CarlaNSM()

  106.     {

  107.         if (fOscServer != nullptr)

  108.         {

  109.             lo_server_del_method(fOscServer, "/reply", "ssss");

  110.             lo_server_del_method(fOscServer, "/nsm/client/open", "sss");

  111.             lo_server_del_method(fOscServer, "/nsm/client/save", "");

  112.             //lo_server_del_method(fOscServer, "/nsm/client/show_optional_gui", "");

  113.             //lo_server_del_method(fOscServer, "/nsm/client/hide_optional_gui", "");

  114.             lo_server_free(fOscServer);

  115.             fOscServer = nullptr;

  116.         }

  117.     }

  118. 

  119.     void announce(const int pid, const char* const initName)

  120.     {

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

  122. 

  123.         if (NSM_URL == nullptr)

  124.             return;

  125. 

  126.         const lo_address addr = lo_address_new_from_url(NSM_URL);

  127.         CARLA_SAFE_ASSERT_RETURN(addr != nullptr,);

  128. 

  129.         const int proto = lo_address_get_protocol(addr);

  130. 

  131.         if (fOscServer == nullptr)

  132.         {

  133.             // create new OSC server

  134.             fOscServer = lo_server_new_with_proto(nullptr, proto, _error_handler);

  135. 

  136.             // register message handlers and start OSC thread

  137.             lo_server_add_method(fOscServer, "/reply",           "ssss", _reply_handler, this);

  138.             lo_server_add_method(fOscServer, "/nsm/client/open", "sss",  _open_handler,  this);

  139.             lo_server_add_method(fOscServer, "/nsm/client/save", "",     _save_handler,  this);

  140.             //lo_server_add_method(fOscServer, "/nsm/client/show_optional_gui", "", _show_gui_handler, this);

  141.             //lo_server_add_method(fOscServer, "/nsm/client/hide_optional_gui", "", _hide_gui_handler, this);

  142.             // /nsm/client/session_is_loaded

  143.         }

  144. 

  145. #ifndef BUILD_ANSI_TEST

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

  147.                      "Carla", NSM_CLIENT_FEATURES, initName, NSM_API_VERSION_MAJOR, NSM_API_VERSION_MINOR, pid);

  148. #endif

  149. 

  150.         lo_address_free(addr);

  151.     }

  152. 

  153.     void idle() noexcept

  154.     {

  155.         if (fOscServer == nullptr)

  156.             return;

  157. 

  158.         for (;;)

  159.         {

  160.             try {

  161.                 if (lo_server_recv_noblock(fOscServer, 0) == 0)

  162.                     break;

  163.             } CARLA_SAFE_EXCEPTION_CONTINUE("NSM OSC idle")

  164.         }

  165.     }

  166. 

  167. protected:

  168.     int handleReply(const char* const path, const char* const types, lo_arg** const argv, const int argc, const lo_message msg)

  169.     {

  170.         carla_debug("CarlaNSM::handleReply(%s, %i, %p, %s, %p)", path, argc, argv, types, msg);

  171. 

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

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

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

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

  176. 

  177.         CARLA_SAFE_ASSERT_RETURN(std::strcmp(method, "/nsm/server/announce") == 0, 0);

  178. 

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

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

  181. 

  182.         carla_stdout("'%s' started: %s", smName, message);

  183. 

  184.         // TODO: send callback, disable open+save etc

  185. 

  186.         return 0;

  187. 

  188. #ifndef DEBUG

  189.         // unused

  190.         (void)path; (void)types; (void)argc; (void)msg;

  191. #endif

  192.     }

  193. 

  194.     // FIXME

  195.     int handleOpen(const char* const path, const char* const types, lo_arg** const argv, const int argc, const lo_message msg)

  196.     {

  197.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 0);

  198.         carla_debug("CarlaNSM::handleOpen(\"%s\", \"%s\", %p, %i, %p)", path, types, argv, argc, msg);

  199. 

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

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

  202.         const char* const clientId    = &argv[2]->s;

  203. 

  204.         if (! carla_is_engine_running())

  205.         {

  206. #ifndef BUILD_BRIDGE

  207.             gStandalone.engineOptions.processMode   = CB::ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS;

  208.             gStandalone.engineOptions.transportMode = CB::ENGINE_TRANSPORT_MODE_JACK;

  209. #endif

  210. 

  211.             carla_engine_init("JACK", clientId);

  212.         }

  213.         else

  214.         {

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

  216. 

  217.             for (uint i=0, count=gStandalone.engine->getCurrentPluginCount(); i < count; ++i)

  218.                 gStandalone.engine->removePlugin(i);

  219.         }

  220. 

  221.         fClientId = clientId;

  222. 

  223.         fProjectPath  = projectPath;

  224.         fProjectPath += ".carxp";

  225. 

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

  227. 

  228.         if (juce::File(fProjectPath.buffer()).existsAsFile())

  229.             gStandalone.engine->loadProject(fProjectPath);

  230. 

  231. #ifndef BUILD_ANSI_TEST

  232.         lo_send_from(lo_message_get_source(msg), fOscServer, LO_TT_IMMEDIATE, "/reply", "ss", "/nsm/client/open", "OK");

  233. #endif

  234. 

  235. #if 0

  236.         if (fHasBroadcast)

  237.         {

  238.             char* const url = lo_server_get_url(fOscServer);

  239. 

  240.             lo_send(lo_message_get_source(msg), "/nsm/server/broadcast", "sssss",

  241.                             "/non/hello", url, "Carla", CARLA_VERSION_STRING, clientId);

  242. 

  243.             //lo_send_from(lo_message_get_source(msg), fOscServer, LO_TT_IMMEDIATE, "/nsm/server/broadcast", "sssss"

  244.             //             "/non/hello", url, "Carla", CARLA_VERSION_STRING, clientId);

  245. 

  246.             lo_send(lo_message_get_source(msg), "/signal/created", "ssfff", "/path/somewhere", true ? "in" : "out", 0.0f, 1.0f, 0.5f);

  247. 

  248.             std::free(url);

  249. 

  250.             carla_stdout("Broadcast sent!");

  251.         }

  252.         else

  253.             carla_stdout("Broadcast NOT NOT NOT sent!");

  254. #endif

  255. 

  256.         return 0;

  257. 

  258. #ifndef DEBUG

  259.         // unused

  260.         (void)path; (void)types; (void)argc; (void)msg;

  261. #endif

  262.     }

  263. 

  264.     int handleSave(const char* const path, const char* const types, lo_arg** const argv, const int argc, const lo_message msg)

  265.     {

  266.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 0);

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

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

  269.         carla_debug("CarlaNSM::handleSave(\"%s\", \"%s\", %p, %i, %p)", path, types, argv, argc, msg);

  270. 

  271.         gStandalone.engine->saveProject(fProjectPath);

  272. 

  273. #ifndef BUILD_ANSI_TEST

  274.         lo_send_from(lo_message_get_source(msg), fOscServer, LO_TT_IMMEDIATE, "/reply", "ss", "/nsm/client/save", "OK");

  275. #endif

  276. 

  277.         return 0;

  278. 

  279. #ifndef DEBUG

  280.         // unused

  281.         (void)path; (void)types; (void)argv; (void)argc; (void)msg;

  282. #endif

  283.     }

  284. 

  285. #if 0

  286.     int handleShowHideGui(const lo_message msg, const bool show)

  287.     {

  288.         CARLA_SAFE_ASSERT_RETURN(fOscServer != nullptr, 0);

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

  290.         //CARLA_SAFE_ASSERT_RETURN(gStandalone.frontendWinId != 0, 0);

  291.         carla_debug("CarlaNSM::handleShowHideGui(%s)", bool2str(show));

  292. 

  293. #ifndef BUILD_ANSI_TEST

  294.         lo_send_from(lo_message_get_source(msg), fOscServer, LO_TT_IMMEDIATE, show ? "/nsm/client/gui_is_shown" : "/nsm/client/gui_is_hidden", "");

  295. #endif

  296. 

  297.         return 0;

  298.     }

  299. #endif

  300. 

  301. private:

  302.     lo_server fOscServer;

  303. 

  304.     CarlaString fClientId;

  305.     CarlaString fProjectPath;

  306. 

  307.     bool fHasBroadcast;

  308.     bool fHasShowHideUI;

  309. 

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

  311. 

  312.     static void _error_handler(int num, const char* msg, const char* path)

  313.     {

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

  315.     }

  316. 

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

  318.     {

  319.         return handlePtr->handleReply(path, types, argv, argc, msg);

  320.     }

  321. 

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

  323.     {

  324.         return handlePtr->handleOpen(path, types, argv, argc, msg);

  325.     }

  326. 

  327.     static int _save_handler(const char* path, const char* types, lo_arg** argv, int argc, lo_message msg, void* data)

  328.     {

  329.         return handlePtr->handleSave(path, types, argv, argc, msg);

  330.     }

  331. 

  332. #if 0

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

  334.     {

  335.         return handlePtr->handleShowHideGui(true);

  336.     }

  337. 

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

  339.     {

  340.         return handlePtr->handleShowHideGui(false);

  341.     }

  342. #endif

  343. 

  344.     #undef handlePtr

  345. 

  346.     CARLA_PREVENT_HEAP_ALLOCATION

  347.     CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)

  348. };

  349. 

  350. static CarlaNSM gNSM;

  351. 

  352. #endif // HAVE_LIBLO

  353. 

  354. // -------------------------------------------------------------------------------------------------------------------

  355. // API

  356. 

  357. #define CARLA_COMMON_NEED_CHECKSTRINGPTR

  358. #include "CarlaHostCommon.cpp"

  359. 

  360. // -------------------------------------------------------------------------------------------------------------------

  361. 

  362. uint carla_get_engine_driver_count()

  363. {

  364.     carla_debug("carla_get_engine_driver_count()");

  365. 

  366.     return CarlaEngine::getDriverCount();

  367. }

  368. 

  369. const char* carla_get_engine_driver_name(uint index)

  370. {

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

  372. 

  373.     return CarlaEngine::getDriverName(index);

  374. }

  375. 

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

  377. {

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

  379. 

  380.     return CarlaEngine::getDriverDeviceNames(index);

  381. }

  382. 

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

  384. {

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

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

  387. 

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

  389.     {

  390.         static EngineDriverDeviceInfo devInfo;

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

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

  393. 

  394.         devInfo.hints       = ret->hints;

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

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

  397.         return &devInfo;

  398.     }

  399. 

  400.     return nullptr;

  401. }

  402. 

  403. // -------------------------------------------------------------------------------------------------------------------

  404. 

  405. CarlaEngine* carla_get_engine()

  406. {

  407.     carla_debug("carla_get_engine()");

  408. 

  409.     return gStandalone.engine;

  410. }

  411. 

  412. // -------------------------------------------------------------------------------------------------------------------

  413. 

  414. static void carla_engine_init_common()

  415. {

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

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

  418. 

  419. #ifdef BUILD_BRIDGE

  420.     using juce::File;

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

  422. 

  423.     /*

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

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

  426. 

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

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

  429. 

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

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

  432.     */

  433. 

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

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

  436. 

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

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

  439. 

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

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

  442. 

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

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

  445. 

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

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

  448. 

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

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

  451. 

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

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

  454. 

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

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

  457. 

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

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

  460. 

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

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

  463. 

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

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

  466. 

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

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

  469. 

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

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

  472.     else

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

  474. 

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

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

  477.     else

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

  479. 

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

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

  482. 

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

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

  485. #else

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

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

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

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

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

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

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

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

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

  495. 

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

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

  498. 

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

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

  501. 

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

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

  504. 

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

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

  507. 

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

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

  510. 

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

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

  513. 

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

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

  516. 

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

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

  519. 

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

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

  522. 

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

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

  525. 

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

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

  528. 

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

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

  531. 

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

  533. 

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

  535.     {

  536.         char strBuf[STR_MAX+1];

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

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

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

  540.     }

  541.     else

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

  543. #endif

  544. }

  545. 

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

  547. {

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

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

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

  551. 

  552.     if (gStandalone.engine != nullptr)

  553.     {

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

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

  556.         return false;

  557.     }

  558. 

  559. #ifdef CARLA_OS_WIN

  560.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  561. #endif

  562. 

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

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

  565.     {

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

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

  568.     }

  569. 

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

  571. 

  572.     if (gStandalone.engine == nullptr)

  573.     {

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

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

  576.         return false;

  577.     }

  578. 

  579. #ifdef BUILD_BRIDGE

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

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

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

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

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

  585. #else

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

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

  588. #endif

  589. 

  590.     carla_engine_init_common();

  591. 

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

  593.     {

  594. #ifndef BUILD_BRIDGE

  595.         juce::initialiseJuce_GUI();

  596. #endif

  597.         gStandalone.lastError = "No error";

  598.         return true;

  599.     }

  600.     else

  601.     {

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

  603.         delete gStandalone.engine;

  604.         gStandalone.engine = nullptr;

  605.         return false;

  606.     }

  607. }

  608. 

  609. #ifdef BUILD_BRIDGE

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

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

  612. {

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

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

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

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

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

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

  619. 

  620.     if (gStandalone.engine != nullptr)

  621.     {

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

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

  624.         return false;

  625.     }

  626. 

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

  628. 

  629.     if (gStandalone.engine == nullptr)

  630.     {

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

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

  633.         return false;

  634.     }

  635. 

  636.     carla_engine_init_common();

  637. 

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

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

  640. 

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

  642.     {

  643.         gStandalone.lastError = "No error";

  644.         return true;

  645.     }

  646.     else

  647.     {

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

  649.         delete gStandalone.engine;

  650.         gStandalone.engine = nullptr;

  651.         return false;

  652.     }

  653. }

  654. #endif

  655. 

  656. bool carla_engine_close()

  657. {

  658.     carla_debug("carla_engine_close()");

  659. 

  660.     if (gStandalone.engine == nullptr)

  661.     {

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

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

  664.         return false;

  665.     }

  666. 

  667.     gStandalone.engine->setAboutToClose();

  668.     gStandalone.engine->removeAllPlugins();

  669. 

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

  671. 

  672.     if (! closed)

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

  674. 

  675. #ifndef BUILD_BRIDGE

  676.     juce::shutdownJuce_GUI();

  677. #endif

  678.     delete gStandalone.engine;

  679.     gStandalone.engine = nullptr;

  680. 

  681.     return closed;

  682. }

  683. 

  684. void carla_engine_idle()

  685. {

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

  687. 

  688. #ifdef HAVE_LIBLO

  689.     gNSM.idle();

  690. #endif

  691.     gStandalone.engine->idle();

  692. }

  693. 

  694. bool carla_is_engine_running()

  695. {

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

  697. }

  698. 

  699. void carla_set_engine_about_to_close()

  700. {

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

  702.     carla_debug("carla_set_engine_about_to_close()");

  703. 

  704.     gStandalone.engine->setAboutToClose();

  705. }

  706. 

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

  708. {

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

  710. 

  711.     gStandalone.engineCallback    = func;

  712.     gStandalone.engineCallbackPtr = ptr;

  713. 

  714.     if (gStandalone.engine != nullptr)

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

  716. 

  717. //#ifdef WANT_LOGS

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

  719. //#endif

  720. }

  721. 

  722. #ifndef BUILD_BRIDGE

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

  724. {

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

  726. 

  727.     switch (option)

  728.     {

  729.     case CB::ENGINE_OPTION_DEBUG:

  730.         break;

  731. 

  732.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  735.         break;

  736. 

  737.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  740.         break;

  741. 

  742.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  745.         break;

  746. 

  747.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  750.         break;

  751. 

  752.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

  754.         gStandalone.engineOptions.preferUiBridges = (value != 0);

  755.         break;

  756. 

  757.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  760.         break;

  761. 

  762.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  763.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  765.         break;

  766. 

  767.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  768.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  770.         break;

  771. 

  772.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  775.         break;

  776. 

  777.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  778.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  780.         break;

  781. 

  782.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  783.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  785.         break;

  786. 

  787.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  788.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  789. 

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

  791.             delete[] gStandalone.engineOptions.audioDevice;

  792. 

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

  794.         break;

  795. 

  796.     case CB:: ENGINE_OPTION_NSM_INIT:

  797.         CARLA_SAFE_ASSERT_RETURN(value != 0,);

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

  799. #ifdef HAVE_LIBLO

  800.         gNSM.announce(value, valueStr);

  801. #endif

  802.         break;

  803. 

  804.     case CB::ENGINE_OPTION_PLUGIN_PATH:

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

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

  807.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  808. 

  809.         switch (value)

  810.         {

  811.         case CB::PLUGIN_LADSPA:

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

  813.                 delete[] gStandalone.engineOptions.pathLADSPA;

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

  815.             break;

  816.         case CB::PLUGIN_DSSI:

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

  818.                 delete[] gStandalone.engineOptions.pathDSSI;

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

  820.             break;

  821.         case CB::PLUGIN_LV2:

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

  823.                 delete[] gStandalone.engineOptions.pathLV2;

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

  825.             break;

  826.         case CB::PLUGIN_VST2:

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

  828.                 delete[] gStandalone.engineOptions.pathVST2;

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

  830.             break;

  831.         case CB::PLUGIN_VST3:

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

  833.                 delete[] gStandalone.engineOptions.pathVST3;

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

  835.             break;

  836.         case CB::PLUGIN_AU:

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

  838.                 delete[] gStandalone.engineOptions.pathAU;

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

  840.             break;

  841.         case CB::PLUGIN_GIG:

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

  843.                 delete[] gStandalone.engineOptions.pathGIG;

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

  845.             break;

  846.         case CB::PLUGIN_SF2:

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

  848.                 delete[] gStandalone.engineOptions.pathSF2;

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

  850.             break;

  851.         case CB::PLUGIN_SFZ:

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

  853.                 delete[] gStandalone.engineOptions.pathSFZ;

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

  855.             break;

  856.         }

  857.         break;

  858. 

  859.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  861. 

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

  863.             delete[] gStandalone.engineOptions.binaryDir;

  864. 

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

  866.         break;

  867. 

  868.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  870. 

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

  872.             delete[] gStandalone.engineOptions.resourceDir;

  873. 

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

  875.         break;

  876. 

  877.     case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

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

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

  880.         break;

  881. 

  882.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  885.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  887.         break;

  888.     }

  889. 

  890.     if (gStandalone.engine != nullptr)

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

  892. }

  893. #endif

  894. 

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

  896. {

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

  898. 

  899.     gStandalone.fileCallback    = func;

  900.     gStandalone.fileCallbackPtr = ptr;

  901. 

  902.     if (gStandalone.engine != nullptr)

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

  904. }

  905. 

  906. // -------------------------------------------------------------------------------------------------------------------

  907. 

  908. bool carla_load_file(const char* filename)

  909. {

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

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

  912. 

  913.     if (gStandalone.engine != nullptr)

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

  915. 

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

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

  918.     return false;

  919. }

  920. 

  921. bool carla_load_project(const char* filename)

  922. {

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

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

  925. 

  926.     if (gStandalone.engine != nullptr)

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

  928. 

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

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

  931.     return false;

  932. }

  933. 

  934. bool carla_save_project(const char* filename)

  935. {

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

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

  938. 

  939.     if (gStandalone.engine != nullptr)

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

  941. 

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

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

  944.     return false;

  945. }

  946. 

  947. #ifndef BUILD_BRIDGE

  948. // -------------------------------------------------------------------------------------------------------------------

  949. 

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

  951. {

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

  953. 

  954.     if (gStandalone.engine != nullptr)

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

  956. 

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

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

  959.     return false;

  960. }

  961. 

  962. bool carla_patchbay_disconnect(uint connectionId)

  963. {

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

  965. 

  966.     if (gStandalone.engine != nullptr)

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

  968. 

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

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

  971.     return false;

  972. }

  973. 

  974. bool carla_patchbay_refresh(bool external)

  975. {

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

  977. 

  978.     if (gStandalone.engine != nullptr)

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

  980. 

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

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

  983.     return false;

  984. }

  985. 

  986. // -------------------------------------------------------------------------------------------------------------------

  987. 

  988. void carla_transport_play()

  989. {

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

  991.     carla_debug("carla_transport_play()");

  992. 

  993.     gStandalone.engine->transportPlay();

  994. }

  995. 

  996. void carla_transport_pause()

  997. {

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

  999.     carla_debug("carla_transport_pause()");

  1000. 

  1001.     gStandalone.engine->transportPause();

  1002. }

  1003. 

  1004. void carla_transport_relocate(uint64_t frame)

  1005. {

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

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

  1008. 

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

  1010. }

  1011. 

  1012. uint64_t carla_get_current_transport_frame()

  1013. {

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

  1015. 

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

  1017.     return timeInfo.frame;

  1018. }

  1019. 

  1020. const CarlaTransportInfo* carla_get_transport_info()

  1021. {

  1022.     static CarlaTransportInfo retInfo;

  1023. 

  1024.     // reset

  1025.     retInfo.playing = false;

  1026.     retInfo.frame   = 0;

  1027.     retInfo.bar     = 0;

  1028.     retInfo.beat    = 0;

  1029.     retInfo.tick    = 0;

  1030.     retInfo.bpm     = 0.0;

  1031. 

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

  1033. 

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

  1035. 

  1036.     retInfo.playing = timeInfo.playing;

  1037.     retInfo.frame   = timeInfo.frame;

  1038. 

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

  1040.     {

  1041.         retInfo.bar  = timeInfo.bbt.bar;

  1042.         retInfo.beat = timeInfo.bbt.beat;

  1043.         retInfo.tick = timeInfo.bbt.tick;

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

  1045.     }

  1046. 

  1047.     return &retInfo;

  1048. }

  1049. #endif

  1050. 

  1051. // -------------------------------------------------------------------------------------------------------------------

  1052. 

  1053. uint32_t carla_get_current_plugin_count()

  1054. {

  1055.     if (gStandalone.engine != nullptr)

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

  1057. 

  1058.     return 0;

  1059. }

  1060. 

  1061. uint32_t carla_get_max_plugin_number()

  1062. {

  1063.     if (gStandalone.engine != nullptr)

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

  1065. 

  1066.     return 0;

  1067. }

  1068. 

  1069. // -------------------------------------------------------------------------------------------------------------------

  1070. 

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

  1072. {

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

  1074. 

  1075.     if (gStandalone.engine != nullptr)

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

  1077. 

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

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

  1080.     return false;

  1081. }

  1082. 

  1083. bool carla_remove_plugin(uint pluginId)

  1084. {

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

  1086. 

  1087.     if (gStandalone.engine != nullptr)

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

  1089. 

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

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

  1092.     return false;

  1093. }

  1094. 

  1095. bool carla_remove_all_plugins()

  1096. {

  1097.     carla_debug("carla_remove_all_plugins()");

  1098. 

  1099.     if (gStandalone.engine != nullptr)

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

  1101. 

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

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

  1104.     return false;

  1105. }

  1106. 

  1107. #ifndef BUILD_BRIDGE

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

  1109. {

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

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

  1112. 

  1113.     if (gStandalone.engine != nullptr)

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

  1115. 

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

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

  1118.     return nullptr;

  1119. }

  1120. 

  1121. bool carla_clone_plugin(uint pluginId)

  1122. {

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

  1124. 

  1125.     if (gStandalone.engine != nullptr)

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

  1127. 

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

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

  1130.     return false;

  1131. }

  1132. 

  1133. bool carla_replace_plugin(uint pluginId)

  1134. {

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

  1136. 

  1137.     if (gStandalone.engine != nullptr)

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

  1139. 

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

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

  1142.     return false;

  1143. }

  1144. 

  1145. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1146. {

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

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

  1149. 

  1150.     if (gStandalone.engine != nullptr)

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

  1152. 

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

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

  1155.     return false;

  1156. }

  1157. #endif

  1158. 

  1159. // -------------------------------------------------------------------------------------------------------------------

  1160. 

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

  1162. {

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

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

  1165. 

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

  1167.     {

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

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

  1170.         return false;

  1171.     }

  1172. 

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

  1174.         return plugin->loadStateFromFile(filename);

  1175. 

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

  1177.     return false;

  1178. }

  1179. 

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

  1181. {

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

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

  1184. 

  1185.     if (gStandalone.engine == nullptr)

  1186.     {

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

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

  1189.         return false;

  1190.     }

  1191. 

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

  1193. 

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

  1195.         return plugin->saveStateToFile(filename);

  1196. 

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

  1198.     return false;

  1199. }

  1200. 

  1201. // -------------------------------------------------------------------------------------------------------------------

  1202. 

  1203. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1204. {

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

  1206. 

  1207.     static CarlaPluginInfo info;

  1208. 

  1209.     // reset

  1210.     info.type             = CB::PLUGIN_NONE;

  1211.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1212.     info.hints            = 0x0;

  1213.     info.optionsAvailable = 0x0;

  1214.     info.optionsEnabled   = 0x0;

  1215.     info.filename         = gNullCharPtr;

  1216.     info.name             = gNullCharPtr;

  1217.     info.iconName         = gNullCharPtr;

  1218.     info.uniqueId         = 0;

  1219. 

  1220.     // cleanup

  1221.     if (info.label != gNullCharPtr)

  1222.     {

  1223.         delete[] info.label;

  1224.         info.label = gNullCharPtr;

  1225.     }

  1226. 

  1227.     if (info.maker != gNullCharPtr)

  1228.     {

  1229.         delete[] info.maker;

  1230.         info.maker = gNullCharPtr;

  1231.     }

  1232. 

  1233.     if (info.copyright != gNullCharPtr)

  1234.     {

  1235.         delete[] info.copyright;

  1236.         info.copyright = gNullCharPtr;

  1237.     }

  1238. 

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

  1240. 

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

  1242.     {

  1243.         char strBufLabel[STR_MAX+1];

  1244.         char strBufMaker[STR_MAX+1];

  1245.         char strBufCopyright[STR_MAX+1];

  1246. 

  1247.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1248.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1249.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1250. 

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

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

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

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

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

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

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

  1258. 

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

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

  1261. 

  1262.         plugin->getLabel(strBufLabel);

  1263.         info.label = carla_strdup_safe(strBufLabel);

  1264. 

  1265.         plugin->getMaker(strBufMaker);

  1266.         info.maker = carla_strdup_safe(strBufMaker);

  1267. 

  1268.         plugin->getCopyright(strBufCopyright);

  1269.         info.copyright = carla_strdup_safe(strBufCopyright);

  1270. 

  1271.         checkStringPtr(info.filename);

  1272.         checkStringPtr(info.name);

  1273.         checkStringPtr(info.iconName);

  1274.         checkStringPtr(info.label);

  1275.         checkStringPtr(info.maker);

  1276.         checkStringPtr(info.copyright);

  1277. 

  1278.         return &info;

  1279.     }

  1280. 

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

  1282.     return &info;

  1283. }

  1284. 

  1285. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1286. {

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

  1288. 

  1289.     static CarlaPortCountInfo info;

  1290. 

  1291.     // reset

  1292.     info.ins   = 0;

  1293.     info.outs  = 0;

  1294. 

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

  1296. 

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

  1298.     {

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

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

  1301.         return &info;

  1302.     }

  1303. 

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

  1305.     return &info;

  1306. }

  1307. 

  1308. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1309. {

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

  1311. 

  1312.     static CarlaPortCountInfo info;

  1313. 

  1314.     // reset

  1315.     info.ins   = 0;

  1316.     info.outs  = 0;

  1317. 

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

  1319. 

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

  1321.     {

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

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

  1324.         return &info;

  1325.     }

  1326. 

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

  1328.     return &info;

  1329. }

  1330. 

  1331. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1332. {

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

  1334. 

  1335.     static CarlaPortCountInfo info;

  1336. 

  1337.     // reset

  1338.     info.ins   = 0;

  1339.     info.outs  = 0;

  1340. 

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

  1342. 

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

  1344.     {

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

  1346.         return &info;

  1347.     }

  1348. 

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

  1350.     return &info;

  1351. }

  1352. 

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

  1354. {

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

  1356. 

  1357.     static CarlaParameterInfo info;

  1358. 

  1359.     // reset

  1360.     info.scalePointCount = 0;

  1361. 

  1362.     // cleanup

  1363.     if (info.name != gNullCharPtr)

  1364.     {

  1365.         delete[] info.name;

  1366.         info.name = gNullCharPtr;

  1367.     }

  1368. 

  1369.     if (info.symbol != gNullCharPtr)

  1370.     {

  1371.         delete[] info.symbol;

  1372.         info.symbol = gNullCharPtr;

  1373.     }

  1374. 

  1375.     if (info.unit != gNullCharPtr)

  1376.     {

  1377.         delete[] info.unit;

  1378.         info.unit = gNullCharPtr;

  1379.     }

  1380. 

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

  1382. 

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

  1384.     {

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

  1386.         {

  1387.             char strBufName[STR_MAX+1];

  1388.             char strBufSymbol[STR_MAX+1];

  1389.             char strBufUnit[STR_MAX+1];

  1390. 

  1391.             carla_zeroChar(strBufName, STR_MAX+1);

  1392.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1393.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1394. 

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

  1396. 

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

  1398.             info.name = carla_strdup_safe(strBufName);

  1399. 

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

  1401.             info.symbol = carla_strdup_safe(strBufSymbol);

  1402. 

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

  1404.             info.unit = carla_strdup_safe(strBufUnit);

  1405. 

  1406.             checkStringPtr(info.name);

  1407.             checkStringPtr(info.symbol);

  1408.             checkStringPtr(info.unit);

  1409.         }

  1410.         else

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

  1412. 

  1413.         return &info;

  1414.     }

  1415. 

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

  1417.     return &info;

  1418. }

  1419. 

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

  1421. {

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

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

  1424. 

  1425.     static CarlaScalePointInfo info;

  1426. 

  1427.     // reset

  1428.     info.value = 0.0f;

  1429. 

  1430.     // cleanup

  1431.     if (info.label != gNullCharPtr)

  1432.     {

  1433.         delete[] info.label;

  1434.         info.label = gNullCharPtr;

  1435.     }

  1436. 

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

  1438. 

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

  1440.     {

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

  1442.         {

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

  1444.             {

  1445.                 char strBufLabel[STR_MAX+1];

  1446.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1447. 

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

  1449. 

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

  1451.                 info.label = carla_strdup_safe(strBufLabel);

  1452.                 checkStringPtr(info.label);

  1453.             }

  1454.             else

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

  1456.         }

  1457.         else

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

  1459. 

  1460.         return &info;

  1461.     }

  1462. 

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

  1464.     return &info;

  1465. }

  1466. 

  1467. // -------------------------------------------------------------------------------------------------------------------

  1468. 

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

  1470. {

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

  1472. 

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

  1474. 

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

  1476. 

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

  1478.     {

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

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

  1481. 

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

  1483.         return &fallbackParameterData;

  1484.     }

  1485. 

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

  1487.     return &fallbackParameterData;

  1488. }

  1489. 

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

  1491. {

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

  1493. 

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

  1495. 

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

  1497. 

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

  1499.     {

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

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

  1502. 

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

  1504.         return &fallbackParamRanges;

  1505.     }

  1506. 

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

  1508.     return &fallbackParamRanges;

  1509. }

  1510. 

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

  1512. {

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

  1514. 

  1515.     static MidiProgramData midiProgData;

  1516. 

  1517.     // reset

  1518.     midiProgData.bank    = 0;

  1519.     midiProgData.program = 0;

  1520.     midiProgData.name    = gNullCharPtr;

  1521. 

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

  1523. 

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

  1525.     {

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

  1527.         {

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

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

  1530.             checkStringPtr(midiProgData.name);

  1531.             return &midiProgData;

  1532.         }

  1533. 

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

  1535.         return &midiProgData;

  1536.     }

  1537. 

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

  1539.     return &midiProgData;

  1540. }

  1541. 

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

  1543. {

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

  1545. 

  1546.     static CustomData customData;

  1547. 

  1548.     // reset

  1549.     customData.type  = gNullCharPtr;

  1550.     customData.key   = gNullCharPtr;

  1551.     customData.value = gNullCharPtr;

  1552. 

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

  1554. 

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

  1556.     {

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

  1558.         {

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

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

  1561.             checkStringPtr(customData.type);

  1562.             checkStringPtr(customData.key);

  1563.             checkStringPtr(customData.value);

  1564.             return &customData;

  1565.         }

  1566. 

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

  1568.         return &customData;

  1569.     }

  1570. 

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

  1572.     return &customData;

  1573. }

  1574. 

  1575. const char* carla_get_chunk_data(uint pluginId)

  1576. {

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

  1578. 

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

  1580. 

  1581.     static CarlaString chunkData;

  1582. 

  1583.     // cleanup

  1584.     chunkData.clear();

  1585. 

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

  1587.     {

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

  1589.         {

  1590.             void* data = nullptr;

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

  1592. 

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

  1594.             {

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

  1596.                 return chunkData;

  1597.             }

  1598.             else

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

  1600.         }

  1601.         else

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

  1603. 

  1604.         return nullptr;

  1605.     }

  1606. 

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

  1608.     return nullptr;

  1609. }

  1610. 

  1611. // -------------------------------------------------------------------------------------------------------------------

  1612. 

  1613. uint32_t carla_get_parameter_count(uint pluginId)

  1614. {

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

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

  1617. 

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

  1619.         return plugin->getParameterCount();

  1620. 

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

  1622.     return 0;

  1623. }

  1624. 

  1625. uint32_t carla_get_program_count(uint pluginId)

  1626. {

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

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

  1629. 

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

  1631.         return plugin->getProgramCount();

  1632. 

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

  1634.     return 0;

  1635. }

  1636. 

  1637. uint32_t carla_get_midi_program_count(uint pluginId)

  1638. {

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

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

  1641. 

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

  1643.         return plugin->getMidiProgramCount();

  1644. 

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

  1646.     return 0;

  1647. }

  1648. 

  1649. uint32_t carla_get_custom_data_count(uint pluginId)

  1650. {

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

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

  1653. 

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

  1655.         return plugin->getCustomDataCount();

  1656. 

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

  1658.     return 0;

  1659. }

  1660. 

  1661. // -------------------------------------------------------------------------------------------------------------------

  1662. 

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

  1664. {

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

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

  1667. 

  1668.     static char textBuf[STR_MAX+1];

  1669. 

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

  1671.     {

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

  1673.         {

  1674.             carla_zeroChar(textBuf, STR_MAX+1);

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

  1676.             return textBuf;

  1677.         }

  1678. 

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

  1680.         return nullptr;

  1681.     }

  1682. 

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

  1684.     return nullptr;

  1685. }

  1686. 

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

  1688. {

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

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

  1691. 

  1692.     static char programName[STR_MAX+1];

  1693. 

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

  1695.     {

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

  1697.         {

  1698.             carla_zeroChar(programName, STR_MAX+1);

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

  1700.             return programName;

  1701.         }

  1702. 

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

  1704.         return nullptr;

  1705.     }

  1706. 

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

  1708.     return nullptr;

  1709. }

  1710. 

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

  1712. {

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

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

  1715. 

  1716.     static char midiProgramName[STR_MAX+1];

  1717. 

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

  1719.     {

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

  1721.         {

  1722.             carla_zeroChar(midiProgramName, STR_MAX+1);

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

  1724.             return midiProgramName;

  1725.         }

  1726. 

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

  1728.         return nullptr;

  1729.     }

  1730. 

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

  1732.     return nullptr;

  1733. }

  1734. 

  1735. const char* carla_get_real_plugin_name(uint pluginId)

  1736. {

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

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

  1739. 

  1740.     static char realPluginName[STR_MAX+1];

  1741. 

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

  1743.     {

  1744.         carla_zeroChar(realPluginName, STR_MAX+1);

  1745.         plugin->getRealName(realPluginName);

  1746.         return realPluginName;

  1747.     }

  1748. 

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

  1750.     return nullptr;

  1751. }

  1752. 

  1753. // -------------------------------------------------------------------------------------------------------------------

  1754. 

  1755. int32_t carla_get_current_program_index(uint pluginId)

  1756. {

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

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

  1759. 

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

  1761.         return plugin->getCurrentProgram();

  1762. 

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

  1764.     return -1;

  1765. }

  1766. 

  1767. int32_t carla_get_current_midi_program_index(uint pluginId)

  1768. {

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

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

  1771. 

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

  1773.         return plugin->getCurrentMidiProgram();

  1774. 

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

  1776.     return -1;

  1777. }

  1778. 

  1779. // -------------------------------------------------------------------------------------------------------------------

  1780. 

  1781. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  1782. {

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

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

  1785. 

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

  1787.     {

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

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

  1790. 

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

  1792.         return 0.0f;

  1793.     }

  1794. 

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

  1796.     return 0.0f;

  1797. }

  1798. 

  1799. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  1800. {

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

  1802. 

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

  1804.     {

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

  1806.             return plugin->getParameterValue(parameterId);

  1807. 

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

  1809.         return 0.0f;

  1810.     }

  1811. 

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

  1813.     return 0.0f;

  1814. }

  1815. 

  1816. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  1817. {

  1818. #ifdef BUILD_BRIDGE

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

  1820. #else

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

  1822. #endif

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

  1824. 

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

  1826.         return plugin->getInternalParameterValue(parameterId);

  1827. 

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

  1829.     return 0.0f;

  1830. }

  1831. 

  1832. // -------------------------------------------------------------------------------------------------------------------

  1833. 

  1834. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  1835. {

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

  1837. 

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

  1839. }

  1840. 

  1841. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  1842. {

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

  1844. 

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

  1846. }

  1847. 

  1848. // -------------------------------------------------------------------------------------------------------------------

  1849. 

  1850. void carla_set_active(uint pluginId, bool onOff)

  1851. {

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

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

  1854. 

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

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

  1857. 

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

  1859. }

  1860. 

  1861. #ifndef BUILD_BRIDGE

  1862. void carla_set_drywet(uint pluginId, float value)

  1863. {

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

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

  1866. 

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

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

  1869. 

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

  1871. }

  1872. 

  1873. void carla_set_volume(uint pluginId, float value)

  1874. {

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

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

  1877. 

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

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

  1880. 

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

  1882. }

  1883. 

  1884. void carla_set_balance_left(uint pluginId, float value)

  1885. {

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

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

  1888. 

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

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

  1891. 

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

  1893. }

  1894. 

  1895. void carla_set_balance_right(uint pluginId, float value)

  1896. {

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

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

  1899. 

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

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

  1902. 

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

  1904. }

  1905. 

  1906. void carla_set_panning(uint pluginId, float value)

  1907. {

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

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

  1910. 

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

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

  1913. 

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

  1915. }

  1916. 

  1917. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  1918. {

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

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

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

  1922. 

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

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

  1925. 

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

  1927. }

  1928. 

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

  1930. {

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

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

  1933. 

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

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

  1936. 

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

  1938. }

  1939. #endif

  1940. 

  1941. // -------------------------------------------------------------------------------------------------------------------

  1942. 

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

  1944. {

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

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

  1947. 

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

  1949.     {

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

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

  1952. 

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

  1954.         return;

  1955.     }

  1956. 

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

  1958. }

  1959. 

  1960. #ifndef BUILD_BRIDGE

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

  1962. {

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

  1964.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  1966. 

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

  1968.     {

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

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

  1971. 

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

  1973.         return;

  1974.     }

  1975. 

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

  1977. }

  1978. 

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

  1980. {

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

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

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

  1984. 

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

  1986.     {

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

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

  1989. 

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

  1991.         return;

  1992.     }

  1993. 

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

  1995. }

  1996. #endif

  1997. 

  1998. // -------------------------------------------------------------------------------------------------------------------

  1999. 

  2000. void carla_set_program(uint pluginId, uint32_t programId)

  2001. {

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

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

  2004. 

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

  2006.     {

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

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

  2009. 

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

  2011.         return;

  2012.     }

  2013. 

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

  2015. }

  2016. 

  2017. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2018. {

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

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

  2021. 

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

  2023.     {

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

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

  2026. 

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

  2028.         return;

  2029.     }

  2030. 

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

  2032. }

  2033. 

  2034. // -------------------------------------------------------------------------------------------------------------------

  2035. 

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

  2037. {

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

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

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

  2041.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  2043. 

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

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

  2046. 

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

  2048. }

  2049. 

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

  2051. {

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

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

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

  2055. 

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

  2057.     {

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

  2059.         {

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

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

  2062.         }

  2063. 

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

  2065.         return;

  2066.     }

  2067. 

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

  2069. }

  2070. 

  2071. // -------------------------------------------------------------------------------------------------------------------

  2072. 

  2073. void carla_prepare_for_save(uint pluginId)

  2074. {

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

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

  2077. 

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

  2079.         return plugin->prepareForSave();

  2080. 

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

  2082. }

  2083. 

  2084. void carla_reset_parameters(uint pluginId)

  2085. {

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

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

  2088. 

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

  2090.         return plugin->resetParameters();

  2091. 

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

  2093. }

  2094. 

  2095. void carla_randomize_parameters(uint pluginId)

  2096. {

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

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

  2099. 

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

  2101.         return plugin->randomizeParameters();

  2102. 

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

  2104. }

  2105. 

  2106. #ifndef BUILD_BRIDGE

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

  2108. {

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

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

  2111. 

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

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

  2114. 

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

  2116. }

  2117. #endif

  2118. 

  2119. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2120. {

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

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

  2123. 

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

  2125.         return plugin->showCustomUI(yesNo);

  2126. 

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

  2128. }

  2129. 

  2130. // -------------------------------------------------------------------------------------------------------------------

  2131. 

  2132. uint32_t carla_get_buffer_size()

  2133. {

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

  2135.     carla_debug("carla_get_buffer_size()");

  2136. 

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

  2138. }

  2139. 

  2140. double carla_get_sample_rate()

  2141. {

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

  2143.     carla_debug("carla_get_sample_rate()");

  2144. 

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

  2146. }

  2147. 

  2148. // -------------------------------------------------------------------------------------------------------------------

  2149. 

  2150. const char* carla_get_last_error()

  2151. {

  2152.     carla_debug("carla_get_last_error()");

  2153. 

  2154.     if (gStandalone.engine != nullptr)

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

  2156. 

  2157.     return gStandalone.lastError;

  2158. }

  2159. 

  2160. const char* carla_get_host_osc_url_tcp()

  2161. {

  2162.     carla_debug("carla_get_host_osc_url_tcp()");

  2163. 

  2164. #ifdef HAVE_LIBLO

  2165.     if (gStandalone.engine == nullptr)

  2166.     {

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

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

  2169.         return nullptr;

  2170.     }

  2171. 

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

  2173. #else

  2174.     return nullptr;

  2175. #endif

  2176. }

  2177. 

  2178. const char* carla_get_host_osc_url_udp()

  2179. {

  2180.     carla_debug("carla_get_host_osc_url_udp()");

  2181. 

  2182. #ifdef HAVE_LIBLO

  2183.     if (gStandalone.engine == nullptr)

  2184.     {

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

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

  2187.         return nullptr;

  2188.     }

  2189. 

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

  2191. #else

  2192.     return nullptr;

  2193. #endif

  2194. }

  2195. 

  2196. // -------------------------------------------------------------------------------------------------------------------

  2197. 

  2198. #include "CarlaPluginUI.cpp"

  2199. #include "CarlaDssiUtils.cpp"

  2200. #include "CarlaPatchbayUtils.cpp"

  2201. #include "CarlaPipeUtils.cpp"

  2202. #include "CarlaStateUtils.cpp"

  2203. #include "CarlaJuceEvents.cpp"

  2204. 

  2205. // -------------------------------------------------------------------------------------------------------------------