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.
2295 Commits
16 Branches
14GB
Tree: 9d167aa45d
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '9d167aa45d'
${ noResults }
Carla/source/backend/CarlaStandalone.cpp

2434 lines
84KB
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::currentApplicationFile).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.             }

  176.             CARLA_SAFE_EXCEPTION_CONTINUE("NSM OSC idle")

  177.         }

  178.     }

  179. 

  180. protected:

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

  182.     {

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

  184. 

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

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

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

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

  189. 

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

  191. 

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

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

  194. 

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

  196. 

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

  198. 

  199.         return 0;

  200. 

  201. #ifndef DEBUG

  202.         // unused

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

  204. #endif

  205.     }

  206. 

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

  208.     {

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

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

  211. 

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

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

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

  215. 

  216.         if (! carla_is_engine_running())

  217.         {

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

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

  220. 

  221.             carla_engine_init("JACK", clientId);

  222.         }

  223.         else

  224.         {

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

  226. 

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

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

  229.         }

  230. 

  231.         fClientId = clientId;

  232. 

  233.         fProjectPath  = projectPath;

  234.         fProjectPath += ".carxp";

  235. 

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

  237. 

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

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

  240. 

  241. #ifndef BUILD_ANSI_TEST

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

  243. #endif

  244. 

  245. #if 0

  246.         if (fHasBroadcast)

  247.         {

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

  249. 

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

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

  252. 

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

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

  255. 

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

  257. 

  258.             std::free(url);

  259. 

  260.             carla_stdout("Broadcast sent!");

  261.         }

  262.         else

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

  264. #endif

  265. 

  266.         return 0;

  267. 

  268. #ifndef DEBUG

  269.         // unused

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

  271. #endif

  272.     }

  273. 

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

  275.     {

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

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

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

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

  280. 

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

  282. 

  283. #ifndef BUILD_ANSI_TEST

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

  285. #endif

  286. 

  287.         return 0;

  288. 

  289. #ifndef DEBUG

  290.         // unused

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

  292. #endif

  293.     }

  294. 

  295. #if 0

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

  297.     {

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

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

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

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

  302. 

  303. #ifndef BUILD_ANSI_TEST

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

  305. #endif

  306. 

  307.         return 0;

  308.     }

  309. #endif

  310. 

  311. private:

  312.     lo_server fOscServer;

  313. 

  314.     CarlaString fClientId;

  315.     CarlaString fProjectPath;

  316. 

  317.     bool fHasBroadcast;

  318.     bool fHasShowHideUI;

  319. 

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

  321. 

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

  323.     {

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

  325.     }

  326. 

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

  328.     {

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

  330.     }

  331. 

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

  333.     {

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

  335.     }

  336. 

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

  338.     {

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

  340.     }

  341. 

  342. #if 0

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

  344.     {

  345.         return handlePtr->handleShowHideGui(true);

  346.     }

  347. 

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

  349.     {

  350.         return handlePtr->handleShowHideGui(false);

  351.     }

  352. #endif

  353. 

  354.     #undef handlePtr

  355. 

  356.     CARLA_PREVENT_HEAP_ALLOCATION

  357.     CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)

  358. };

  359. 

  360. static CarlaNSM gNSM;

  361. 

  362. // -------------------------------------------------------------------------------------------------------------------

  363. // Always return a valid string ptr

  364. 

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

  366. 

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

  368. {

  369.     if (charPtr == nullptr)

  370.         charPtr = gNullCharPtr;

  371. }

  372. 

  373. // -------------------------------------------------------------------------------------------------------------------

  374. // Constructors

  375. 

  376. _CarlaPluginInfo::_CarlaPluginInfo() noexcept

  377.     : type(CB::PLUGIN_NONE),

  378.       category(CB::PLUGIN_CATEGORY_NONE),

  379.       hints(0x0),

  380.       optionsAvailable(0x0),

  381.       optionsEnabled(0x0),

  382.       filename(gNullCharPtr),

  383.       name(gNullCharPtr),

  384.       label(gNullCharPtr),

  385.       maker(gNullCharPtr),

  386.       copyright(gNullCharPtr),

  387.       iconName(gNullCharPtr),

  388.       uniqueId(0) {}

  389. 

  390. _CarlaPluginInfo::~_CarlaPluginInfo() noexcept

  391. {

  392.     if (label != gNullCharPtr)

  393.         delete[] label;

  394.     if (maker != gNullCharPtr)

  395.         delete[] maker;

  396.     if (copyright != gNullCharPtr)

  397.         delete[] copyright;

  398. }

  399. 

  400. _CarlaNativePluginInfo::_CarlaNativePluginInfo() noexcept

  401.     : category(CB::PLUGIN_CATEGORY_NONE),

  402.       hints(0x0),

  403.       audioIns(0),

  404.       audioOuts(0),

  405.       midiIns(0),

  406.       midiOuts(0),

  407.       parameterIns(0),

  408.       parameterOuts(0),

  409.       name(gNullCharPtr),

  410.       label(gNullCharPtr),

  411.       maker(gNullCharPtr),

  412.       copyright(gNullCharPtr) {}

  413. 

  414. _CarlaParameterInfo::_CarlaParameterInfo() noexcept

  415.     : name(gNullCharPtr),

  416.       symbol(gNullCharPtr),

  417.       unit(gNullCharPtr),

  418.       scalePointCount(0) {}

  419. 

  420. _CarlaParameterInfo::~_CarlaParameterInfo() noexcept

  421. {

  422.     if (name != gNullCharPtr)

  423.         delete[] name;

  424.     if (symbol != gNullCharPtr)

  425.         delete[] symbol;

  426.     if (unit != gNullCharPtr)

  427.         delete[] unit;

  428. }

  429. 

  430. _CarlaScalePointInfo::_CarlaScalePointInfo() noexcept

  431.     : value(0.0f),

  432.       label(gNullCharPtr) {}

  433. 

  434. _CarlaScalePointInfo::~_CarlaScalePointInfo() noexcept

  435. {

  436.     if (label != gNullCharPtr)

  437.         delete[] label;

  438. }

  439. 

  440. _CarlaTransportInfo::_CarlaTransportInfo() noexcept

  441.     : playing(false),

  442.       frame(0),

  443.       bar(0),

  444.       beat(0),

  445.       tick(0),

  446.       bpm(0.0) {}

  447. 

  448. // -------------------------------------------------------------------------------------------------------------------

  449. // API

  450. 

  451. const char* carla_get_complete_license_text()

  452. {

  453.     carla_debug("carla_get_complete_license_text()");

  454. 

  455.     static CarlaString retText;

  456. 

  457.     if (retText.isEmpty())

  458.     {

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

  460. 

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

  462.         text1 += "<ul>";

  463. 

  464.         // Plugin formats

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

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

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

  468. #ifdef VESTIGE_HEADER

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

  470. #else

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

  472. #endif

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

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

  475. #endif

  476. #ifdef CARLA_OS_MAC

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

  478. #endif

  479. 

  480.         // Sample kit libraries

  481. #ifdef HAVE_FLUIDSYNTH

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

  483. #endif

  484. #ifdef HAVE_LINUXSAMPLER

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

  486. #endif

  487. 

  488.         // Internal plugins

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

  490. #ifdef WANT_ZYNADDSUBFX

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

  492. # ifdef WANT_ZYNADDSUBFX_UI

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

  494. # endif

  495. #endif

  496. 

  497.         // misc libs

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

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

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

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

  502. #endif

  503. 

  504.         // end

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

  506. 

  507. #ifdef HAVE_LINUXSAMPLER

  508.         // LinuxSampler GPL exception

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

  510. #endif

  511. 

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

  513.     }

  514. 

  515.     return retText;

  516. }

  517. 

  518. const char* carla_get_juce_version()

  519. {

  520.     carla_debug("carla_get_juce_version()");

  521. 

  522.     static CarlaString retVersion;

  523. 

  524.     if (retVersion.isEmpty())

  525.     {

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

  527.             retVersion = version+6;

  528.         else

  529.             retVersion = "3.0";

  530.     }

  531. 

  532.     return retVersion;

  533. }

  534. 

  535. const char* carla_get_supported_file_extensions()

  536. {

  537.     carla_debug("carla_get_supported_file_extensions()");

  538. 

  539.     static CarlaString retText;

  540. 

  541.     if (retText.isEmpty())

  542.     {

  543.         // Base types

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

  545. 

  546.         // Sample kits

  547. #ifdef HAVE_FLUIDSYNTH

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

  549. #endif

  550. #ifdef HAVE_LINUXSAMPLER

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

  552. #endif

  553. 

  554. #ifndef BUILD_BRIDGE

  555.         // Audio files

  556.         {

  557.             using namespace juce;

  558. 

  559.             AudioFormatManager afm;

  560.             afm.registerBasicFormats();

  561. 

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

  563.             {

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

  565. 

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

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

  568.             }

  569.         }

  570. #endif

  571. 

  572.         // MIDI files

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

  574. 

  575.         // Plugin presets

  576. #ifdef WANT_ZYNADDSUBFX

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

  578. #endif

  579.     }

  580. 

  581.     return retText;

  582. }

  583. 

  584. // -------------------------------------------------------------------------------------------------------------------

  585. 

  586. uint carla_get_engine_driver_count()

  587. {

  588.     carla_debug("carla_get_engine_driver_count()");

  589. 

  590.     return CarlaEngine::getDriverCount();

  591. }

  592. 

  593. const char* carla_get_engine_driver_name(uint index)

  594. {

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

  596. 

  597.     return CarlaEngine::getDriverName(index);

  598. }

  599. 

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

  601. {

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

  603. 

  604.     return CarlaEngine::getDriverDeviceNames(index);

  605. }

  606. 

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

  608. {

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

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

  611. 

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

  613.     {

  614.         static EngineDriverDeviceInfo devInfo;

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

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

  617. 

  618.         devInfo.hints       = ret->hints;

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

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

  621.         return &devInfo;

  622.     }

  623. 

  624.     return nullptr;

  625. }

  626. 

  627. #ifndef BUILD_BRIDGE

  628. // -------------------------------------------------------------------------------------------------------------------

  629. 

  630. uint carla_get_internal_plugin_count()

  631. {

  632.     carla_debug("carla_get_internal_plugin_count()");

  633. 

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

  635. }

  636. 

  637. const CarlaNativePluginInfo* carla_get_internal_plugin_info(uint index)

  638. {

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

  640. 

  641.     static CarlaNativePluginInfo info;

  642. 

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

  644. 

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

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

  647. 

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

  649.      info.hints    = 0x0;

  650. 

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

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

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

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

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

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

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

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

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

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

  661. 

  662.      info.audioIns  = nativePlugin->audioIns;

  663.      info.audioOuts = nativePlugin->audioOuts;

  664.      info.midiIns   = nativePlugin->midiIns;

  665.      info.midiOuts  = nativePlugin->midiOuts;

  666.      info.parameterIns  = nativePlugin->paramIns;

  667.      info.parameterOuts = nativePlugin->paramOuts;

  668. 

  669.      info.name      = nativePlugin->name;

  670.      info.label     = nativePlugin->label;

  671.      info.maker     = nativePlugin->maker;

  672.      info.copyright = nativePlugin->copyright;

  673. 

  674.      checkStringPtr(info.name);

  675.      checkStringPtr(info.label);

  676.      checkStringPtr(info.maker);

  677.      checkStringPtr(info.copyright);

  678. 

  679.     return &info;

  680. }

  681. #endif

  682. 

  683. // -------------------------------------------------------------------------------------------------------------------

  684. 

  685. const CarlaEngine* carla_get_engine()

  686. {

  687.     carla_debug("carla_get_engine()");

  688. 

  689.     return gStandalone.engine;

  690. }

  691. 

  692. // -------------------------------------------------------------------------------------------------------------------

  693. 

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

  695. {

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

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

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

  699. 

  700.     if (gStandalone.engine != nullptr)

  701.     {

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

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

  704.         return false;

  705.     }

  706. 

  707. #ifdef CARLA_OS_WIN

  708.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  709. #endif

  710. 

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

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

  713.     {

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

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

  716.     }

  717. 

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

  719. 

  720.     if (gStandalone.engine == nullptr)

  721.     {

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

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

  724.         return false;

  725.     }

  726. 

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

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

  729. 

  730. #ifdef BUILD_BRIDGE

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

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

  733. #else

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

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

  736. #endif

  737. 

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

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

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

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

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

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

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

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

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

  747. 

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

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

  750. 

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

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

  753. 

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

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

  756. 

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

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

  759. 

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

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

  762. 

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

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

  765. 

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

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

  768. 

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

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

  771. 

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

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

  774. 

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

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

  777. 

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

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

  780. 

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

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

  783. 

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

  785.     {

  786.         char strBuf[STR_MAX+1];

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

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

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

  790.     }

  791.     else

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

  793. 

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

  795.     {

  796. #ifndef BUILD_BRIDGE

  797.         juce::initialiseJuce_GUI();

  798. #endif

  799.         gStandalone.lastError = "No error";

  800.         return true;

  801.     }

  802.     else

  803.     {

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

  805.         delete gStandalone.engine;

  806.         gStandalone.engine = nullptr;

  807.         return false;

  808.     }

  809. }

  810. 

  811. #ifdef BUILD_BRIDGE

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

  813. {

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

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

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

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

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

  819. 

  820.     if (gStandalone.engine != nullptr)

  821.     {

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

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

  824.         return false;

  825.     }

  826. 

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

  828. 

  829.     if (gStandalone.engine == nullptr)

  830.     {

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

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

  833.         return false;

  834.     }

  835. 

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

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

  838. 

  839.     // forced options for bridge mode

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

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

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

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

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

  845. 

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

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

  848. 

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

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

  851. 

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

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

  854. 

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

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

  857. 

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

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

  860. 

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

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

  863. 

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

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

  866. 

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

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

  869. 

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

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

  872. 

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

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

  875. 

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

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

  878. 

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

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

  881. 

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

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

  884. 

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

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

  887. 

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

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

  890. 

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

  892.     {

  893.         gStandalone.lastError = "No error";

  894.         return true;

  895.     }

  896.     else

  897.     {

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

  899.         delete gStandalone.engine;

  900.         gStandalone.engine = nullptr;

  901.         return false;

  902.     }

  903. }

  904. #endif

  905. 

  906. bool carla_engine_close()

  907. {

  908.     carla_debug("carla_engine_close()");

  909. 

  910.     if (gStandalone.engine == nullptr)

  911.     {

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

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

  914.         return false;

  915.     }

  916. 

  917.     gStandalone.engine->setAboutToClose();

  918.     gStandalone.engine->removeAllPlugins();

  919. 

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

  921. 

  922.     if (! closed)

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

  924. 

  925. #ifndef BUILD_BRIDGE

  926.     juce::shutdownJuce_GUI();

  927. #endif

  928.     delete gStandalone.engine;

  929.     gStandalone.engine = nullptr;

  930. 

  931.     return closed;

  932. }

  933. 

  934. void carla_engine_idle()

  935. {

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

  937. 

  938.     gNSM.idle();

  939.     gStandalone.engine->idle();

  940. }

  941. 

  942. bool carla_is_engine_running()

  943. {

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

  945. }

  946. 

  947. void carla_set_engine_about_to_close()

  948. {

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

  950.     carla_debug("carla_set_engine_about_to_close()");

  951. 

  952.     gStandalone.engine->setAboutToClose();

  953. }

  954. 

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

  956. {

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

  958. 

  959.     gStandalone.engineCallback    = func;

  960.     gStandalone.engineCallbackPtr = ptr;

  961. 

  962.     if (gStandalone.engine != nullptr)

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

  964. 

  965. //#ifdef WANT_LOGS

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

  967. //#endif

  968. }

  969. 

  970. #ifndef BUILD_BRIDGE

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

  972. {

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

  974. 

  975.     switch (option)

  976.     {

  977.     case CB::ENGINE_OPTION_DEBUG:

  978.         break;

  979. 

  980.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  983.         break;

  984. 

  985.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  988.         break;

  989. 

  990.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  993.         break;

  994. 

  995.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  998.         break;

  999. 

  1000.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  1003.         break;

  1004. 

  1005.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  1008.         break;

  1009. 

  1010.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  1011.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1013.         break;

  1014. 

  1015.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  1016.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1018.         break;

  1019. 

  1020.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  1023.         break;

  1024. 

  1025.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  1026.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  1028.         break;

  1029. 

  1030.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  1031.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  1033.         break;

  1034. 

  1035.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  1036.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1037. 

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

  1039.             delete[] gStandalone.engineOptions.audioDevice;

  1040. 

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

  1042.         break;

  1043. 

  1044.     case CB:: ENGINE_OPTION_NSM_INIT:

  1045.         CARLA_SAFE_ASSERT_RETURN(value != 0,);

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

  1047.         gNSM.announce(value, valueStr);

  1048.         break;

  1049. 

  1050.     case CB::ENGINE_OPTION_PLUGIN_PATH:

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

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

  1053.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1054. 

  1055.         switch (value)

  1056.         {

  1057.         case CB::PLUGIN_LADSPA:

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

  1059.                 delete[] gStandalone.engineOptions.pathLADSPA;

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

  1061.             break;

  1062.         case CB::PLUGIN_DSSI:

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

  1064.                 delete[] gStandalone.engineOptions.pathDSSI;

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

  1066.             break;

  1067.         case CB::PLUGIN_LV2:

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

  1069.                 delete[] gStandalone.engineOptions.pathLV2;

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

  1071.             break;

  1072.         case CB::PLUGIN_VST:

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

  1074.                 delete[] gStandalone.engineOptions.pathVST;

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

  1076.             break;

  1077.         case CB::PLUGIN_VST3:

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

  1079.                 delete[] gStandalone.engineOptions.pathVST3;

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

  1081.             break;

  1082.         case CB::PLUGIN_AU:

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

  1084.                 delete[] gStandalone.engineOptions.pathAU;

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

  1086.             break;

  1087.         case CB::PLUGIN_GIG:

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

  1089.                 delete[] gStandalone.engineOptions.pathGIG;

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

  1091.             break;

  1092.         case CB::PLUGIN_SF2:

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

  1094.                 delete[] gStandalone.engineOptions.pathSF2;

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

  1096.             break;

  1097.         case CB::PLUGIN_SFZ:

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

  1099.                 delete[] gStandalone.engineOptions.pathSFZ;

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

  1101.             break;

  1102.         }

  1103.         break;

  1104. 

  1105.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  1107. 

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

  1109.             delete[] gStandalone.engineOptions.binaryDir;

  1110. 

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

  1112.         break;

  1113. 

  1114.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  1116. 

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

  1118.             delete[] gStandalone.engineOptions.resourceDir;

  1119. 

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

  1121.         break;

  1122. 

  1123.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  1126.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  1128.         break;

  1129.     }

  1130. 

  1131.     if (gStandalone.engine != nullptr)

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

  1133. }

  1134. #endif

  1135. 

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

  1137. {

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

  1139. 

  1140.     gStandalone.fileCallback    = func;

  1141.     gStandalone.fileCallbackPtr = ptr;

  1142. 

  1143.     if (gStandalone.engine != nullptr)

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

  1145. }

  1146. 

  1147. // -------------------------------------------------------------------------------------------------------------------

  1148. 

  1149. bool carla_load_file(const char* filename)

  1150. {

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

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

  1153. 

  1154.     if (gStandalone.engine != nullptr)

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

  1156. 

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

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

  1159.     return false;

  1160. }

  1161. 

  1162. bool carla_load_project(const char* filename)

  1163. {

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

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

  1166. 

  1167.     if (gStandalone.engine != nullptr)

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

  1169. 

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

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

  1172.     return false;

  1173. }

  1174. 

  1175. bool carla_save_project(const char* filename)

  1176. {

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

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

  1179. 

  1180.     if (gStandalone.engine != nullptr)

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

  1182. 

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

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

  1185.     return false;

  1186. }

  1187. 

  1188. #ifndef BUILD_BRIDGE

  1189. // -------------------------------------------------------------------------------------------------------------------

  1190. 

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

  1192. {

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

  1194. 

  1195.     if (gStandalone.engine != nullptr)

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

  1197. 

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

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

  1200.     return false;

  1201. }

  1202. 

  1203. bool carla_patchbay_disconnect(uint connectionId)

  1204. {

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

  1206. 

  1207.     if (gStandalone.engine != nullptr)

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

  1209. 

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

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

  1212.     return false;

  1213. }

  1214. 

  1215. bool carla_patchbay_refresh(bool external)

  1216. {

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

  1218. 

  1219.     if (gStandalone.engine != nullptr)

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

  1221. 

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

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

  1224.     return false;

  1225. }

  1226. 

  1227. // -------------------------------------------------------------------------------------------------------------------

  1228. 

  1229. void carla_transport_play()

  1230. {

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

  1232.     carla_debug("carla_transport_play()");

  1233. 

  1234.     gStandalone.engine->transportPlay();

  1235. }

  1236. 

  1237. void carla_transport_pause()

  1238. {

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

  1240.     carla_debug("carla_transport_pause()");

  1241. 

  1242.     gStandalone.engine->transportPause();

  1243. }

  1244. 

  1245. void carla_transport_relocate(uint64_t frame)

  1246. {

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

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

  1249. 

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

  1251. }

  1252. 

  1253. uint64_t carla_get_current_transport_frame()

  1254. {

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

  1256. 

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

  1258.     return timeInfo.frame;

  1259. }

  1260. 

  1261. const CarlaTransportInfo* carla_get_transport_info()

  1262. {

  1263.     static CarlaTransportInfo retInfo;

  1264. 

  1265.     // reset

  1266.     retInfo.playing = false;

  1267.     retInfo.frame   = 0;

  1268.     retInfo.bar     = 0;

  1269.     retInfo.beat    = 0;

  1270.     retInfo.tick    = 0;

  1271.     retInfo.bpm     = 0.0;

  1272. 

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

  1274. 

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

  1276. 

  1277.     retInfo.playing = timeInfo.playing;

  1278.     retInfo.frame   = timeInfo.frame;

  1279. 

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

  1281.     {

  1282.         retInfo.bar  = timeInfo.bbt.bar;

  1283.         retInfo.beat = timeInfo.bbt.beat;

  1284.         retInfo.tick = timeInfo.bbt.tick;

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

  1286.     }

  1287. 

  1288.     return &retInfo;

  1289. }

  1290. #endif

  1291. 

  1292. // -------------------------------------------------------------------------------------------------------------------

  1293. 

  1294. uint32_t carla_get_current_plugin_count()

  1295. {

  1296.     if (gStandalone.engine != nullptr)

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

  1298. 

  1299.     return 0;

  1300. }

  1301. 

  1302. uint32_t carla_get_max_plugin_number()

  1303. {

  1304.     if (gStandalone.engine != nullptr)

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

  1306. 

  1307.     return 0;

  1308. }

  1309. 

  1310. // -------------------------------------------------------------------------------------------------------------------

  1311. 

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

  1313. {

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

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

  1316. 

  1317.     if (gStandalone.engine != nullptr)

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

  1319. 

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

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

  1322.     return false;

  1323. }

  1324. 

  1325. bool carla_remove_plugin(uint pluginId)

  1326. {

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

  1328. 

  1329.     if (gStandalone.engine != nullptr)

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

  1331. 

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

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

  1334.     return false;

  1335. }

  1336. 

  1337. bool carla_remove_all_plugins()

  1338. {

  1339.     carla_debug("carla_remove_all_plugins()");

  1340. 

  1341.     if (gStandalone.engine != nullptr)

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

  1343. 

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

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

  1346.     return false;

  1347. }

  1348. 

  1349. #ifndef BUILD_BRIDGE

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

  1351. {

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

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

  1354. 

  1355.     if (gStandalone.engine != nullptr)

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

  1357. 

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

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

  1360.     return nullptr;

  1361. }

  1362. 

  1363. bool carla_clone_plugin(uint pluginId)

  1364. {

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

  1366. 

  1367.     if (gStandalone.engine != nullptr)

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

  1369. 

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

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

  1372.     return false;

  1373. }

  1374. 

  1375. bool carla_replace_plugin(uint pluginId)

  1376. {

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

  1378. 

  1379.     if (gStandalone.engine != nullptr)

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

  1381. 

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

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

  1384.     return false;

  1385. }

  1386. 

  1387. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1388. {

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

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

  1391. 

  1392.     if (gStandalone.engine != nullptr)

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

  1394. 

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

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

  1397.     return false;

  1398. }

  1399. #endif

  1400. 

  1401. // -------------------------------------------------------------------------------------------------------------------

  1402. 

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

  1404. {

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

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

  1407. 

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

  1409.     {

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

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

  1412.         return false;

  1413.     }

  1414. 

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

  1416.         return plugin->loadStateFromFile(filename);

  1417. 

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

  1419.     return false;

  1420. }

  1421. 

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

  1423. {

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

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

  1426. 

  1427.     if (gStandalone.engine == nullptr)

  1428.     {

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

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

  1431.         return false;

  1432.     }

  1433. 

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

  1435. 

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

  1437.         return plugin->saveStateToFile(filename);

  1438. 

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

  1440.     return false;

  1441. }

  1442. 

  1443. // -------------------------------------------------------------------------------------------------------------------

  1444. 

  1445. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1446. {

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

  1448. 

  1449.     static CarlaPluginInfo info;

  1450. 

  1451.     // reset

  1452.     info.type             = CB::PLUGIN_NONE;

  1453.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1454.     info.hints            = 0x0;

  1455.     info.optionsAvailable = 0x0;

  1456.     info.optionsEnabled   = 0x0;

  1457.     info.filename         = gNullCharPtr;

  1458.     info.name             = gNullCharPtr;

  1459.     info.iconName         = gNullCharPtr;

  1460.     info.uniqueId         = 0;

  1461. 

  1462.     // cleanup

  1463.     if (info.label != gNullCharPtr)

  1464.     {

  1465.         delete[] info.label;

  1466.         info.label = gNullCharPtr;

  1467.     }

  1468. 

  1469.     if (info.maker != gNullCharPtr)

  1470.     {

  1471.         delete[] info.maker;

  1472.         info.maker = gNullCharPtr;

  1473.     }

  1474. 

  1475.     if (info.copyright != gNullCharPtr)

  1476.     {

  1477.         delete[] info.copyright;

  1478.         info.copyright = gNullCharPtr;

  1479.     }

  1480. 

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

  1482. 

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

  1484.     {

  1485.         char strBufLabel[STR_MAX+1];

  1486.         char strBufMaker[STR_MAX+1];

  1487.         char strBufCopyright[STR_MAX+1];

  1488. 

  1489.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1490.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1491.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1492. 

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

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

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

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

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

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

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

  1500. 

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

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

  1503. 

  1504.         plugin->getLabel(strBufLabel);

  1505.         info.label = carla_strdup_safe(strBufLabel);

  1506. 

  1507.         plugin->getMaker(strBufMaker);

  1508.         info.maker = carla_strdup_safe(strBufMaker);

  1509. 

  1510.         plugin->getCopyright(strBufCopyright);

  1511.         info.copyright = carla_strdup_safe(strBufCopyright);

  1512. 

  1513.         checkStringPtr(info.filename);

  1514.         checkStringPtr(info.name);

  1515.         checkStringPtr(info.iconName);

  1516.         checkStringPtr(info.label);

  1517.         checkStringPtr(info.maker);

  1518.         checkStringPtr(info.copyright);

  1519. 

  1520.         return &info;

  1521.     }

  1522. 

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

  1524.     return &info;

  1525. }

  1526. 

  1527. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1528. {

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

  1530. 

  1531.     static CarlaPortCountInfo info;

  1532. 

  1533.     // reset

  1534.     info.ins   = 0;

  1535.     info.outs  = 0;

  1536. 

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

  1538. 

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

  1540.     {

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

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

  1543.         return &info;

  1544.     }

  1545. 

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

  1547.     return &info;

  1548. }

  1549. 

  1550. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1551. {

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

  1553. 

  1554.     static CarlaPortCountInfo info;

  1555. 

  1556.     // reset

  1557.     info.ins   = 0;

  1558.     info.outs  = 0;

  1559. 

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

  1561. 

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

  1563.     {

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

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

  1566.         return &info;

  1567.     }

  1568. 

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

  1570.     return &info;

  1571. }

  1572. 

  1573. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1574. {

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

  1576. 

  1577.     static CarlaPortCountInfo info;

  1578. 

  1579.     // reset

  1580.     info.ins   = 0;

  1581.     info.outs  = 0;

  1582. 

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

  1584. 

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

  1586.     {

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

  1588.         return &info;

  1589.     }

  1590. 

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

  1592.     return &info;

  1593. }

  1594. 

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

  1596. {

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

  1598. 

  1599.     static CarlaParameterInfo info;

  1600. 

  1601.     // reset

  1602.     info.scalePointCount = 0;

  1603. 

  1604.     // cleanup

  1605.     if (info.name != gNullCharPtr)

  1606.     {

  1607.         delete[] info.name;

  1608.         info.name = gNullCharPtr;

  1609.     }

  1610. 

  1611.     if (info.symbol != gNullCharPtr)

  1612.     {

  1613.         delete[] info.symbol;

  1614.         info.symbol = gNullCharPtr;

  1615.     }

  1616. 

  1617.     if (info.unit != gNullCharPtr)

  1618.     {

  1619.         delete[] info.unit;

  1620.         info.unit = gNullCharPtr;

  1621.     }

  1622. 

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

  1624. 

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

  1626.     {

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

  1628.         {

  1629.             char strBufName[STR_MAX+1];

  1630.             char strBufSymbol[STR_MAX+1];

  1631.             char strBufUnit[STR_MAX+1];

  1632. 

  1633.             carla_zeroChar(strBufName, STR_MAX+1);

  1634.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1635.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1636. 

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

  1638. 

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

  1640.             info.name = carla_strdup_safe(strBufName);

  1641. 

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

  1643.             info.symbol = carla_strdup_safe(strBufSymbol);

  1644. 

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

  1646.             info.unit = carla_strdup_safe(strBufUnit);

  1647. 

  1648.             checkStringPtr(info.name);

  1649.             checkStringPtr(info.symbol);

  1650.             checkStringPtr(info.unit);

  1651.         }

  1652.         else

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

  1654. 

  1655.         return &info;

  1656.     }

  1657. 

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

  1659.     return &info;

  1660. }

  1661. 

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

  1663. {

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

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

  1666. 

  1667.     static CarlaScalePointInfo info;

  1668. 

  1669.     // reset

  1670.     info.value = 0.0f;

  1671. 

  1672.     // cleanup

  1673.     if (info.label != gNullCharPtr)

  1674.     {

  1675.         delete[] info.label;

  1676.         info.label = gNullCharPtr;

  1677.     }

  1678. 

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

  1680. 

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

  1682.     {

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

  1684.         {

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

  1686.             {

  1687.                 char strBufLabel[STR_MAX+1];

  1688.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1689. 

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

  1691. 

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

  1693.                 info.label = carla_strdup_safe(strBufLabel);

  1694.                 checkStringPtr(info.label);

  1695.             }

  1696.             else

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

  1698.         }

  1699.         else

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

  1701. 

  1702.         return &info;

  1703.     }

  1704. 

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

  1706.     return &info;

  1707. }

  1708. 

  1709. // -------------------------------------------------------------------------------------------------------------------

  1710. 

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

  1712. {

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

  1714. 

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

  1716. 

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

  1718. 

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

  1720.     {

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

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

  1723. 

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

  1725.         return &fallbackParameterData;

  1726.     }

  1727. 

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

  1729.     return &fallbackParameterData;

  1730. }

  1731. 

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

  1733. {

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

  1735. 

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

  1737. 

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

  1739. 

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

  1741.     {

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

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

  1744. 

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

  1746.         return &fallbackParamRanges;

  1747.     }

  1748. 

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

  1750.     return &fallbackParamRanges;

  1751. }

  1752. 

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

  1754. {

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

  1756. 

  1757.     static MidiProgramData midiProgData;

  1758. 

  1759.     // reset

  1760.     midiProgData.bank    = 0;

  1761.     midiProgData.program = 0;

  1762.     midiProgData.name    = gNullCharPtr;

  1763. 

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

  1765. 

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

  1767.     {

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

  1769.         {

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

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

  1772.             checkStringPtr(midiProgData.name);

  1773.             return &midiProgData;

  1774.         }

  1775. 

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

  1777.         return &midiProgData;

  1778.     }

  1779. 

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

  1781.     return &midiProgData;

  1782. }

  1783. 

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

  1785. {

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

  1787. 

  1788.     static CustomData customData;

  1789. 

  1790.     // reset

  1791.     customData.type  = gNullCharPtr;

  1792.     customData.key   = gNullCharPtr;

  1793.     customData.value = gNullCharPtr;

  1794. 

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

  1796. 

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

  1798.     {

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

  1800.         {

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

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

  1803.             checkStringPtr(customData.type);

  1804.             checkStringPtr(customData.key);

  1805.             checkStringPtr(customData.value);

  1806.             return &customData;

  1807.         }

  1808. 

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

  1810.         return &customData;

  1811.     }

  1812. 

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

  1814.     return &customData;

  1815. }

  1816. 

  1817. const char* carla_get_chunk_data(uint pluginId)

  1818. {

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

  1820. 

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

  1822. 

  1823.     static CarlaString chunkData;

  1824. 

  1825.     // cleanup

  1826.     chunkData.clear();

  1827. 

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

  1829.     {

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

  1831.         {

  1832.             void* data = nullptr;

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

  1834. 

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

  1836.             {

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

  1838.                 return chunkData;

  1839.             }

  1840.             else

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

  1842.         }

  1843.         else

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

  1845. 

  1846.         return nullptr;

  1847.     }

  1848. 

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

  1850.     return nullptr;

  1851. }

  1852. 

  1853. // -------------------------------------------------------------------------------------------------------------------

  1854. 

  1855. uint32_t carla_get_parameter_count(uint pluginId)

  1856. {

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

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

  1859. 

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

  1861.         return plugin->getParameterCount();

  1862. 

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

  1864.     return 0;

  1865. }

  1866. 

  1867. uint32_t carla_get_program_count(uint pluginId)

  1868. {

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

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

  1871. 

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

  1873.         return plugin->getProgramCount();

  1874. 

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

  1876.     return 0;

  1877. }

  1878. 

  1879. uint32_t carla_get_midi_program_count(uint pluginId)

  1880. {

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

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

  1883. 

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

  1885.         return plugin->getMidiProgramCount();

  1886. 

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

  1888.     return 0;

  1889. }

  1890. 

  1891. uint32_t carla_get_custom_data_count(uint pluginId)

  1892. {

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

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

  1895. 

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

  1897.         return plugin->getCustomDataCount();

  1898. 

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

  1900.     return 0;

  1901. }

  1902. 

  1903. // -------------------------------------------------------------------------------------------------------------------

  1904. 

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

  1906. {

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

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

  1909. 

  1910.     static char textBuf[STR_MAX+1];

  1911. 

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

  1913.     {

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

  1915.         {

  1916.             carla_zeroChar(textBuf, STR_MAX+1);

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

  1918.             return textBuf;

  1919.         }

  1920. 

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

  1922.         return nullptr;

  1923.     }

  1924. 

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

  1926.     return nullptr;

  1927. }

  1928. 

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

  1930. {

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

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

  1933. 

  1934.     static char programName[STR_MAX+1];

  1935. 

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

  1937.     {

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

  1939.         {

  1940.             carla_zeroChar(programName, STR_MAX+1);

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

  1942.             return programName;

  1943.         }

  1944. 

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

  1946.         return nullptr;

  1947.     }

  1948. 

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

  1950.     return nullptr;

  1951. }

  1952. 

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

  1954. {

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

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

  1957. 

  1958.     static char midiProgramName[STR_MAX+1];

  1959. 

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

  1961.     {

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

  1963.         {

  1964.             carla_zeroChar(midiProgramName, STR_MAX+1);

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

  1966.             return midiProgramName;

  1967.         }

  1968. 

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

  1970.         return nullptr;

  1971.     }

  1972. 

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

  1974.     return nullptr;

  1975. }

  1976. 

  1977. const char* carla_get_real_plugin_name(uint pluginId)

  1978. {

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

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

  1981. 

  1982.     static char realPluginName[STR_MAX+1];

  1983. 

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

  1985.     {

  1986.         carla_zeroChar(realPluginName, STR_MAX+1);

  1987.         plugin->getRealName(realPluginName);

  1988.         return realPluginName;

  1989.     }

  1990. 

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

  1992.     return nullptr;

  1993. }

  1994. 

  1995. // -------------------------------------------------------------------------------------------------------------------

  1996. 

  1997. int32_t carla_get_current_program_index(uint pluginId)

  1998. {

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

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

  2001. 

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

  2003.         return plugin->getCurrentProgram();

  2004. 

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

  2006.     return -1;

  2007. }

  2008. 

  2009. int32_t carla_get_current_midi_program_index(uint pluginId)

  2010. {

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

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

  2013. 

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

  2015.         return plugin->getCurrentMidiProgram();

  2016. 

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

  2018.     return -1;

  2019. }

  2020. 

  2021. // -------------------------------------------------------------------------------------------------------------------

  2022. 

  2023. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  2024. {

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

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

  2027. 

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

  2029.     {

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

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

  2032. 

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

  2034.         return 0.0f;

  2035.     }

  2036. 

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

  2038.     return 0.0f;

  2039. }

  2040. 

  2041. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  2042. {

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

  2044. 

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

  2046.     {

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

  2048.             return plugin->getParameterValue(parameterId);

  2049. 

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

  2051.         return 0.0f;

  2052.     }

  2053. 

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

  2055.     return 0.0f;

  2056. }

  2057. 

  2058. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  2059. {

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

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

  2062. 

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

  2064.         return plugin->getInternalParameterValue(parameterId);

  2065. 

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

  2067.     return 0.0f;

  2068. }

  2069. 

  2070. // -------------------------------------------------------------------------------------------------------------------

  2071. 

  2072. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  2073. {

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

  2075. 

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

  2077. }

  2078. 

  2079. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  2080. {

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

  2082. 

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

  2084. }

  2085. 

  2086. // -------------------------------------------------------------------------------------------------------------------

  2087. 

  2088. void carla_set_active(uint pluginId, bool onOff)

  2089. {

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

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

  2092. 

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

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

  2095. 

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

  2097. }

  2098. 

  2099. #ifndef BUILD_BRIDGE

  2100. void carla_set_drywet(uint pluginId, float value)

  2101. {

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

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

  2104. 

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

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

  2107. 

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

  2109. }

  2110. 

  2111. void carla_set_volume(uint pluginId, float value)

  2112. {

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

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

  2115. 

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

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

  2118. 

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

  2120. }

  2121. 

  2122. void carla_set_balance_left(uint pluginId, float value)

  2123. {

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

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

  2126. 

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

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

  2129. 

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

  2131. }

  2132. 

  2133. void carla_set_balance_right(uint pluginId, float value)

  2134. {

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

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

  2137. 

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

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

  2140. 

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

  2142. }

  2143. 

  2144. void carla_set_panning(uint pluginId, float value)

  2145. {

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

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

  2148. 

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

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

  2151. 

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

  2153. }

  2154. 

  2155. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  2156. {

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

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

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

  2160. 

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

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

  2163. 

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

  2165. }

  2166. 

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

  2168. {

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

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

  2171. 

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

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

  2174. 

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

  2176. }

  2177. #endif

  2178. 

  2179. // -------------------------------------------------------------------------------------------------------------------

  2180. 

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

  2182. {

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

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

  2185. 

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

  2187.     {

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

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

  2190. 

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

  2192.         return;

  2193.     }

  2194. 

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

  2196. }

  2197. 

  2198. #ifndef BUILD_BRIDGE

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

  2200. {

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

  2202.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  2204. 

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

  2206.     {

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

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

  2209. 

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

  2211.         return;

  2212.     }

  2213. 

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

  2215. }

  2216. 

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

  2218. {

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

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

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

  2222. 

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

  2224.     {

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

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

  2227. 

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

  2229.         return;

  2230.     }

  2231. 

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

  2233. }

  2234. #endif

  2235. 

  2236. // -------------------------------------------------------------------------------------------------------------------

  2237. 

  2238. void carla_set_program(uint pluginId, uint32_t programId)

  2239. {

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

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

  2242. 

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

  2244.     {

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

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

  2247. 

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

  2249.         return;

  2250.     }

  2251. 

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

  2253. }

  2254. 

  2255. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2256. {

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

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

  2259. 

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

  2261.     {

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

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

  2264. 

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

  2266.         return;

  2267.     }

  2268. 

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

  2270. }

  2271. 

  2272. // -------------------------------------------------------------------------------------------------------------------

  2273. 

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

  2275. {

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

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

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

  2279.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  2281. 

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

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

  2284. 

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

  2286. }

  2287. 

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

  2289. {

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

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

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

  2293. 

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

  2295.     {

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

  2297.         {

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

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

  2300.         }

  2301. 

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

  2303.         return;

  2304.     }

  2305. 

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

  2307. }

  2308. 

  2309. // -------------------------------------------------------------------------------------------------------------------

  2310. 

  2311. void carla_prepare_for_save(uint pluginId)

  2312. {

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

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

  2315. 

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

  2317.         return plugin->prepareForSave();

  2318. 

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

  2320. }

  2321. 

  2322. void carla_reset_parameters(uint pluginId)

  2323. {

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

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

  2326. 

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

  2328.         return plugin->resetParameters();

  2329. 

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

  2331. }

  2332. 

  2333. void carla_randomize_parameters(uint pluginId)

  2334. {

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

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

  2337. 

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

  2339.         return plugin->randomizeParameters();

  2340. 

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

  2342. }

  2343. 

  2344. #ifndef BUILD_BRIDGE

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

  2346. {

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

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

  2349. 

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

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

  2352. 

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

  2354. }

  2355. #endif

  2356. 

  2357. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2358. {

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

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

  2361. 

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

  2363.         return plugin->showCustomUI(yesNo);

  2364. 

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

  2366. }

  2367. 

  2368. // -------------------------------------------------------------------------------------------------------------------

  2369. 

  2370. uint32_t carla_get_buffer_size()

  2371. {

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

  2373.     carla_debug("carla_get_buffer_size()");

  2374. 

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

  2376. }

  2377. 

  2378. double carla_get_sample_rate()

  2379. {

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

  2381.     carla_debug("carla_get_sample_rate()");

  2382. 

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

  2384. }

  2385. 

  2386. // -------------------------------------------------------------------------------------------------------------------

  2387. 

  2388. const char* carla_get_last_error()

  2389. {

  2390.     carla_debug("carla_get_last_error()");

  2391. 

  2392.     if (gStandalone.engine != nullptr)

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

  2394. 

  2395.     return gStandalone.lastError;

  2396. }

  2397. 

  2398. const char* carla_get_host_osc_url_tcp()

  2399. {

  2400.     carla_debug("carla_get_host_osc_url_tcp()");

  2401. 

  2402.     if (gStandalone.engine == nullptr)

  2403.     {

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

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

  2406.         return nullptr;

  2407.     }

  2408. 

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

  2410. }

  2411. 

  2412. const char* carla_get_host_osc_url_udp()

  2413. {

  2414.     carla_debug("carla_get_host_osc_url_udp()");

  2415. 

  2416.     if (gStandalone.engine == nullptr)

  2417.     {

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

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

  2420.         return nullptr;

  2421.     }

  2422. 

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

  2424. }

  2425. 

  2426. // -------------------------------------------------------------------------------------------------------------------

  2427. 

  2428. #include "CarlaPluginUI.cpp"

  2429. #include "CarlaDssiUtils.cpp"

  2430. #include "CarlaStateUtils.cpp"

  2431. #include "CarlaJuceEvents.cpp"

  2432. 

  2433. // -------------------------------------------------------------------------------------------------------------------