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.
3866 Commits
16 Branches
322MB
Tree: b08ade977c
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'b08ade977c'
${ noResults }
Carla/source/backend/CarlaStandalone.cpp

2012 lines
72KB
Raw Blame History 

  1. /*

  2.  * Carla Standalone

  3.  * Copyright (C) 2011-2017 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 BUILD_BRIDGE

  31. # include "water/water.h"

  32. #else

  33. # include "CarlaLogThread.hpp"

  34. #endif

  35. 

  36. namespace CB = CarlaBackend;

  37. using CB::EngineOptions;

  38. 

  39. // -------------------------------------------------------------------------------------------------------------------

  40. // Single, standalone engine

  41. 

  42. struct CarlaBackendStandalone {

  43.     CarlaEngine*       engine;

  44.     EngineCallbackFunc engineCallback;

  45.     void*              engineCallbackPtr;

  46. #ifndef BUILD_BRIDGE

  47.     EngineOptions      engineOptions;

  48.     CarlaLogThread     logThread;

  49.     bool               logThreadEnabled;

  50. #endif

  51. 

  52.     FileCallbackFunc fileCallback;

  53.     void*            fileCallbackPtr;

  54. 

  55.     CarlaString lastError;

  56. 

  57.     CarlaBackendStandalone() noexcept

  58.         : engine(nullptr),

  59.           engineCallback(nullptr),

  60.           engineCallbackPtr(nullptr),

  61. #ifndef BUILD_BRIDGE

  62.           engineOptions(),

  63.           logThread(),

  64.           logThreadEnabled(false),

  65. #endif

  66.           fileCallback(nullptr),

  67.           fileCallbackPtr(nullptr),

  68.           lastError() {}

  69. 

  70.     ~CarlaBackendStandalone() noexcept

  71.     {

  72.         CARLA_SAFE_ASSERT(engine == nullptr);

  73.     }

  74. 

  75.     CARLA_PREVENT_HEAP_ALLOCATION

  76.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  77. };

  78. 

  79. CarlaBackendStandalone gStandalone;

  80. 

  81. // -------------------------------------------------------------------------------------------------------------------

  82. // API

  83. 

  84. #define CARLA_COMMON_NEED_CHECKSTRINGPTR

  85. #include "CarlaHostCommon.cpp"

  86. 

  87. // -------------------------------------------------------------------------------------------------------------------

  88. 

  89. uint carla_get_engine_driver_count()

  90. {

  91.     carla_debug("carla_get_engine_driver_count()");

  92. 

  93.     return CarlaEngine::getDriverCount();

  94. }

  95. 

  96. const char* carla_get_engine_driver_name(uint index)

  97. {

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

  99. 

  100.     return CarlaEngine::getDriverName(index);

  101. }

  102. 

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

  104. {

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

  106. 

  107.     return CarlaEngine::getDriverDeviceNames(index);

  108. }

  109. 

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

  111. {

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

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

  114. 

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

  116.     {

  117.         static EngineDriverDeviceInfo devInfo;

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

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

  120. 

  121.         devInfo.hints       = ret->hints;

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

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

  124.         return &devInfo;

  125.     }

  126. 

  127.     return nullptr;

  128. }

  129. 

  130. // -------------------------------------------------------------------------------------------------------------------

  131. 

  132. CarlaEngine* carla_get_engine()

  133. {

  134.     carla_debug("carla_get_engine()");

  135. 

  136.     return gStandalone.engine;

  137. }

  138. 

  139. // -------------------------------------------------------------------------------------------------------------------

  140. 

  141. static void carla_engine_init_common()

  142. {

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

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

  145. 

  146. #ifdef BUILD_BRIDGE

  147.     using water::File;

  148.     File waterBinaryDir(File::getSpecialLocation(File::currentExecutableFile).getParentDirectory());

  149. 

  150.     /*

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

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

  153. 

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

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

  156. 

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

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

  159.     */

  160. 

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

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

  163. 

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

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

  166. 

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

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

  169. 

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

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

  172. 

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

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

  175. 

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

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

  178. 

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

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

  181. 

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

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

  184. 

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

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

  187. 

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

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

  190. 

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

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

  193.     else

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

  195. 

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

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

  198.     else

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

  200. 

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

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

  203. 

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

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

  206. #else

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

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

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

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

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

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

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

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

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

  216. 

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

  218. 

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

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

  221. 

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

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

  224. 

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

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

  227. 

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

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

  230. 

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

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

  233. 

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

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

  236. 

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

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

  239. 

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

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

  242. 

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

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

  245. 

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

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

  248. 

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

  250. 

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

  252.     {

  253.         char strBuf[STR_MAX+1];

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

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

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

  257.     }

  258.     else

  259.     {

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

  261.     }

  262. 

  263.     if (gStandalone.engineOptions.wine.executable != nullptr && gStandalone.engineOptions.wine.executable[0] != '\0')

  264.         gStandalone.engine->setOption(CB::ENGINE_OPTION_WINE_EXECUTABLE, 0, gStandalone.engineOptions.wine.executable);

  265. 

  266.     gStandalone.engine->setOption(CB::ENGINE_OPTION_WINE_AUTO_PREFIX, gStandalone.engineOptions.wine.autoPrefix ? 1 : 0, nullptr);

  267. 

  268.     if (gStandalone.engineOptions.wine.fallbackPrefix != nullptr && gStandalone.engineOptions.wine.fallbackPrefix[0] != '\0')

  269.         gStandalone.engine->setOption(CB::ENGINE_OPTION_WINE_FALLBACK_PREFIX, 0, gStandalone.engineOptions.wine.fallbackPrefix);

  270. 

  271.     gStandalone.engine->setOption(CB::ENGINE_OPTION_WINE_RT_PRIO_ENABLED, gStandalone.engineOptions.wine.rtPrio ? 1 : 0, nullptr);

  272.     gStandalone.engine->setOption(CB::ENGINE_OPTION_WINE_BASE_RT_PRIO, gStandalone.engineOptions.wine.baseRtPrio, nullptr);

  273.     gStandalone.engine->setOption(CB::ENGINE_OPTION_WINE_SERVER_RT_PRIO, gStandalone.engineOptions.wine.serverRtPrio, nullptr);

  274. 

  275. #endif

  276. }

  277. 

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

  279. {

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

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

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

  283. 

  284.     if (gStandalone.engine != nullptr)

  285.     {

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

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

  288.         return false;

  289.     }

  290. 

  291. #ifdef CARLA_OS_WIN

  292.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  293. #endif

  294. 

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

  296. 

  297.     if (gStandalone.engine == nullptr)

  298.     {

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

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

  301.         return false;

  302.     }

  303. 

  304. #ifdef BUILD_BRIDGE

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

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

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

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

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

  310. #else

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

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

  313. #endif

  314. 

  315.     carla_engine_init_common();

  316. 

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

  318.     {

  319. #ifndef BUILD_BRIDGE

  320.         if (gStandalone.logThreadEnabled && std::getenv("CARLA_LOGS_DISABLED") == nullptr)

  321.             gStandalone.logThread.init();

  322. #endif

  323.         gStandalone.lastError = "No error";

  324.         return true;

  325.     }

  326.     else

  327.     {

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

  329.         delete gStandalone.engine;

  330.         gStandalone.engine = nullptr;

  331.         return false;

  332.     }

  333. }

  334. 

  335. #ifdef BUILD_BRIDGE

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

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

  338. {

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

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

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

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

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

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

  345. 

  346.     if (gStandalone.engine != nullptr)

  347.     {

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

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

  350.         return false;

  351.     }

  352. 

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

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

  355.     {

  356.         carla_setenv("WINE_RT", "55");

  357.         carla_setenv("WINE_SVR_RT", "70");

  358.     }

  359. 

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

  361. 

  362.     if (gStandalone.engine == nullptr)

  363.     {

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

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

  366.         return false;

  367.     }

  368. 

  369.     carla_engine_init_common();

  370. 

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

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

  373. 

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

  375.     {

  376.         gStandalone.lastError = "No error";

  377.         return true;

  378.     }

  379.     else

  380.     {

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

  382.         delete gStandalone.engine;

  383.         gStandalone.engine = nullptr;

  384.         return false;

  385.     }

  386. }

  387. #endif

  388. 

  389. bool carla_engine_close()

  390. {

  391.     carla_debug("carla_engine_close()");

  392. 

  393.     if (gStandalone.engine == nullptr)

  394.     {

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

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

  397.         return false;

  398.     }

  399. 

  400.     gStandalone.engine->setAboutToClose();

  401.     gStandalone.engine->removeAllPlugins();

  402. 

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

  404. 

  405.     if (! closed)

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

  407. 

  408.     delete gStandalone.engine;

  409.     gStandalone.engine = nullptr;

  410. 

  411. #ifndef BUILD_BRIDGE

  412.     gStandalone.logThread.stop();

  413. #endif

  414. 

  415.     return closed;

  416. }

  417. 

  418. void carla_engine_idle()

  419. {

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

  421. 

  422.     gStandalone.engine->idle();

  423. }

  424. 

  425. bool carla_is_engine_running()

  426. {

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

  428. }

  429. 

  430. bool carla_set_engine_about_to_close()

  431. {

  432.     CARLA_SAFE_ASSERT_RETURN(gStandalone.engine != nullptr, true);

  433.     carla_debug("carla_set_engine_about_to_close()");

  434. 

  435.     return gStandalone.engine->setAboutToClose();

  436. }

  437. 

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

  439. {

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

  441. 

  442.     gStandalone.engineCallback    = func;

  443.     gStandalone.engineCallbackPtr = ptr;

  444. 

  445. #ifndef BUILD_BRIDGE

  446.     gStandalone.logThread.setCallback(func, ptr);

  447. #endif

  448. 

  449.     if (gStandalone.engine != nullptr)

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

  451. }

  452. 

  453. #ifndef BUILD_BRIDGE

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

  455. {

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

  457. 

  458.     switch (option)

  459.     {

  460.     case CB::ENGINE_OPTION_DEBUG:

  461.         break;

  462. 

  463.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  466.         break;

  467. 

  468.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

  469.         CARLA_SAFE_ASSERT_RETURN(value >= CB::ENGINE_TRANSPORT_MODE_DISABLED && value <= CB::ENGINE_TRANSPORT_MODE_BRIDGE,);

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

  471.         delete[] gStandalone.engineOptions.transportExtra;

  472.         if (value != CB::ENGINE_TRANSPORT_MODE_DISABLED && valueStr != nullptr)

  473.             gStandalone.engineOptions.transportExtra = carla_strdup_safe(valueStr);

  474.         else

  475.             gStandalone.engineOptions.transportExtra = nullptr;

  476.         break;

  477. 

  478.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  481.         break;

  482. 

  483.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  486.         break;

  487. 

  488.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  491.         break;

  492. 

  493.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  496.         break;

  497. 

  498.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  499.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  501.         break;

  502. 

  503.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  504.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  506.         break;

  507. 

  508.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  511.         break;

  512. 

  513.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  514.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  516.         break;

  517. 

  518.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  519.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  521.         break;

  522. 

  523.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  524.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  525. 

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

  527.             delete[] gStandalone.engineOptions.audioDevice;

  528. 

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

  530.         break;

  531. 

  532.     case CB::ENGINE_OPTION_PLUGIN_PATH:

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

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

  535.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  536. 

  537.         switch (value)

  538.         {

  539.         case CB::PLUGIN_LADSPA:

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

  541.                 delete[] gStandalone.engineOptions.pathLADSPA;

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

  543.             break;

  544.         case CB::PLUGIN_DSSI:

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

  546.                 delete[] gStandalone.engineOptions.pathDSSI;

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

  548.             break;

  549.         case CB::PLUGIN_LV2:

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

  551.                 delete[] gStandalone.engineOptions.pathLV2;

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

  553.             break;

  554.         case CB::PLUGIN_VST2:

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

  556.                 delete[] gStandalone.engineOptions.pathVST2;

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

  558.             break;

  559.         case CB::PLUGIN_GIG:

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

  561.                 delete[] gStandalone.engineOptions.pathGIG;

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

  563.             break;

  564.         case CB::PLUGIN_SF2:

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

  566.                 delete[] gStandalone.engineOptions.pathSF2;

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

  568.             break;

  569.         case CB::PLUGIN_SFZ:

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

  571.                 delete[] gStandalone.engineOptions.pathSFZ;

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

  573.             break;

  574.         }

  575.         break;

  576. 

  577.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  579. 

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

  581.             delete[] gStandalone.engineOptions.binaryDir;

  582. 

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

  584.         break;

  585. 

  586.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  588. 

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

  590.             delete[] gStandalone.engineOptions.resourceDir;

  591. 

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

  593.         break;

  594. 

  595.     case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

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

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

  598.         break;

  599. 

  600.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID: {

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

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

  603.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  605.     }   break;

  606. 

  607.     case CB::ENGINE_OPTION_WINE_EXECUTABLE:

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

  609. 

  610.         if (gStandalone.engineOptions.wine.executable != nullptr)

  611.             delete[] gStandalone.engineOptions.wine.executable;

  612. 

  613.         gStandalone.engineOptions.wine.executable = carla_strdup_safe(valueStr);

  614.         break;

  615. 

  616.     case CB::ENGINE_OPTION_WINE_AUTO_PREFIX:

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

  618.         gStandalone.engineOptions.wine.autoPrefix = (value != 0);

  619.         break;

  620. 

  621.     case CB::ENGINE_OPTION_WINE_FALLBACK_PREFIX:

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

  623. 

  624.         if (gStandalone.engineOptions.wine.fallbackPrefix != nullptr)

  625.             delete[] gStandalone.engineOptions.wine.fallbackPrefix;

  626. 

  627.         gStandalone.engineOptions.wine.fallbackPrefix = carla_strdup_safe(valueStr);

  628.         break;

  629. 

  630.     case CB::ENGINE_OPTION_WINE_RT_PRIO_ENABLED:

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

  632.         gStandalone.engineOptions.wine.rtPrio = (value != 0);

  633.         break;

  634. 

  635.     case CB::ENGINE_OPTION_WINE_BASE_RT_PRIO:

  636.         CARLA_SAFE_ASSERT_RETURN(value >= 1 && value <= 89,);

  637.         gStandalone.engineOptions.wine.baseRtPrio = value;

  638.         break;

  639. 

  640.     case CB::ENGINE_OPTION_WINE_SERVER_RT_PRIO:

  641.         CARLA_SAFE_ASSERT_RETURN(value >= 1 && value <= 99,);

  642.         gStandalone.engineOptions.wine.serverRtPrio = value;

  643.         break;

  644. 

  645.     case CB::ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT:

  646.         gStandalone.logThreadEnabled = (value != 0);

  647.         break;

  648.     }

  649. 

  650.     if (gStandalone.engine != nullptr)

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

  652. }

  653. #endif

  654. 

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

  656. {

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

  658. 

  659.     gStandalone.fileCallback    = func;

  660.     gStandalone.fileCallbackPtr = ptr;

  661. 

  662.     if (gStandalone.engine != nullptr)

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

  664. }

  665. 

  666. // -------------------------------------------------------------------------------------------------------------------

  667. 

  668. bool carla_load_file(const char* filename)

  669. {

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

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

  672. 

  673.     if (gStandalone.engine != nullptr)

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

  675. 

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

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

  678.     return false;

  679. }

  680. 

  681. bool carla_load_project(const char* filename)

  682. {

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

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

  685. 

  686.     if (gStandalone.engine != nullptr)

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

  688. 

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

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

  691.     return false;

  692. }

  693. 

  694. bool carla_save_project(const char* filename)

  695. {

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

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

  698. 

  699.     if (gStandalone.engine != nullptr)

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

  701. 

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

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

  704.     return false;

  705. }

  706. 

  707. #ifndef BUILD_BRIDGE

  708. // -------------------------------------------------------------------------------------------------------------------

  709. 

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

  711. {

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

  713. 

  714.     if (gStandalone.engine != nullptr)

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

  716. 

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

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

  719.     return false;

  720. }

  721. 

  722. bool carla_patchbay_disconnect(uint connectionId)

  723. {

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

  725. 

  726.     if (gStandalone.engine != nullptr)

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

  728. 

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

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

  731.     return false;

  732. }

  733. 

  734. bool carla_patchbay_refresh(bool external)

  735. {

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

  737. 

  738.     if (gStandalone.engine != nullptr)

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

  740. 

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

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

  743.     return false;

  744. }

  745. 

  746. // -------------------------------------------------------------------------------------------------------------------

  747. 

  748. void carla_transport_play()

  749. {

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

  751.     carla_debug("carla_transport_play()");

  752. 

  753.     gStandalone.engine->transportPlay();

  754. }

  755. 

  756. void carla_transport_pause()

  757. {

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

  759.     carla_debug("carla_transport_pause()");

  760. 

  761.     gStandalone.engine->transportPause();

  762. }

  763. 

  764. void carla_transport_bpm(double bpm)

  765. {

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

  767.     carla_debug("carla_transport_bpm(%f)", bpm);

  768. 

  769.     gStandalone.engine->transportBPM(bpm);

  770. }

  771. 

  772. void carla_transport_relocate(uint64_t frame)

  773. {

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

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

  776. 

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

  778. }

  779. 

  780. uint64_t carla_get_current_transport_frame()

  781. {

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

  783. 

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

  785.     return timeInfo.frame;

  786. }

  787. 

  788. const CarlaTransportInfo* carla_get_transport_info()

  789. {

  790.     static CarlaTransportInfo retInfo;

  791.     carla_zeroStruct(retInfo);

  792. 

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

  794. 

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

  796. 

  797.     retInfo.playing = timeInfo.playing;

  798.     retInfo.frame   = timeInfo.frame;

  799. 

  800.     if (timeInfo.bbt.valid)

  801.     {

  802.         retInfo.bar  = timeInfo.bbt.bar;

  803.         retInfo.beat = timeInfo.bbt.beat;

  804.         retInfo.tick = timeInfo.bbt.tick;

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

  806.     }

  807. 

  808.     return &retInfo;

  809. }

  810. #endif

  811. 

  812. // -------------------------------------------------------------------------------------------------------------------

  813. 

  814. uint32_t carla_get_current_plugin_count()

  815. {

  816.     if (gStandalone.engine != nullptr)

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

  818. 

  819.     return 0;

  820. }

  821. 

  822. uint32_t carla_get_max_plugin_number()

  823. {

  824.     if (gStandalone.engine != nullptr)

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

  826. 

  827.     return 0;

  828. }

  829. 

  830. // -------------------------------------------------------------------------------------------------------------------

  831. 

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

  833. {

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

  835. 

  836.     if (gStandalone.engine != nullptr)

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

  838. 

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

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

  841.     return false;

  842. }

  843. 

  844. bool carla_remove_plugin(uint pluginId)

  845. {

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

  847. 

  848.     if (gStandalone.engine != nullptr)

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

  850. 

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

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

  853.     return false;

  854. }

  855. 

  856. bool carla_remove_all_plugins()

  857. {

  858.     carla_debug("carla_remove_all_plugins()");

  859. 

  860.     if (gStandalone.engine != nullptr)

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

  862. 

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

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

  865.     return false;

  866. }

  867. 

  868. #ifndef BUILD_BRIDGE

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

  870. {

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

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

  873. 

  874.     if (gStandalone.engine != nullptr)

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

  876. 

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

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

  879.     return nullptr;

  880. }

  881. 

  882. bool carla_clone_plugin(uint pluginId)

  883. {

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

  885. 

  886.     if (gStandalone.engine != nullptr)

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

  888. 

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

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

  891.     return false;

  892. }

  893. 

  894. bool carla_replace_plugin(uint pluginId)

  895. {

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

  897. 

  898.     if (gStandalone.engine != nullptr)

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

  900. 

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

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

  903.     return false;

  904. }

  905. 

  906. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  907. {

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

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

  910. 

  911.     if (gStandalone.engine != nullptr)

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

  913. 

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

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

  916.     return false;

  917. }

  918. #endif

  919. 

  920. // -------------------------------------------------------------------------------------------------------------------

  921. 

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

  923. {

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

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

  926. 

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

  928.     {

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

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

  931.         return false;

  932.     }

  933. 

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

  935.         return plugin->loadStateFromFile(filename);

  936. 

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

  938.     return false;

  939. }

  940. 

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

  942. {

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

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

  945. 

  946.     if (gStandalone.engine == nullptr)

  947.     {

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

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

  950.         return false;

  951.     }

  952. 

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

  954. 

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

  956.         return plugin->saveStateToFile(filename);

  957. 

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

  959.     return false;

  960. }

  961. 

  962. bool carla_export_plugin_lv2(uint pluginId, const char* lv2path)

  963. {

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

  965.     carla_debug("carla_export_plugin_lv2(%i, \"%s\")", pluginId, lv2path);

  966. 

  967.     if (gStandalone.engine == nullptr)

  968.     {

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

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

  971.         return false;

  972.     }

  973. 

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

  975.         return plugin->exportAsLV2(lv2path);

  976. 

  977.     carla_stderr2("carla_export_plugin_lv2(%i, \"%s\") - could not find plugin", pluginId, lv2path);

  978.     return false;

  979. }

  980. 

  981. // -------------------------------------------------------------------------------------------------------------------

  982. 

  983. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  984. {

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

  986. 

  987.     static CarlaPluginInfo info;

  988. 

  989.     // reset

  990.     info.type             = CB::PLUGIN_NONE;

  991.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  992.     info.hints            = 0x0;

  993.     info.optionsAvailable = 0x0;

  994.     info.optionsEnabled   = 0x0;

  995.     info.filename         = gNullCharPtr;

  996.     info.name             = gNullCharPtr;

  997.     info.iconName         = gNullCharPtr;

  998.     info.uniqueId         = 0;

  999. 

  1000.     // cleanup

  1001.     if (info.label != gNullCharPtr)

  1002.     {

  1003.         delete[] info.label;

  1004.         info.label = gNullCharPtr;

  1005.     }

  1006. 

  1007.     if (info.maker != gNullCharPtr)

  1008.     {

  1009.         delete[] info.maker;

  1010.         info.maker = gNullCharPtr;

  1011.     }

  1012. 

  1013.     if (info.copyright != gNullCharPtr)

  1014.     {

  1015.         delete[] info.copyright;

  1016.         info.copyright = gNullCharPtr;

  1017.     }

  1018. 

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

  1020. 

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

  1022.     {

  1023.         char strBufLabel[STR_MAX+1];

  1024.         char strBufMaker[STR_MAX+1];

  1025.         char strBufCopyright[STR_MAX+1];

  1026. 

  1027.         carla_zeroChars(strBufLabel, STR_MAX+1);

  1028.         carla_zeroChars(strBufMaker, STR_MAX+1);

  1029.         carla_zeroChars(strBufCopyright, STR_MAX+1);

  1030. 

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

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

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

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

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

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

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

  1038. 

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

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

  1041. 

  1042.         plugin->getLabel(strBufLabel);

  1043.         info.label = carla_strdup_safe(strBufLabel);

  1044. 

  1045.         plugin->getMaker(strBufMaker);

  1046.         info.maker = carla_strdup_safe(strBufMaker);

  1047. 

  1048.         plugin->getCopyright(strBufCopyright);

  1049.         info.copyright = carla_strdup_safe(strBufCopyright);

  1050. 

  1051.         checkStringPtr(info.filename);

  1052.         checkStringPtr(info.name);

  1053.         checkStringPtr(info.iconName);

  1054.         checkStringPtr(info.label);

  1055.         checkStringPtr(info.maker);

  1056.         checkStringPtr(info.copyright);

  1057. 

  1058.         return &info;

  1059.     }

  1060. 

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

  1062.     return &info;

  1063. }

  1064. 

  1065. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1066. {

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

  1068. 

  1069.     static CarlaPortCountInfo info;

  1070. 

  1071.     // reset

  1072.     info.ins   = 0;

  1073.     info.outs  = 0;

  1074. 

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

  1076. 

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

  1078.     {

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

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

  1081.         return &info;

  1082.     }

  1083. 

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

  1085.     return &info;

  1086. }

  1087. 

  1088. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1089. {

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

  1091. 

  1092.     static CarlaPortCountInfo info;

  1093. 

  1094.     // reset

  1095.     info.ins   = 0;

  1096.     info.outs  = 0;

  1097. 

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

  1099. 

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

  1101.     {

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

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

  1104.         return &info;

  1105.     }

  1106. 

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

  1108.     return &info;

  1109. }

  1110. 

  1111. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1112. {

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

  1114. 

  1115.     static CarlaPortCountInfo info;

  1116. 

  1117.     // reset

  1118.     info.ins   = 0;

  1119.     info.outs  = 0;

  1120. 

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

  1122. 

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

  1124.     {

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

  1126.         return &info;

  1127.     }

  1128. 

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

  1130.     return &info;

  1131. }

  1132. 

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

  1134. {

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

  1136. 

  1137.     static CarlaParameterInfo info;

  1138. 

  1139.     // reset

  1140.     info.scalePointCount = 0;

  1141. 

  1142.     // cleanup

  1143.     if (info.name != gNullCharPtr)

  1144.     {

  1145.         delete[] info.name;

  1146.         info.name = gNullCharPtr;

  1147.     }

  1148. 

  1149.     if (info.symbol != gNullCharPtr)

  1150.     {

  1151.         delete[] info.symbol;

  1152.         info.symbol = gNullCharPtr;

  1153.     }

  1154. 

  1155.     if (info.unit != gNullCharPtr)

  1156.     {

  1157.         delete[] info.unit;

  1158.         info.unit = gNullCharPtr;

  1159.     }

  1160. 

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

  1162. 

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

  1164.     {

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

  1166.         {

  1167.             char strBufName[STR_MAX+1];

  1168.             char strBufSymbol[STR_MAX+1];

  1169.             char strBufUnit[STR_MAX+1];

  1170. 

  1171.             carla_zeroChars(strBufName, STR_MAX+1);

  1172.             carla_zeroChars(strBufSymbol, STR_MAX+1);

  1173.             carla_zeroChars(strBufUnit, STR_MAX+1);

  1174. 

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

  1176. 

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

  1178.             info.name = carla_strdup_safe(strBufName);

  1179. 

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

  1181.             info.symbol = carla_strdup_safe(strBufSymbol);

  1182. 

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

  1184.             info.unit = carla_strdup_safe(strBufUnit);

  1185. 

  1186.             checkStringPtr(info.name);

  1187.             checkStringPtr(info.symbol);

  1188.             checkStringPtr(info.unit);

  1189.         }

  1190.         else

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

  1192. 

  1193.         return &info;

  1194.     }

  1195. 

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

  1197.     return &info;

  1198. }

  1199. 

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

  1201. {

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

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

  1204. 

  1205.     static CarlaScalePointInfo info;

  1206. 

  1207.     // reset

  1208.     info.value = 0.0f;

  1209. 

  1210.     // cleanup

  1211.     if (info.label != gNullCharPtr)

  1212.     {

  1213.         delete[] info.label;

  1214.         info.label = gNullCharPtr;

  1215.     }

  1216. 

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

  1218. 

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

  1220.     {

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

  1222.         {

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

  1224.             {

  1225.                 char strBufLabel[STR_MAX+1];

  1226.                 carla_zeroChars(strBufLabel, STR_MAX+1);

  1227. 

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

  1229. 

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

  1231.                 info.label = carla_strdup_safe(strBufLabel);

  1232.                 checkStringPtr(info.label);

  1233.             }

  1234.             else

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

  1236.         }

  1237.         else

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

  1239. 

  1240.         return &info;

  1241.     }

  1242. 

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

  1244.     return &info;

  1245. }

  1246. 

  1247. // -------------------------------------------------------------------------------------------------------------------

  1248. 

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

  1250. {

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

  1252. 

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

  1254. 

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

  1256. 

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

  1258.     {

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

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

  1261. 

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

  1263.         return &fallbackParameterData;

  1264.     }

  1265. 

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

  1267.     return &fallbackParameterData;

  1268. }

  1269. 

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

  1271. {

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

  1273. 

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

  1275. 

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

  1277. 

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

  1279.     {

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

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

  1282. 

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

  1284.         return &fallbackParamRanges;

  1285.     }

  1286. 

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

  1288.     return &fallbackParamRanges;

  1289. }

  1290. 

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

  1292. {

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

  1294. 

  1295.     static MidiProgramData midiProgData;

  1296. 

  1297.     // reset

  1298.     midiProgData.bank    = 0;

  1299.     midiProgData.program = 0;

  1300.     midiProgData.name    = gNullCharPtr;

  1301. 

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

  1303. 

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

  1305.     {

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

  1307.         {

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

  1309.             carla_copyStruct(midiProgData, ret);

  1310.             checkStringPtr(midiProgData.name);

  1311.             return &midiProgData;

  1312.         }

  1313. 

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

  1315.         return &midiProgData;

  1316.     }

  1317. 

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

  1319.     return &midiProgData;

  1320. }

  1321. 

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

  1323. {

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

  1325. 

  1326.     static CustomData customData;

  1327. 

  1328.     // reset

  1329.     customData.type  = gNullCharPtr;

  1330.     customData.key   = gNullCharPtr;

  1331.     customData.value = gNullCharPtr;

  1332. 

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

  1334. 

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

  1336.     {

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

  1338.         {

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

  1340.             carla_copyStruct(customData, ret);

  1341.             checkStringPtr(customData.type);

  1342.             checkStringPtr(customData.key);

  1343.             checkStringPtr(customData.value);

  1344.             return &customData;

  1345.         }

  1346. 

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

  1348.         return &customData;

  1349.     }

  1350. 

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

  1352.     return &customData;

  1353. }

  1354. 

  1355. const char* carla_get_chunk_data(uint pluginId)

  1356. {

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

  1358. 

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

  1360. 

  1361.     static CarlaString chunkData;

  1362. 

  1363.     // cleanup

  1364.     chunkData.clear();

  1365. 

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

  1367.     {

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

  1369.         {

  1370.             void* data = nullptr;

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

  1372. 

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

  1374.             {

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

  1376.                 return chunkData;

  1377.             }

  1378.             else

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

  1380.         }

  1381.         else

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

  1383. 

  1384.         return nullptr;

  1385.     }

  1386. 

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

  1388.     return nullptr;

  1389. }

  1390. 

  1391. // -------------------------------------------------------------------------------------------------------------------

  1392. 

  1393. uint32_t carla_get_parameter_count(uint pluginId)

  1394. {

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

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

  1397. 

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

  1399.         return plugin->getParameterCount();

  1400. 

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

  1402.     return 0;

  1403. }

  1404. 

  1405. uint32_t carla_get_program_count(uint pluginId)

  1406. {

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

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

  1409. 

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

  1411.         return plugin->getProgramCount();

  1412. 

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

  1414.     return 0;

  1415. }

  1416. 

  1417. uint32_t carla_get_midi_program_count(uint pluginId)

  1418. {

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

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

  1421. 

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

  1423.         return plugin->getMidiProgramCount();

  1424. 

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

  1426.     return 0;

  1427. }

  1428. 

  1429. uint32_t carla_get_custom_data_count(uint pluginId)

  1430. {

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

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

  1433. 

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

  1435.         return plugin->getCustomDataCount();

  1436. 

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

  1438.     return 0;

  1439. }

  1440. 

  1441. // -------------------------------------------------------------------------------------------------------------------

  1442. 

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

  1444. {

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

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

  1447. 

  1448.     static char textBuf[STR_MAX+1];

  1449. 

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

  1451.     {

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

  1453.         {

  1454.             carla_zeroChars(textBuf, STR_MAX+1);

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

  1456.             return textBuf;

  1457.         }

  1458. 

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

  1460.         return nullptr;

  1461.     }

  1462. 

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

  1464.     return nullptr;

  1465. }

  1466. 

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

  1468. {

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

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

  1471. 

  1472.     static char programName[STR_MAX+1];

  1473. 

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

  1475.     {

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

  1477.         {

  1478.             carla_zeroChars(programName, STR_MAX+1);

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

  1480.             return programName;

  1481.         }

  1482. 

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

  1484.         return nullptr;

  1485.     }

  1486. 

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

  1488.     return nullptr;

  1489. }

  1490. 

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

  1492. {

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

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

  1495. 

  1496.     static char midiProgramName[STR_MAX+1];

  1497. 

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

  1499.     {

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

  1501.         {

  1502.             carla_zeroChars(midiProgramName, STR_MAX+1);

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

  1504.             return midiProgramName;

  1505.         }

  1506. 

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

  1508.         return nullptr;

  1509.     }

  1510. 

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

  1512.     return nullptr;

  1513. }

  1514. 

  1515. const char* carla_get_real_plugin_name(uint pluginId)

  1516. {

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

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

  1519. 

  1520.     static char realPluginName[STR_MAX+1];

  1521. 

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

  1523.     {

  1524.         carla_zeroChars(realPluginName, STR_MAX+1);

  1525.         plugin->getRealName(realPluginName);

  1526.         return realPluginName;

  1527.     }

  1528. 

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

  1530.     return nullptr;

  1531. }

  1532. 

  1533. // -------------------------------------------------------------------------------------------------------------------

  1534. 

  1535. int32_t carla_get_current_program_index(uint pluginId)

  1536. {

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

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

  1539. 

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

  1541.         return plugin->getCurrentProgram();

  1542. 

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

  1544.     return -1;

  1545. }

  1546. 

  1547. int32_t carla_get_current_midi_program_index(uint pluginId)

  1548. {

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

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

  1551. 

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

  1553.         return plugin->getCurrentMidiProgram();

  1554. 

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

  1556.     return -1;

  1557. }

  1558. 

  1559. // -------------------------------------------------------------------------------------------------------------------

  1560. 

  1561. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  1562. {

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

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

  1565. 

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

  1567.     {

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

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

  1570. 

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

  1572.         return 0.0f;

  1573.     }

  1574. 

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

  1576.     return 0.0f;

  1577. }

  1578. 

  1579. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  1580. {

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

  1582. 

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

  1584.     {

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

  1586.             return plugin->getParameterValue(parameterId);

  1587. 

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

  1589.         return 0.0f;

  1590.     }

  1591. 

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

  1593.     return 0.0f;

  1594. }

  1595. 

  1596. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  1597. {

  1598. #ifdef BUILD_BRIDGE

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

  1600. #else

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

  1602. #endif

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

  1604. 

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

  1606.         return plugin->getInternalParameterValue(parameterId);

  1607. 

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

  1609.     return 0.0f;

  1610. }

  1611. 

  1612. // -------------------------------------------------------------------------------------------------------------------

  1613. 

  1614. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  1615. {

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

  1617. 

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

  1619. }

  1620. 

  1621. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  1622. {

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

  1624. 

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

  1626. }

  1627. 

  1628. // -------------------------------------------------------------------------------------------------------------------

  1629. 

  1630. CARLA_BACKEND_START_NAMESPACE

  1631. 

  1632. // defined in CarlaPluginLV2.cpp

  1633. void* carla_render_inline_display_lv2(CarlaPlugin* plugin, int width, int height);

  1634. 

  1635. CARLA_BACKEND_END_NAMESPACE

  1636. 

  1637. CarlaInlineDisplayImageSurface* carla_render_inline_display(uint pluginId, int width, int height)

  1638. {

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

  1640. 

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

  1642.     {

  1643.         CARLA_SAFE_ASSERT_RETURN(plugin->getType() == CB::PLUGIN_LV2, nullptr);

  1644.         return (CarlaInlineDisplayImageSurface*)CB::carla_render_inline_display_lv2(plugin, width, height);

  1645.     }

  1646. 

  1647.     carla_stderr2("carla_render_inline_display(%i, %i, %i) - could not find plugin", pluginId, width, height);

  1648.     return nullptr;

  1649. }

  1650. 

  1651. // -------------------------------------------------------------------------------------------------------------------

  1652. 

  1653. void carla_set_active(uint pluginId, bool onOff)

  1654. {

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

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

  1657. 

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

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

  1660. 

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

  1662. }

  1663. 

  1664. #ifndef BUILD_BRIDGE

  1665. void carla_set_drywet(uint pluginId, float value)

  1666. {

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

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

  1669. 

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

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

  1672. 

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

  1674. }

  1675. 

  1676. void carla_set_volume(uint pluginId, float value)

  1677. {

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

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

  1680. 

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

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

  1683. 

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

  1685. }

  1686. 

  1687. void carla_set_balance_left(uint pluginId, float value)

  1688. {

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

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

  1691. 

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

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

  1694. 

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

  1696. }

  1697. 

  1698. void carla_set_balance_right(uint pluginId, float value)

  1699. {

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

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

  1702. 

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

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

  1705. 

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

  1707. }

  1708. 

  1709. void carla_set_panning(uint pluginId, float value)

  1710. {

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

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

  1713. 

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

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

  1716. 

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

  1718. }

  1719. 

  1720. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  1721. {

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

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

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

  1725. 

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

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

  1728. 

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

  1730. }

  1731. 

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

  1733. {

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

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

  1736. 

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

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

  1739. 

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

  1741. }

  1742. #endif

  1743. 

  1744. // -------------------------------------------------------------------------------------------------------------------

  1745. 

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

  1747. {

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

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

  1750. 

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

  1752.     {

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

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

  1755. 

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

  1757.         return;

  1758.     }

  1759. 

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

  1761. }

  1762. 

  1763. #ifndef BUILD_BRIDGE

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

  1765. {

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

  1767.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  1769. 

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

  1771.     {

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

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

  1774. 

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

  1776.         return;

  1777.     }

  1778. 

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

  1780. }

  1781. 

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

  1783. {

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

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

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

  1787. 

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

  1789.     {

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

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

  1792. 

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

  1794.         return;

  1795.     }

  1796. 

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

  1798. }

  1799. #endif

  1800. 

  1801. // -------------------------------------------------------------------------------------------------------------------

  1802. 

  1803. void carla_set_program(uint pluginId, uint32_t programId)

  1804. {

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

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

  1807. 

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

  1809.     {

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

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

  1812. 

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

  1814.         return;

  1815.     }

  1816. 

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

  1818. }

  1819. 

  1820. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  1821. {

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

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

  1824. 

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

  1826.     {

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

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

  1829. 

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

  1831.         return;

  1832.     }

  1833. 

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

  1835. }

  1836. 

  1837. // -------------------------------------------------------------------------------------------------------------------

  1838. 

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

  1840. {

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

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

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

  1844.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  1846. 

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

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

  1849. 

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

  1851. }

  1852. 

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

  1854. {

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

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

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

  1858. 

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

  1860.     {

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

  1862.         {

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

  1864. #ifdef CARLA_PROPER_CPP11_SUPPORT

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

  1866. #else

  1867.             return plugin->setChunkData(&chunk.front(), chunk.size());

  1868. #endif

  1869.         }

  1870. 

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

  1872.         return;

  1873.     }

  1874. 

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

  1876. }

  1877. 

  1878. // -------------------------------------------------------------------------------------------------------------------

  1879. 

  1880. void carla_prepare_for_save(uint pluginId)

  1881. {

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

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

  1884. 

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

  1886.         return plugin->prepareForSave();

  1887. 

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

  1889. }

  1890. 

  1891. void carla_reset_parameters(uint pluginId)

  1892. {

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

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

  1895. 

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

  1897.         return plugin->resetParameters();

  1898. 

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

  1900. }

  1901. 

  1902. void carla_randomize_parameters(uint pluginId)

  1903. {

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

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

  1906. 

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

  1908.         return plugin->randomizeParameters();

  1909. 

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

  1911. }

  1912. 

  1913. #ifndef BUILD_BRIDGE

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

  1915. {

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

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

  1918. 

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

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

  1921. 

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

  1923. }

  1924. #endif

  1925. 

  1926. void carla_show_custom_ui(uint pluginId, bool yesNo)

  1927. {

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

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

  1930. 

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

  1932.         return plugin->showCustomUI(yesNo);

  1933. 

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

  1935. }

  1936. 

  1937. // -------------------------------------------------------------------------------------------------------------------

  1938. 

  1939. uint32_t carla_get_buffer_size()

  1940. {

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

  1942.     carla_debug("carla_get_buffer_size()");

  1943. 

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

  1945. }

  1946. 

  1947. double carla_get_sample_rate()

  1948. {

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

  1950.     carla_debug("carla_get_sample_rate()");

  1951. 

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

  1953. }

  1954. 

  1955. // -------------------------------------------------------------------------------------------------------------------

  1956. 

  1957. const char* carla_get_last_error()

  1958. {

  1959.     carla_debug("carla_get_last_error()");

  1960. 

  1961.     if (gStandalone.engine != nullptr)

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

  1963. 

  1964.     return gStandalone.lastError;

  1965. }

  1966. 

  1967. const char* carla_get_host_osc_url_tcp()

  1968. {

  1969.     carla_debug("carla_get_host_osc_url_tcp()");

  1970. 

  1971. #ifdef HAVE_LIBLO

  1972.     if (gStandalone.engine == nullptr)

  1973.     {

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

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

  1976.         return nullptr;

  1977.     }

  1978. 

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

  1980. #else

  1981.     return nullptr;

  1982. #endif

  1983. }

  1984. 

  1985. const char* carla_get_host_osc_url_udp()

  1986. {

  1987.     carla_debug("carla_get_host_osc_url_udp()");

  1988. 

  1989. #ifdef HAVE_LIBLO

  1990.     if (gStandalone.engine == nullptr)

  1991.     {

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

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

  1994.         return nullptr;

  1995.     }

  1996. 

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

  1998. #else

  1999.     return nullptr;

  2000. #endif

  2001. }

  2002. 

  2003. // -------------------------------------------------------------------------------------------------------------------

  2004. 

  2005. #include "CarlaPluginUI.cpp"

  2006. #include "CarlaDssiUtils.cpp"

  2007. #include "CarlaPatchbayUtils.cpp"

  2008. #include "CarlaPipeUtils.cpp"

  2009. #include "CarlaStateUtils.cpp"

  2010. 

  2011. // -------------------------------------------------------------------------------------------------------------------