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

2426 lines
79KB
Raw Blame History 

  1. /*

  2.  * Carla Standalone

  3.  * Copyright (C) 2011-2013 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 "CarlaOscUtils.hpp"

  30. 

  31. #include <QtCore/QByteArray>

  32. 

  33. #ifdef BUILD_BRIDGE

  34. # undef HAVE_JUCE

  35. #endif

  36. 

  37. #ifdef HAVE_JUCE

  38. # include "juce_gui_basics.h"

  39. using juce::initialiseJuce_GUI;

  40. using juce::shutdownJuce_GUI;

  41. using juce::MessageManager;

  42. #endif

  43. 

  44. namespace CB = CarlaBackend;

  45. using CB::EngineOptions;

  46. 

  47. // -------------------------------------------------------------------------------------------------------------------

  48. // Juce Message Thread

  49. 

  50. #if defined(HAVE_JUCE) && defined(CARLA_OS_LINUX)

  51. 

  52. class JuceMessageThread : public juce::Thread

  53. {

  54. public:

  55.     JuceMessageThread()

  56.       : juce::Thread("JuceMessageThread"),

  57.         fInitialised(false)

  58.     {

  59.     }

  60. 

  61.     ~JuceMessageThread() override

  62.     {

  63.         stop();

  64.     }

  65. 

  66.     void start()

  67.     {

  68.         CARLA_SAFE_ASSERT_RETURN(! fInitialised,);

  69. 

  70.         fInitialised = false;

  71. 

  72.         startThread();

  73. 

  74.         while (! fInitialised)

  75.             Thread::sleep(1);

  76.     }

  77. 

  78.     void stop()

  79.     {

  80.         if (! fInitialised)

  81.             return;

  82. 

  83.         stopThread(-1);

  84.     }

  85. 

  86. protected:

  87.     void run() override

  88.     {

  89.         fInitialised = true;

  90. 

  91.         if (MessageManager* const msgMgr = MessageManager::getInstance())

  92.         {

  93.             msgMgr->setCurrentThreadAsMessageThread();

  94. 

  95.             for (; (! threadShouldExit()) && msgMgr->runDispatchLoopUntil(250);) {}

  96.         }

  97. 

  98.         fInitialised = false;

  99.     }

  100. 

  101. private:

  102.     volatile bool fInitialised;

  103. 

  104.     CARLA_DECLARE_NON_COPY_CLASS(JuceMessageThread)

  105. };

  106. 

  107. #endif // defined(HAVE_JUCE) && defined(CARLA_OS_LINUX)

  108. 

  109. // -------------------------------------------------------------------------------------------------------------------

  110. // Single, standalone engine

  111. 

  112. struct CarlaBackendStandalone {

  113.     CarlaEngine*       engine;

  114.     EngineCallbackFunc engineCallback;

  115.     void*              engineCallbackPtr;

  116.     EngineOptions      engineOptions;

  117. 

  118.     FileCallbackFunc fileCallback;

  119.     void*            fileCallbackPtr;

  120. 

  121.     CarlaString lastError;

  122. 

  123. #if defined(HAVE_JUCE) && defined(CARLA_OS_LINUX)

  124.     JuceMessageThread juceMsgThread;

  125. #endif

  126. 

  127.     CarlaBackendStandalone()

  128.         : engine(nullptr),

  129.           engineCallback(nullptr),

  130.           engineCallbackPtr(nullptr),

  131.           fileCallback(nullptr),

  132.           fileCallbackPtr(nullptr)

  133.     {

  134. #ifdef BUILD_BRIDGE

  135.         engineOptions.processMode         = CB::ENGINE_PROCESS_MODE_BRIDGE;

  136.         engineOptions.transportMode       = CB::ENGINE_TRANSPORT_MODE_BRIDGE;

  137.         engineOptions.forceStereo         = false;

  138.         engineOptions.preferPluginBridges = false;

  139.         engineOptions.preferUiBridges     = false;

  140. #endif

  141.     }

  142. 

  143.     ~CarlaBackendStandalone()

  144.     {

  145.         CARLA_SAFE_ASSERT(engine == nullptr);

  146. #ifdef HAVE_JUCE

  147.         CARLA_SAFE_ASSERT(MessageManager::getInstanceWithoutCreating() == nullptr);

  148. #endif

  149.     }

  150. 

  151. #ifdef HAVE_JUCE

  152.     void init()

  153.     {

  154.         JUCE_AUTORELEASEPOOL

  155.         {

  156.             initialiseJuce_GUI();

  157. # ifdef CARLA_OS_LINUX

  158.             juceMsgThread.start();

  159. # else

  160.             if (MessageManager* const msgMgr = MessageManager::getInstance())

  161.                 msgMgr->setCurrentThreadAsMessageThread();

  162. # endif

  163.         }

  164.     }

  165. 

  166.     void close()

  167.     {

  168.         JUCE_AUTORELEASEPOOL

  169.         {

  170. # ifdef CARLA_OS_LINUX

  171.             juceMsgThread.stop();

  172. # else

  173.             MessageManager::deleteInstance();

  174. # endif

  175.             shutdownJuce_GUI();

  176.         }

  177.     }

  178. 

  179. # ifndef CARLA_OS_LINUX

  180.     void idle()

  181.     {

  182.         JUCE_AUTORELEASEPOOL

  183.         {

  184.             if (MessageManager* const msgMgr = MessageManager::getInstanceWithoutCreating())

  185.                 msgMgr->runDispatchLoopUntil(5);

  186.         }

  187.     }

  188. # endif

  189. #endif

  190. 

  191.     CARLA_PREVENT_HEAP_ALLOCATION

  192.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  193. };

  194. 

  195. static CarlaBackendStandalone gStandalone;

  196. 

  197. // -------------------------------------------------------------------------------------------------------------------

  198. // NSM support

  199. 

  200. #define NSM_API_VERSION_MAJOR 1

  201. #define NSM_API_VERSION_MINOR 2

  202. 

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

  204. #define NSM_CLIENT_FEATURES ":switch:"

  205. 

  206. class CarlaNSM

  207. {

  208. public:

  209.     CarlaNSM() noexcept

  210.         : fOscServer(nullptr),

  211.           fHasBroadcast(false),

  212.           fHasShowHideUI(false) {}

  213. 

  214.     ~CarlaNSM()

  215.     {

  216.         if (fOscServer != nullptr)

  217.         {

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

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

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

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

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

  223.             lo_server_free(fOscServer);

  224.             fOscServer = nullptr;

  225.         }

  226.     }

  227. 

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

  229.     {

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

  231. 

  232.         if (NSM_URL == nullptr)

  233.             return;

  234. 

  235.         const lo_address addr = lo_address_new_from_url(NSM_URL);

  236. 

  237.         if (addr == nullptr)

  238.             return;

  239. 

  240.         const int proto = lo_address_get_protocol(addr);

  241. 

  242.         if (fOscServer == nullptr)

  243.         {

  244.             // create new OSC server

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

  246. 

  247.             // register message handlers and start OSC thread

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

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

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

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

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

  253.             // /nsm/client/session_is_loaded

  254.         }

  255. 

  256. #ifndef BUILD_ANSI_TEST

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

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

  259. #endif

  260. 

  261.         lo_address_free(addr);

  262.     }

  263. 

  264.     void idle() noexcept

  265.     {

  266.         if (fOscServer == nullptr)

  267.             return;

  268. 

  269.         for (;;)

  270.         {

  271.             try {

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

  273.                     break;

  274.             }

  275.             CARLA_SAFE_EXCEPTION_CONTINUE("NSM OSC idle")

  276.         }

  277.     }

  278. 

  279. protected:

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

  281.     {

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

  283. 

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

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

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

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

  288. 

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

  290. 

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

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

  293. 

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

  295. 

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

  297. 

  298.         return 0;

  299. 

  300. #ifndef DEBUG

  301.         // unused

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

  303. #endif

  304.     }

  305. 

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

  307.     {

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

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

  310. 

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

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

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

  314. 

  315.         if (! carla_is_engine_running())

  316.         {

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

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

  319. 

  320.             carla_engine_init("JACK", clientId);

  321.         }

  322.         else

  323.         {

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

  325. 

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

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

  328.         }

  329. 

  330.         fClientId = clientId;

  331. 

  332.         fProjectPath  = projectPath;

  333.         fProjectPath += ".carxp";

  334. 

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

  336. 

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

  338. 

  339. #ifndef BUILD_ANSI_TEST

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

  341. #endif

  342. 

  343. #if 0

  344.         if (fHasBroadcast)

  345.         {

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

  347. 

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

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

  350. 

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

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

  353. 

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

  355. 

  356.             std::free(url);

  357. 

  358.             carla_stdout("Broadcast sent!");

  359.         }

  360.         else

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

  362. #endif

  363. 

  364.         return 0;

  365. 

  366. #ifndef DEBUG

  367.         // unused

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

  369. #endif

  370.     }

  371. 

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

  373.     {

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

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

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

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

  378. 

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

  380. 

  381. #ifndef BUILD_ANSI_TEST

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

  383. #endif

  384. 

  385.         return 0;

  386. 

  387. #ifndef DEBUG

  388.         // unused

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

  390. #endif

  391.     }

  392. 

  393. #if 0

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

  395.     {

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

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

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

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

  400. 

  401. #ifdef HAVE_X11

  402. #endif

  403. 

  404. #ifndef BUILD_ANSI_TEST

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

  406. #endif

  407. 

  408.         return 0;

  409.     }

  410. #endif

  411. 

  412. private:

  413.     lo_server fOscServer;

  414. 

  415.     CarlaString fClientId;

  416.     CarlaString fProjectPath;

  417. 

  418.     bool fHasBroadcast;

  419.     bool fHasShowHideUI;

  420. 

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

  422. 

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

  424.     {

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

  426.     }

  427. 

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

  429.     {

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

  431.     }

  432. 

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

  434.     {

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

  436.     }

  437. 

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

  439.     {

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

  441.     }

  442. 

  443. #if 0

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

  445.     {

  446.         return handlePtr->handleShowHideGui(true);

  447.     }

  448. 

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

  450.     {

  451.         return handlePtr->handleShowHideGui(false);

  452.     }

  453. #endif

  454. 

  455.     #undef handlePtr

  456. 

  457.     CARLA_PREVENT_HEAP_ALLOCATION

  458.     CARLA_DECLARE_NON_COPY_CLASS(CarlaNSM)

  459. };

  460. 

  461. static CarlaNSM gNSM;

  462. 

  463. // -------------------------------------------------------------------------------------------------------------------

  464. // Always return a valid string ptr

  465. 

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

  467. 

  468. static void checkStringPtr(const char*& charPtr)

  469. {

  470.     if (charPtr == nullptr)

  471.         charPtr = gNullCharPtr;

  472. }

  473. 

  474. // -------------------------------------------------------------------------------------------------------------------

  475. // Constructors

  476. 

  477. _CarlaPluginInfo::_CarlaPluginInfo() noexcept

  478.     : type(CB::PLUGIN_NONE),

  479.       category(CB::PLUGIN_CATEGORY_NONE),

  480.       hints(0x0),

  481.       optionsAvailable(0x0),

  482.       optionsEnabled(0x0),

  483.       filename(gNullCharPtr),

  484.       name(gNullCharPtr),

  485.       label(gNullCharPtr),

  486.       maker(gNullCharPtr),

  487.       copyright(gNullCharPtr),

  488.       iconName(gNullCharPtr),

  489.       uniqueId(0) {}

  490. 

  491. _CarlaPluginInfo::~_CarlaPluginInfo() noexcept

  492. {

  493.     if (label != gNullCharPtr)

  494.         delete[] label;

  495.     if (maker != gNullCharPtr)

  496.         delete[] maker;

  497.     if (copyright != gNullCharPtr)

  498.         delete[] copyright;

  499. }

  500. 

  501. _CarlaNativePluginInfo::_CarlaNativePluginInfo() noexcept

  502.     : category(CB::PLUGIN_CATEGORY_NONE),

  503.       hints(0x0),

  504.       audioIns(0),

  505.       audioOuts(0),

  506.       midiIns(0),

  507.       midiOuts(0),

  508.       parameterIns(0),

  509.       parameterOuts(0),

  510.       name(gNullCharPtr),

  511.       label(gNullCharPtr),

  512.       maker(gNullCharPtr),

  513.       copyright(gNullCharPtr) {}

  514. 

  515. _CarlaParameterInfo::_CarlaParameterInfo() noexcept

  516.     : name(gNullCharPtr),

  517.       symbol(gNullCharPtr),

  518.       unit(gNullCharPtr),

  519.       scalePointCount(0) {}

  520. 

  521. _CarlaParameterInfo::~_CarlaParameterInfo() noexcept

  522. {

  523.     if (name != gNullCharPtr)

  524.         delete[] name;

  525.     if (symbol != gNullCharPtr)

  526.         delete[] symbol;

  527.     if (unit != gNullCharPtr)

  528.         delete[] unit;

  529. }

  530. 

  531. _CarlaScalePointInfo::_CarlaScalePointInfo() noexcept

  532.     : value(0.0f),

  533.       label(gNullCharPtr) {}

  534. 

  535. _CarlaScalePointInfo::~_CarlaScalePointInfo() noexcept

  536. {

  537.     if (label != gNullCharPtr)

  538.         delete[] label;

  539. }

  540. 

  541. _CarlaTransportInfo::_CarlaTransportInfo() noexcept

  542.     : playing(false),

  543.       frame(0),

  544.       bar(0),

  545.       beat(0),

  546.       tick(0),

  547.       bpm(0.0) {}

  548. 

  549. // -------------------------------------------------------------------------------------------------------------------

  550. // API

  551. 

  552. const char* carla_get_complete_license_text()

  553. {

  554.     carla_debug("carla_get_complete_license_text()");

  555. 

  556.     static CarlaString retText;

  557. 

  558.     if (retText.isEmpty())

  559.     {

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

  561. 

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

  563.         text1 += "<ul>";

  564. 

  565.         // Plugin formats

  566. #ifdef WANT_LADSPA

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

  568. #endif

  569. #ifdef WANT_DSSI

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

  571. #endif

  572. #ifdef WANT_LV2

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

  574. #endif

  575. #ifdef WANT_VST

  576. # ifdef VESTIGE_HEADER

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

  578. # else

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

  580. # endif

  581. #endif

  582. #ifdef WANT_AU

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

  584. #endif

  585. 

  586.         // Files

  587. #ifdef WANT_CSOUND

  588.         text2 += "<li>CSound library for csd support</li>"; // FIXME

  589. #endif

  590. 

  591.         // Sample kit libraries

  592. #ifdef WANT_FLUIDSYNTH

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

  594. #endif

  595. #ifdef WANT_LINUXSAMPLER

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

  597. #endif

  598. 

  599. #ifdef WANT_NATIVE

  600.         // Internal plugins

  601. # ifdef HAVE_OPENGL

  602.         text3 += "<li>DISTRHO Mini-Series plugin code, based on LOSER-dev suite by Michael Gruhn</li>";

  603. # endif

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

  605.         //text1 += "<li>SunVox library file support, http://www.warmplace.ru/soft/sunvox/</li>"; // unfinished

  606. # ifdef WANT_AUDIOFILE

  607.         text3 += "<li>AudioDecoder library for Audio file support, by Robin Gareus</li>";

  608. # endif

  609. # ifdef WANT_MIDIFILE

  610.         text3 += "<li>LibSMF library for MIDI file support, http://libsmf.sourceforge.net/</li>";

  611. # endif

  612. # ifdef WANT_ZYNADDSUBFX

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

  614. #  ifdef WANT_ZYNADDSUBFX_UI

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

  616. #  endif

  617. # endif

  618. #endif

  619. 

  620.         // misc libs

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

  622. #ifdef WANT_LV2

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

  624. #endif

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

  626. 

  627.         // end

  628.         text4 += "</ul>";

  629. 

  630.         // code snippets

  631.         text5 += "<p>Additionally, Carla uses code snippets from the following projects:</p>";

  632.         text5 += "<ul>";

  633.         text5 += "<li>Pointer and data leak utils from JUCE, http://www.rawmaterialsoftware.com/juce.php</li>";

  634.         text5 += "<li>Shared memory utils from dssi-vst, http://www.breakfastquay.com/dssi-vst/</li>";

  635.         text5 += "<li>Real-time memory pool, by Nedko Arnaudov</li>";

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

  637. 

  638. #ifdef WANT_LINUXSAMPLER

  639.         // LinuxSampler GPL exception

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

  641. #endif

  642. 

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

  644.     }

  645. 

  646.     return retText;

  647. }

  648. 

  649. const char* carla_get_supported_file_extensions()

  650. {

  651.     carla_debug("carla_get_supported_file_extensions()");

  652. 

  653.     static CarlaString retText;

  654. 

  655.     if (retText.isEmpty())

  656.     {

  657.         // Base types

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

  659. 

  660.         // CSound

  661. #ifdef WANT_CSOUND

  662.         retText += ";*.csd";

  663. #endif

  664. 

  665.         // Sample kits

  666. #ifdef WANT_FLUIDSYNTH

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

  668. #endif

  669. #ifdef WANT_LINUXSAMPLER

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

  671. #endif

  672. 

  673.         // Files provided by internal plugins

  674. #ifdef WANT_AUDIOFILE

  675.         retText += ";*.aiff;*.flac;*.oga;*.ogg;*.w64;*.wav";

  676. # ifdef HAVE_FFMPEG

  677.         retText += ";*.3g2;*.3gp;*.aac;*.ac3;*.amr;*.ape;*.mp2;*.mp3;*.mpc;*.wma";

  678. # endif

  679. #endif

  680. #ifdef WANT_MIDIFILE

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

  682. #endif

  683. 

  684.         // Plugin presets

  685. #ifdef WANT_ZYNADDSUBFX

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

  687. #endif

  688.     }

  689. 

  690.     return retText;

  691. }

  692. 

  693. // -------------------------------------------------------------------------------------------------------------------

  694. 

  695. unsigned int carla_get_engine_driver_count()

  696. {

  697.     carla_debug("carla_get_engine_driver_count()");

  698. 

  699.     return CarlaEngine::getDriverCount();

  700. }

  701. 

  702. const char* carla_get_engine_driver_name(unsigned int index)

  703. {

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

  705. 

  706.     return CarlaEngine::getDriverName(index);

  707. }

  708. 

  709. const char* const* carla_get_engine_driver_device_names(unsigned int index)

  710. {

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

  712. 

  713.     return CarlaEngine::getDriverDeviceNames(index);

  714. }

  715. 

  716. const EngineDriverDeviceInfo* carla_get_engine_driver_device_info(unsigned int index, const char* name)

  717. {

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

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

  720. 

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

  722.     {

  723.         static EngineDriverDeviceInfo devInfo;

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

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

  726. 

  727.         devInfo.hints       = ret->hints;

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

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

  730.         return &devInfo;

  731.     }

  732. 

  733.     return nullptr;

  734. }

  735. 

  736. // -------------------------------------------------------------------------------------------------------------------

  737. 

  738. unsigned int carla_get_internal_plugin_count()

  739. {

  740.     carla_debug("carla_get_internal_plugin_count()");

  741. 

  742. #ifdef WANT_NATIVE

  743.     return static_cast<unsigned int>(CarlaPlugin::getNativePluginCount());

  744. #else

  745.     return 0;

  746. #endif

  747. }

  748. 

  749. const CarlaNativePluginInfo* carla_get_internal_plugin_info(unsigned int index)

  750. {

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

  752. 

  753. #ifdef WANT_NATIVE

  754.     static CarlaNativePluginInfo info;

  755. 

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

  757. 

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

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

  760. 

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

  762.      info.hints    = 0x0;

  763. 

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

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

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

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

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

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

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

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

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

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

  774. 

  775.      info.audioIns  = nativePlugin->audioIns;

  776.      info.audioOuts = nativePlugin->audioOuts;

  777.      info.midiIns   = nativePlugin->midiIns;

  778.      info.midiOuts  = nativePlugin->midiOuts;

  779.      info.parameterIns  = nativePlugin->paramIns;

  780.      info.parameterOuts = nativePlugin->paramOuts;

  781. 

  782.      info.name      = nativePlugin->name;

  783.      info.label     = nativePlugin->label;

  784.      info.maker     = nativePlugin->maker;

  785.      info.copyright = nativePlugin->copyright;

  786. 

  787.      checkStringPtr(info.name);

  788.      checkStringPtr(info.label);

  789.      checkStringPtr(info.maker);

  790.      checkStringPtr(info.copyright);

  791. 

  792.     return &info;

  793. #else

  794.     return nullptr;

  795. 

  796.     // unused

  797.     (void)index;

  798. #endif

  799. }

  800. 

  801. // -------------------------------------------------------------------------------------------------------------------

  802. 

  803. const CarlaEngine* carla_get_engine()

  804. {

  805.     carla_debug("carla_get_engine()");

  806. 

  807.     return gStandalone.engine;

  808. }

  809. 

  810. // -------------------------------------------------------------------------------------------------------------------

  811. 

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

  813. {

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

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

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

  817. 

  818.     if (gStandalone.engine != nullptr)

  819.     {

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

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

  822.         return false;

  823.     }

  824. 

  825. #ifdef CARLA_OS_WIN

  826.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  827. #endif

  828. 

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

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

  831.     {

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

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

  834.     }

  835. 

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

  837. 

  838.     if (gStandalone.engine == nullptr)

  839.     {

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

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

  842.         return false;

  843.     }

  844. 

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

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

  847. 

  848. #ifdef BUILD_BRIDGE

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

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

  851. #else

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

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

  854. #endif

  855. 

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

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

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

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

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

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

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

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

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

  865. 

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

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

  868. 

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

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

  871. 

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

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

  874. 

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

  876.     {

  877.         char strBuf[STR_MAX+1];

  878.         std::sprintf(strBuf, P_UINTPTR, gStandalone.engineOptions.frontendWinId);

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

  880.     }

  881.     else

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

  883. 

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

  885.     {

  886.         gStandalone.lastError = "No error";

  887. #ifdef HAVE_JUCE

  888.         gStandalone.init();

  889. #endif

  890.         return true;

  891.     }

  892.     else

  893.     {

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

  895.         delete gStandalone.engine;

  896.         gStandalone.engine = nullptr;

  897.         return false;

  898.     }

  899. }

  900. 

  901. #ifdef BUILD_BRIDGE

  902. bool carla_engine_init_bridge(const char audioBaseName[6+1], const char controlBaseName[6+1], const char timeBaseName[6+1], const char* clientName)

  903. {

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

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

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

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

  908.     carla_debug("carla_engine_init_bridge(\"%s\", \"%s\", \"%s\", \"%s\")", audioBaseName, controlBaseName, timeBaseName, clientName);

  909. 

  910.     if (gStandalone.engine != nullptr)

  911.     {

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

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

  914.         return false;

  915.     }

  916. 

  917.     gStandalone.engine = CarlaEngine::newBridge(audioBaseName, controlBaseName, timeBaseName);

  918. 

  919.     if (gStandalone.engine == nullptr)

  920.     {

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

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

  923.         return false;

  924.     }

  925. 

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

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

  928. 

  929.     // forced options for bridge mode

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

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

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

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

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

  935. 

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

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

  938. 

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

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

  941. 

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

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

  944. 

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

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

  947. 

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

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

  950. 

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

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

  953. 

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

  955.     {

  956.         gStandalone.lastError = "No error";

  957. #ifdef HAVE_JUCE

  958.         gStandalone.init();

  959. #endif

  960.         return true;

  961.     }

  962.     else

  963.     {

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

  965.         delete gStandalone.engine;

  966.         gStandalone.engine = nullptr;

  967.         return false;

  968.     }

  969. }

  970. #endif

  971. 

  972. bool carla_engine_close()

  973. {

  974.     carla_debug("carla_engine_close()");

  975. 

  976.     if (gStandalone.engine == nullptr)

  977.     {

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

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

  980.         return false;

  981.     }

  982. 

  983.     gStandalone.engine->setAboutToClose();

  984.     gStandalone.engine->removeAllPlugins();

  985. 

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

  987. 

  988.     if (! closed)

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

  990. 

  991. #ifdef HAVE_JUCE

  992.     gStandalone.close();

  993. #endif

  994. 

  995.     delete gStandalone.engine;

  996.     gStandalone.engine = nullptr;

  997. 

  998.     return closed;

  999. }

  1000. 

  1001. void carla_engine_idle()

  1002. {

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

  1004. 

  1005.     gNSM.idle();

  1006. #if defined(HAVE_JUCE) && ! defined(CARLA_OS_LINUX)

  1007.     gStandalone.idle();

  1008. #endif

  1009.     gStandalone.engine->idle();

  1010. }

  1011. 

  1012. bool carla_is_engine_running()

  1013. {

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

  1015. }

  1016. 

  1017. void carla_set_engine_about_to_close()

  1018. {

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

  1020.     carla_debug("carla_set_engine_about_to_close()");

  1021. 

  1022.     gStandalone.engine->setAboutToClose();

  1023. }

  1024. 

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

  1026. {

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

  1028. 

  1029.     gStandalone.engineCallback    = func;

  1030.     gStandalone.engineCallbackPtr = ptr;

  1031. 

  1032.     if (gStandalone.engine != nullptr)

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

  1034. 

  1035. //#ifdef WANT_LOGS

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

  1037. //#endif

  1038. }

  1039. 

  1040. #ifndef BUILD_BRIDGE

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

  1042. {

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

  1044. 

  1045.     switch (option)

  1046.     {

  1047.     case CB::ENGINE_OPTION_DEBUG:

  1048.         break;

  1049. 

  1050.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  1053.         break;

  1054. 

  1055.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  1058.         break;

  1059. 

  1060.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  1063.         break;

  1064. 

  1065.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  1068.         break;

  1069. 

  1070.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  1073.         break;

  1074. 

  1075.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  1078.         break;

  1079. 

  1080.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  1081.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

  1082.         gStandalone.engineOptions.maxParameters = static_cast<unsigned int>(value);

  1083.         break;

  1084. 

  1085.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  1086.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

  1087.         gStandalone.engineOptions.uiBridgesTimeout = static_cast<unsigned int>(value);

  1088.         break;

  1089. 

  1090.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

  1092.         gStandalone.engineOptions.audioNumPeriods = static_cast<unsigned int>(value);

  1093.         break;

  1094. 

  1095.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  1096.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

  1097.         gStandalone.engineOptions.audioBufferSize = static_cast<unsigned int>(value);

  1098.         break;

  1099. 

  1100.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  1101.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

  1102.         gStandalone.engineOptions.audioSampleRate = static_cast<unsigned int>(value);

  1103.         break;

  1104. 

  1105.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  1106.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1107. 

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

  1109.             delete[] gStandalone.engineOptions.audioDevice;

  1110. 

  1111.         gStandalone.engineOptions.audioDevice = carla_strdup(valueStr);

  1112.         break;

  1113. 

  1114.     case CB:: ENGINE_OPTION_NSM_INIT:

  1115.         CARLA_SAFE_ASSERT_RETURN(value != 0,);

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

  1117.         gNSM.announce(value, valueStr);

  1118.         break;

  1119. 

  1120.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  1122. 

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

  1124.             delete[] gStandalone.engineOptions.binaryDir;

  1125. 

  1126.         gStandalone.engineOptions.binaryDir = carla_strdup(valueStr);

  1127.         break;

  1128. 

  1129.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  1131. 

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

  1133.             delete[] gStandalone.engineOptions.resourceDir;

  1134. 

  1135.         gStandalone.engineOptions.resourceDir = carla_strdup(valueStr);

  1136.         break;

  1137. 

  1138.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  1141.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  1143.         break;

  1144.     }

  1145. 

  1146.     if (gStandalone.engine != nullptr)

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

  1148. }

  1149. #endif

  1150. 

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

  1152. {

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

  1154. 

  1155.     gStandalone.fileCallback    = func;

  1156.     gStandalone.fileCallbackPtr = ptr;

  1157. 

  1158.     if (gStandalone.engine != nullptr)

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

  1160. }

  1161. 

  1162. // -------------------------------------------------------------------------------------------------------------------

  1163. 

  1164. bool carla_load_file(const char* filename)

  1165. {

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

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

  1168. 

  1169.     if (gStandalone.engine != nullptr)

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

  1171. 

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

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

  1174.     return false;

  1175. }

  1176. 

  1177. bool carla_load_project(const char* filename)

  1178. {

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

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

  1181. 

  1182.     if (gStandalone.engine != nullptr)

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

  1184. 

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

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

  1187.     return false;

  1188. }

  1189. 

  1190. bool carla_save_project(const char* filename)

  1191. {

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

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

  1194. 

  1195.     if (gStandalone.engine != nullptr)

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

  1197. 

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

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

  1200.     return false;

  1201. }

  1202. 

  1203. #ifndef BUILD_BRIDGE

  1204. // -------------------------------------------------------------------------------------------------------------------

  1205. 

  1206. bool carla_patchbay_connect(int groupIdA, int portIdA, int groupIdB, int portIdB)

  1207. {

  1208.     carla_debug("carla_patchbay_connect(%i, %i, %i, %i)", groupIdA, portIdA, groupIdB, portIdB);

  1209. 

  1210.     if (gStandalone.engine != nullptr)

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

  1212. 

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

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

  1215.     return false;

  1216. }

  1217. 

  1218. bool carla_patchbay_disconnect(uint connectionId)

  1219. {

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

  1221. 

  1222.     if (gStandalone.engine != nullptr)

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

  1224. 

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

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

  1227.     return false;

  1228. }

  1229. 

  1230. bool carla_patchbay_refresh()

  1231. {

  1232.     carla_debug("carla_patchbay_refresh()");

  1233. 

  1234.     if (gStandalone.engine != nullptr)

  1235.         return gStandalone.engine->patchbayRefresh();

  1236. 

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

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

  1239.     return false;

  1240. }

  1241. #endif

  1242. 

  1243. // -------------------------------------------------------------------------------------------------------------------

  1244. 

  1245. void carla_transport_play()

  1246. {

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

  1248.     carla_debug("carla_transport_play()");

  1249. 

  1250.     gStandalone.engine->transportPlay();

  1251. }

  1252. 

  1253. void carla_transport_pause()

  1254. {

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

  1256.     carla_debug("carla_transport_pause()");

  1257. 

  1258.     gStandalone.engine->transportPause();

  1259. }

  1260. 

  1261. void carla_transport_relocate(uint64_t frame)

  1262. {

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

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

  1265. 

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

  1267. }

  1268. 

  1269. uint64_t carla_get_current_transport_frame()

  1270. {

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

  1272. 

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

  1274.     return timeInfo.frame;

  1275. }

  1276. 

  1277. const CarlaTransportInfo* carla_get_transport_info()

  1278. {

  1279.     static CarlaTransportInfo retInfo;

  1280. 

  1281.     // reset

  1282.     retInfo.playing = false;

  1283.     retInfo.frame   = 0;

  1284.     retInfo.bar     = 0;

  1285.     retInfo.beat    = 0;

  1286.     retInfo.tick    = 0;

  1287.     retInfo.bpm     = 0.0;

  1288. 

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

  1290. 

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

  1292. 

  1293.     retInfo.playing = timeInfo.playing;

  1294.     retInfo.frame   = timeInfo.frame;

  1295. 

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

  1297.     {

  1298.         retInfo.bar  = timeInfo.bbt.bar;

  1299.         retInfo.beat = timeInfo.bbt.beat;

  1300.         retInfo.tick = timeInfo.bbt.tick;

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

  1302.     }

  1303. 

  1304.     return &retInfo;

  1305. }

  1306. 

  1307. // -------------------------------------------------------------------------------------------------------------------

  1308. 

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

  1310. {

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

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

  1313. 

  1314.     if (gStandalone.engine != nullptr)

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

  1316. 

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

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

  1319.     return false;

  1320. }

  1321. 

  1322. bool carla_remove_plugin(uint pluginId)

  1323. {

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

  1325. 

  1326.     if (gStandalone.engine != nullptr)

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

  1328. 

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

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

  1331.     return false;

  1332. }

  1333. 

  1334. bool carla_remove_all_plugins()

  1335. {

  1336.     carla_debug("carla_remove_all_plugins()");

  1337. 

  1338.     if (gStandalone.engine != nullptr)

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

  1340. 

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

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

  1343.     return false;

  1344. }

  1345. 

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

  1347. {

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

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

  1350. 

  1351.     if (gStandalone.engine != nullptr)

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

  1353. 

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

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

  1356.     return nullptr;

  1357. }

  1358. 

  1359. bool carla_clone_plugin(uint pluginId)

  1360. {

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

  1362. 

  1363.     if (gStandalone.engine != nullptr)

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

  1365. 

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

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

  1368.     return false;

  1369. }

  1370. 

  1371. bool carla_replace_plugin(uint pluginId)

  1372. {

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

  1374. 

  1375.     if (gStandalone.engine != nullptr)

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

  1377. 

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

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

  1380.     return false;

  1381. }

  1382. 

  1383. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1384. {

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

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

  1387. 

  1388.     if (gStandalone.engine != nullptr)

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

  1390. 

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

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

  1393.     return false;

  1394. }

  1395. 

  1396. // -------------------------------------------------------------------------------------------------------------------

  1397. 

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

  1399. {

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

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

  1402. 

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

  1404.     {

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

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

  1407.         return false;

  1408.     }

  1409. 

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

  1411.         return plugin->loadStateFromFile(filename);

  1412. 

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

  1414.     return false;

  1415. }

  1416. 

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

  1418. {

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

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

  1421. 

  1422.     if (gStandalone.engine == nullptr)

  1423.     {

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

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

  1426.         return false;

  1427.     }

  1428. 

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

  1430. 

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

  1432.         return plugin->saveStateToFile(filename);

  1433. 

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

  1435.     return false;

  1436. }

  1437. 

  1438. // -------------------------------------------------------------------------------------------------------------------

  1439. 

  1440. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1441. {

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

  1443. 

  1444.     static CarlaPluginInfo info;

  1445. 

  1446.     // reset

  1447.     info.type             = CB::PLUGIN_NONE;

  1448.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1449.     info.hints            = 0x0;

  1450.     info.optionsAvailable = 0x0;

  1451.     info.optionsEnabled   = 0x0;

  1452.     info.filename         = gNullCharPtr;

  1453.     info.name             = gNullCharPtr;

  1454.     info.iconName         = gNullCharPtr;

  1455.     info.uniqueId         = 0;

  1456. 

  1457.     // cleanup

  1458.     if (info.label != gNullCharPtr)

  1459.     {

  1460.         delete[] info.label;

  1461.         info.label = gNullCharPtr;

  1462.     }

  1463. 

  1464.     if (info.maker != gNullCharPtr)

  1465.     {

  1466.         delete[] info.maker;

  1467.         info.maker = gNullCharPtr;

  1468.     }

  1469. 

  1470.     if (info.copyright != gNullCharPtr)

  1471.     {

  1472.         delete[] info.copyright;

  1473.         info.copyright = gNullCharPtr;

  1474.     }

  1475. 

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

  1477. 

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

  1479.     {

  1480.         char strBufLabel[STR_MAX+1];

  1481.         char strBufMaker[STR_MAX+1];

  1482.         char strBufCopyright[STR_MAX+1];

  1483. 

  1484.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1485.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1486.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1487. 

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

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

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

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

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

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

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

  1495. 

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

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

  1498. 

  1499.         plugin->getLabel(strBufLabel);

  1500.         info.label = carla_strdup(strBufLabel);

  1501. 

  1502.         plugin->getMaker(strBufMaker);

  1503.         info.maker = carla_strdup(strBufMaker);

  1504. 

  1505.         plugin->getCopyright(strBufCopyright);

  1506.         info.copyright = carla_strdup(strBufCopyright);

  1507. 

  1508.         checkStringPtr(info.filename);

  1509.         checkStringPtr(info.name);

  1510.         checkStringPtr(info.iconName);

  1511. 

  1512.         return &info;

  1513.     }

  1514. 

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

  1516.     return &info;

  1517. }

  1518. 

  1519. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1520. {

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

  1522. 

  1523.     static CarlaPortCountInfo info;

  1524. 

  1525.     // reset

  1526.     info.ins   = 0;

  1527.     info.outs  = 0;

  1528. 

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

  1530. 

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

  1532.     {

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

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

  1535.         return &info;

  1536.     }

  1537. 

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

  1539.     return &info;

  1540. }

  1541. 

  1542. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1543. {

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

  1545. 

  1546.     static CarlaPortCountInfo info;

  1547. 

  1548.     // reset

  1549.     info.ins   = 0;

  1550.     info.outs  = 0;

  1551. 

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

  1553. 

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

  1555.     {

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

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

  1558.         return &info;

  1559.     }

  1560. 

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

  1562.     return &info;

  1563. }

  1564. 

  1565. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1566. {

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

  1568. 

  1569.     static CarlaPortCountInfo info;

  1570. 

  1571.     // reset

  1572.     info.ins   = 0;

  1573.     info.outs  = 0;

  1574. 

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

  1576. 

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

  1578.     {

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

  1580.         return &info;

  1581.     }

  1582. 

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

  1584.     return &info;

  1585. }

  1586. 

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

  1588. {

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

  1590. 

  1591.     static CarlaParameterInfo info;

  1592. 

  1593.     // reset

  1594.     info.scalePointCount = 0;

  1595. 

  1596.     // cleanup

  1597.     if (info.name != gNullCharPtr)

  1598.     {

  1599.         delete[] info.name;

  1600.         info.name = gNullCharPtr;

  1601.     }

  1602. 

  1603.     if (info.symbol != gNullCharPtr)

  1604.     {

  1605.         delete[] info.symbol;

  1606.         info.symbol = gNullCharPtr;

  1607.     }

  1608. 

  1609.     if (info.unit != gNullCharPtr)

  1610.     {

  1611.         delete[] info.unit;

  1612.         info.unit = gNullCharPtr;

  1613.     }

  1614. 

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

  1616. 

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

  1618.     {

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

  1620.         {

  1621.             char strBufName[STR_MAX+1];

  1622.             char strBufSymbol[STR_MAX+1];

  1623.             char strBufUnit[STR_MAX+1];

  1624. 

  1625.             carla_zeroChar(strBufName, STR_MAX+1);

  1626.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1627.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1628. 

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

  1630. 

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

  1632.             info.name = carla_strdup(strBufName);

  1633. 

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

  1635.             info.symbol = carla_strdup(strBufSymbol);

  1636. 

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

  1638.             info.unit = carla_strdup(strBufUnit);

  1639.         }

  1640.         else

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

  1642. 

  1643.         return &info;

  1644.     }

  1645. 

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

  1647.     return &info;

  1648. }

  1649. 

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

  1651. {

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

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

  1654. 

  1655.     static CarlaScalePointInfo info;

  1656. 

  1657.     // reset

  1658.     info.value = 0.0f;

  1659. 

  1660.     // cleanup

  1661.     if (info.label != gNullCharPtr)

  1662.     {

  1663.         delete[] info.label;

  1664.         info.label = gNullCharPtr;

  1665.     }

  1666. 

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

  1668. 

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

  1670.     {

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

  1672.         {

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

  1674.             {

  1675.                 char strBufLabel[STR_MAX+1];

  1676.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1677. 

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

  1679. 

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

  1681.                 info.label = carla_strdup(strBufLabel);

  1682.             }

  1683.             else

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

  1685.         }

  1686.         else

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

  1688. 

  1689.         return &info;

  1690.     }

  1691. 

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

  1693.     return &info;

  1694. }

  1695. 

  1696. // -------------------------------------------------------------------------------------------------------------------

  1697. 

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

  1699. {

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

  1701. 

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

  1703. 

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

  1705. 

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

  1707.     {

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

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

  1710. 

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

  1712.         return &fallbackParameterData;

  1713.     }

  1714. 

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

  1716.     return &fallbackParameterData;

  1717. }

  1718. 

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

  1720. {

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

  1722. 

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

  1724. 

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

  1726. 

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

  1728.     {

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

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

  1731. 

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

  1733.         return &fallbackParamRanges;

  1734.     }

  1735. 

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

  1737.     return &fallbackParamRanges;

  1738. }

  1739. 

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

  1741. {

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

  1743. 

  1744.     static MidiProgramData midiProgData;

  1745. 

  1746.     // reset

  1747.     midiProgData.bank    = 0;

  1748.     midiProgData.program = 0;

  1749.     midiProgData.name    = gNullCharPtr;

  1750. 

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

  1752. 

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

  1754.     {

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

  1756.         {

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

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

  1759.             checkStringPtr(midiProgData.name);

  1760.             return &midiProgData;

  1761.         }

  1762. 

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

  1764.         return &midiProgData;

  1765.     }

  1766. 

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

  1768.     return &midiProgData;

  1769. }

  1770. 

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

  1772. {

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

  1774. 

  1775.     static CustomData customData;

  1776. 

  1777.     // reset

  1778.     customData.type  = gNullCharPtr;

  1779.     customData.key   = gNullCharPtr;

  1780.     customData.value = gNullCharPtr;

  1781. 

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

  1783. 

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

  1785.     {

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

  1787.         {

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

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

  1790.             checkStringPtr(customData.type);

  1791.             checkStringPtr(customData.key);

  1792.             checkStringPtr(customData.value);

  1793.             return &customData;

  1794.         }

  1795. 

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

  1797.         return &customData;

  1798.     }

  1799. 

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

  1801.     return &customData;

  1802. }

  1803. 

  1804. const char* carla_get_chunk_data(uint pluginId)

  1805. {

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

  1807. 

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

  1809. 

  1810.     static CarlaString chunkData;

  1811. 

  1812.     // cleanup

  1813.     chunkData.clear();

  1814. 

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

  1816.     {

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

  1818.         {

  1819.             void* data = nullptr;

  1820.             const int32_t dataSize(plugin->getChunkData(&data));

  1821. 

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

  1823.             {

  1824.                 chunkData = QByteArray((char*)data, dataSize).toBase64().constData();

  1825. 

  1826.                 return chunkData;

  1827.             }

  1828.             else

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

  1830.         }

  1831.         else

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

  1833. 

  1834.         return nullptr;

  1835.     }

  1836. 

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

  1838.     return nullptr;

  1839. }

  1840. 

  1841. // -------------------------------------------------------------------------------------------------------------------

  1842. 

  1843. uint32_t carla_get_parameter_count(uint pluginId)

  1844. {

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

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

  1847. 

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

  1849.         return plugin->getParameterCount();

  1850. 

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

  1852.     return 0;

  1853. }

  1854. 

  1855. uint32_t carla_get_program_count(uint pluginId)

  1856. {

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

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

  1859. 

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

  1861.         return plugin->getProgramCount();

  1862. 

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

  1864.     return 0;

  1865. }

  1866. 

  1867. uint32_t carla_get_midi_program_count(uint pluginId)

  1868. {

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

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

  1871. 

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

  1873.         return plugin->getMidiProgramCount();

  1874. 

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

  1876.     return 0;

  1877. }

  1878. 

  1879. uint32_t carla_get_custom_data_count(uint pluginId)

  1880. {

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

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

  1883. 

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

  1885.         return plugin->getCustomDataCount();

  1886. 

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

  1888.     return 0;

  1889. }

  1890. 

  1891. // -------------------------------------------------------------------------------------------------------------------

  1892. 

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

  1894. {

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

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

  1897. 

  1898.     static char textBuf[STR_MAX+1];

  1899. 

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

  1901.     {

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

  1903.         {

  1904.             carla_zeroChar(textBuf, STR_MAX+1);

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

  1906.             return textBuf;

  1907.         }

  1908. 

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

  1910.         return nullptr;

  1911.     }

  1912. 

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

  1914.     return nullptr;

  1915. }

  1916. 

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

  1918. {

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

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

  1921. 

  1922.     static char programName[STR_MAX+1];

  1923. 

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

  1925.     {

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

  1927.         {

  1928.             carla_zeroChar(programName, STR_MAX+1);

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

  1930.             return programName;

  1931.         }

  1932. 

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

  1934.         return nullptr;

  1935.     }

  1936. 

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

  1938.     return nullptr;

  1939. }

  1940. 

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

  1942. {

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

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

  1945. 

  1946.     static char midiProgramName[STR_MAX+1];

  1947. 

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

  1949.     {

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

  1951.         {

  1952.             carla_zeroChar(midiProgramName, STR_MAX+1);

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

  1954.             return midiProgramName;

  1955.         }

  1956. 

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

  1958.         return nullptr;

  1959.     }

  1960. 

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

  1962.     return nullptr;

  1963. }

  1964. 

  1965. const char* carla_get_real_plugin_name(uint pluginId)

  1966. {

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

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

  1969. 

  1970.     static char realPluginName[STR_MAX+1];

  1971. 

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

  1973.     {

  1974.         carla_zeroChar(realPluginName, STR_MAX+1);

  1975.         plugin->getRealName(realPluginName);

  1976.         return realPluginName;

  1977.     }

  1978. 

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

  1980.     return nullptr;

  1981. }

  1982. 

  1983. // -------------------------------------------------------------------------------------------------------------------

  1984. 

  1985. int32_t carla_get_current_program_index(uint pluginId)

  1986. {

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

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

  1989. 

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

  1991.         return plugin->getCurrentProgram();

  1992. 

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

  1994.     return -1;

  1995. }

  1996. 

  1997. int32_t carla_get_current_midi_program_index(uint pluginId)

  1998. {

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

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

  2001. 

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

  2003.         return plugin->getCurrentMidiProgram();

  2004. 

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

  2006.     return -1;

  2007. }

  2008. 

  2009. // -------------------------------------------------------------------------------------------------------------------

  2010. 

  2011. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  2012. {

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

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

  2015. 

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

  2017.     {

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

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

  2020. 

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

  2022.         return 0.0f;

  2023.     }

  2024. 

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

  2026.     return 0.0f;

  2027. }

  2028. 

  2029. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  2030. {

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

  2032. 

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

  2034.     {

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

  2036.             return plugin->getParameterValue(parameterId);

  2037. 

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

  2039.         return 0.0f;

  2040.     }

  2041. 

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

  2043.     return 0.0f;

  2044. }

  2045. 

  2046. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  2047. {

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

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

  2050. 

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

  2052.         return plugin->getInternalParameterValue(parameterId);

  2053. 

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

  2055.     return 0.0f;

  2056. }

  2057. 

  2058. // -------------------------------------------------------------------------------------------------------------------

  2059. 

  2060. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  2061. {

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

  2063. 

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

  2065. }

  2066. 

  2067. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  2068. {

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

  2070. 

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

  2072. }

  2073. 

  2074. // -------------------------------------------------------------------------------------------------------------------

  2075. 

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

  2077. {

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

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

  2080. 

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

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

  2083. 

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

  2085. }

  2086. 

  2087. void carla_set_active(uint pluginId, bool onOff)

  2088. {

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

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

  2091. 

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

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

  2094. 

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

  2096. }

  2097. 

  2098. #ifndef BUILD_BRIDGE

  2099. void carla_set_drywet(uint pluginId, float value)

  2100. {

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

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

  2103. 

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

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

  2106. 

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

  2108. }

  2109. 

  2110. void carla_set_volume(uint pluginId, float value)

  2111. {

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

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

  2114. 

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

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

  2117. 

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

  2119. }

  2120. 

  2121. void carla_set_balance_left(uint pluginId, float value)

  2122. {

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

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

  2125. 

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

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

  2128. 

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

  2130. }

  2131. 

  2132. void carla_set_balance_right(uint pluginId, float value)

  2133. {

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

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

  2136. 

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

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

  2139. 

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

  2141. }

  2142. 

  2143. void carla_set_panning(uint pluginId, float value)

  2144. {

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

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

  2147. 

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

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

  2150. 

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

  2152. }

  2153. #endif

  2154. 

  2155. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  2156. {

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

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

  2159. 

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

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

  2162. 

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

  2164. }

  2165. 

  2166. // -------------------------------------------------------------------------------------------------------------------

  2167. 

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

  2169. {

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

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

  2172. 

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

  2174.     {

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

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

  2177. 

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

  2179.         return;

  2180.     }

  2181. 

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

  2183. }

  2184. 

  2185. #ifndef BUILD_BRIDGE

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

  2187. {

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

  2189.     CARLA_SAFE_ASSERT_RETURN(channel >= MAX_MIDI_CHANNELS,);

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

  2191. 

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

  2193.     {

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

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

  2196. 

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

  2198.         return;

  2199.     }

  2200. 

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

  2202. }

  2203. 

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

  2205. {

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

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

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

  2209. 

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

  2211.     {

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

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

  2214. 

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

  2216.         return;

  2217.     }

  2218. 

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

  2220. }

  2221. #endif

  2222. 

  2223. // -------------------------------------------------------------------------------------------------------------------

  2224. 

  2225. void carla_set_program(uint pluginId, uint32_t programId)

  2226. {

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

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

  2229. 

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

  2231.     {

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

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

  2234. 

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

  2236.         return;

  2237.     }

  2238. 

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

  2240. }

  2241. 

  2242. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2243. {

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

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

  2246. 

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

  2248.     {

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

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

  2251. 

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

  2253.         return;

  2254.     }

  2255. 

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

  2257. }

  2258. 

  2259. // -------------------------------------------------------------------------------------------------------------------

  2260. 

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

  2262. {

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

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

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

  2266.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  2268. 

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

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

  2271. 

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

  2273. }

  2274. 

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

  2276. {

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

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

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

  2280. 

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

  2282.     {

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

  2284.             return plugin->setChunkData(chunkData);

  2285. 

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

  2287.         return;

  2288.     }

  2289. 

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

  2291. }

  2292. 

  2293. // -------------------------------------------------------------------------------------------------------------------

  2294. 

  2295. void carla_prepare_for_save(uint pluginId)

  2296. {

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

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

  2299. 

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

  2301.         return plugin->prepareForSave();

  2302. 

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

  2304. }

  2305. 

  2306. void carla_reset_parameters(uint pluginId)

  2307. {

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

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

  2310. 

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

  2312.         return plugin->resetParameters();

  2313. 

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

  2315. }

  2316. 

  2317. void carla_randomize_parameters(uint pluginId)

  2318. {

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

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

  2321. 

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

  2323.         return plugin->randomizeParameters();

  2324. 

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

  2326. }

  2327. 

  2328. #ifndef BUILD_BRIDGE

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

  2330. {

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

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

  2333. 

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

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

  2336. 

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

  2338. }

  2339. #endif

  2340. 

  2341. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2342. {

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

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

  2345. 

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

  2347.         return plugin->showCustomUI(yesNo);

  2348. 

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

  2350. }

  2351. 

  2352. // -------------------------------------------------------------------------------------------------------------------

  2353. 

  2354. uint32_t carla_get_buffer_size()

  2355. {

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

  2357.     carla_debug("carla_get_buffer_size()");

  2358. 

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

  2360. }

  2361. 

  2362. double carla_get_sample_rate()

  2363. {

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

  2365.     carla_debug("carla_get_sample_rate()");

  2366. 

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

  2368. }

  2369. 

  2370. // -------------------------------------------------------------------------------------------------------------------

  2371. 

  2372. const char* carla_get_last_error()

  2373. {

  2374.     carla_debug("carla_get_last_error()");

  2375. 

  2376.     if (gStandalone.engine != nullptr)

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

  2378. 

  2379.     return gStandalone.lastError;

  2380. }

  2381. 

  2382. const char* carla_get_host_osc_url_tcp()

  2383. {

  2384.     carla_debug("carla_get_host_osc_url_tcp()");

  2385. 

  2386.     if (gStandalone.engine == nullptr)

  2387.     {

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

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

  2390.         return nullptr;

  2391.     }

  2392. 

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

  2394. }

  2395. 

  2396. const char* carla_get_host_osc_url_udp()

  2397. {

  2398.     carla_debug("carla_get_host_osc_url_udp()");

  2399. 

  2400.     if (gStandalone.engine == nullptr)

  2401.     {

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

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

  2404.         return nullptr;

  2405.     }

  2406. 

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

  2408. }

  2409. 

  2410. // -------------------------------------------------------------------------------------------------------------------

  2411. 

  2412. #ifdef WANT_DSSI

  2413. # include "CarlaDssiUtils.cpp"

  2414. #endif

  2415. 

  2416. #include "CarlaStateUtils.cpp"

  2417. 

  2418. #if 0

  2419. int main(int argc, char* argv[])

  2420. {

  2421.     return 0;

  2422. }

  2423. #endif

  2424. 

  2425. // -------------------------------------------------------------------------------------------------------------------