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

2478 lines
85KB
Raw Blame History 

  1. /*

  2.  * Carla Standalone

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

  4.  *

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

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

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

  8.  * the License, or any later version.

  9.  *

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

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

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

  13.  * GNU General Public License for more details.

  14.  *

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

  16.  */

  17. 

  18. // TODO:

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

  20. 

  21. #include "CarlaHost.h"

  22. #include "CarlaMIDI.h"

  23. #include "CarlaNative.h"

  24. 

  25. #include "CarlaEngine.hpp"

  26. #include "CarlaPlugin.hpp"

  27. 

  28. #include "CarlaBackendUtils.hpp"

  29. #include "CarlaBase64Utils.hpp"

  30. #include "CarlaOscUtils.hpp"

  31. 

  32. #include "juce_audio_formats.h"

  33. 

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

  35. # include "juce_gui_basics.h"

  36. #else

  37. namespace juce {

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

  39. } // namespace juce

  40. #endif

  41. 

  42. namespace CB = CarlaBackend;

  43. using CB::EngineOptions;

  44. 

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

  46. // Single, standalone engine

  47. 

  48. struct CarlaBackendStandalone {

  49.     CarlaEngine*       engine;

  50.     EngineCallbackFunc engineCallback;

  51.     void*              engineCallbackPtr;

  52.     EngineOptions      engineOptions;

  53. 

  54.     FileCallbackFunc fileCallback;

  55.     void*            fileCallbackPtr;

  56. 

  57.     CarlaString lastError;

  58. 

  59.     CarlaBackendStandalone()

  60.         : engine(nullptr),

  61.           engineCallback(nullptr),

  62.           engineCallbackPtr(nullptr),

  63.           engineOptions(),

  64.           fileCallback(nullptr),

  65.           fileCallbackPtr(nullptr),

  66.           lastError()

  67.     {

  68. #ifdef BUILD_BRIDGE

  69.         engineOptions.processMode         = CB::ENGINE_PROCESS_MODE_BRIDGE;

  70.         engineOptions.transportMode       = CB::ENGINE_TRANSPORT_MODE_BRIDGE;

  71.         engineOptions.forceStereo         = false;

  72.         engineOptions.preferPluginBridges = false;

  73.         engineOptions.preferUiBridges     = false;

  74. 

  75.         using juce::File;

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

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

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

  79. #else

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

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

  82. #endif

  83.     }

  84. 

  85.     ~CarlaBackendStandalone()

  86.     {

  87.         CARLA_SAFE_ASSERT(engine == nullptr);

  88.     }

  89. 

  90.     CARLA_PREVENT_HEAP_ALLOCATION

  91.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  92. };

  93. 

  94. static CarlaBackendStandalone gStandalone;

  95. 

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

  97. // NSM support

  98. 

  99. #define NSM_API_VERSION_MAJOR 1

  100. #define NSM_API_VERSION_MINOR 2

  101. 

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

  103. #define NSM_CLIENT_FEATURES ":switch:"

  104. 

  105. class CarlaNSM

  106. {

  107. public:

  108.     CarlaNSM() noexcept

  109.         : fOscServer(nullptr),

  110.           fClientId(),

  111.           fProjectPath(),

  112.           fHasBroadcast(false),

  113.           fHasShowHideUI(false) {}

  114. 

  115.     ~CarlaNSM()

  116.     {

  117.         if (fOscServer != nullptr)

  118.         {

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

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

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

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

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

  124.             lo_server_free(fOscServer);

  125.             fOscServer = nullptr;

  126.         }

  127.     }

  128. 

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

  130.     {

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

  132. 

  133.         if (NSM_URL == nullptr)

  134.             return;

  135. 

  136.         const lo_address addr = lo_address_new_from_url(NSM_URL);

  137.         CARLA_SAFE_ASSERT_RETURN(addr != nullptr,);

  138. 

  139.         const int proto = lo_address_get_protocol(addr);

  140. 

  141.         if (fOscServer == nullptr)

  142.         {

  143.             // create new OSC server

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

  145. 

  146.             // register message handlers and start OSC thread

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

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

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

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

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

  152.             // /nsm/client/session_is_loaded

  153.         }

  154. 

  155. #ifndef BUILD_ANSI_TEST

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

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

  158. #endif

  159. 

  160.         lo_address_free(addr);

  161.     }

  162. 

  163.     void idle() noexcept

  164.     {

  165.         if (fOscServer == nullptr)

  166.             return;

  167. 

  168.         for (;;)

  169.         {

  170.             try {

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

  172.                     break;

  173.             } CARLA_SAFE_EXCEPTION_CONTINUE("NSM OSC idle")

  174.         }

  175.     }

  176. 

  177. protected:

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

  179.     {

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

  181. 

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

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

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

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

  186. 

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

  188. 

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

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

  191. 

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

  193. 

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

  195. 

  196.         return 0;

  197. 

  198. #ifndef DEBUG

  199.         // unused

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

  201. #endif

  202.     }

  203. 

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

  205.     {

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

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

  208. 

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

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

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

  212. 

  213.         if (! carla_is_engine_running())

  214.         {

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

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

  217. 

  218.             carla_engine_init("JACK", clientId);

  219.         }

  220.         else

  221.         {

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

  223. 

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

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

  226.         }

  227. 

  228.         fClientId = clientId;

  229. 

  230.         fProjectPath  = projectPath;

  231.         fProjectPath += ".carxp";

  232. 

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

  234. 

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

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

  237. 

  238. #ifndef BUILD_ANSI_TEST

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

  240. #endif

  241. 

  242. #if 0

  243.         if (fHasBroadcast)

  244.         {

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

  246. 

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

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

  249. 

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

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

  252. 

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

  254. 

  255.             std::free(url);

  256. 

  257.             carla_stdout("Broadcast sent!");

  258.         }

  259.         else

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

  261. #endif

  262. 

  263.         return 0;

  264. 

  265. #ifndef DEBUG

  266.         // unused

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

  268. #endif

  269.     }

  270. 

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

  272.     {

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

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

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

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

  277. 

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

  279. 

  280. #ifndef BUILD_ANSI_TEST

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

  282. #endif

  283. 

  284.         return 0;

  285. 

  286. #ifndef DEBUG

  287.         // unused

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

  289. #endif

  290.     }

  291. 

  292. #if 0

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

  294.     {

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

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

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

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

  299. 

  300. #ifndef BUILD_ANSI_TEST

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

  302. #endif

  303. 

  304.         return 0;

  305.     }

  306. #endif

  307. 

  308. private:

  309.     lo_server fOscServer;

  310. 

  311.     CarlaString fClientId;

  312.     CarlaString fProjectPath;

  313. 

  314.     bool fHasBroadcast;

  315.     bool fHasShowHideUI;

  316. 

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

  318. 

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

  320.     {

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

  322.     }

  323. 

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

  325.     {

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

  327.     }

  328. 

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

  330.     {

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

  332.     }

  333. 

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

  335.     {

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

  337.     }

  338. 

  339. #if 0

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

  341.     {

  342.         return handlePtr->handleShowHideGui(true);

  343.     }

  344. 

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

  346.     {

  347.         return handlePtr->handleShowHideGui(false);

  348.     }

  349. #endif

  350. 

  351.     #undef handlePtr

  352. 

  353.     CARLA_PREVENT_HEAP_ALLOCATION

  354.     CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)

  355. };

  356. 

  357. static CarlaNSM gNSM;

  358. 

  359. // -------------------------------------------------------------------------------------------------------------------

  360. // Always return a valid string ptr

  361. 

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

  363. 

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

  365. {

  366.     if (charPtr == nullptr)

  367.         charPtr = gNullCharPtr;

  368. }

  369. 

  370. // -------------------------------------------------------------------------------------------------------------------

  371. // Constructors

  372. 

  373. _CarlaPluginInfo::_CarlaPluginInfo() noexcept

  374.     : type(CB::PLUGIN_NONE),

  375.       category(CB::PLUGIN_CATEGORY_NONE),

  376.       hints(0x0),

  377.       optionsAvailable(0x0),

  378.       optionsEnabled(0x0),

  379.       filename(gNullCharPtr),

  380.       name(gNullCharPtr),

  381.       label(gNullCharPtr),

  382.       maker(gNullCharPtr),

  383.       copyright(gNullCharPtr),

  384.       iconName(gNullCharPtr),

  385.       uniqueId(0) {}

  386. 

  387. _CarlaPluginInfo::~_CarlaPluginInfo() noexcept

  388. {

  389.     if (label != gNullCharPtr)

  390.         delete[] label;

  391.     if (maker != gNullCharPtr)

  392.         delete[] maker;

  393.     if (copyright != gNullCharPtr)

  394.         delete[] copyright;

  395. }

  396. 

  397. _CarlaNativePluginInfo::_CarlaNativePluginInfo() noexcept

  398.     : category(CB::PLUGIN_CATEGORY_NONE),

  399.       hints(0x0),

  400.       audioIns(0),

  401.       audioOuts(0),

  402.       midiIns(0),

  403.       midiOuts(0),

  404.       parameterIns(0),

  405.       parameterOuts(0),

  406.       name(gNullCharPtr),

  407.       label(gNullCharPtr),

  408.       maker(gNullCharPtr),

  409.       copyright(gNullCharPtr) {}

  410. 

  411. _CarlaParameterInfo::_CarlaParameterInfo() noexcept

  412.     : name(gNullCharPtr),

  413.       symbol(gNullCharPtr),

  414.       unit(gNullCharPtr),

  415.       scalePointCount(0) {}

  416. 

  417. _CarlaParameterInfo::~_CarlaParameterInfo() noexcept

  418. {

  419.     if (name != gNullCharPtr)

  420.         delete[] name;

  421.     if (symbol != gNullCharPtr)

  422.         delete[] symbol;

  423.     if (unit != gNullCharPtr)

  424.         delete[] unit;

  425. }

  426. 

  427. _CarlaScalePointInfo::_CarlaScalePointInfo() noexcept

  428.     : value(0.0f),

  429.       label(gNullCharPtr) {}

  430. 

  431. _CarlaScalePointInfo::~_CarlaScalePointInfo() noexcept

  432. {

  433.     if (label != gNullCharPtr)

  434.         delete[] label;

  435. }

  436. 

  437. _CarlaTransportInfo::_CarlaTransportInfo() noexcept

  438.     : playing(false),

  439.       frame(0),

  440.       bar(0),

  441.       beat(0),

  442.       tick(0),

  443.       bpm(0.0) {}

  444. 

  445. // -------------------------------------------------------------------------------------------------------------------

  446. // API

  447. 

  448. const char* carla_get_complete_license_text()

  449. {

  450.     carla_debug("carla_get_complete_license_text()");

  451. 

  452.     static CarlaString retText;

  453. 

  454.     if (retText.isEmpty())

  455.     {

  456.         retText =

  457.         "<p>This current Carla build is using the following features and 3rd-party code:</p>"

  458.         "<ul>"

  459. 

  460.         // Plugin formats

  461.         "<li>LADSPA plugin support - http://www.ladspa.org/</li>"

  462.         "<li>DSSI plugin support - http://dssi.sourceforge.net/</li>"

  463.         "<li>LV2 plugin support - http://lv2plug.in/</li>"

  464. #ifdef VESTIGE_HEADER

  465.         "<li>VST plugin support using VeSTige header by Javier Serrano Polo</li>"

  466. #else

  467.         "<li>VST plugin support using official VST SDK 2.4 (trademark of Steinberg Media Technologies GmbH)</li>"

  468. #endif

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

  470.         "<li>VST3 plugin support using official VST SDK 3.6 (trademark of Steinberg Media Technologies GmbH)</li>"

  471. #endif

  472. #ifdef CARLA_OS_MAC

  473.         "<li>AU plugin support</li>"

  474. #endif

  475. 

  476.         // Sample kit libraries

  477. #ifdef HAVE_FLUIDSYNTH

  478.         "<li>FluidSynth library for SF2 support - http://www.fluidsynth.org/</li>"

  479. #endif

  480. #ifdef HAVE_LINUXSAMPLER

  481.         "<li>LinuxSampler library for GIG and SFZ support* - http://www.linuxsampler.org/</li>"

  482. #endif

  483. 

  484.         // Internal plugins

  485.         "<li>NekoFilter plugin code based on lv2fil by Nedko Arnaudov and Fons Adriaensen</li>"

  486. #ifdef WANT_ZYNADDSUBFX

  487.         "<li>ZynAddSubFX plugin code - http://zynaddsubfx.sf.net/</li>"

  488. #endif

  489. 

  490.         // misc libs

  491.         "<li>base64 utilities based on code by Ren\u00E9 Nyffenegger - http://www.adp-gmbh.ch/cpp/common/base64.html</li>"

  492.         "<li>liblo library for OSC support - http://liblo.sourceforge.net/</li>"

  493.         "<li>rtmempool library by Nedko Arnaudov"

  494.         "<li>serd, sord, sratom and lilv libraries for LV2 discovery - http://drobilla.net/software/lilv/</li>"

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

  496.         "<li>RtAudio+RtMidi libraries for extra Audio and MIDI support - http://www.music.mcgill.ca/~gary/rtaudio/</li>"

  497. #endif

  498. 

  499.         // end

  500.         "</ul>"

  501. 

  502. #ifdef HAVE_LINUXSAMPLER

  503.         // LinuxSampler GPL exception

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

  505. #endif

  506.         ;

  507.     }

  508. 

  509.     return retText;

  510. }

  511. 

  512. const char* carla_get_juce_version()

  513. {

  514.     carla_debug("carla_get_juce_version()");

  515. 

  516.     static CarlaString retVersion;

  517. 

  518.     if (retVersion.isEmpty())

  519.     {

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

  521.             retVersion = version+6;

  522.         else

  523.             retVersion = "3.0";

  524.     }

  525. 

  526.     return retVersion;

  527. }

  528. 

  529. const char* carla_get_supported_file_extensions()

  530. {

  531.     carla_debug("carla_get_supported_file_extensions()");

  532. 

  533.     static CarlaString retText;

  534. 

  535.     if (retText.isEmpty())

  536.     {

  537.         retText =

  538.         // Base types

  539.         "*.carxp;*.carxs"

  540.         // MIDI files

  541.         ";*.mid;*.midi"

  542. #ifdef HAVE_FLUIDSYNTH

  543.         // fluidsynth (sf2)

  544.         ";*.sf2"

  545. #endif

  546. #ifdef HAVE_LINUXSAMPLER

  547.         // linuxsampler (gig and sfz)

  548.         ";*.gig;*.sfz"

  549. #endif

  550. #ifdef WANT_ZYNADDSUBFX

  551.         // zynaddsubfx presets

  552.         ";*.xmz;*.xiz"

  553. #endif

  554.         ;

  555. 

  556. #ifndef BUILD_BRIDGE

  557.         // Audio files

  558.         {

  559.             using namespace juce;

  560. 

  561.             AudioFormatManager afm;

  562.             afm.registerBasicFormats();

  563. 

  564.             String juceFormats;

  565. 

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

  567.             {

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

  569. 

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

  571.                     juceFormats += String(";*" + (*eit)).toRawUTF8();

  572.             }

  573. 

  574.             retText += juceFormats.toRawUTF8();

  575.         }

  576. #endif

  577.     }

  578. 

  579.     return retText;

  580. }

  581. 

  582. // -------------------------------------------------------------------------------------------------------------------

  583. 

  584. uint carla_get_engine_driver_count()

  585. {

  586.     carla_debug("carla_get_engine_driver_count()");

  587. 

  588.     return CarlaEngine::getDriverCount();

  589. }

  590. 

  591. const char* carla_get_engine_driver_name(uint index)

  592. {

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

  594. 

  595.     return CarlaEngine::getDriverName(index);

  596. }

  597. 

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

  599. {

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

  601. 

  602.     return CarlaEngine::getDriverDeviceNames(index);

  603. }

  604. 

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

  606. {

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

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

  609. 

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

  611.     {

  612.         static EngineDriverDeviceInfo devInfo;

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

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

  615. 

  616.         devInfo.hints       = ret->hints;

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

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

  619.         return &devInfo;

  620.     }

  621. 

  622.     return nullptr;

  623. }

  624. 

  625. #ifndef BUILD_BRIDGE

  626. // -------------------------------------------------------------------------------------------------------------------

  627. 

  628. uint carla_get_internal_plugin_count()

  629. {

  630.     carla_debug("carla_get_internal_plugin_count()");

  631. 

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

  633. }

  634. 

  635. const CarlaNativePluginInfo* carla_get_internal_plugin_info(uint index)

  636. {

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

  638. 

  639.     static CarlaNativePluginInfo info;

  640. 

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

  642. 

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

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

  645. 

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

  647.      info.hints    = 0x0;

  648. 

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

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

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

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

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

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

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

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

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

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

  659. 

  660.      info.audioIns  = nativePlugin->audioIns;

  661.      info.audioOuts = nativePlugin->audioOuts;

  662.      info.midiIns   = nativePlugin->midiIns;

  663.      info.midiOuts  = nativePlugin->midiOuts;

  664.      info.parameterIns  = nativePlugin->paramIns;

  665.      info.parameterOuts = nativePlugin->paramOuts;

  666. 

  667.      info.name      = nativePlugin->name;

  668.      info.label     = nativePlugin->label;

  669.      info.maker     = nativePlugin->maker;

  670.      info.copyright = nativePlugin->copyright;

  671. 

  672.      checkStringPtr(info.name);

  673.      checkStringPtr(info.label);

  674.      checkStringPtr(info.maker);

  675.      checkStringPtr(info.copyright);

  676. 

  677.     return &info;

  678. }

  679. #endif

  680. 

  681. // -------------------------------------------------------------------------------------------------------------------

  682. 

  683. const CarlaEngine* carla_get_engine()

  684. {

  685.     carla_debug("carla_get_engine()");

  686. 

  687.     return gStandalone.engine;

  688. }

  689. 

  690. // -------------------------------------------------------------------------------------------------------------------

  691. 

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

  693. {

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

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

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

  697. 

  698.     if (gStandalone.engine != nullptr)

  699.     {

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

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

  702.         return false;

  703.     }

  704. 

  705. #ifdef CARLA_OS_WIN

  706.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  707. #endif

  708. 

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

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

  711.     {

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

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

  714.     }

  715. 

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

  717. 

  718.     if (gStandalone.engine == nullptr)

  719.     {

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

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

  722.         return false;

  723.     }

  724. 

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

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

  727. 

  728. #ifdef BUILD_BRIDGE

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

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

  731. #else

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

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

  734. #endif

  735. 

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

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

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

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

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

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

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

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

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

  745. 

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

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

  748. 

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

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

  751. 

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

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

  754. 

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

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

  757. 

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

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

  760. 

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

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

  763. 

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

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

  766. 

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

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

  769. 

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

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

  772. 

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

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

  775. 

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

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

  778. 

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

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

  781. 

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

  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 preventBadBehaviour = std::getenv("ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR"))

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

  890. 

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

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

  893. 

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

  895.     {

  896.         gStandalone.lastError = "No error";

  897.         return true;

  898.     }

  899.     else

  900.     {

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

  902.         delete gStandalone.engine;

  903.         gStandalone.engine = nullptr;

  904.         return false;

  905.     }

  906. }

  907. #endif

  908. 

  909. bool carla_engine_close()

  910. {

  911.     carla_debug("carla_engine_close()");

  912. 

  913.     if (gStandalone.engine == nullptr)

  914.     {

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

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

  917.         return false;

  918.     }

  919. 

  920.     gStandalone.engine->setAboutToClose();

  921.     gStandalone.engine->removeAllPlugins();

  922. 

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

  924. 

  925.     if (! closed)

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

  927. 

  928. #ifndef BUILD_BRIDGE

  929.     juce::shutdownJuce_GUI();

  930. #endif

  931.     delete gStandalone.engine;

  932.     gStandalone.engine = nullptr;

  933. 

  934.     return closed;

  935. }

  936. 

  937. void carla_engine_idle()

  938. {

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

  940. 

  941.     gNSM.idle();

  942.     gStandalone.engine->idle();

  943. }

  944. 

  945. bool carla_is_engine_running()

  946. {

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

  948. }

  949. 

  950. void carla_set_engine_about_to_close()

  951. {

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

  953.     carla_debug("carla_set_engine_about_to_close()");

  954. 

  955.     gStandalone.engine->setAboutToClose();

  956. }

  957. 

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

  959. {

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

  961. 

  962.     gStandalone.engineCallback    = func;

  963.     gStandalone.engineCallbackPtr = ptr;

  964. 

  965.     if (gStandalone.engine != nullptr)

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

  967. 

  968. //#ifdef WANT_LOGS

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

  970. //#endif

  971. }

  972. 

  973. #ifndef BUILD_BRIDGE

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

  975. {

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

  977. 

  978.     switch (option)

  979.     {

  980.     case CB::ENGINE_OPTION_DEBUG:

  981.         break;

  982. 

  983.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  986.         break;

  987. 

  988.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  991.         break;

  992. 

  993.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  996.         break;

  997. 

  998.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  1001.         break;

  1002. 

  1003.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  1006.         break;

  1007. 

  1008.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  1011.         break;

  1012. 

  1013.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  1014.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1016.         break;

  1017. 

  1018.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  1019.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1021.         break;

  1022. 

  1023.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  1026.         break;

  1027. 

  1028.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  1029.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  1031.         break;

  1032. 

  1033.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  1034.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  1036.         break;

  1037. 

  1038.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  1039.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1040. 

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

  1042.             delete[] gStandalone.engineOptions.audioDevice;

  1043. 

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

  1045.         break;

  1046. 

  1047.     case CB:: ENGINE_OPTION_NSM_INIT:

  1048.         CARLA_SAFE_ASSERT_RETURN(value != 0,);

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

  1050.         gNSM.announce(value, valueStr);

  1051.         break;

  1052. 

  1053.     case CB::ENGINE_OPTION_PLUGIN_PATH:

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

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

  1056.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1057. 

  1058.         switch (value)

  1059.         {

  1060.         case CB::PLUGIN_LADSPA:

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

  1062.                 delete[] gStandalone.engineOptions.pathLADSPA;

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

  1064.             break;

  1065.         case CB::PLUGIN_DSSI:

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

  1067.                 delete[] gStandalone.engineOptions.pathDSSI;

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

  1069.             break;

  1070.         case CB::PLUGIN_LV2:

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

  1072.                 delete[] gStandalone.engineOptions.pathLV2;

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

  1074.             break;

  1075.         case CB::PLUGIN_VST:

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

  1077.                 delete[] gStandalone.engineOptions.pathVST;

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

  1079.             break;

  1080.         case CB::PLUGIN_VST3:

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

  1082.                 delete[] gStandalone.engineOptions.pathVST3;

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

  1084.             break;

  1085.         case CB::PLUGIN_AU:

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

  1087.                 delete[] gStandalone.engineOptions.pathAU;

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

  1089.             break;

  1090.         case CB::PLUGIN_GIG:

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

  1092.                 delete[] gStandalone.engineOptions.pathGIG;

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

  1094.             break;

  1095.         case CB::PLUGIN_SF2:

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

  1097.                 delete[] gStandalone.engineOptions.pathSF2;

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

  1099.             break;

  1100.         case CB::PLUGIN_SFZ:

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

  1102.                 delete[] gStandalone.engineOptions.pathSFZ;

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

  1104.             break;

  1105.         }

  1106.         break;

  1107. 

  1108.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  1110. 

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

  1112.             delete[] gStandalone.engineOptions.binaryDir;

  1113. 

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

  1115.         break;

  1116. 

  1117.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  1119. 

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

  1121.             delete[] gStandalone.engineOptions.resourceDir;

  1122. 

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

  1124.         break;

  1125. 

  1126.     case CB::ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

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

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

  1129.         break;

  1130. 

  1131.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  1134.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  1136.         break;

  1137.     }

  1138. 

  1139.     if (gStandalone.engine != nullptr)

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

  1141. }

  1142. #endif

  1143. 

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

  1145. {

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

  1147. 

  1148.     gStandalone.fileCallback    = func;

  1149.     gStandalone.fileCallbackPtr = ptr;

  1150. 

  1151.     if (gStandalone.engine != nullptr)

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

  1153. }

  1154. 

  1155. // -------------------------------------------------------------------------------------------------------------------

  1156. 

  1157. bool carla_load_file(const char* filename)

  1158. {

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

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

  1161. 

  1162.     if (gStandalone.engine != nullptr)

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

  1164. 

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

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

  1167.     return false;

  1168. }

  1169. 

  1170. bool carla_load_project(const char* filename)

  1171. {

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

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

  1174. 

  1175.     if (gStandalone.engine != nullptr)

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

  1177. 

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

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

  1180.     return false;

  1181. }

  1182. 

  1183. bool carla_save_project(const char* filename)

  1184. {

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

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

  1187. 

  1188.     if (gStandalone.engine != nullptr)

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

  1190. 

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

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

  1193.     return false;

  1194. }

  1195. 

  1196. #ifndef BUILD_BRIDGE

  1197. // -------------------------------------------------------------------------------------------------------------------

  1198. 

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

  1200. {

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

  1202. 

  1203.     if (gStandalone.engine != nullptr)

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

  1205. 

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

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

  1208.     return false;

  1209. }

  1210. 

  1211. bool carla_patchbay_disconnect(uint connectionId)

  1212. {

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

  1214. 

  1215.     if (gStandalone.engine != nullptr)

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

  1217. 

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

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

  1220.     return false;

  1221. }

  1222. 

  1223. bool carla_patchbay_refresh(bool external)

  1224. {

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

  1226. 

  1227.     if (gStandalone.engine != nullptr)

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

  1229. 

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

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

  1232.     return false;

  1233. }

  1234. 

  1235. // -------------------------------------------------------------------------------------------------------------------

  1236. 

  1237. void carla_transport_play()

  1238. {

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

  1240.     carla_debug("carla_transport_play()");

  1241. 

  1242.     gStandalone.engine->transportPlay();

  1243. }

  1244. 

  1245. void carla_transport_pause()

  1246. {

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

  1248.     carla_debug("carla_transport_pause()");

  1249. 

  1250.     gStandalone.engine->transportPause();

  1251. }

  1252. 

  1253. void carla_transport_relocate(uint64_t frame)

  1254. {

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

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

  1257. 

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

  1259. }

  1260. 

  1261. uint64_t carla_get_current_transport_frame()

  1262. {

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

  1264. 

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

  1266.     return timeInfo.frame;

  1267. }

  1268. 

  1269. const CarlaTransportInfo* carla_get_transport_info()

  1270. {

  1271.     static CarlaTransportInfo retInfo;

  1272. 

  1273.     // reset

  1274.     retInfo.playing = false;

  1275.     retInfo.frame   = 0;

  1276.     retInfo.bar     = 0;

  1277.     retInfo.beat    = 0;

  1278.     retInfo.tick    = 0;

  1279.     retInfo.bpm     = 0.0;

  1280. 

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

  1282. 

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

  1284. 

  1285.     retInfo.playing = timeInfo.playing;

  1286.     retInfo.frame   = timeInfo.frame;

  1287. 

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

  1289.     {

  1290.         retInfo.bar  = timeInfo.bbt.bar;

  1291.         retInfo.beat = timeInfo.bbt.beat;

  1292.         retInfo.tick = timeInfo.bbt.tick;

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

  1294.     }

  1295. 

  1296.     return &retInfo;

  1297. }

  1298. #endif

  1299. 

  1300. // -------------------------------------------------------------------------------------------------------------------

  1301. 

  1302. uint32_t carla_get_current_plugin_count()

  1303. {

  1304.     if (gStandalone.engine != nullptr)

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

  1306. 

  1307.     return 0;

  1308. }

  1309. 

  1310. uint32_t carla_get_max_plugin_number()

  1311. {

  1312.     if (gStandalone.engine != nullptr)

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

  1314. 

  1315.     return 0;

  1316. }

  1317. 

  1318. // -------------------------------------------------------------------------------------------------------------------

  1319. 

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

  1321. {

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

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

  1324. 

  1325.     if (gStandalone.engine != nullptr)

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

  1327. 

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

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

  1330.     return false;

  1331. }

  1332. 

  1333. bool carla_remove_plugin(uint pluginId)

  1334. {

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

  1336. 

  1337.     if (gStandalone.engine != nullptr)

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

  1339. 

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

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

  1342.     return false;

  1343. }

  1344. 

  1345. bool carla_remove_all_plugins()

  1346. {

  1347.     carla_debug("carla_remove_all_plugins()");

  1348. 

  1349.     if (gStandalone.engine != nullptr)

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

  1351. 

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

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

  1354.     return false;

  1355. }

  1356. 

  1357. #ifndef BUILD_BRIDGE

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

  1359. {

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

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

  1362. 

  1363.     if (gStandalone.engine != nullptr)

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

  1365. 

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

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

  1368.     return nullptr;

  1369. }

  1370. 

  1371. bool carla_clone_plugin(uint pluginId)

  1372. {

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

  1374. 

  1375.     if (gStandalone.engine != nullptr)

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

  1377. 

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

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

  1380.     return false;

  1381. }

  1382. 

  1383. bool carla_replace_plugin(uint pluginId)

  1384. {

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

  1386. 

  1387.     if (gStandalone.engine != nullptr)

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

  1389. 

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

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

  1392.     return false;

  1393. }

  1394. 

  1395. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1396. {

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

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

  1399. 

  1400.     if (gStandalone.engine != nullptr)

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

  1402. 

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

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

  1405.     return false;

  1406. }

  1407. #endif

  1408. 

  1409. // -------------------------------------------------------------------------------------------------------------------

  1410. 

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

  1412. {

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

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

  1415. 

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

  1417.     {

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

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

  1420.         return false;

  1421.     }

  1422. 

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

  1424.         return plugin->loadStateFromFile(filename);

  1425. 

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

  1427.     return false;

  1428. }

  1429. 

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

  1431. {

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

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

  1434. 

  1435.     if (gStandalone.engine == nullptr)

  1436.     {

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

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

  1439.         return false;

  1440.     }

  1441. 

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

  1443. 

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

  1445.         return plugin->saveStateToFile(filename);

  1446. 

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

  1448.     return false;

  1449. }

  1450. 

  1451. // -------------------------------------------------------------------------------------------------------------------

  1452. 

  1453. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1454. {

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

  1456. 

  1457.     static CarlaPluginInfo info;

  1458. 

  1459.     // reset

  1460.     info.type             = CB::PLUGIN_NONE;

  1461.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1462.     info.hints            = 0x0;

  1463.     info.optionsAvailable = 0x0;

  1464.     info.optionsEnabled   = 0x0;

  1465.     info.filename         = gNullCharPtr;

  1466.     info.name             = gNullCharPtr;

  1467.     info.iconName         = gNullCharPtr;

  1468.     info.uniqueId         = 0;

  1469. 

  1470.     // cleanup

  1471.     if (info.label != gNullCharPtr)

  1472.     {

  1473.         delete[] info.label;

  1474.         info.label = gNullCharPtr;

  1475.     }

  1476. 

  1477.     if (info.maker != gNullCharPtr)

  1478.     {

  1479.         delete[] info.maker;

  1480.         info.maker = gNullCharPtr;

  1481.     }

  1482. 

  1483.     if (info.copyright != gNullCharPtr)

  1484.     {

  1485.         delete[] info.copyright;

  1486.         info.copyright = gNullCharPtr;

  1487.     }

  1488. 

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

  1490. 

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

  1492.     {

  1493.         char strBufLabel[STR_MAX+1];

  1494.         char strBufMaker[STR_MAX+1];

  1495.         char strBufCopyright[STR_MAX+1];

  1496. 

  1497.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1498.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1499.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1500. 

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

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

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

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

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

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

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

  1508. 

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

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

  1511. 

  1512.         plugin->getLabel(strBufLabel);

  1513.         info.label = carla_strdup_safe(strBufLabel);

  1514. 

  1515.         plugin->getMaker(strBufMaker);

  1516.         info.maker = carla_strdup_safe(strBufMaker);

  1517. 

  1518.         plugin->getCopyright(strBufCopyright);

  1519.         info.copyright = carla_strdup_safe(strBufCopyright);

  1520. 

  1521.         checkStringPtr(info.filename);

  1522.         checkStringPtr(info.name);

  1523.         checkStringPtr(info.iconName);

  1524.         checkStringPtr(info.label);

  1525.         checkStringPtr(info.maker);

  1526.         checkStringPtr(info.copyright);

  1527. 

  1528.         return &info;

  1529.     }

  1530. 

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

  1532.     return &info;

  1533. }

  1534. 

  1535. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1536. {

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

  1538. 

  1539.     static CarlaPortCountInfo info;

  1540. 

  1541.     // reset

  1542.     info.ins   = 0;

  1543.     info.outs  = 0;

  1544. 

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

  1546. 

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

  1548.     {

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

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

  1551.         return &info;

  1552.     }

  1553. 

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

  1555.     return &info;

  1556. }

  1557. 

  1558. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1559. {

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

  1561. 

  1562.     static CarlaPortCountInfo info;

  1563. 

  1564.     // reset

  1565.     info.ins   = 0;

  1566.     info.outs  = 0;

  1567. 

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

  1569. 

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

  1571.     {

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

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

  1574.         return &info;

  1575.     }

  1576. 

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

  1578.     return &info;

  1579. }

  1580. 

  1581. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1582. {

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

  1584. 

  1585.     static CarlaPortCountInfo info;

  1586. 

  1587.     // reset

  1588.     info.ins   = 0;

  1589.     info.outs  = 0;

  1590. 

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

  1592. 

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

  1594.     {

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

  1596.         return &info;

  1597.     }

  1598. 

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

  1600.     return &info;

  1601. }

  1602. 

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

  1604. {

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

  1606. 

  1607.     static CarlaParameterInfo info;

  1608. 

  1609.     // reset

  1610.     info.scalePointCount = 0;

  1611. 

  1612.     // cleanup

  1613.     if (info.name != gNullCharPtr)

  1614.     {

  1615.         delete[] info.name;

  1616.         info.name = gNullCharPtr;

  1617.     }

  1618. 

  1619.     if (info.symbol != gNullCharPtr)

  1620.     {

  1621.         delete[] info.symbol;

  1622.         info.symbol = gNullCharPtr;

  1623.     }

  1624. 

  1625.     if (info.unit != gNullCharPtr)

  1626.     {

  1627.         delete[] info.unit;

  1628.         info.unit = gNullCharPtr;

  1629.     }

  1630. 

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

  1632. 

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

  1634.     {

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

  1636.         {

  1637.             char strBufName[STR_MAX+1];

  1638.             char strBufSymbol[STR_MAX+1];

  1639.             char strBufUnit[STR_MAX+1];

  1640. 

  1641.             carla_zeroChar(strBufName, STR_MAX+1);

  1642.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1643.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1644. 

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

  1646. 

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

  1648.             info.name = carla_strdup_safe(strBufName);

  1649. 

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

  1651.             info.symbol = carla_strdup_safe(strBufSymbol);

  1652. 

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

  1654.             info.unit = carla_strdup_safe(strBufUnit);

  1655. 

  1656.             checkStringPtr(info.name);

  1657.             checkStringPtr(info.symbol);

  1658.             checkStringPtr(info.unit);

  1659.         }

  1660.         else

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

  1662. 

  1663.         return &info;

  1664.     }

  1665. 

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

  1667.     return &info;

  1668. }

  1669. 

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

  1671. {

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

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

  1674. 

  1675.     static CarlaScalePointInfo info;

  1676. 

  1677.     // reset

  1678.     info.value = 0.0f;

  1679. 

  1680.     // cleanup

  1681.     if (info.label != gNullCharPtr)

  1682.     {

  1683.         delete[] info.label;

  1684.         info.label = gNullCharPtr;

  1685.     }

  1686. 

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

  1688. 

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

  1690.     {

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

  1692.         {

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

  1694.             {

  1695.                 char strBufLabel[STR_MAX+1];

  1696.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1697. 

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

  1699. 

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

  1701.                 info.label = carla_strdup_safe(strBufLabel);

  1702.                 checkStringPtr(info.label);

  1703.             }

  1704.             else

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

  1706.         }

  1707.         else

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

  1709. 

  1710.         return &info;

  1711.     }

  1712. 

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

  1714.     return &info;

  1715. }

  1716. 

  1717. // -------------------------------------------------------------------------------------------------------------------

  1718. 

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

  1720. {

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

  1722. 

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

  1724. 

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

  1726. 

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

  1728.     {

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

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

  1731. 

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

  1733.         return &fallbackParameterData;

  1734.     }

  1735. 

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

  1737.     return &fallbackParameterData;

  1738. }

  1739. 

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

  1741. {

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

  1743. 

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

  1745. 

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

  1747. 

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

  1749.     {

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

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

  1752. 

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

  1754.         return &fallbackParamRanges;

  1755.     }

  1756. 

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

  1758.     return &fallbackParamRanges;

  1759. }

  1760. 

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

  1762. {

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

  1764. 

  1765.     static MidiProgramData midiProgData;

  1766. 

  1767.     // reset

  1768.     midiProgData.bank    = 0;

  1769.     midiProgData.program = 0;

  1770.     midiProgData.name    = gNullCharPtr;

  1771. 

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

  1773. 

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

  1775.     {

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

  1777.         {

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

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

  1780.             checkStringPtr(midiProgData.name);

  1781.             return &midiProgData;

  1782.         }

  1783. 

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

  1785.         return &midiProgData;

  1786.     }

  1787. 

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

  1789.     return &midiProgData;

  1790. }

  1791. 

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

  1793. {

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

  1795. 

  1796.     static CustomData customData;

  1797. 

  1798.     // reset

  1799.     customData.type  = gNullCharPtr;

  1800.     customData.key   = gNullCharPtr;

  1801.     customData.value = gNullCharPtr;

  1802. 

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

  1804. 

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

  1806.     {

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

  1808.         {

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

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

  1811.             checkStringPtr(customData.type);

  1812.             checkStringPtr(customData.key);

  1813.             checkStringPtr(customData.value);

  1814.             return &customData;

  1815.         }

  1816. 

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

  1818.         return &customData;

  1819.     }

  1820. 

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

  1822.     return &customData;

  1823. }

  1824. 

  1825. const char* carla_get_chunk_data(uint pluginId)

  1826. {

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

  1828. 

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

  1830. 

  1831.     static CarlaString chunkData;

  1832. 

  1833.     // cleanup

  1834.     chunkData.clear();

  1835. 

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

  1837.     {

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

  1839.         {

  1840.             void* data = nullptr;

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

  1842. 

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

  1844.             {

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

  1846.                 return chunkData;

  1847.             }

  1848.             else

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

  1850.         }

  1851.         else

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

  1853. 

  1854.         return nullptr;

  1855.     }

  1856. 

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

  1858.     return nullptr;

  1859. }

  1860. 

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

  1862. 

  1863. uint32_t carla_get_parameter_count(uint pluginId)

  1864. {

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

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

  1867. 

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

  1869.         return plugin->getParameterCount();

  1870. 

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

  1872.     return 0;

  1873. }

  1874. 

  1875. uint32_t carla_get_program_count(uint pluginId)

  1876. {

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

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

  1879. 

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

  1881.         return plugin->getProgramCount();

  1882. 

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

  1884.     return 0;

  1885. }

  1886. 

  1887. uint32_t carla_get_midi_program_count(uint pluginId)

  1888. {

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

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

  1891. 

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

  1893.         return plugin->getMidiProgramCount();

  1894. 

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

  1896.     return 0;

  1897. }

  1898. 

  1899. uint32_t carla_get_custom_data_count(uint pluginId)

  1900. {

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

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

  1903. 

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

  1905.         return plugin->getCustomDataCount();

  1906. 

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

  1908.     return 0;

  1909. }

  1910. 

  1911. // -------------------------------------------------------------------------------------------------------------------

  1912. 

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

  1914. {

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

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

  1917. 

  1918.     static char textBuf[STR_MAX+1];

  1919. 

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

  1921.     {

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

  1923.         {

  1924.             carla_zeroChar(textBuf, STR_MAX+1);

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

  1926.             return textBuf;

  1927.         }

  1928. 

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

  1930.         return nullptr;

  1931.     }

  1932. 

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

  1934.     return nullptr;

  1935. }

  1936. 

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

  1938. {

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

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

  1941. 

  1942.     static char programName[STR_MAX+1];

  1943. 

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

  1945.     {

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

  1947.         {

  1948.             carla_zeroChar(programName, STR_MAX+1);

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

  1950.             return programName;

  1951.         }

  1952. 

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

  1954.         return nullptr;

  1955.     }

  1956. 

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

  1958.     return nullptr;

  1959. }

  1960. 

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

  1962. {

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

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

  1965. 

  1966.     static char midiProgramName[STR_MAX+1];

  1967. 

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

  1969.     {

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

  1971.         {

  1972.             carla_zeroChar(midiProgramName, STR_MAX+1);

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

  1974.             return midiProgramName;

  1975.         }

  1976. 

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

  1978.         return nullptr;

  1979.     }

  1980. 

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

  1982.     return nullptr;

  1983. }

  1984. 

  1985. const char* carla_get_real_plugin_name(uint pluginId)

  1986. {

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

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

  1989. 

  1990.     static char realPluginName[STR_MAX+1];

  1991. 

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

  1993.     {

  1994.         carla_zeroChar(realPluginName, STR_MAX+1);

  1995.         plugin->getRealName(realPluginName);

  1996.         return realPluginName;

  1997.     }

  1998. 

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

  2000.     return nullptr;

  2001. }

  2002. 

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

  2004. 

  2005. int32_t carla_get_current_program_index(uint pluginId)

  2006. {

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

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

  2009. 

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

  2011.         return plugin->getCurrentProgram();

  2012. 

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

  2014.     return -1;

  2015. }

  2016. 

  2017. int32_t carla_get_current_midi_program_index(uint pluginId)

  2018. {

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

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

  2021. 

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

  2023.         return plugin->getCurrentMidiProgram();

  2024. 

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

  2026.     return -1;

  2027. }

  2028. 

  2029. // -------------------------------------------------------------------------------------------------------------------

  2030. 

  2031. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  2032. {

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

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

  2035. 

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

  2037.     {

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

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

  2040. 

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

  2042.         return 0.0f;

  2043.     }

  2044. 

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

  2046.     return 0.0f;

  2047. }

  2048. 

  2049. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  2050. {

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

  2052. 

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

  2054.     {

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

  2056.             return plugin->getParameterValue(parameterId);

  2057. 

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

  2059.         return 0.0f;

  2060.     }

  2061. 

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

  2063.     return 0.0f;

  2064. }

  2065. 

  2066. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  2067. {

  2068. #ifdef BUILD_BRIDGE

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

  2070. #else

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

  2072. #endif

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

  2074. 

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

  2076.         return plugin->getInternalParameterValue(parameterId);

  2077. 

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

  2079.     return 0.0f;

  2080. }

  2081. 

  2082. // -------------------------------------------------------------------------------------------------------------------

  2083. 

  2084. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  2085. {

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

  2087. 

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

  2089. }

  2090. 

  2091. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  2092. {

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

  2094. 

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

  2096. }

  2097. 

  2098. // -------------------------------------------------------------------------------------------------------------------

  2099. 

  2100. void carla_set_active(uint pluginId, bool onOff)

  2101. {

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

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

  2104. 

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

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

  2107. 

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

  2109. }

  2110. 

  2111. #ifndef BUILD_BRIDGE

  2112. void carla_set_drywet(uint pluginId, float value)

  2113. {

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

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

  2116. 

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

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

  2119. 

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

  2121. }

  2122. 

  2123. void carla_set_volume(uint pluginId, float value)

  2124. {

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

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

  2127. 

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

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

  2130. 

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

  2132. }

  2133. 

  2134. void carla_set_balance_left(uint pluginId, float value)

  2135. {

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

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

  2138. 

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

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

  2141. 

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

  2143. }

  2144. 

  2145. void carla_set_balance_right(uint pluginId, float value)

  2146. {

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

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

  2149. 

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

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

  2152. 

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

  2154. }

  2155. 

  2156. void carla_set_panning(uint pluginId, float value)

  2157. {

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

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

  2160. 

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

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

  2163. 

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

  2165. }

  2166. 

  2167. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  2168. {

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

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

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

  2172. 

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

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

  2175. 

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

  2177. }

  2178. 

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

  2180. {

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

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

  2183. 

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

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

  2186. 

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

  2188. }

  2189. #endif

  2190. 

  2191. // -------------------------------------------------------------------------------------------------------------------

  2192. 

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

  2194. {

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

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

  2197. 

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

  2199.     {

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

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

  2202. 

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

  2204.         return;

  2205.     }

  2206. 

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

  2208. }

  2209. 

  2210. #ifndef BUILD_BRIDGE

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

  2212. {

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

  2214.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  2216. 

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

  2218.     {

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

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

  2221. 

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

  2223.         return;

  2224.     }

  2225. 

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

  2227. }

  2228. 

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

  2230. {

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

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

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

  2234. 

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

  2236.     {

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

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

  2239. 

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

  2241.         return;

  2242.     }

  2243. 

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

  2245. }

  2246. #endif

  2247. 

  2248. // -------------------------------------------------------------------------------------------------------------------

  2249. 

  2250. void carla_set_program(uint pluginId, uint32_t programId)

  2251. {

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

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

  2254. 

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

  2256.     {

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

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

  2259. 

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

  2261.         return;

  2262.     }

  2263. 

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

  2265. }

  2266. 

  2267. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2268. {

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

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

  2271. 

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

  2273.     {

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

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

  2276. 

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

  2278.         return;

  2279.     }

  2280. 

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

  2282. }

  2283. 

  2284. // -------------------------------------------------------------------------------------------------------------------

  2285. 

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

  2287. {

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

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

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

  2291.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  2293. 

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

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

  2296. 

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

  2298. }

  2299. 

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

  2301. {

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

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

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

  2305. 

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

  2307.     {

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

  2309.         {

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

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

  2312.         }

  2313. 

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

  2315.         return;

  2316.     }

  2317. 

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

  2319. }

  2320. 

  2321. // -------------------------------------------------------------------------------------------------------------------

  2322. 

  2323. void carla_prepare_for_save(uint pluginId)

  2324. {

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

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

  2327. 

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

  2329.         return plugin->prepareForSave();

  2330. 

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

  2332. }

  2333. 

  2334. void carla_reset_parameters(uint pluginId)

  2335. {

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

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

  2338. 

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

  2340.         return plugin->resetParameters();

  2341. 

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

  2343. }

  2344. 

  2345. void carla_randomize_parameters(uint pluginId)

  2346. {

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

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

  2349. 

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

  2351.         return plugin->randomizeParameters();

  2352. 

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

  2354. }

  2355. 

  2356. #ifndef BUILD_BRIDGE

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

  2358. {

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

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

  2361. 

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

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

  2364. 

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

  2366. }

  2367. #endif

  2368. 

  2369. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2370. {

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

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

  2373. 

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

  2375.         return plugin->showCustomUI(yesNo);

  2376. 

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

  2378. }

  2379. 

  2380. // -------------------------------------------------------------------------------------------------------------------

  2381. 

  2382. uint32_t carla_get_buffer_size()

  2383. {

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

  2385.     carla_debug("carla_get_buffer_size()");

  2386. 

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

  2388. }

  2389. 

  2390. double carla_get_sample_rate()

  2391. {

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

  2393.     carla_debug("carla_get_sample_rate()");

  2394. 

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

  2396. }

  2397. 

  2398. // -------------------------------------------------------------------------------------------------------------------

  2399. 

  2400. const char* carla_get_last_error()

  2401. {

  2402.     carla_debug("carla_get_last_error()");

  2403. 

  2404.     if (gStandalone.engine != nullptr)

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

  2406. 

  2407.     return gStandalone.lastError;

  2408. }

  2409. 

  2410. const char* carla_get_host_osc_url_tcp()

  2411. {

  2412.     carla_debug("carla_get_host_osc_url_tcp()");

  2413. 

  2414.     if (gStandalone.engine == nullptr)

  2415.     {

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

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

  2418.         return nullptr;

  2419.     }

  2420. 

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

  2422. }

  2423. 

  2424. const char* carla_get_host_osc_url_udp()

  2425. {

  2426.     carla_debug("carla_get_host_osc_url_udp()");

  2427. 

  2428.     if (gStandalone.engine == nullptr)

  2429.     {

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

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

  2432.         return nullptr;

  2433.     }

  2434. 

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

  2436. }

  2437. 

  2438. // -------------------------------------------------------------------------------------------------------------------

  2439. 

  2440. const char* carla_get_library_filename()

  2441. {

  2442.     carla_debug("carla_get_library_filename()");

  2443. 

  2444.     static CarlaString ret;

  2445. 

  2446.     if (ret.isEmpty())

  2447.     {

  2448.         using juce::File;

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

  2450.     }

  2451. 

  2452.     return ret;

  2453. }

  2454. 

  2455. const char* carla_get_library_folder()

  2456. {

  2457.     carla_debug("carla_get_library_folder()");

  2458. 

  2459.     static CarlaString ret;

  2460. 

  2461.     if (ret.isEmpty())

  2462.     {

  2463.         using juce::File;

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

  2465.     }

  2466. 

  2467.     return ret;

  2468. }

  2469. 

  2470. // -------------------------------------------------------------------------------------------------------------------

  2471. 

  2472. #include "CarlaPluginUI.cpp"

  2473. #include "CarlaDssiUtils.cpp"

  2474. #include "CarlaStateUtils.cpp"

  2475. #include "CarlaJuceEvents.cpp"

  2476. 

  2477. // -------------------------------------------------------------------------------------------------------------------