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

1937 lines
69KB
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. #ifndef BUILD_BRIDGE

  31. # include "CarlaLogThread.hpp"

  32. #endif

  33. 

  34. #include "AppConfig.h"

  35. #include "juce_audio_formats/juce_audio_formats.h"

  36. 

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

  38. # include "juce_gui_basics/juce_gui_basics.h"

  39. #else

  40. namespace juce {

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

  42. } // namespace juce

  43. #endif

  44. 

  45. namespace CB = CarlaBackend;

  46. using CB::EngineOptions;

  47. 

  48. // -------------------------------------------------------------------------------------------------------------------

  49. // Single, standalone engine

  50. 

  51. struct CarlaBackendStandalone {

  52.     CarlaEngine*       engine;

  53.     EngineCallbackFunc engineCallback;

  54.     void*              engineCallbackPtr;

  55. #ifndef BUILD_BRIDGE

  56.     EngineOptions      engineOptions;

  57.     CarlaLogThread     logThread;

  58.     bool               logThreadEnabled;

  59. #endif

  60. 

  61.     FileCallbackFunc fileCallback;

  62.     void*            fileCallbackPtr;

  63. 

  64.     CarlaString lastError;

  65. 

  66.     CarlaBackendStandalone() noexcept

  67.         : engine(nullptr),

  68.           engineCallback(nullptr),

  69.           engineCallbackPtr(nullptr),

  70. #ifndef BUILD_BRIDGE

  71.           engineOptions(),

  72.           logThread(),

  73.           logThreadEnabled(false),

  74. #endif

  75.           fileCallback(nullptr),

  76.           fileCallbackPtr(nullptr),

  77.           lastError() {}

  78. 

  79.     ~CarlaBackendStandalone() noexcept

  80.     {

  81.         CARLA_SAFE_ASSERT(engine == nullptr);

  82.     }

  83. 

  84.     CARLA_PREVENT_HEAP_ALLOCATION

  85.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  86. };

  87. 

  88. CarlaBackendStandalone gStandalone;

  89. 

  90. // -------------------------------------------------------------------------------------------------------------------

  91. // API

  92. 

  93. #define CARLA_COMMON_NEED_CHECKSTRINGPTR

  94. #include "CarlaHostCommon.cpp"

  95. 

  96. // -------------------------------------------------------------------------------------------------------------------

  97. 

  98. uint carla_get_engine_driver_count()

  99. {

  100.     carla_debug("carla_get_engine_driver_count()");

  101. 

  102.     return CarlaEngine::getDriverCount();

  103. }

  104. 

  105. const char* carla_get_engine_driver_name(uint index)

  106. {

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

  108. 

  109.     return CarlaEngine::getDriverName(index);

  110. }

  111. 

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

  113. {

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

  115. 

  116.     return CarlaEngine::getDriverDeviceNames(index);

  117. }

  118. 

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

  120. {

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

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

  123. 

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

  125.     {

  126.         static EngineDriverDeviceInfo devInfo;

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

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

  129. 

  130.         devInfo.hints       = ret->hints;

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

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

  133.         return &devInfo;

  134.     }

  135. 

  136.     return nullptr;

  137. }

  138. 

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

  140. 

  141. CarlaEngine* carla_get_engine()

  142. {

  143.     carla_debug("carla_get_engine()");

  144. 

  145.     return gStandalone.engine;

  146. }

  147. 

  148. // -------------------------------------------------------------------------------------------------------------------

  149. 

  150. static void carla_engine_init_common()

  151. {

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

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

  154. 

  155. #ifdef BUILD_BRIDGE

  156.     using juce::File;

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

  158. 

  159.     /*

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

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

  162. 

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

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

  165. 

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

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

  168.     */

  169. 

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

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

  172. 

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

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

  175. 

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

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

  178. 

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

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

  181. 

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

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

  184. 

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

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

  187. 

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

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

  190. 

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

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

  193. 

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

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

  196. 

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

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

  199. 

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

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

  202. 

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

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

  205.     else

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

  207. 

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

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

  210.     else

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

  212. 

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

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

  215. 

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

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

  218. #else

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

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

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

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

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

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

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

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

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

  228. 

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

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

  231. 

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

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

  234. 

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

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

  237. 

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

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

  240. 

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

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

  243. 

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

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

  246. 

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

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

  249. 

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

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

  252. 

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

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

  255. 

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

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

  258. 

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

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

  261. 

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

  263. 

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

  265.     {

  266.         char strBuf[STR_MAX+1];

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

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

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

  270.     }

  271.     else

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

  273. #endif

  274. }

  275. 

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

  277. {

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

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

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

  281. 

  282.     if (gStandalone.engine != nullptr)

  283.     {

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

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

  286.         return false;

  287.     }

  288. 

  289. #ifdef CARLA_OS_WIN

  290.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  291. #endif

  292. 

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

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

  295.     {

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

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

  298.     }

  299. 

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

  301. 

  302.     if (gStandalone.engine == nullptr)

  303.     {

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

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

  306.         return false;

  307.     }

  308. 

  309. #ifdef BUILD_BRIDGE

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

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

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

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

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

  315. #else

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

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

  318. #endif

  319. 

  320.     carla_engine_init_common();

  321. 

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

  323.     {

  324. #ifndef BUILD_BRIDGE

  325.         juce::initialiseJuce_GUI();

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

  327.             gStandalone.logThread.init();

  328. #endif

  329.         gStandalone.lastError = "No error";

  330.         return true;

  331.     }

  332.     else

  333.     {

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

  335.         delete gStandalone.engine;

  336.         gStandalone.engine = nullptr;

  337.         return false;

  338.     }

  339. }

  340. 

  341. #ifdef BUILD_BRIDGE

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

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

  344. {

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

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

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

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

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

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

  351. 

  352.     if (gStandalone.engine != nullptr)

  353.     {

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

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

  356.         return false;

  357.     }

  358. 

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

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

  361.     {

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

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

  364.     }

  365. 

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

  367. 

  368.     if (gStandalone.engine == nullptr)

  369.     {

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

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

  372.         return false;

  373.     }

  374. 

  375.     carla_engine_init_common();

  376. 

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

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

  379. 

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

  381.     {

  382.         gStandalone.lastError = "No error";

  383.         return true;

  384.     }

  385.     else

  386.     {

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

  388.         delete gStandalone.engine;

  389.         gStandalone.engine = nullptr;

  390.         return false;

  391.     }

  392. }

  393. #endif

  394. 

  395. bool carla_engine_close()

  396. {

  397.     carla_debug("carla_engine_close()");

  398. 

  399.     if (gStandalone.engine == nullptr)

  400.     {

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

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

  403.         return false;

  404.     }

  405. 

  406.     gStandalone.engine->setAboutToClose();

  407.     gStandalone.engine->removeAllPlugins();

  408. 

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

  410. 

  411.     if (! closed)

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

  413. 

  414. #ifndef BUILD_BRIDGE

  415.     juce::shutdownJuce_GUI();

  416.     gStandalone.logThread.stop();

  417. #endif

  418. 

  419.     delete gStandalone.engine;

  420.     gStandalone.engine = nullptr;

  421. 

  422.     return closed;

  423. }

  424. 

  425. void carla_engine_idle()

  426. {

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

  428. 

  429.     gStandalone.engine->idle();

  430. }

  431. 

  432. bool carla_is_engine_running()

  433. {

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

  435. }

  436. 

  437. bool carla_set_engine_about_to_close()

  438. {

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

  440.     carla_debug("carla_set_engine_about_to_close()");

  441. 

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

  443. }

  444. 

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

  446. {

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

  448. 

  449.     gStandalone.engineCallback    = func;

  450.     gStandalone.engineCallbackPtr = ptr;

  451. 

  452. #ifndef BUILD_BRIDGE

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

  454. #endif

  455. 

  456.     if (gStandalone.engine != nullptr)

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

  458. }

  459. 

  460. #ifndef BUILD_BRIDGE

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

  462. {

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

  464. 

  465.     switch (option)

  466.     {

  467.     case CB::ENGINE_OPTION_DEBUG:

  468.         break;

  469. 

  470.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  473.         break;

  474. 

  475.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  478.         delete[] gStandalone.engineOptions.transportExtra;

  479.         gStandalone.engineOptions.transportExtra = (valueStr != nullptr) ? carla_strdup_safe(valueStr) : nullptr;

  480.         break;

  481. 

  482.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  485.         break;

  486. 

  487.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  490.         break;

  491. 

  492.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  495.         break;

  496. 

  497.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  500.         break;

  501. 

  502.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  503.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  505.         break;

  506. 

  507.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  508.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  510.         break;

  511. 

  512.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  515.         break;

  516. 

  517.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  518.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  520.         break;

  521. 

  522.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  523.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  525.         break;

  526. 

  527.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  528.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  529. 

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

  531.             delete[] gStandalone.engineOptions.audioDevice;

  532. 

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

  534.         break;

  535. 

  536.     case CB::ENGINE_OPTION_PLUGIN_PATH:

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

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

  539.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  540. 

  541.         switch (value)

  542.         {

  543.         case CB::PLUGIN_LADSPA:

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

  545.                 delete[] gStandalone.engineOptions.pathLADSPA;

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

  547.             break;

  548.         case CB::PLUGIN_DSSI:

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

  550.                 delete[] gStandalone.engineOptions.pathDSSI;

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

  552.             break;

  553.         case CB::PLUGIN_LV2:

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

  555.                 delete[] gStandalone.engineOptions.pathLV2;

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

  557.             break;

  558.         case CB::PLUGIN_VST2:

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

  560.                 delete[] gStandalone.engineOptions.pathVST2;

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

  562.             break;

  563.         case CB::PLUGIN_VST3:

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

  565.                 delete[] gStandalone.engineOptions.pathVST3;

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

  567.             break;

  568.         case CB::PLUGIN_GIG:

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

  570.                 delete[] gStandalone.engineOptions.pathGIG;

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

  572.             break;

  573.         case CB::PLUGIN_SF2:

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

  575.                 delete[] gStandalone.engineOptions.pathSF2;

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

  577.             break;

  578.         case CB::PLUGIN_SFZ:

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

  580.                 delete[] gStandalone.engineOptions.pathSFZ;

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

  582.             break;

  583.         }

  584.         break;

  585. 

  586.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  588. 

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

  590.             delete[] gStandalone.engineOptions.binaryDir;

  591. 

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

  593.         break;

  594. 

  595.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  597. 

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

  599.             delete[] gStandalone.engineOptions.resourceDir;

  600. 

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

  602.         break;

  603. 

  604.     case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

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

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

  607.         break;

  608. 

  609.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID: {

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

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

  612.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  614.     }   break;

  615. 

  616.     case CB::ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT:

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

  618.         break;

  619.     }

  620. 

  621.     if (gStandalone.engine != nullptr)

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

  623. }

  624. #endif

  625. 

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

  627. {

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

  629. 

  630.     gStandalone.fileCallback    = func;

  631.     gStandalone.fileCallbackPtr = ptr;

  632. 

  633.     if (gStandalone.engine != nullptr)

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

  635. }

  636. 

  637. // -------------------------------------------------------------------------------------------------------------------

  638. 

  639. bool carla_load_file(const char* filename)

  640. {

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

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

  643. 

  644.     if (gStandalone.engine != nullptr)

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

  646. 

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

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

  649.     return false;

  650. }

  651. 

  652. bool carla_load_project(const char* filename)

  653. {

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

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

  656. 

  657.     if (gStandalone.engine != nullptr)

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

  659. 

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

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

  662.     return false;

  663. }

  664. 

  665. bool carla_save_project(const char* filename)

  666. {

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

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

  669. 

  670.     if (gStandalone.engine != nullptr)

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

  672. 

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

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

  675.     return false;

  676. }

  677. 

  678. #ifndef BUILD_BRIDGE

  679. // -------------------------------------------------------------------------------------------------------------------

  680. 

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

  682. {

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

  684. 

  685.     if (gStandalone.engine != nullptr)

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

  687. 

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

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

  690.     return false;

  691. }

  692. 

  693. bool carla_patchbay_disconnect(uint connectionId)

  694. {

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

  696. 

  697.     if (gStandalone.engine != nullptr)

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

  699. 

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

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

  702.     return false;

  703. }

  704. 

  705. bool carla_patchbay_refresh(bool external)

  706. {

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

  708. 

  709.     if (gStandalone.engine != nullptr)

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

  711. 

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

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

  714.     return false;

  715. }

  716. 

  717. // -------------------------------------------------------------------------------------------------------------------

  718. 

  719. void carla_transport_play()

  720. {

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

  722.     carla_debug("carla_transport_play()");

  723. 

  724.     gStandalone.engine->transportPlay();

  725. }

  726. 

  727. void carla_transport_pause()

  728. {

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

  730.     carla_debug("carla_transport_pause()");

  731. 

  732.     gStandalone.engine->transportPause();

  733. }

  734. 

  735. void carla_transport_relocate(uint64_t frame)

  736. {

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

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

  739. 

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

  741. }

  742. 

  743. uint64_t carla_get_current_transport_frame()

  744. {

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

  746. 

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

  748.     return timeInfo.frame;

  749. }

  750. 

  751. const CarlaTransportInfo* carla_get_transport_info()

  752. {

  753.     static CarlaTransportInfo retInfo;

  754. 

  755.     // reset

  756.     retInfo.playing = false;

  757.     retInfo.frame   = 0;

  758.     retInfo.bar     = 0;

  759.     retInfo.beat    = 0;

  760.     retInfo.tick    = 0;

  761.     retInfo.bpm     = 0.0;

  762. 

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

  764. 

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

  766. 

  767.     retInfo.playing = timeInfo.playing;

  768.     retInfo.frame   = timeInfo.frame;

  769. 

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

  771.     {

  772.         retInfo.bar  = timeInfo.bbt.bar;

  773.         retInfo.beat = timeInfo.bbt.beat;

  774.         retInfo.tick = timeInfo.bbt.tick;

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

  776.     }

  777. 

  778.     return &retInfo;

  779. }

  780. #endif

  781. 

  782. // -------------------------------------------------------------------------------------------------------------------

  783. 

  784. uint32_t carla_get_current_plugin_count()

  785. {

  786.     if (gStandalone.engine != nullptr)

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

  788. 

  789.     return 0;

  790. }

  791. 

  792. uint32_t carla_get_max_plugin_number()

  793. {

  794.     if (gStandalone.engine != nullptr)

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

  796. 

  797.     return 0;

  798. }

  799. 

  800. // -------------------------------------------------------------------------------------------------------------------

  801. 

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

  803. {

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

  805. 

  806.     if (gStandalone.engine != nullptr)

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

  808. 

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

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

  811.     return false;

  812. }

  813. 

  814. bool carla_remove_plugin(uint pluginId)

  815. {

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

  817. 

  818.     if (gStandalone.engine != nullptr)

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

  820. 

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

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

  823.     return false;

  824. }

  825. 

  826. bool carla_remove_all_plugins()

  827. {

  828.     carla_debug("carla_remove_all_plugins()");

  829. 

  830.     if (gStandalone.engine != nullptr)

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

  832. 

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

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

  835.     return false;

  836. }

  837. 

  838. #ifndef BUILD_BRIDGE

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

  840. {

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

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

  843. 

  844.     if (gStandalone.engine != nullptr)

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

  846. 

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

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

  849.     return nullptr;

  850. }

  851. 

  852. bool carla_clone_plugin(uint pluginId)

  853. {

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

  855. 

  856.     if (gStandalone.engine != nullptr)

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

  858. 

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

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

  861.     return false;

  862. }

  863. 

  864. bool carla_replace_plugin(uint pluginId)

  865. {

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

  867. 

  868.     if (gStandalone.engine != nullptr)

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

  870. 

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

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

  873.     return false;

  874. }

  875. 

  876. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  877. {

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

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

  880. 

  881.     if (gStandalone.engine != nullptr)

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

  883. 

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

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

  886.     return false;

  887. }

  888. #endif

  889. 

  890. // -------------------------------------------------------------------------------------------------------------------

  891. 

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

  893. {

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

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

  896. 

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

  898.     {

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

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

  901.         return false;

  902.     }

  903. 

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

  905.         return plugin->loadStateFromFile(filename);

  906. 

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

  908.     return false;

  909. }

  910. 

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

  912. {

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

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

  915. 

  916.     if (gStandalone.engine == nullptr)

  917.     {

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

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

  920.         return false;

  921.     }

  922. 

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

  924. 

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

  926.         return plugin->saveStateToFile(filename);

  927. 

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

  929.     return false;

  930. }

  931. 

  932. // -------------------------------------------------------------------------------------------------------------------

  933. 

  934. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  935. {

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

  937. 

  938.     static CarlaPluginInfo info;

  939. 

  940.     // reset

  941.     info.type             = CB::PLUGIN_NONE;

  942.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  943.     info.hints            = 0x0;

  944.     info.optionsAvailable = 0x0;

  945.     info.optionsEnabled   = 0x0;

  946.     info.filename         = gNullCharPtr;

  947.     info.name             = gNullCharPtr;

  948.     info.iconName         = gNullCharPtr;

  949.     info.uniqueId         = 0;

  950. 

  951.     // cleanup

  952.     if (info.label != gNullCharPtr)

  953.     {

  954.         delete[] info.label;

  955.         info.label = gNullCharPtr;

  956.     }

  957. 

  958.     if (info.maker != gNullCharPtr)

  959.     {

  960.         delete[] info.maker;

  961.         info.maker = gNullCharPtr;

  962.     }

  963. 

  964.     if (info.copyright != gNullCharPtr)

  965.     {

  966.         delete[] info.copyright;

  967.         info.copyright = gNullCharPtr;

  968.     }

  969. 

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

  971. 

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

  973.     {

  974.         char strBufLabel[STR_MAX+1];

  975.         char strBufMaker[STR_MAX+1];

  976.         char strBufCopyright[STR_MAX+1];

  977. 

  978.         carla_zeroChars(strBufLabel, STR_MAX+1);

  979.         carla_zeroChars(strBufMaker, STR_MAX+1);

  980.         carla_zeroChars(strBufCopyright, STR_MAX+1);

  981. 

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

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

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

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

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

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

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

  989. 

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

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

  992. 

  993.         plugin->getLabel(strBufLabel);

  994.         info.label = carla_strdup_safe(strBufLabel);

  995. 

  996.         plugin->getMaker(strBufMaker);

  997.         info.maker = carla_strdup_safe(strBufMaker);

  998. 

  999.         plugin->getCopyright(strBufCopyright);

  1000.         info.copyright = carla_strdup_safe(strBufCopyright);

  1001. 

  1002.         checkStringPtr(info.filename);

  1003.         checkStringPtr(info.name);

  1004.         checkStringPtr(info.iconName);

  1005.         checkStringPtr(info.label);

  1006.         checkStringPtr(info.maker);

  1007.         checkStringPtr(info.copyright);

  1008. 

  1009.         return &info;

  1010.     }

  1011. 

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

  1013.     return &info;

  1014. }

  1015. 

  1016. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1017. {

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

  1019. 

  1020.     static CarlaPortCountInfo info;

  1021. 

  1022.     // reset

  1023.     info.ins   = 0;

  1024.     info.outs  = 0;

  1025. 

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

  1027. 

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

  1029.     {

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

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

  1032.         return &info;

  1033.     }

  1034. 

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

  1036.     return &info;

  1037. }

  1038. 

  1039. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1040. {

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

  1042. 

  1043.     static CarlaPortCountInfo info;

  1044. 

  1045.     // reset

  1046.     info.ins   = 0;

  1047.     info.outs  = 0;

  1048. 

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

  1050. 

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

  1052.     {

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

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

  1055.         return &info;

  1056.     }

  1057. 

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

  1059.     return &info;

  1060. }

  1061. 

  1062. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1063. {

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

  1065. 

  1066.     static CarlaPortCountInfo info;

  1067. 

  1068.     // reset

  1069.     info.ins   = 0;

  1070.     info.outs  = 0;

  1071. 

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

  1073. 

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

  1075.     {

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

  1077.         return &info;

  1078.     }

  1079. 

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

  1081.     return &info;

  1082. }

  1083. 

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

  1085. {

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

  1087. 

  1088.     static CarlaParameterInfo info;

  1089. 

  1090.     // reset

  1091.     info.scalePointCount = 0;

  1092. 

  1093.     // cleanup

  1094.     if (info.name != gNullCharPtr)

  1095.     {

  1096.         delete[] info.name;

  1097.         info.name = gNullCharPtr;

  1098.     }

  1099. 

  1100.     if (info.symbol != gNullCharPtr)

  1101.     {

  1102.         delete[] info.symbol;

  1103.         info.symbol = gNullCharPtr;

  1104.     }

  1105. 

  1106.     if (info.unit != gNullCharPtr)

  1107.     {

  1108.         delete[] info.unit;

  1109.         info.unit = gNullCharPtr;

  1110.     }

  1111. 

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

  1113. 

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

  1115.     {

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

  1117.         {

  1118.             char strBufName[STR_MAX+1];

  1119.             char strBufSymbol[STR_MAX+1];

  1120.             char strBufUnit[STR_MAX+1];

  1121. 

  1122.             carla_zeroChars(strBufName, STR_MAX+1);

  1123.             carla_zeroChars(strBufSymbol, STR_MAX+1);

  1124.             carla_zeroChars(strBufUnit, STR_MAX+1);

  1125. 

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

  1127. 

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

  1129.             info.name = carla_strdup_safe(strBufName);

  1130. 

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

  1132.             info.symbol = carla_strdup_safe(strBufSymbol);

  1133. 

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

  1135.             info.unit = carla_strdup_safe(strBufUnit);

  1136. 

  1137.             checkStringPtr(info.name);

  1138.             checkStringPtr(info.symbol);

  1139.             checkStringPtr(info.unit);

  1140.         }

  1141.         else

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

  1143. 

  1144.         return &info;

  1145.     }

  1146. 

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

  1148.     return &info;

  1149. }

  1150. 

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

  1152. {

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

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

  1155. 

  1156.     static CarlaScalePointInfo info;

  1157. 

  1158.     // reset

  1159.     info.value = 0.0f;

  1160. 

  1161.     // cleanup

  1162.     if (info.label != gNullCharPtr)

  1163.     {

  1164.         delete[] info.label;

  1165.         info.label = gNullCharPtr;

  1166.     }

  1167. 

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

  1169. 

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

  1171.     {

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

  1173.         {

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

  1175.             {

  1176.                 char strBufLabel[STR_MAX+1];

  1177.                 carla_zeroChars(strBufLabel, STR_MAX+1);

  1178. 

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

  1180. 

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

  1182.                 info.label = carla_strdup_safe(strBufLabel);

  1183.                 checkStringPtr(info.label);

  1184.             }

  1185.             else

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

  1187.         }

  1188.         else

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

  1190. 

  1191.         return &info;

  1192.     }

  1193. 

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

  1195.     return &info;

  1196. }

  1197. 

  1198. // -------------------------------------------------------------------------------------------------------------------

  1199. 

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

  1201. {

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

  1203. 

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

  1205. 

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

  1207. 

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

  1209.     {

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

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

  1212. 

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

  1214.         return &fallbackParameterData;

  1215.     }

  1216. 

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

  1218.     return &fallbackParameterData;

  1219. }

  1220. 

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

  1222. {

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

  1224. 

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

  1226. 

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

  1228. 

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

  1230.     {

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

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

  1233. 

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

  1235.         return &fallbackParamRanges;

  1236.     }

  1237. 

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

  1239.     return &fallbackParamRanges;

  1240. }

  1241. 

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

  1243. {

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

  1245. 

  1246.     static MidiProgramData midiProgData;

  1247. 

  1248.     // reset

  1249.     midiProgData.bank    = 0;

  1250.     midiProgData.program = 0;

  1251.     midiProgData.name    = gNullCharPtr;

  1252. 

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

  1254. 

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

  1256.     {

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

  1258.         {

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

  1260.             carla_copyStruct(midiProgData, ret);

  1261.             checkStringPtr(midiProgData.name);

  1262.             return &midiProgData;

  1263.         }

  1264. 

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

  1266.         return &midiProgData;

  1267.     }

  1268. 

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

  1270.     return &midiProgData;

  1271. }

  1272. 

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

  1274. {

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

  1276. 

  1277.     static CustomData customData;

  1278. 

  1279.     // reset

  1280.     customData.type  = gNullCharPtr;

  1281.     customData.key   = gNullCharPtr;

  1282.     customData.value = gNullCharPtr;

  1283. 

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

  1285. 

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

  1287.     {

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

  1289.         {

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

  1291.             carla_copyStruct(customData, ret);

  1292.             checkStringPtr(customData.type);

  1293.             checkStringPtr(customData.key);

  1294.             checkStringPtr(customData.value);

  1295.             return &customData;

  1296.         }

  1297. 

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

  1299.         return &customData;

  1300.     }

  1301. 

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

  1303.     return &customData;

  1304. }

  1305. 

  1306. const char* carla_get_chunk_data(uint pluginId)

  1307. {

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

  1309. 

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

  1311. 

  1312.     static CarlaString chunkData;

  1313. 

  1314.     // cleanup

  1315.     chunkData.clear();

  1316. 

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

  1318.     {

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

  1320.         {

  1321.             void* data = nullptr;

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

  1323. 

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

  1325.             {

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

  1327.                 return chunkData;

  1328.             }

  1329.             else

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

  1331.         }

  1332.         else

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

  1334. 

  1335.         return nullptr;

  1336.     }

  1337. 

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

  1339.     return nullptr;

  1340. }

  1341. 

  1342. // -------------------------------------------------------------------------------------------------------------------

  1343. 

  1344. uint32_t carla_get_parameter_count(uint pluginId)

  1345. {

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

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

  1348. 

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

  1350.         return plugin->getParameterCount();

  1351. 

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

  1353.     return 0;

  1354. }

  1355. 

  1356. uint32_t carla_get_program_count(uint pluginId)

  1357. {

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

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

  1360. 

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

  1362.         return plugin->getProgramCount();

  1363. 

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

  1365.     return 0;

  1366. }

  1367. 

  1368. uint32_t carla_get_midi_program_count(uint pluginId)

  1369. {

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

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

  1372. 

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

  1374.         return plugin->getMidiProgramCount();

  1375. 

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

  1377.     return 0;

  1378. }

  1379. 

  1380. uint32_t carla_get_custom_data_count(uint pluginId)

  1381. {

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

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

  1384. 

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

  1386.         return plugin->getCustomDataCount();

  1387. 

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

  1389.     return 0;

  1390. }

  1391. 

  1392. // -------------------------------------------------------------------------------------------------------------------

  1393. 

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

  1395. {

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

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

  1398. 

  1399.     static char textBuf[STR_MAX+1];

  1400. 

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

  1402.     {

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

  1404.         {

  1405.             carla_zeroChars(textBuf, STR_MAX+1);

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

  1407.             return textBuf;

  1408.         }

  1409. 

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

  1411.         return nullptr;

  1412.     }

  1413. 

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

  1415.     return nullptr;

  1416. }

  1417. 

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

  1419. {

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

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

  1422. 

  1423.     static char programName[STR_MAX+1];

  1424. 

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

  1426.     {

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

  1428.         {

  1429.             carla_zeroChars(programName, STR_MAX+1);

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

  1431.             return programName;

  1432.         }

  1433. 

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

  1435.         return nullptr;

  1436.     }

  1437. 

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

  1439.     return nullptr;

  1440. }

  1441. 

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

  1443. {

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

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

  1446. 

  1447.     static char midiProgramName[STR_MAX+1];

  1448. 

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

  1450.     {

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

  1452.         {

  1453.             carla_zeroChars(midiProgramName, STR_MAX+1);

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

  1455.             return midiProgramName;

  1456.         }

  1457. 

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

  1459.         return nullptr;

  1460.     }

  1461. 

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

  1463.     return nullptr;

  1464. }

  1465. 

  1466. const char* carla_get_real_plugin_name(uint pluginId)

  1467. {

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

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

  1470. 

  1471.     static char realPluginName[STR_MAX+1];

  1472. 

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

  1474.     {

  1475.         carla_zeroChars(realPluginName, STR_MAX+1);

  1476.         plugin->getRealName(realPluginName);

  1477.         return realPluginName;

  1478.     }

  1479. 

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

  1481.     return nullptr;

  1482. }

  1483. 

  1484. // -------------------------------------------------------------------------------------------------------------------

  1485. 

  1486. int32_t carla_get_current_program_index(uint pluginId)

  1487. {

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

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

  1490. 

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

  1492.         return plugin->getCurrentProgram();

  1493. 

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

  1495.     return -1;

  1496. }

  1497. 

  1498. int32_t carla_get_current_midi_program_index(uint pluginId)

  1499. {

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

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

  1502. 

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

  1504.         return plugin->getCurrentMidiProgram();

  1505. 

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

  1507.     return -1;

  1508. }

  1509. 

  1510. // -------------------------------------------------------------------------------------------------------------------

  1511. 

  1512. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  1513. {

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

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

  1516. 

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

  1518.     {

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

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

  1521. 

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

  1523.         return 0.0f;

  1524.     }

  1525. 

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

  1527.     return 0.0f;

  1528. }

  1529. 

  1530. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  1531. {

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

  1533. 

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

  1535.     {

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

  1537.             return plugin->getParameterValue(parameterId);

  1538. 

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

  1540.         return 0.0f;

  1541.     }

  1542. 

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

  1544.     return 0.0f;

  1545. }

  1546. 

  1547. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  1548. {

  1549. #ifdef BUILD_BRIDGE

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

  1551. #else

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

  1553. #endif

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

  1555. 

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

  1557.         return plugin->getInternalParameterValue(parameterId);

  1558. 

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

  1560.     return 0.0f;

  1561. }

  1562. 

  1563. // -------------------------------------------------------------------------------------------------------------------

  1564. 

  1565. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  1566. {

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

  1568. 

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

  1570. }

  1571. 

  1572. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  1573. {

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

  1575. 

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

  1577. }

  1578. 

  1579. // -------------------------------------------------------------------------------------------------------------------

  1580. 

  1581. void carla_set_active(uint pluginId, bool onOff)

  1582. {

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

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

  1585. 

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

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

  1588. 

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

  1590. }

  1591. 

  1592. #ifndef BUILD_BRIDGE

  1593. void carla_set_drywet(uint pluginId, float value)

  1594. {

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

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

  1597. 

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

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

  1600. 

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

  1602. }

  1603. 

  1604. void carla_set_volume(uint pluginId, float value)

  1605. {

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

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

  1608. 

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

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

  1611. 

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

  1613. }

  1614. 

  1615. void carla_set_balance_left(uint pluginId, float value)

  1616. {

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

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

  1619. 

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

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

  1622. 

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

  1624. }

  1625. 

  1626. void carla_set_balance_right(uint pluginId, float value)

  1627. {

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

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

  1630. 

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

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

  1633. 

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

  1635. }

  1636. 

  1637. void carla_set_panning(uint pluginId, float value)

  1638. {

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

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

  1641. 

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

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

  1644. 

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

  1646. }

  1647. 

  1648. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  1649. {

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

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

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

  1653. 

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

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

  1656. 

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

  1658. }

  1659. 

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

  1661. {

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

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

  1664. 

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

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

  1667. 

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

  1669. }

  1670. #endif

  1671. 

  1672. // -------------------------------------------------------------------------------------------------------------------

  1673. 

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

  1675. {

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

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

  1678. 

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

  1680.     {

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

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

  1683. 

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

  1685.         return;

  1686.     }

  1687. 

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

  1689. }

  1690. 

  1691. #ifndef BUILD_BRIDGE

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

  1693. {

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

  1695.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  1697. 

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

  1699.     {

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

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

  1702. 

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

  1704.         return;

  1705.     }

  1706. 

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

  1708. }

  1709. 

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

  1711. {

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

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

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

  1715. 

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

  1717.     {

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

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

  1720. 

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

  1722.         return;

  1723.     }

  1724. 

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

  1726. }

  1727. #endif

  1728. 

  1729. // -------------------------------------------------------------------------------------------------------------------

  1730. 

  1731. void carla_set_program(uint pluginId, uint32_t programId)

  1732. {

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

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

  1735. 

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

  1737.     {

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

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

  1740. 

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

  1742.         return;

  1743.     }

  1744. 

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

  1746. }

  1747. 

  1748. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  1749. {

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

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

  1752. 

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

  1754.     {

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

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

  1757. 

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

  1759.         return;

  1760.     }

  1761. 

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

  1763. }

  1764. 

  1765. // -------------------------------------------------------------------------------------------------------------------

  1766. 

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

  1768. {

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

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

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

  1772.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  1774. 

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

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

  1777. 

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

  1779. }

  1780. 

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

  1782. {

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

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

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

  1786. 

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

  1788.     {

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

  1790.         {

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

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

  1793.         }

  1794. 

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

  1796.         return;

  1797.     }

  1798. 

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

  1800. }

  1801. 

  1802. // -------------------------------------------------------------------------------------------------------------------

  1803. 

  1804. void carla_prepare_for_save(uint pluginId)

  1805. {

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

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

  1808. 

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

  1810.         return plugin->prepareForSave();

  1811. 

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

  1813. }

  1814. 

  1815. void carla_reset_parameters(uint pluginId)

  1816. {

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

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

  1819. 

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

  1821.         return plugin->resetParameters();

  1822. 

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

  1824. }

  1825. 

  1826. void carla_randomize_parameters(uint pluginId)

  1827. {

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

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

  1830. 

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

  1832.         return plugin->randomizeParameters();

  1833. 

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

  1835. }

  1836. 

  1837. #ifndef BUILD_BRIDGE

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

  1839. {

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

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

  1842. 

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

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

  1845. 

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

  1847. }

  1848. #endif

  1849. 

  1850. void carla_show_custom_ui(uint pluginId, bool yesNo)

  1851. {

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

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

  1854. 

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

  1856.         return plugin->showCustomUI(yesNo);

  1857. 

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

  1859. }

  1860. 

  1861. // -------------------------------------------------------------------------------------------------------------------

  1862. 

  1863. uint32_t carla_get_buffer_size()

  1864. {

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

  1866.     carla_debug("carla_get_buffer_size()");

  1867. 

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

  1869. }

  1870. 

  1871. double carla_get_sample_rate()

  1872. {

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

  1874.     carla_debug("carla_get_sample_rate()");

  1875. 

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

  1877. }

  1878. 

  1879. // -------------------------------------------------------------------------------------------------------------------

  1880. 

  1881. const char* carla_get_last_error()

  1882. {

  1883.     carla_debug("carla_get_last_error()");

  1884. 

  1885.     if (gStandalone.engine != nullptr)

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

  1887. 

  1888.     return gStandalone.lastError;

  1889. }

  1890. 

  1891. const char* carla_get_host_osc_url_tcp()

  1892. {

  1893.     carla_debug("carla_get_host_osc_url_tcp()");

  1894. 

  1895. #ifdef HAVE_LIBLO

  1896.     if (gStandalone.engine == nullptr)

  1897.     {

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

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

  1900.         return nullptr;

  1901.     }

  1902. 

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

  1904. #else

  1905.     return nullptr;

  1906. #endif

  1907. }

  1908. 

  1909. const char* carla_get_host_osc_url_udp()

  1910. {

  1911.     carla_debug("carla_get_host_osc_url_udp()");

  1912. 

  1913. #ifdef HAVE_LIBLO

  1914.     if (gStandalone.engine == nullptr)

  1915.     {

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

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

  1918.         return nullptr;

  1919.     }

  1920. 

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

  1922. #else

  1923.     return nullptr;

  1924. #endif

  1925. }

  1926. 

  1927. // -------------------------------------------------------------------------------------------------------------------

  1928. 

  1929. #include "CarlaPluginUI.cpp"

  1930. #include "CarlaDssiUtils.cpp"

  1931. #include "CarlaPatchbayUtils.cpp"

  1932. #include "CarlaPipeUtils.cpp"

  1933. #include "CarlaStateUtils.cpp"

  1934. #include "CarlaJuceEvents.cpp"

  1935. 

  1936. // -------------------------------------------------------------------------------------------------------------------