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

2479 lines
85KB
Raw Blame History 

  1. /*

  2.  * Carla Standalone

  3.  * Copyright (C) 2011-2014 Filipe Coelho <falktx@falktx.com>

  4.  *

  5.  * This program is free software; you can redistribute it and/or

  6.  * modify it under the terms of the GNU General Public License as

  7.  * published by the Free Software Foundation; either version 2 of

  8.  * the License, or any later version.

  9.  *

  10.  * This program is distributed in the hope that it will be useful,

  11.  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  12.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

  13.  * GNU General Public License for more details.

  14.  *

  15.  * For a full copy of the GNU General Public License see the doc/GPL.txt file.

  16.  */

  17. 

  18. // TODO:

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

  20. 

  21. #include "CarlaHost.h"

  22. #include "CarlaMIDI.h"

  23. #include "CarlaNative.h"

  24. 

  25. #include "CarlaEngine.hpp"

  26. #include "CarlaPlugin.hpp"

  27. 

  28. #include "CarlaBackendUtils.hpp"

  29. #include "CarlaBase64Utils.hpp"

  30. #include "CarlaOscUtils.hpp"

  31. 

  32. #include "juce_audio_formats.h"

  33. 

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

  35. # include "juce_gui_basics.h"

  36. #else

  37. namespace juce {

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

  39. } // namespace juce

  40. #endif

  41. 

  42. namespace CB = CarlaBackend;

  43. using CB::EngineOptions;

  44. 

  45. // -------------------------------------------------------------------------------------------------------------------

  46. // Single, standalone engine

  47. 

  48. struct CarlaBackendStandalone {

  49.     CarlaEngine*       engine;

  50.     EngineCallbackFunc engineCallback;

  51.     void*              engineCallbackPtr;

  52.     EngineOptions      engineOptions;

  53. 

  54.     FileCallbackFunc fileCallback;

  55.     void*            fileCallbackPtr;

  56. 

  57.     CarlaString lastError;

  58. 

  59.     CarlaBackendStandalone()

  60.         : engine(nullptr),

  61.           engineCallback(nullptr),

  62.           engineCallbackPtr(nullptr),

  63.           engineOptions(),

  64.           fileCallback(nullptr),

  65.           fileCallbackPtr(nullptr),

  66.           lastError()

  67.     {

  68. #ifdef BUILD_BRIDGE

  69.         engineOptions.processMode         = CB::ENGINE_PROCESS_MODE_BRIDGE;

  70.         engineOptions.transportMode       = CB::ENGINE_TRANSPORT_MODE_BRIDGE;

  71.         engineOptions.forceStereo         = false;

  72.         engineOptions.preferPluginBridges = false;

  73.         engineOptions.preferUiBridges     = false;

  74. 

  75.         using juce::File;

  76.         File binaryDir(File::getSpecialLocation(File::currentExecutableFile).getParentDirectory());

  77.         engineOptions.binaryDir   = carla_strdup_safe(binaryDir.getFullPathName().toRawUTF8());

  78.         engineOptions.resourceDir = carla_strdup_safe(binaryDir.getChildFile("resources").getFullPathName().toRawUTF8());

  79. #else

  80.         if (std::getenv("LADISH_APP_NAME") == nullptr && std::getenv("NSM_URL") == nullptr)

  81.             juce::Thread::setCurrentThreadName("Carla");

  82. #endif

  83.     }

  84. 

  85.     ~CarlaBackendStandalone()

  86.     {

  87.         CARLA_SAFE_ASSERT(engine == nullptr);

  88.     }

  89. 

  90.     CARLA_PREVENT_HEAP_ALLOCATION

  91.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  92. };

  93. 

  94. static CarlaBackendStandalone gStandalone;

  95. 

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

  97. // NSM support

  98. 

  99. #define NSM_API_VERSION_MAJOR 1

  100. #define NSM_API_VERSION_MINOR 2

  101. 

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

  103. #define NSM_CLIENT_FEATURES ":switch:"

  104. 

  105. class CarlaNSM

  106. {

  107. public:

  108.     CarlaNSM() noexcept

  109.         : fOscServer(nullptr),

  110.           fClientId(),

  111.           fProjectPath(),

  112.           fHasBroadcast(false),

  113.           fHasShowHideUI(false) {}

  114. 

  115.     ~CarlaNSM()

  116.     {

  117.         if (fOscServer != nullptr)

  118.         {

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

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

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

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

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

  124.             lo_server_free(fOscServer);

  125.             fOscServer = nullptr;

  126.         }

  127.     }

  128. 

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

  130.     {

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

  132. 

  133.         if (NSM_URL == nullptr)

  134.             return;

  135. 

  136.         const lo_address addr = lo_address_new_from_url(NSM_URL);

  137. 

  138.         if (addr == nullptr)

  139.             return;

  140. 

  141.         const int proto = lo_address_get_protocol(addr);

  142. 

  143.         if (fOscServer == nullptr)

  144.         {

  145.             // create new OSC server

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

  147. 

  148.             // register message handlers and start OSC thread

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

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

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

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

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

  154.             // /nsm/client/session_is_loaded

  155.         }

  156. 

  157. #ifndef BUILD_ANSI_TEST

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

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

  160. #endif

  161. 

  162.         lo_address_free(addr);

  163.     }

  164. 

  165.     void idle() noexcept

  166.     {

  167.         if (fOscServer == nullptr)

  168.             return;

  169. 

  170.         for (;;)

  171.         {

  172.             try {

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

  174.                     break;

  175.             } CARLA_SAFE_EXCEPTION_CONTINUE("NSM OSC idle")

  176.         }

  177.     }

  178. 

  179. protected:

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

  181.     {

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

  183. 

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

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

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

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

  188. 

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

  190. 

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

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

  193. 

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

  195. 

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

  197. 

  198.         return 0;

  199. 

  200. #ifndef DEBUG

  201.         // unused

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

  203. #endif

  204.     }

  205. 

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

  207.     {

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

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

  210. 

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

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

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

  214. 

  215.         if (! carla_is_engine_running())

  216.         {

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

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

  219. 

  220.             carla_engine_init("JACK", clientId);

  221.         }

  222.         else

  223.         {

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

  225. 

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

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

  228.         }

  229. 

  230.         fClientId = clientId;

  231. 

  232.         fProjectPath  = projectPath;

  233.         fProjectPath += ".carxp";

  234. 

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

  236. 

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

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

  239. 

  240. #ifndef BUILD_ANSI_TEST

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

  242. #endif

  243. 

  244. #if 0

  245.         if (fHasBroadcast)

  246.         {

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

  248. 

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

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

  251. 

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

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

  254. 

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

  256. 

  257.             std::free(url);

  258. 

  259.             carla_stdout("Broadcast sent!");

  260.         }

  261.         else

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

  263. #endif

  264. 

  265.         return 0;

  266. 

  267. #ifndef DEBUG

  268.         // unused

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

  270. #endif

  271.     }

  272. 

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

  274.     {

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

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

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

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

  279. 

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

  281. 

  282. #ifndef BUILD_ANSI_TEST

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

  284. #endif

  285. 

  286.         return 0;

  287. 

  288. #ifndef DEBUG

  289.         // unused

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

  291. #endif

  292.     }

  293. 

  294. #if 0

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

  296.     {

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

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

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

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

  301. 

  302. #ifndef BUILD_ANSI_TEST

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

  304. #endif

  305. 

  306.         return 0;

  307.     }

  308. #endif

  309. 

  310. private:

  311.     lo_server fOscServer;

  312. 

  313.     CarlaString fClientId;

  314.     CarlaString fProjectPath;

  315. 

  316.     bool fHasBroadcast;

  317.     bool fHasShowHideUI;

  318. 

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

  320. 

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

  322.     {

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

  324.     }

  325. 

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

  327.     {

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

  329.     }

  330. 

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

  332.     {

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

  334.     }

  335. 

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

  337.     {

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

  339.     }

  340. 

  341. #if 0

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

  343.     {

  344.         return handlePtr->handleShowHideGui(true);

  345.     }

  346. 

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

  348.     {

  349.         return handlePtr->handleShowHideGui(false);

  350.     }

  351. #endif

  352. 

  353.     #undef handlePtr

  354. 

  355.     CARLA_PREVENT_HEAP_ALLOCATION

  356.     CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)

  357. };

  358. 

  359. static CarlaNSM gNSM;

  360. 

  361. // -------------------------------------------------------------------------------------------------------------------

  362. // Always return a valid string ptr

  363. 

  364. static const char* const gNullCharPtr = "";

  365. 

  366. static void checkStringPtr(const char*& charPtr) noexcept

  367. {

  368.     if (charPtr == nullptr)

  369.         charPtr = gNullCharPtr;

  370. }

  371. 

  372. // -------------------------------------------------------------------------------------------------------------------

  373. // Constructors

  374. 

  375. _CarlaPluginInfo::_CarlaPluginInfo() noexcept

  376.     : type(CB::PLUGIN_NONE),

  377.       category(CB::PLUGIN_CATEGORY_NONE),

  378.       hints(0x0),

  379.       optionsAvailable(0x0),

  380.       optionsEnabled(0x0),

  381.       filename(gNullCharPtr),

  382.       name(gNullCharPtr),

  383.       label(gNullCharPtr),

  384.       maker(gNullCharPtr),

  385.       copyright(gNullCharPtr),

  386.       iconName(gNullCharPtr),

  387.       uniqueId(0) {}

  388. 

  389. _CarlaPluginInfo::~_CarlaPluginInfo() noexcept

  390. {

  391.     if (label != gNullCharPtr)

  392.         delete[] label;

  393.     if (maker != gNullCharPtr)

  394.         delete[] maker;

  395.     if (copyright != gNullCharPtr)

  396.         delete[] copyright;

  397. }

  398. 

  399. _CarlaNativePluginInfo::_CarlaNativePluginInfo() noexcept

  400.     : category(CB::PLUGIN_CATEGORY_NONE),

  401.       hints(0x0),

  402.       audioIns(0),

  403.       audioOuts(0),

  404.       midiIns(0),

  405.       midiOuts(0),

  406.       parameterIns(0),

  407.       parameterOuts(0),

  408.       name(gNullCharPtr),

  409.       label(gNullCharPtr),

  410.       maker(gNullCharPtr),

  411.       copyright(gNullCharPtr) {}

  412. 

  413. _CarlaParameterInfo::_CarlaParameterInfo() noexcept

  414.     : name(gNullCharPtr),

  415.       symbol(gNullCharPtr),

  416.       unit(gNullCharPtr),

  417.       scalePointCount(0) {}

  418. 

  419. _CarlaParameterInfo::~_CarlaParameterInfo() noexcept

  420. {

  421.     if (name != gNullCharPtr)

  422.         delete[] name;

  423.     if (symbol != gNullCharPtr)

  424.         delete[] symbol;

  425.     if (unit != gNullCharPtr)

  426.         delete[] unit;

  427. }

  428. 

  429. _CarlaScalePointInfo::_CarlaScalePointInfo() noexcept

  430.     : value(0.0f),

  431.       label(gNullCharPtr) {}

  432. 

  433. _CarlaScalePointInfo::~_CarlaScalePointInfo() noexcept

  434. {

  435.     if (label != gNullCharPtr)

  436.         delete[] label;

  437. }

  438. 

  439. _CarlaTransportInfo::_CarlaTransportInfo() noexcept

  440.     : playing(false),

  441.       frame(0),

  442.       bar(0),

  443.       beat(0),

  444.       tick(0),

  445.       bpm(0.0) {}

  446. 

  447. // -------------------------------------------------------------------------------------------------------------------

  448. // API

  449. 

  450. const char* carla_get_complete_license_text()

  451. {

  452.     carla_debug("carla_get_complete_license_text()");

  453. 

  454.     static CarlaString retText;

  455. 

  456.     if (retText.isEmpty())

  457.     {

  458.         CarlaString text1, text2, text3, text4, text5;

  459. 

  460.         text1 += "<p>This current Carla build is using the following features and 3rd-party code:</p>";

  461.         text1 += "<ul>";

  462. 

  463.         // Plugin formats

  464.         text2 += "<li>LADSPA plugin support, http://www.ladspa.org/</li>";

  465.         text2 += "<li>DSSI plugin support, http://dssi.sourceforge.net/</li>";

  466.         text2 += "<li>LV2 plugin support, http://lv2plug.in/</li>";

  467. #ifdef VESTIGE_HEADER

  468.         text2 += "<li>VST plugin support, using VeSTige header by Javier Serrano Polo</li>";

  469. #else

  470.         text2 += "<li>VST plugin support, using official VST SDK 2.4 (trademark of Steinberg Media Technologies GmbH)</li>";

  471. #endif

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

  473.         text2 += "<li>VST3 plugin support, using official VST SDK 3.6 (trademark of Steinberg Media Technologies GmbH)</li>";

  474. #endif

  475. #ifdef CARLA_OS_MAC

  476.         text2 += "<li>AU plugin support</li>";

  477. #endif

  478. 

  479.         // Sample kit libraries

  480. #ifdef HAVE_FLUIDSYNTH

  481.         text2 += "<li>FluidSynth library for SF2 support, http://www.fluidsynth.org/</li>";

  482. #endif

  483. #ifdef HAVE_LINUXSAMPLER

  484.         text2 += "<li>LinuxSampler library for GIG and SFZ support*, http://www.linuxsampler.org/</li>";

  485. #endif

  486. 

  487.         // Internal plugins

  488.         text3 += "<li>NekoFilter plugin code, based on lv2fil by Nedko Arnaudov and Fons Adriaensen</li>";

  489. #ifdef WANT_ZYNADDSUBFX

  490.         text3 += "<li>ZynAddSubFX plugin code, http://zynaddsubfx.sf.net/</li>";

  491. # ifdef WANT_ZYNADDSUBFX_UI

  492.         text3 += "<li>ZynAddSubFX UI using NTK, http://non.tuxfamily.org/wiki/NTK</li>";

  493. # endif

  494. #endif

  495. 

  496.         // misc libs

  497.         text4 += "<li>liblo library for OSC support, http://liblo.sourceforge.net/</li>";

  498.         text4 += "<li>serd, sord, sratom and lilv libraries for LV2 discovery, http://drobilla.net/software/lilv/</li>";

  499. #if ! (defined(CARLA_OS_MAC) || defined(CARLA_OS_WIN))

  500.         text4 += "<li>RtAudio+RtMidi libraries for extra Audio and MIDI support, http://www.music.mcgill.ca/~gary/rtaudio/</li>";

  501. #endif

  502. 

  503.         // end

  504.         text5 += "</ul>";

  505. 

  506. #ifdef HAVE_LINUXSAMPLER

  507.         // LinuxSampler GPL exception

  508.         text5 += "<p>(*) Using LinuxSampler code in commercial hardware or software products is not allowed without prior written authorization by the authors.</p>";

  509. #endif

  510. 

  511.         retText = text1 + text2 + text3 + text4 + text5;

  512.     }

  513. 

  514.     return retText;

  515. }

  516. 

  517. const char* carla_get_juce_version()

  518. {

  519.     carla_debug("carla_get_juce_version()");

  520. 

  521.     static CarlaString retVersion;

  522. 

  523.     if (retVersion.isEmpty())

  524.     {

  525.         if (const char* const version = juce::SystemStats::getJUCEVersion().toRawUTF8())

  526.             retVersion = version+6;

  527.         else

  528.             retVersion = "3.0";

  529.     }

  530. 

  531.     return retVersion;

  532. }

  533. 

  534. const char* carla_get_supported_file_extensions()

  535. {

  536.     carla_debug("carla_get_supported_file_extensions()");

  537. 

  538.     static CarlaString retText;

  539. 

  540.     if (retText.isEmpty())

  541.     {

  542.         // Base types

  543.         retText += "*.carxp;*.carxs";

  544. 

  545.         // Sample kits

  546. #ifdef HAVE_FLUIDSYNTH

  547.         retText += ";*.sf2";

  548. #endif

  549. #ifdef HAVE_LINUXSAMPLER

  550.         retText += ";*.gig;*.sfz";

  551. #endif

  552. 

  553. #ifndef BUILD_BRIDGE

  554.         // Audio files

  555.         {

  556.             using namespace juce;

  557. 

  558.             AudioFormatManager afm;

  559.             afm.registerBasicFormats();

  560. 

  561.             for (AudioFormat **it=afm.begin(), **end=afm.end(); it != end; ++it)

  562.             {

  563.                 const StringArray& exts((*it)->getFileExtensions());

  564. 

  565.                 for (String *eit=exts.begin(), *eend=exts.end(); eit != eend; ++eit)

  566.                     retText += String(";*" + (*eit)).toRawUTF8();

  567.             }

  568.         }

  569. #endif

  570. 

  571.         // MIDI files

  572.         retText += ";*.mid;*.midi";

  573. 

  574.         // Plugin presets

  575. #ifdef WANT_ZYNADDSUBFX

  576.         retText += ";*.xmz;*.xiz";

  577. #endif

  578.     }

  579. 

  580.     return retText;

  581. }

  582. 

  583. // -------------------------------------------------------------------------------------------------------------------

  584. 

  585. uint carla_get_engine_driver_count()

  586. {

  587.     carla_debug("carla_get_engine_driver_count()");

  588. 

  589.     return CarlaEngine::getDriverCount();

  590. }

  591. 

  592. const char* carla_get_engine_driver_name(uint index)

  593. {

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

  595. 

  596.     return CarlaEngine::getDriverName(index);

  597. }

  598. 

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

  600. {

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

  602. 

  603.     return CarlaEngine::getDriverDeviceNames(index);

  604. }

  605. 

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

  607. {

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

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

  610. 

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

  612.     {

  613.         static EngineDriverDeviceInfo devInfo;

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

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

  616. 

  617.         devInfo.hints       = ret->hints;

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

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

  620.         return &devInfo;

  621.     }

  622. 

  623.     return nullptr;

  624. }

  625. 

  626. #ifndef BUILD_BRIDGE

  627. // -------------------------------------------------------------------------------------------------------------------

  628. 

  629. uint carla_get_internal_plugin_count()

  630. {

  631.     carla_debug("carla_get_internal_plugin_count()");

  632. 

  633.     return static_cast<uint>(CarlaPlugin::getNativePluginCount());

  634. }

  635. 

  636. const CarlaNativePluginInfo* carla_get_internal_plugin_info(uint index)

  637. {

  638.     carla_debug("carla_get_internal_plugin_info(%i)", index);

  639. 

  640.     static CarlaNativePluginInfo info;

  641. 

  642.     const NativePluginDescriptor* const nativePlugin(CarlaPlugin::getNativePluginDescriptor(index));

  643. 

  644.     // as internal plugin, this must never fail

  645.     CARLA_SAFE_ASSERT_RETURN(nativePlugin != nullptr, nullptr);

  646. 

  647.      info.category = static_cast<CB::PluginCategory>(nativePlugin->category);

  648.      info.hints    = 0x0;

  649. 

  650.      if (nativePlugin->hints & ::PLUGIN_IS_RTSAFE)

  651.          info.hints |= CB::PLUGIN_IS_RTSAFE;

  652.      if (nativePlugin->hints & ::PLUGIN_IS_SYNTH)

  653.          info.hints |= CB::PLUGIN_IS_SYNTH;

  654.      if (nativePlugin->hints & ::PLUGIN_HAS_UI)

  655.          info.hints |= CB::PLUGIN_HAS_CUSTOM_UI;

  656.      if (nativePlugin->hints & ::PLUGIN_NEEDS_FIXED_BUFFERS)

  657.          info.hints |= CB::PLUGIN_NEEDS_FIXED_BUFFERS;

  658.      if (nativePlugin->hints & ::PLUGIN_NEEDS_SINGLE_THREAD)

  659.          info.hints |= CB::PLUGIN_NEEDS_SINGLE_THREAD;

  660. 

  661.      info.audioIns  = nativePlugin->audioIns;

  662.      info.audioOuts = nativePlugin->audioOuts;

  663.      info.midiIns   = nativePlugin->midiIns;

  664.      info.midiOuts  = nativePlugin->midiOuts;

  665.      info.parameterIns  = nativePlugin->paramIns;

  666.      info.parameterOuts = nativePlugin->paramOuts;

  667. 

  668.      info.name      = nativePlugin->name;

  669.      info.label     = nativePlugin->label;

  670.      info.maker     = nativePlugin->maker;

  671.      info.copyright = nativePlugin->copyright;

  672. 

  673.      checkStringPtr(info.name);

  674.      checkStringPtr(info.label);

  675.      checkStringPtr(info.maker);

  676.      checkStringPtr(info.copyright);

  677. 

  678.     return &info;

  679. }

  680. #endif

  681. 

  682. // -------------------------------------------------------------------------------------------------------------------

  683. 

  684. const CarlaEngine* carla_get_engine()

  685. {

  686.     carla_debug("carla_get_engine()");

  687. 

  688.     return gStandalone.engine;

  689. }

  690. 

  691. // -------------------------------------------------------------------------------------------------------------------

  692. 

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

  694. {

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

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

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

  698. 

  699.     if (gStandalone.engine != nullptr)

  700.     {

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

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

  703.         return false;

  704.     }

  705. 

  706. #ifdef CARLA_OS_WIN

  707.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  708. #endif

  709. 

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

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

  712.     {

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

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

  715.     }

  716. 

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

  718. 

  719.     if (gStandalone.engine == nullptr)

  720.     {

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

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

  723.         return false;

  724.     }

  725. 

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

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

  728. 

  729. #ifdef BUILD_BRIDGE

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

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

  732. #else

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

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

  735. #endif

  736. 

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

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

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

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

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

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

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

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

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

  746. 

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

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

  749. 

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

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

  752. 

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

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

  755. 

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

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

  758. 

  759.     if (gStandalone.engineOptions.pathVST != nullptr)

  760.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH,    CB::PLUGIN_VST, gStandalone.engineOptions.pathVST);

  761. 

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

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

  764. 

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

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

  767. 

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

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

  770. 

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

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

  773. 

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

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

  776. 

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

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

  779. 

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

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

  782. 

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

  784. 

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

  786.     {

  787.         char strBuf[STR_MAX+1];

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

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

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

  791.     }

  792.     else

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

  794. 

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

  796.     {

  797. #ifndef BUILD_BRIDGE

  798.         juce::initialiseJuce_GUI();

  799. #endif

  800.         gStandalone.lastError = "No error";

  801.         return true;

  802.     }

  803.     else

  804.     {

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

  806.         delete gStandalone.engine;

  807.         gStandalone.engine = nullptr;

  808.         return false;

  809.     }

  810. }

  811. 

  812. #ifdef BUILD_BRIDGE

  813. bool carla_engine_init_bridge(const char audioBaseName[6+1], const char rtBaseName[6+1], const char nonRtBaseName[6+1], const char* clientName)

  814. {

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

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

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

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

  819.     carla_debug("carla_engine_init_bridge(\"%s\", \"%s\", \"%s\", \"%s\")", audioBaseName, rtBaseName, nonRtBaseName, clientName);

  820. 

  821.     if (gStandalone.engine != nullptr)

  822.     {

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

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

  825.         return false;

  826.     }

  827. 

  828.     gStandalone.engine = CarlaEngine::newBridge(audioBaseName, rtBaseName, nonRtBaseName);

  829. 

  830.     if (gStandalone.engine == nullptr)

  831.     {

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

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

  834.         return false;

  835.     }

  836. 

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

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

  839. 

  840.     // forced options for bridge mode

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

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

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

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

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

  846. 

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

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

  849. 

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

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

  852. 

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

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

  855. 

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

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

  858. 

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

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

  861. 

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

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

  864. 

  865.     if (const char* const pathVST = std::getenv("ENGINE_OPTION_PLUGIN_PATH_VST"))

  866.         gStandalone.engine->setOption(CB::ENGINE_OPTION_PLUGIN_PATH, CB::PLUGIN_VST, pathVST);

  867. 

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

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

  870. 

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

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

  873. 

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

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

  876. 

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

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

  879. 

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

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

  882. 

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

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

  885. 

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

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

  888. 

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

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

  891. 

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

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

  894. 

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

  896.     {

  897.         gStandalone.lastError = "No error";

  898.         return true;

  899.     }

  900.     else

  901.     {

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

  903.         delete gStandalone.engine;

  904.         gStandalone.engine = nullptr;

  905.         return false;

  906.     }

  907. }

  908. #endif

  909. 

  910. bool carla_engine_close()

  911. {

  912.     carla_debug("carla_engine_close()");

  913. 

  914.     if (gStandalone.engine == nullptr)

  915.     {

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

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

  918.         return false;

  919.     }

  920. 

  921.     gStandalone.engine->setAboutToClose();

  922.     gStandalone.engine->removeAllPlugins();

  923. 

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

  925. 

  926.     if (! closed)

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

  928. 

  929. #ifndef BUILD_BRIDGE

  930.     juce::shutdownJuce_GUI();

  931. #endif

  932.     delete gStandalone.engine;

  933.     gStandalone.engine = nullptr;

  934. 

  935.     return closed;

  936. }

  937. 

  938. void carla_engine_idle()

  939. {

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

  941. 

  942.     gNSM.idle();

  943.     gStandalone.engine->idle();

  944. }

  945. 

  946. bool carla_is_engine_running()

  947. {

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

  949. }

  950. 

  951. void carla_set_engine_about_to_close()

  952. {

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

  954.     carla_debug("carla_set_engine_about_to_close()");

  955. 

  956.     gStandalone.engine->setAboutToClose();

  957. }

  958. 

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

  960. {

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

  962. 

  963.     gStandalone.engineCallback    = func;

  964.     gStandalone.engineCallbackPtr = ptr;

  965. 

  966.     if (gStandalone.engine != nullptr)

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

  968. 

  969. //#ifdef WANT_LOGS

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

  971. //#endif

  972. }

  973. 

  974. #ifndef BUILD_BRIDGE

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

  976. {

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

  978. 

  979.     switch (option)

  980.     {

  981.     case CB::ENGINE_OPTION_DEBUG:

  982.         break;

  983. 

  984.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  987.         break;

  988. 

  989.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  992.         break;

  993. 

  994.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  997.         break;

  998. 

  999.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  1002.         break;

  1003. 

  1004.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  1007.         break;

  1008. 

  1009.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  1012.         break;

  1013. 

  1014.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  1015.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1017.         break;

  1018. 

  1019.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  1020.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1022.         break;

  1023. 

  1024.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  1027.         break;

  1028. 

  1029.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  1030.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  1032.         break;

  1033. 

  1034.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  1035.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  1037.         break;

  1038. 

  1039.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  1040.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1041. 

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

  1043.             delete[] gStandalone.engineOptions.audioDevice;

  1044. 

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

  1046.         break;

  1047. 

  1048.     case CB:: ENGINE_OPTION_NSM_INIT:

  1049.         CARLA_SAFE_ASSERT_RETURN(value != 0,);

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

  1051.         gNSM.announce(value, valueStr);

  1052.         break;

  1053. 

  1054.     case CB::ENGINE_OPTION_PLUGIN_PATH:

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

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

  1057.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1058. 

  1059.         switch (value)

  1060.         {

  1061.         case CB::PLUGIN_LADSPA:

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

  1063.                 delete[] gStandalone.engineOptions.pathLADSPA;

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

  1065.             break;

  1066.         case CB::PLUGIN_DSSI:

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

  1068.                 delete[] gStandalone.engineOptions.pathDSSI;

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

  1070.             break;

  1071.         case CB::PLUGIN_LV2:

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

  1073.                 delete[] gStandalone.engineOptions.pathLV2;

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

  1075.             break;

  1076.         case CB::PLUGIN_VST:

  1077.             if (gStandalone.engineOptions.pathVST != nullptr)

  1078.                 delete[] gStandalone.engineOptions.pathVST;

  1079.             gStandalone.engineOptions.pathVST = carla_strdup_safe(valueStr);

  1080.             break;

  1081.         case CB::PLUGIN_VST3:

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

  1083.                 delete[] gStandalone.engineOptions.pathVST3;

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

  1085.             break;

  1086.         case CB::PLUGIN_AU:

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

  1088.                 delete[] gStandalone.engineOptions.pathAU;

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

  1090.             break;

  1091.         case CB::PLUGIN_GIG:

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

  1093.                 delete[] gStandalone.engineOptions.pathGIG;

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

  1095.             break;

  1096.         case CB::PLUGIN_SF2:

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

  1098.                 delete[] gStandalone.engineOptions.pathSF2;

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

  1100.             break;

  1101.         case CB::PLUGIN_SFZ:

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

  1103.                 delete[] gStandalone.engineOptions.pathSFZ;

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

  1105.             break;

  1106.         }

  1107.         break;

  1108. 

  1109.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  1111. 

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

  1113.             delete[] gStandalone.engineOptions.binaryDir;

  1114. 

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

  1116.         break;

  1117. 

  1118.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  1120. 

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

  1122.             delete[] gStandalone.engineOptions.resourceDir;

  1123. 

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

  1125.         break;

  1126. 

  1127.     case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

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

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

  1130.         break;

  1131. 

  1132.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  1135.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  1137.         break;

  1138.     }

  1139. 

  1140.     if (gStandalone.engine != nullptr)

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

  1142. }

  1143. #endif

  1144. 

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

  1146. {

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

  1148. 

  1149.     gStandalone.fileCallback    = func;

  1150.     gStandalone.fileCallbackPtr = ptr;

  1151. 

  1152.     if (gStandalone.engine != nullptr)

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

  1154. }

  1155. 

  1156. // -------------------------------------------------------------------------------------------------------------------

  1157. 

  1158. bool carla_load_file(const char* filename)

  1159. {

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

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

  1162. 

  1163.     if (gStandalone.engine != nullptr)

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

  1165. 

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

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

  1168.     return false;

  1169. }

  1170. 

  1171. bool carla_load_project(const char* filename)

  1172. {

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

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

  1175. 

  1176.     if (gStandalone.engine != nullptr)

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

  1178. 

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

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

  1181.     return false;

  1182. }

  1183. 

  1184. bool carla_save_project(const char* filename)

  1185. {

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

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

  1188. 

  1189.     if (gStandalone.engine != nullptr)

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

  1191. 

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

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

  1194.     return false;

  1195. }

  1196. 

  1197. #ifndef BUILD_BRIDGE

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

  1199. 

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

  1201. {

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

  1203. 

  1204.     if (gStandalone.engine != nullptr)

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

  1206. 

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

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

  1209.     return false;

  1210. }

  1211. 

  1212. bool carla_patchbay_disconnect(uint connectionId)

  1213. {

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

  1215. 

  1216.     if (gStandalone.engine != nullptr)

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

  1218. 

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

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

  1221.     return false;

  1222. }

  1223. 

  1224. bool carla_patchbay_refresh(bool external)

  1225. {

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

  1227. 

  1228.     if (gStandalone.engine != nullptr)

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

  1230. 

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

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

  1233.     return false;

  1234. }

  1235. 

  1236. // -------------------------------------------------------------------------------------------------------------------

  1237. 

  1238. void carla_transport_play()

  1239. {

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

  1241.     carla_debug("carla_transport_play()");

  1242. 

  1243.     gStandalone.engine->transportPlay();

  1244. }

  1245. 

  1246. void carla_transport_pause()

  1247. {

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

  1249.     carla_debug("carla_transport_pause()");

  1250. 

  1251.     gStandalone.engine->transportPause();

  1252. }

  1253. 

  1254. void carla_transport_relocate(uint64_t frame)

  1255. {

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

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

  1258. 

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

  1260. }

  1261. 

  1262. uint64_t carla_get_current_transport_frame()

  1263. {

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

  1265. 

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

  1267.     return timeInfo.frame;

  1268. }

  1269. 

  1270. const CarlaTransportInfo* carla_get_transport_info()

  1271. {

  1272.     static CarlaTransportInfo retInfo;

  1273. 

  1274.     // reset

  1275.     retInfo.playing = false;

  1276.     retInfo.frame   = 0;

  1277.     retInfo.bar     = 0;

  1278.     retInfo.beat    = 0;

  1279.     retInfo.tick    = 0;

  1280.     retInfo.bpm     = 0.0;

  1281. 

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

  1283. 

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

  1285. 

  1286.     retInfo.playing = timeInfo.playing;

  1287.     retInfo.frame   = timeInfo.frame;

  1288. 

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

  1290.     {

  1291.         retInfo.bar  = timeInfo.bbt.bar;

  1292.         retInfo.beat = timeInfo.bbt.beat;

  1293.         retInfo.tick = timeInfo.bbt.tick;

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

  1295.     }

  1296. 

  1297.     return &retInfo;

  1298. }

  1299. #endif

  1300. 

  1301. // -------------------------------------------------------------------------------------------------------------------

  1302. 

  1303. uint32_t carla_get_current_plugin_count()

  1304. {

  1305.     if (gStandalone.engine != nullptr)

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

  1307. 

  1308.     return 0;

  1309. }

  1310. 

  1311. uint32_t carla_get_max_plugin_number()

  1312. {

  1313.     if (gStandalone.engine != nullptr)

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

  1315. 

  1316.     return 0;

  1317. }

  1318. 

  1319. // -------------------------------------------------------------------------------------------------------------------

  1320. 

  1321. bool carla_add_plugin(BinaryType btype, PluginType ptype, const char* filename, const char* name, const char* label, int64_t uniqueId, const void* extraPtr)

  1322. {

  1323.     CARLA_SAFE_ASSERT_RETURN(label != nullptr /*&& label[0] != '\0'*/, false);

  1324.     carla_debug("carla_add_plugin(%i:%s, %i:%s, \"%s\", \"%s\", \"%s\", " P_INT64 ", %p)", btype, CB::BinaryType2Str(btype), ptype, CB::PluginType2Str(ptype), filename, name, label, uniqueId, extraPtr);

  1325. 

  1326.     if (gStandalone.engine != nullptr)

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

  1328. 

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

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

  1331.     return false;

  1332. }

  1333. 

  1334. bool carla_remove_plugin(uint pluginId)

  1335. {

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

  1337. 

  1338.     if (gStandalone.engine != nullptr)

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

  1340. 

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

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

  1343.     return false;

  1344. }

  1345. 

  1346. bool carla_remove_all_plugins()

  1347. {

  1348.     carla_debug("carla_remove_all_plugins()");

  1349. 

  1350.     if (gStandalone.engine != nullptr)

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

  1352. 

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

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

  1355.     return false;

  1356. }

  1357. 

  1358. #ifndef BUILD_BRIDGE

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

  1360. {

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

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

  1363. 

  1364.     if (gStandalone.engine != nullptr)

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

  1366. 

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

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

  1369.     return nullptr;

  1370. }

  1371. 

  1372. bool carla_clone_plugin(uint pluginId)

  1373. {

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

  1375. 

  1376.     if (gStandalone.engine != nullptr)

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

  1378. 

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

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

  1381.     return false;

  1382. }

  1383. 

  1384. bool carla_replace_plugin(uint pluginId)

  1385. {

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

  1387. 

  1388.     if (gStandalone.engine != nullptr)

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

  1390. 

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

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

  1393.     return false;

  1394. }

  1395. 

  1396. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1397. {

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

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

  1400. 

  1401.     if (gStandalone.engine != nullptr)

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

  1403. 

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

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

  1406.     return false;

  1407. }

  1408. #endif

  1409. 

  1410. // -------------------------------------------------------------------------------------------------------------------

  1411. 

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

  1413. {

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

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

  1416. 

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

  1418.     {

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

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

  1421.         return false;

  1422.     }

  1423. 

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

  1425.         return plugin->loadStateFromFile(filename);

  1426. 

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

  1428.     return false;

  1429. }

  1430. 

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

  1432. {

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

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

  1435. 

  1436.     if (gStandalone.engine == nullptr)

  1437.     {

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

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

  1440.         return false;

  1441.     }

  1442. 

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

  1444. 

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

  1446.         return plugin->saveStateToFile(filename);

  1447. 

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

  1449.     return false;

  1450. }

  1451. 

  1452. // -------------------------------------------------------------------------------------------------------------------

  1453. 

  1454. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1455. {

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

  1457. 

  1458.     static CarlaPluginInfo info;

  1459. 

  1460.     // reset

  1461.     info.type             = CB::PLUGIN_NONE;

  1462.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1463.     info.hints            = 0x0;

  1464.     info.optionsAvailable = 0x0;

  1465.     info.optionsEnabled   = 0x0;

  1466.     info.filename         = gNullCharPtr;

  1467.     info.name             = gNullCharPtr;

  1468.     info.iconName         = gNullCharPtr;

  1469.     info.uniqueId         = 0;

  1470. 

  1471.     // cleanup

  1472.     if (info.label != gNullCharPtr)

  1473.     {

  1474.         delete[] info.label;

  1475.         info.label = gNullCharPtr;

  1476.     }

  1477. 

  1478.     if (info.maker != gNullCharPtr)

  1479.     {

  1480.         delete[] info.maker;

  1481.         info.maker = gNullCharPtr;

  1482.     }

  1483. 

  1484.     if (info.copyright != gNullCharPtr)

  1485.     {

  1486.         delete[] info.copyright;

  1487.         info.copyright = gNullCharPtr;

  1488.     }

  1489. 

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

  1491. 

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

  1493.     {

  1494.         char strBufLabel[STR_MAX+1];

  1495.         char strBufMaker[STR_MAX+1];

  1496.         char strBufCopyright[STR_MAX+1];

  1497. 

  1498.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1499.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1500.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1501. 

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

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

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

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

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

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

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

  1509. 

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

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

  1512. 

  1513.         plugin->getLabel(strBufLabel);

  1514.         info.label = carla_strdup_safe(strBufLabel);

  1515. 

  1516.         plugin->getMaker(strBufMaker);

  1517.         info.maker = carla_strdup_safe(strBufMaker);

  1518. 

  1519.         plugin->getCopyright(strBufCopyright);

  1520.         info.copyright = carla_strdup_safe(strBufCopyright);

  1521. 

  1522.         checkStringPtr(info.filename);

  1523.         checkStringPtr(info.name);

  1524.         checkStringPtr(info.iconName);

  1525.         checkStringPtr(info.label);

  1526.         checkStringPtr(info.maker);

  1527.         checkStringPtr(info.copyright);

  1528. 

  1529.         return &info;

  1530.     }

  1531. 

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

  1533.     return &info;

  1534. }

  1535. 

  1536. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1537. {

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

  1539. 

  1540.     static CarlaPortCountInfo info;

  1541. 

  1542.     // reset

  1543.     info.ins   = 0;

  1544.     info.outs  = 0;

  1545. 

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

  1547. 

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

  1549.     {

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

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

  1552.         return &info;

  1553.     }

  1554. 

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

  1556.     return &info;

  1557. }

  1558. 

  1559. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1560. {

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

  1562. 

  1563.     static CarlaPortCountInfo info;

  1564. 

  1565.     // reset

  1566.     info.ins   = 0;

  1567.     info.outs  = 0;

  1568. 

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

  1570. 

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

  1572.     {

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

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

  1575.         return &info;

  1576.     }

  1577. 

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

  1579.     return &info;

  1580. }

  1581. 

  1582. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1583. {

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

  1585. 

  1586.     static CarlaPortCountInfo info;

  1587. 

  1588.     // reset

  1589.     info.ins   = 0;

  1590.     info.outs  = 0;

  1591. 

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

  1593. 

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

  1595.     {

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

  1597.         return &info;

  1598.     }

  1599. 

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

  1601.     return &info;

  1602. }

  1603. 

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

  1605. {

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

  1607. 

  1608.     static CarlaParameterInfo info;

  1609. 

  1610.     // reset

  1611.     info.scalePointCount = 0;

  1612. 

  1613.     // cleanup

  1614.     if (info.name != gNullCharPtr)

  1615.     {

  1616.         delete[] info.name;

  1617.         info.name = gNullCharPtr;

  1618.     }

  1619. 

  1620.     if (info.symbol != gNullCharPtr)

  1621.     {

  1622.         delete[] info.symbol;

  1623.         info.symbol = gNullCharPtr;

  1624.     }

  1625. 

  1626.     if (info.unit != gNullCharPtr)

  1627.     {

  1628.         delete[] info.unit;

  1629.         info.unit = gNullCharPtr;

  1630.     }

  1631. 

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

  1633. 

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

  1635.     {

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

  1637.         {

  1638.             char strBufName[STR_MAX+1];

  1639.             char strBufSymbol[STR_MAX+1];

  1640.             char strBufUnit[STR_MAX+1];

  1641. 

  1642.             carla_zeroChar(strBufName, STR_MAX+1);

  1643.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1644.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1645. 

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

  1647. 

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

  1649.             info.name = carla_strdup_safe(strBufName);

  1650. 

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

  1652.             info.symbol = carla_strdup_safe(strBufSymbol);

  1653. 

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

  1655.             info.unit = carla_strdup_safe(strBufUnit);

  1656. 

  1657.             checkStringPtr(info.name);

  1658.             checkStringPtr(info.symbol);

  1659.             checkStringPtr(info.unit);

  1660.         }

  1661.         else

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

  1663. 

  1664.         return &info;

  1665.     }

  1666. 

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

  1668.     return &info;

  1669. }

  1670. 

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

  1672. {

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

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

  1675. 

  1676.     static CarlaScalePointInfo info;

  1677. 

  1678.     // reset

  1679.     info.value = 0.0f;

  1680. 

  1681.     // cleanup

  1682.     if (info.label != gNullCharPtr)

  1683.     {

  1684.         delete[] info.label;

  1685.         info.label = gNullCharPtr;

  1686.     }

  1687. 

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

  1689. 

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

  1691.     {

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

  1693.         {

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

  1695.             {

  1696.                 char strBufLabel[STR_MAX+1];

  1697.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1698. 

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

  1700. 

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

  1702.                 info.label = carla_strdup_safe(strBufLabel);

  1703.                 checkStringPtr(info.label);

  1704.             }

  1705.             else

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

  1707.         }

  1708.         else

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

  1710. 

  1711.         return &info;

  1712.     }

  1713. 

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

  1715.     return &info;

  1716. }

  1717. 

  1718. // -------------------------------------------------------------------------------------------------------------------

  1719. 

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

  1721. {

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

  1723. 

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

  1725. 

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

  1727. 

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

  1729.     {

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

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

  1732. 

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

  1734.         return &fallbackParameterData;

  1735.     }

  1736. 

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

  1738.     return &fallbackParameterData;

  1739. }

  1740. 

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

  1742. {

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

  1744. 

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

  1746. 

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

  1748. 

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

  1750.     {

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

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

  1753. 

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

  1755.         return &fallbackParamRanges;

  1756.     }

  1757. 

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

  1759.     return &fallbackParamRanges;

  1760. }

  1761. 

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

  1763. {

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

  1765. 

  1766.     static MidiProgramData midiProgData;

  1767. 

  1768.     // reset

  1769.     midiProgData.bank    = 0;

  1770.     midiProgData.program = 0;

  1771.     midiProgData.name    = gNullCharPtr;

  1772. 

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

  1774. 

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

  1776.     {

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

  1778.         {

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

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

  1781.             checkStringPtr(midiProgData.name);

  1782.             return &midiProgData;

  1783.         }

  1784. 

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

  1786.         return &midiProgData;

  1787.     }

  1788. 

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

  1790.     return &midiProgData;

  1791. }

  1792. 

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

  1794. {

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

  1796. 

  1797.     static CustomData customData;

  1798. 

  1799.     // reset

  1800.     customData.type  = gNullCharPtr;

  1801.     customData.key   = gNullCharPtr;

  1802.     customData.value = gNullCharPtr;

  1803. 

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

  1805. 

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

  1807.     {

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

  1809.         {

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

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

  1812.             checkStringPtr(customData.type);

  1813.             checkStringPtr(customData.key);

  1814.             checkStringPtr(customData.value);

  1815.             return &customData;

  1816.         }

  1817. 

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

  1819.         return &customData;

  1820.     }

  1821. 

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

  1823.     return &customData;

  1824. }

  1825. 

  1826. const char* carla_get_chunk_data(uint pluginId)

  1827. {

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

  1829. 

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

  1831. 

  1832.     static CarlaString chunkData;

  1833. 

  1834.     // cleanup

  1835.     chunkData.clear();

  1836. 

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

  1838.     {

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

  1840.         {

  1841.             void* data = nullptr;

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

  1843. 

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

  1845.             {

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

  1847.                 return chunkData;

  1848.             }

  1849.             else

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

  1851.         }

  1852.         else

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

  1854. 

  1855.         return nullptr;

  1856.     }

  1857. 

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

  1859.     return nullptr;

  1860. }

  1861. 

  1862. // -------------------------------------------------------------------------------------------------------------------

  1863. 

  1864. uint32_t carla_get_parameter_count(uint pluginId)

  1865. {

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

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

  1868. 

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

  1870.         return plugin->getParameterCount();

  1871. 

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

  1873.     return 0;

  1874. }

  1875. 

  1876. uint32_t carla_get_program_count(uint pluginId)

  1877. {

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

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

  1880. 

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

  1882.         return plugin->getProgramCount();

  1883. 

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

  1885.     return 0;

  1886. }

  1887. 

  1888. uint32_t carla_get_midi_program_count(uint pluginId)

  1889. {

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

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

  1892. 

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

  1894.         return plugin->getMidiProgramCount();

  1895. 

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

  1897.     return 0;

  1898. }

  1899. 

  1900. uint32_t carla_get_custom_data_count(uint pluginId)

  1901. {

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

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

  1904. 

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

  1906.         return plugin->getCustomDataCount();

  1907. 

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

  1909.     return 0;

  1910. }

  1911. 

  1912. // -------------------------------------------------------------------------------------------------------------------

  1913. 

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

  1915. {

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

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

  1918. 

  1919.     static char textBuf[STR_MAX+1];

  1920. 

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

  1922.     {

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

  1924.         {

  1925.             carla_zeroChar(textBuf, STR_MAX+1);

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

  1927.             return textBuf;

  1928.         }

  1929. 

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

  1931.         return nullptr;

  1932.     }

  1933. 

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

  1935.     return nullptr;

  1936. }

  1937. 

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

  1939. {

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

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

  1942. 

  1943.     static char programName[STR_MAX+1];

  1944. 

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

  1946.     {

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

  1948.         {

  1949.             carla_zeroChar(programName, STR_MAX+1);

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

  1951.             return programName;

  1952.         }

  1953. 

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

  1955.         return nullptr;

  1956.     }

  1957. 

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

  1959.     return nullptr;

  1960. }

  1961. 

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

  1963. {

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

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

  1966. 

  1967.     static char midiProgramName[STR_MAX+1];

  1968. 

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

  1970.     {

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

  1972.         {

  1973.             carla_zeroChar(midiProgramName, STR_MAX+1);

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

  1975.             return midiProgramName;

  1976.         }

  1977. 

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

  1979.         return nullptr;

  1980.     }

  1981. 

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

  1983.     return nullptr;

  1984. }

  1985. 

  1986. const char* carla_get_real_plugin_name(uint pluginId)

  1987. {

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

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

  1990. 

  1991.     static char realPluginName[STR_MAX+1];

  1992. 

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

  1994.     {

  1995.         carla_zeroChar(realPluginName, STR_MAX+1);

  1996.         plugin->getRealName(realPluginName);

  1997.         return realPluginName;

  1998.     }

  1999. 

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

  2001.     return nullptr;

  2002. }

  2003. 

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

  2005. 

  2006. int32_t carla_get_current_program_index(uint pluginId)

  2007. {

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

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

  2010. 

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

  2012.         return plugin->getCurrentProgram();

  2013. 

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

  2015.     return -1;

  2016. }

  2017. 

  2018. int32_t carla_get_current_midi_program_index(uint pluginId)

  2019. {

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

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

  2022. 

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

  2024.         return plugin->getCurrentMidiProgram();

  2025. 

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

  2027.     return -1;

  2028. }

  2029. 

  2030. // -------------------------------------------------------------------------------------------------------------------

  2031. 

  2032. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  2033. {

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

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

  2036. 

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

  2038.     {

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

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

  2041. 

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

  2043.         return 0.0f;

  2044.     }

  2045. 

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

  2047.     return 0.0f;

  2048. }

  2049. 

  2050. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  2051. {

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

  2053. 

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

  2055.     {

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

  2057.             return plugin->getParameterValue(parameterId);

  2058. 

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

  2060.         return 0.0f;

  2061.     }

  2062. 

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

  2064.     return 0.0f;

  2065. }

  2066. 

  2067. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  2068. {

  2069. #ifdef BUILD_BRIDGE

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

  2071. #else

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

  2073. #endif

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

  2075. 

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

  2077.         return plugin->getInternalParameterValue(parameterId);

  2078. 

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

  2080.     return 0.0f;

  2081. }

  2082. 

  2083. // -------------------------------------------------------------------------------------------------------------------

  2084. 

  2085. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  2086. {

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

  2088. 

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

  2090. }

  2091. 

  2092. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  2093. {

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

  2095. 

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

  2097. }

  2098. 

  2099. // -------------------------------------------------------------------------------------------------------------------

  2100. 

  2101. void carla_set_active(uint pluginId, bool onOff)

  2102. {

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

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

  2105. 

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

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

  2108. 

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

  2110. }

  2111. 

  2112. #ifndef BUILD_BRIDGE

  2113. void carla_set_drywet(uint pluginId, float value)

  2114. {

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

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

  2117. 

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

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

  2120. 

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

  2122. }

  2123. 

  2124. void carla_set_volume(uint pluginId, float value)

  2125. {

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

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

  2128. 

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

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

  2131. 

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

  2133. }

  2134. 

  2135. void carla_set_balance_left(uint pluginId, float value)

  2136. {

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

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

  2139. 

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

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

  2142. 

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

  2144. }

  2145. 

  2146. void carla_set_balance_right(uint pluginId, float value)

  2147. {

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

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

  2150. 

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

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

  2153. 

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

  2155. }

  2156. 

  2157. void carla_set_panning(uint pluginId, float value)

  2158. {

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

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

  2161. 

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

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

  2164. 

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

  2166. }

  2167. 

  2168. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  2169. {

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

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

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

  2173. 

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

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

  2176. 

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

  2178. }

  2179. 

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

  2181. {

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

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

  2184. 

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

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

  2187. 

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

  2189. }

  2190. #endif

  2191. 

  2192. // -------------------------------------------------------------------------------------------------------------------

  2193. 

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

  2195. {

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

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

  2198. 

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

  2200.     {

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

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

  2203. 

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

  2205.         return;

  2206.     }

  2207. 

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

  2209. }

  2210. 

  2211. #ifndef BUILD_BRIDGE

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

  2213. {

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

  2215.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  2217. 

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

  2219.     {

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

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

  2222. 

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

  2224.         return;

  2225.     }

  2226. 

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

  2228. }

  2229. 

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

  2231. {

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

  2233.     CARLA_SAFE_ASSERT_RETURN(cc >= -1 && cc <= 0x5F,);

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

  2235. 

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

  2237.     {

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

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

  2240. 

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

  2242.         return;

  2243.     }

  2244. 

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

  2246. }

  2247. #endif

  2248. 

  2249. // -------------------------------------------------------------------------------------------------------------------

  2250. 

  2251. void carla_set_program(uint pluginId, uint32_t programId)

  2252. {

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

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

  2255. 

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

  2257.     {

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

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

  2260. 

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

  2262.         return;

  2263.     }

  2264. 

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

  2266. }

  2267. 

  2268. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2269. {

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

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

  2272. 

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

  2274.     {

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

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

  2277. 

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

  2279.         return;

  2280.     }

  2281. 

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

  2283. }

  2284. 

  2285. // -------------------------------------------------------------------------------------------------------------------

  2286. 

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

  2288. {

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

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

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

  2292.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  2294. 

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

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

  2297. 

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

  2299. }

  2300. 

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

  2302. {

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

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

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

  2306. 

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

  2308.     {

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

  2310.         {

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

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

  2313.         }

  2314. 

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

  2316.         return;

  2317.     }

  2318. 

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

  2320. }

  2321. 

  2322. // -------------------------------------------------------------------------------------------------------------------

  2323. 

  2324. void carla_prepare_for_save(uint pluginId)

  2325. {

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

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

  2328. 

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

  2330.         return plugin->prepareForSave();

  2331. 

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

  2333. }

  2334. 

  2335. void carla_reset_parameters(uint pluginId)

  2336. {

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

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

  2339. 

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

  2341.         return plugin->resetParameters();

  2342. 

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

  2344. }

  2345. 

  2346. void carla_randomize_parameters(uint pluginId)

  2347. {

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

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

  2350. 

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

  2352.         return plugin->randomizeParameters();

  2353. 

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

  2355. }

  2356. 

  2357. #ifndef BUILD_BRIDGE

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

  2359. {

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

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

  2362. 

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

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

  2365. 

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

  2367. }

  2368. #endif

  2369. 

  2370. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2371. {

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

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

  2374. 

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

  2376.         return plugin->showCustomUI(yesNo);

  2377. 

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

  2379. }

  2380. 

  2381. // -------------------------------------------------------------------------------------------------------------------

  2382. 

  2383. uint32_t carla_get_buffer_size()

  2384. {

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

  2386.     carla_debug("carla_get_buffer_size()");

  2387. 

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

  2389. }

  2390. 

  2391. double carla_get_sample_rate()

  2392. {

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

  2394.     carla_debug("carla_get_sample_rate()");

  2395. 

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

  2397. }

  2398. 

  2399. // -------------------------------------------------------------------------------------------------------------------

  2400. 

  2401. const char* carla_get_last_error()

  2402. {

  2403.     carla_debug("carla_get_last_error()");

  2404. 

  2405.     if (gStandalone.engine != nullptr)

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

  2407. 

  2408.     return gStandalone.lastError;

  2409. }

  2410. 

  2411. const char* carla_get_host_osc_url_tcp()

  2412. {

  2413.     carla_debug("carla_get_host_osc_url_tcp()");

  2414. 

  2415.     if (gStandalone.engine == nullptr)

  2416.     {

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

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

  2419.         return nullptr;

  2420.     }

  2421. 

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

  2423. }

  2424. 

  2425. const char* carla_get_host_osc_url_udp()

  2426. {

  2427.     carla_debug("carla_get_host_osc_url_udp()");

  2428. 

  2429.     if (gStandalone.engine == nullptr)

  2430.     {

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

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

  2433.         return nullptr;

  2434.     }

  2435. 

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

  2437. }

  2438. 

  2439. // -------------------------------------------------------------------------------------------------------------------

  2440. 

  2441. const char* carla_get_library_filename()

  2442. {

  2443.     carla_debug("carla_get_library_filename()");

  2444. 

  2445.     static CarlaString ret;

  2446. 

  2447.     if (ret.isEmpty())

  2448.     {

  2449.         using juce::File;

  2450.         ret = File(File::getSpecialLocation(File::currentExecutableFile)).getFullPathName().toRawUTF8();

  2451.     }

  2452. 

  2453.     return ret;

  2454. }

  2455. 

  2456. const char* carla_get_library_folder()

  2457. {

  2458.     carla_debug("carla_get_library_folder()");

  2459. 

  2460.     static CarlaString ret;

  2461. 

  2462.     if (ret.isEmpty())

  2463.     {

  2464.         using juce::File;

  2465.         ret = File(File::getSpecialLocation(File::currentExecutableFile).getParentDirectory()).getFullPathName().toRawUTF8();

  2466.     }

  2467. 

  2468.     return ret;

  2469. }

  2470. 

  2471. // -------------------------------------------------------------------------------------------------------------------

  2472. 

  2473. #include "CarlaPluginUI.cpp"

  2474. #include "CarlaDssiUtils.cpp"

  2475. #include "CarlaStateUtils.cpp"

  2476. #include "CarlaJuceEvents.cpp"

  2477. 

  2478. // -------------------------------------------------------------------------------------------------------------------