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

2417 lines
80KB
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. #include "CarlaThread.hpp"

  31. 

  32. #ifdef BUILD_BRIDGE

  33. # undef HAVE_JUCE_UI

  34. #endif

  35. 

  36. #ifdef HAVE_JUCE_UI

  37. # include "juce_gui_basics.h"

  38. using juce::initialiseJuce_GUI;

  39. using juce::shutdownJuce_GUI;

  40. using juce::MessageManager;

  41. using juce::Thread;

  42. #endif

  43. 

  44. namespace CB = CarlaBackend;

  45. using CB::EngineOptions;

  46. 

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

  48. // Juce Message Thread

  49. 

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

  51. 

  52. class JuceMessageThread : public Thread

  53. {

  54. public:

  55.     JuceMessageThread()

  56.       : 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(7);

  73. 

  74.         while (! fInitialised)

  75.             sleep(1);

  76.     }

  77. 

  78.     void stop()

  79.     {

  80.         signalThreadShouldExit();

  81.         waitForThreadToExit(5000);

  82.     }

  83. 

  84. protected:

  85.     void run() override

  86.     {

  87.         MessageManager* const msgMgr(MessageManager::getInstance());

  88.         CARLA_SAFE_ASSERT_RETURN(msgMgr != nullptr,);

  89. 

  90.         msgMgr->setCurrentThreadAsMessageThread();

  91.         fInitialised = true;

  92. 

  93.         while ((! threadShouldExit()) && MessageManager::getInstance()->runDispatchLoopUntil(250))

  94.         {}

  95. 

  96.         fInitialised = false;

  97.     }

  98. 

  99. private:

  100.     volatile bool fInitialised;

  101. 

  102.     CARLA_DECLARE_NON_COPY_CLASS(JuceMessageThread)

  103. };

  104. 

  105. #endif // defined(HAVE_JUCE_UI) && defined(CARLA_OS_LINUX)

  106. 

  107. // -------------------------------------------------------------------------------------------------------------------

  108. // Single, standalone engine

  109. 

  110. struct CarlaBackendStandalone {

  111.     CarlaEngine*       engine;

  112.     EngineCallbackFunc engineCallback;

  113.     void*              engineCallbackPtr;

  114.     EngineOptions      engineOptions;

  115. 

  116.     FileCallbackFunc fileCallback;

  117.     void*            fileCallbackPtr;

  118. 

  119.     CarlaString lastError;

  120. 

  121. #if defined(HAVE_JUCE_UI) && defined(CARLA_OS_LINUX)

  122.     JuceMessageThread juceMsgThread;

  123. #endif

  124. 

  125.     CarlaBackendStandalone()

  126.         : engine(nullptr),

  127.           engineCallback(nullptr),

  128.           engineCallbackPtr(nullptr),

  129.           fileCallback(nullptr),

  130.           fileCallbackPtr(nullptr)

  131.     {

  132. #ifdef BUILD_BRIDGE

  133.         engineOptions.processMode         = CB::ENGINE_PROCESS_MODE_BRIDGE;

  134.         engineOptions.transportMode       = CB::ENGINE_TRANSPORT_MODE_BRIDGE;

  135.         engineOptions.forceStereo         = false;

  136.         engineOptions.preferPluginBridges = false;

  137.         engineOptions.preferUiBridges     = false;

  138. #else

  139.         if (std::getenv("LADISH_APP_NAME") != nullptr || std::getenv("NSM_URL") != nullptr)

  140.             return;

  141. 

  142.         CarlaThread::setCurrentThreadName("Carla");

  143. #endif

  144.     }

  145. 

  146.     ~CarlaBackendStandalone()

  147.     {

  148.         CARLA_SAFE_ASSERT(engine == nullptr);

  149. #ifdef HAVE_JUCE_UI

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

  151. #endif

  152.     }

  153. 

  154. #ifdef HAVE_JUCE_UI

  155.     void init()

  156.     {

  157.         JUCE_AUTORELEASEPOOL

  158.         {

  159.             initialiseJuce_GUI();

  160. # ifdef CARLA_OS_LINUX

  161.             juceMsgThread.start();

  162. # else

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

  164.                 msgMgr->setCurrentThreadAsMessageThread();

  165. # endif

  166.         }

  167.     }

  168. 

  169.     void close()

  170.     {

  171.         JUCE_AUTORELEASEPOOL

  172.         {

  173. # ifdef CARLA_OS_LINUX

  174.             juceMsgThread.stop();

  175. # else

  176.             MessageManager::deleteInstance();

  177. # endif

  178.             shutdownJuce_GUI();

  179.         }

  180.     }

  181. 

  182. # ifndef CARLA_OS_LINUX

  183.     void idle()

  184.     {

  185.         JUCE_AUTORELEASEPOOL

  186.         {

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

  188.                 msgMgr->runDispatchLoopUntil(5);

  189.         }

  190.     }

  191. # endif

  192. #endif

  193. 

  194.     CARLA_PREVENT_HEAP_ALLOCATION

  195.     CARLA_DECLARE_NON_COPY_STRUCT(CarlaBackendStandalone)

  196. };

  197. 

  198. static CarlaBackendStandalone gStandalone;

  199. 

  200. // -------------------------------------------------------------------------------------------------------------------

  201. // NSM support

  202. 

  203. #define NSM_API_VERSION_MAJOR 1

  204. #define NSM_API_VERSION_MINOR 2

  205. 

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

  207. #define NSM_CLIENT_FEATURES ":switch:"

  208. 

  209. class CarlaNSM

  210. {

  211. public:

  212.     CarlaNSM() noexcept

  213.         : fOscServer(nullptr),

  214.           fHasBroadcast(false),

  215.           fHasShowHideUI(false) {}

  216. 

  217.     ~CarlaNSM()

  218.     {

  219.         if (fOscServer != nullptr)

  220.         {

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

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

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

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

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

  226.             lo_server_free(fOscServer);

  227.             fOscServer = nullptr;

  228.         }

  229.     }

  230. 

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

  232.     {

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

  234. 

  235.         if (NSM_URL == nullptr)

  236.             return;

  237. 

  238.         const lo_address addr = lo_address_new_from_url(NSM_URL);

  239. 

  240.         if (addr == nullptr)

  241.             return;

  242. 

  243.         const int proto = lo_address_get_protocol(addr);

  244. 

  245.         if (fOscServer == nullptr)

  246.         {

  247.             // create new OSC server

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

  249. 

  250.             // register message handlers and start OSC thread

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

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

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

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

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

  256.             // /nsm/client/session_is_loaded

  257.         }

  258. 

  259. #ifndef BUILD_ANSI_TEST

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

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

  262. #endif

  263. 

  264.         lo_address_free(addr);

  265.     }

  266. 

  267.     void idle() noexcept

  268.     {

  269.         if (fOscServer == nullptr)

  270.             return;

  271. 

  272.         for (;;)

  273.         {

  274.             try {

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

  276.                     break;

  277.             }

  278.             CARLA_SAFE_EXCEPTION_CONTINUE("NSM OSC idle")

  279.         }

  280.     }

  281. 

  282. protected:

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

  284.     {

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

  286. 

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

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

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

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

  291. 

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

  293. 

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

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

  296. 

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

  298. 

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

  300. 

  301.         return 0;

  302. 

  303. #ifndef DEBUG

  304.         // unused

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

  306. #endif

  307.     }

  308. 

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

  310.     {

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

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

  313. 

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

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

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

  317. 

  318.         if (! carla_is_engine_running())

  319.         {

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

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

  322. 

  323.             carla_engine_init("JACK", clientId);

  324.         }

  325.         else

  326.         {

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

  328. 

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

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

  331.         }

  332. 

  333.         fClientId = clientId;

  334. 

  335.         fProjectPath  = projectPath;

  336.         fProjectPath += ".carxp";

  337. 

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

  339. 

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

  341. 

  342. #ifndef BUILD_ANSI_TEST

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

  344. #endif

  345. 

  346. #if 0

  347.         if (fHasBroadcast)

  348.         {

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

  350. 

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

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

  353. 

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

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

  356. 

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

  358. 

  359.             std::free(url);

  360. 

  361.             carla_stdout("Broadcast sent!");

  362.         }

  363.         else

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

  365. #endif

  366. 

  367.         return 0;

  368. 

  369. #ifndef DEBUG

  370.         // unused

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

  372. #endif

  373.     }

  374. 

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

  376.     {

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

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

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

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

  381. 

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

  383. 

  384. #ifndef BUILD_ANSI_TEST

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

  386. #endif

  387. 

  388.         return 0;

  389. 

  390. #ifndef DEBUG

  391.         // unused

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

  393. #endif

  394.     }

  395. 

  396. #if 0

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

  398.     {

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

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

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

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

  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.         // Sample kit libraries

  587. #ifdef WANT_FLUIDSYNTH

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

  589. #endif

  590. #ifdef WANT_LINUXSAMPLER

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

  592. #endif

  593. 

  594. #ifdef WANT_NATIVE

  595.         // Internal plugins

  596. # ifdef HAVE_OPENGL

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

  598. # endif

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

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

  601. # ifdef WANT_AUDIOFILE

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

  603. # endif

  604. # ifdef WANT_MIDIFILE

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

  606. # endif

  607. # ifdef WANT_ZYNADDSUBFX

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

  609. #  ifdef WANT_ZYNADDSUBFX_UI

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

  611. #  endif

  612. # endif

  613. #endif

  614. 

  615.         // misc libs

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

  617. #ifdef WANT_LV2

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

  619. #endif

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

  621. 

  622.         // end

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

  624. 

  625.         // code snippets

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

  627.         text5 += "<ul>";

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

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

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

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

  632. 

  633. #ifdef WANT_LINUXSAMPLER

  634.         // LinuxSampler GPL exception

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

  636. #endif

  637. 

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

  639.     }

  640. 

  641.     return retText;

  642. }

  643. 

  644. const char* carla_get_supported_file_extensions()

  645. {

  646.     carla_debug("carla_get_supported_file_extensions()");

  647. 

  648.     static CarlaString retText;

  649. 

  650.     if (retText.isEmpty())

  651.     {

  652.         // Base types

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

  654. 

  655.         // Sample kits

  656. #ifdef WANT_FLUIDSYNTH

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

  658. #endif

  659. #ifdef WANT_LINUXSAMPLER

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

  661. #endif

  662. 

  663.         // Files provided by internal plugins

  664. #ifdef WANT_AUDIOFILE

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

  666. # ifdef HAVE_FFMPEG

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

  668. # endif

  669. #endif

  670. #ifdef WANT_MIDIFILE

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

  672. #endif

  673. 

  674.         // Plugin presets

  675. #ifdef WANT_ZYNADDSUBFX

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

  677. #endif

  678.     }

  679. 

  680.     return retText;

  681. }

  682. 

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

  684. 

  685. unsigned int carla_get_engine_driver_count()

  686. {

  687.     carla_debug("carla_get_engine_driver_count()");

  688. 

  689.     return CarlaEngine::getDriverCount();

  690. }

  691. 

  692. const char* carla_get_engine_driver_name(unsigned int index)

  693. {

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

  695. 

  696.     return CarlaEngine::getDriverName(index);

  697. }

  698. 

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

  700. {

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

  702. 

  703.     return CarlaEngine::getDriverDeviceNames(index);

  704. }

  705. 

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

  707. {

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

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

  710. 

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

  712.     {

  713.         static EngineDriverDeviceInfo devInfo;

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

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

  716. 

  717.         devInfo.hints       = ret->hints;

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

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

  720.         return &devInfo;

  721.     }

  722. 

  723.     return nullptr;

  724. }

  725. 

  726. // -------------------------------------------------------------------------------------------------------------------

  727. 

  728. unsigned int carla_get_internal_plugin_count()

  729. {

  730.     carla_debug("carla_get_internal_plugin_count()");

  731. 

  732. #ifdef WANT_NATIVE

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

  734. #else

  735.     return 0;

  736. #endif

  737. }

  738. 

  739. const CarlaNativePluginInfo* carla_get_internal_plugin_info(unsigned int index)

  740. {

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

  742. 

  743. #ifdef WANT_NATIVE

  744.     static CarlaNativePluginInfo info;

  745. 

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

  747. 

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

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

  750. 

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

  752.      info.hints    = 0x0;

  753. 

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

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

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

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

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

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

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

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

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

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

  764. 

  765.      info.audioIns  = nativePlugin->audioIns;

  766.      info.audioOuts = nativePlugin->audioOuts;

  767.      info.midiIns   = nativePlugin->midiIns;

  768.      info.midiOuts  = nativePlugin->midiOuts;

  769.      info.parameterIns  = nativePlugin->paramIns;

  770.      info.parameterOuts = nativePlugin->paramOuts;

  771. 

  772.      info.name      = nativePlugin->name;

  773.      info.label     = nativePlugin->label;

  774.      info.maker     = nativePlugin->maker;

  775.      info.copyright = nativePlugin->copyright;

  776. 

  777.      checkStringPtr(info.name);

  778.      checkStringPtr(info.label);

  779.      checkStringPtr(info.maker);

  780.      checkStringPtr(info.copyright);

  781. 

  782.     return &info;

  783. #else

  784.     return nullptr;

  785. 

  786.     // unused

  787.     (void)index;

  788. #endif

  789. }

  790. 

  791. // -------------------------------------------------------------------------------------------------------------------

  792. 

  793. const CarlaEngine* carla_get_engine()

  794. {

  795.     carla_debug("carla_get_engine()");

  796. 

  797.     return gStandalone.engine;

  798. }

  799. 

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

  801. 

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

  803. {

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

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

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

  807. 

  808.     if (gStandalone.engine != nullptr)

  809.     {

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

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

  812.         return false;

  813.     }

  814. 

  815. #ifdef CARLA_OS_WIN

  816.     carla_setenv("WINEASIO_CLIENT_NAME", clientName);

  817. #endif

  818. 

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

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

  821.     {

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

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

  824.     }

  825. 

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

  827. 

  828.     if (gStandalone.engine == nullptr)

  829.     {

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

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

  832.         return false;

  833.     }

  834. 

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

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

  837. 

  838. #ifdef BUILD_BRIDGE

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

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

  841. #else

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

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

  844. #endif

  845. 

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

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

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

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

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

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

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

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

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

  855. 

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

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

  858. 

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

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

  861. 

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

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

  864. 

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

  866.     {

  867.         char strBuf[STR_MAX+1];

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

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

  870.     }

  871.     else

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

  873. 

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

  875.     {

  876.         gStandalone.lastError = "No error";

  877. #ifdef HAVE_JUCE_UI

  878.         gStandalone.init();

  879. #endif

  880.         return true;

  881.     }

  882.     else

  883.     {

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

  885.         delete gStandalone.engine;

  886.         gStandalone.engine = nullptr;

  887.         return false;

  888.     }

  889. }

  890. 

  891. #ifdef BUILD_BRIDGE

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

  893. {

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

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

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

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

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

  899. 

  900.     if (gStandalone.engine != nullptr)

  901.     {

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

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

  904.         return false;

  905.     }

  906. 

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

  908. 

  909.     if (gStandalone.engine == nullptr)

  910.     {

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

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

  913.         return false;

  914.     }

  915. 

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

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

  918. 

  919.     // forced options for bridge mode

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

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

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

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

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

  925. 

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

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

  928. 

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

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

  931. 

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

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

  934. 

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

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

  937. 

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

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

  940. 

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

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

  943. 

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

  945.     {

  946.         gStandalone.lastError = "No error";

  947. #ifdef HAVE_JUCE_UI

  948.         gStandalone.init();

  949. #endif

  950.         return true;

  951.     }

  952.     else

  953.     {

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

  955.         delete gStandalone.engine;

  956.         gStandalone.engine = nullptr;

  957.         return false;

  958.     }

  959. }

  960. #endif

  961. 

  962. bool carla_engine_close()

  963. {

  964.     carla_debug("carla_engine_close()");

  965. 

  966.     if (gStandalone.engine == nullptr)

  967.     {

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

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

  970.         return false;

  971.     }

  972. 

  973.     gStandalone.engine->setAboutToClose();

  974.     gStandalone.engine->removeAllPlugins();

  975. 

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

  977. 

  978.     if (! closed)

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

  980. 

  981. #ifdef HAVE_JUCE_UI

  982.     gStandalone.close();

  983. #endif

  984. 

  985.     delete gStandalone.engine;

  986.     gStandalone.engine = nullptr;

  987. 

  988.     return closed;

  989. }

  990. 

  991. void carla_engine_idle()

  992. {

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

  994. 

  995.     gNSM.idle();

  996. #if defined(HAVE_JUCE_UI) && ! defined(CARLA_OS_LINUX)

  997.     gStandalone.idle();

  998. #endif

  999.     gStandalone.engine->idle();

  1000. }

  1001. 

  1002. bool carla_is_engine_running()

  1003. {

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

  1005. }

  1006. 

  1007. void carla_set_engine_about_to_close()

  1008. {

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

  1010.     carla_debug("carla_set_engine_about_to_close()");

  1011. 

  1012.     gStandalone.engine->setAboutToClose();

  1013. }

  1014. 

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

  1016. {

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

  1018. 

  1019.     gStandalone.engineCallback    = func;

  1020.     gStandalone.engineCallbackPtr = ptr;

  1021. 

  1022.     if (gStandalone.engine != nullptr)

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

  1024. 

  1025. //#ifdef WANT_LOGS

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

  1027. //#endif

  1028. }

  1029. 

  1030. #ifndef BUILD_BRIDGE

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

  1032. {

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

  1034. 

  1035.     switch (option)

  1036.     {

  1037.     case CB::ENGINE_OPTION_DEBUG:

  1038.         break;

  1039. 

  1040.     case CB::ENGINE_OPTION_PROCESS_MODE:

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

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

  1043.         break;

  1044. 

  1045.     case CB::ENGINE_OPTION_TRANSPORT_MODE:

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

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

  1048.         break;

  1049. 

  1050.     case CB::ENGINE_OPTION_FORCE_STEREO:

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

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

  1053.         break;

  1054. 

  1055.     case CB::ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

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

  1058.         break;

  1059. 

  1060.     case CB::ENGINE_OPTION_PREFER_UI_BRIDGES:

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

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

  1063.         break;

  1064. 

  1065.     case CB::ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

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

  1068.         break;

  1069. 

  1070.     case CB::ENGINE_OPTION_MAX_PARAMETERS:

  1071.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1073.         break;

  1074. 

  1075.     case CB::ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  1076.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

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

  1078.         break;

  1079. 

  1080.     case CB::ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

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

  1083.         break;

  1084. 

  1085.     case CB::ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  1086.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

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

  1088.         break;

  1089. 

  1090.     case CB::ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  1091.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

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

  1093.         break;

  1094. 

  1095.     case CB::ENGINE_OPTION_AUDIO_DEVICE:

  1096.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1097. 

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

  1099.             delete[] gStandalone.engineOptions.audioDevice;

  1100. 

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

  1102.         break;

  1103. 

  1104.     case CB:: ENGINE_OPTION_NSM_INIT:

  1105.         CARLA_SAFE_ASSERT_RETURN(value != 0,);

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

  1107.         gNSM.announce(value, valueStr);

  1108.         break;

  1109. 

  1110.     case CB::ENGINE_OPTION_PATH_BINARIES:

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

  1112. 

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

  1114.             delete[] gStandalone.engineOptions.binaryDir;

  1115. 

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

  1117.         break;

  1118. 

  1119.     case CB::ENGINE_OPTION_PATH_RESOURCES:

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

  1121. 

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

  1123.             delete[] gStandalone.engineOptions.resourceDir;

  1124. 

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

  1126.         break;

  1127. 

  1128.     case CB::ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  1131.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

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

  1133.         break;

  1134.     }

  1135. 

  1136.     if (gStandalone.engine != nullptr)

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

  1138. }

  1139. #endif

  1140. 

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

  1142. {

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

  1144. 

  1145.     gStandalone.fileCallback    = func;

  1146.     gStandalone.fileCallbackPtr = ptr;

  1147. 

  1148.     if (gStandalone.engine != nullptr)

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

  1150. }

  1151. 

  1152. // -------------------------------------------------------------------------------------------------------------------

  1153. 

  1154. bool carla_load_file(const char* filename)

  1155. {

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

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

  1158. 

  1159.     if (gStandalone.engine != nullptr)

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

  1161. 

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

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

  1164.     return false;

  1165. }

  1166. 

  1167. bool carla_load_project(const char* filename)

  1168. {

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

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

  1171. 

  1172.     if (gStandalone.engine != nullptr)

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

  1174. 

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

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

  1177.     return false;

  1178. }

  1179. 

  1180. bool carla_save_project(const char* filename)

  1181. {

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

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

  1184. 

  1185.     if (gStandalone.engine != nullptr)

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

  1187. 

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

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

  1190.     return false;

  1191. }

  1192. 

  1193. #ifndef BUILD_BRIDGE

  1194. // -------------------------------------------------------------------------------------------------------------------

  1195. 

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

  1197. {

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

  1199. 

  1200.     if (gStandalone.engine != nullptr)

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

  1202. 

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

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

  1205.     return false;

  1206. }

  1207. 

  1208. bool carla_patchbay_disconnect(uint connectionId)

  1209. {

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

  1211. 

  1212.     if (gStandalone.engine != nullptr)

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

  1214. 

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

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

  1217.     return false;

  1218. }

  1219. 

  1220. bool carla_patchbay_refresh()

  1221. {

  1222.     carla_debug("carla_patchbay_refresh()");

  1223. 

  1224.     if (gStandalone.engine != nullptr)

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

  1226. 

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

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

  1229.     return false;

  1230. }

  1231. #endif

  1232. 

  1233. // -------------------------------------------------------------------------------------------------------------------

  1234. 

  1235. void carla_transport_play()

  1236. {

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

  1238.     carla_debug("carla_transport_play()");

  1239. 

  1240.     gStandalone.engine->transportPlay();

  1241. }

  1242. 

  1243. void carla_transport_pause()

  1244. {

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

  1246.     carla_debug("carla_transport_pause()");

  1247. 

  1248.     gStandalone.engine->transportPause();

  1249. }

  1250. 

  1251. void carla_transport_relocate(uint64_t frame)

  1252. {

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

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

  1255. 

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

  1257. }

  1258. 

  1259. uint64_t carla_get_current_transport_frame()

  1260. {

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

  1262. 

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

  1264.     return timeInfo.frame;

  1265. }

  1266. 

  1267. const CarlaTransportInfo* carla_get_transport_info()

  1268. {

  1269.     static CarlaTransportInfo retInfo;

  1270. 

  1271.     // reset

  1272.     retInfo.playing = false;

  1273.     retInfo.frame   = 0;

  1274.     retInfo.bar     = 0;

  1275.     retInfo.beat    = 0;

  1276.     retInfo.tick    = 0;

  1277.     retInfo.bpm     = 0.0;

  1278. 

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

  1280. 

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

  1282. 

  1283.     retInfo.playing = timeInfo.playing;

  1284.     retInfo.frame   = timeInfo.frame;

  1285. 

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

  1287.     {

  1288.         retInfo.bar  = timeInfo.bbt.bar;

  1289.         retInfo.beat = timeInfo.bbt.beat;

  1290.         retInfo.tick = timeInfo.bbt.tick;

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

  1292.     }

  1293. 

  1294.     return &retInfo;

  1295. }

  1296. 

  1297. // -------------------------------------------------------------------------------------------------------------------

  1298. 

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

  1300. {

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

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

  1303. 

  1304.     if (gStandalone.engine != nullptr)

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

  1306. 

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

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

  1309.     return false;

  1310. }

  1311. 

  1312. bool carla_remove_plugin(uint pluginId)

  1313. {

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

  1315. 

  1316.     if (gStandalone.engine != nullptr)

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

  1318. 

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

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

  1321.     return false;

  1322. }

  1323. 

  1324. bool carla_remove_all_plugins()

  1325. {

  1326.     carla_debug("carla_remove_all_plugins()");

  1327. 

  1328.     if (gStandalone.engine != nullptr)

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

  1330. 

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

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

  1333.     return false;

  1334. }

  1335. 

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

  1337. {

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

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

  1340. 

  1341.     if (gStandalone.engine != nullptr)

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

  1343. 

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

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

  1346.     return nullptr;

  1347. }

  1348. 

  1349. bool carla_clone_plugin(uint pluginId)

  1350. {

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

  1352. 

  1353.     if (gStandalone.engine != nullptr)

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

  1355. 

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

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

  1358.     return false;

  1359. }

  1360. 

  1361. bool carla_replace_plugin(uint pluginId)

  1362. {

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

  1364. 

  1365.     if (gStandalone.engine != nullptr)

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

  1367. 

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

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

  1370.     return false;

  1371. }

  1372. 

  1373. bool carla_switch_plugins(uint pluginIdA, uint pluginIdB)

  1374. {

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

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

  1377. 

  1378.     if (gStandalone.engine != nullptr)

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

  1380. 

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

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

  1383.     return false;

  1384. }

  1385. 

  1386. // -------------------------------------------------------------------------------------------------------------------

  1387. 

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

  1389. {

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

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

  1392. 

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

  1394.     {

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

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

  1397.         return false;

  1398.     }

  1399. 

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

  1401.         return plugin->loadStateFromFile(filename);

  1402. 

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

  1404.     return false;

  1405. }

  1406. 

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

  1408. {

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

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

  1411. 

  1412.     if (gStandalone.engine == nullptr)

  1413.     {

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

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

  1416.         return false;

  1417.     }

  1418. 

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

  1420. 

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

  1422.         return plugin->saveStateToFile(filename);

  1423. 

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

  1425.     return false;

  1426. }

  1427. 

  1428. // -------------------------------------------------------------------------------------------------------------------

  1429. 

  1430. const CarlaPluginInfo* carla_get_plugin_info(uint pluginId)

  1431. {

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

  1433. 

  1434.     static CarlaPluginInfo info;

  1435. 

  1436.     // reset

  1437.     info.type             = CB::PLUGIN_NONE;

  1438.     info.category         = CB::PLUGIN_CATEGORY_NONE;

  1439.     info.hints            = 0x0;

  1440.     info.optionsAvailable = 0x0;

  1441.     info.optionsEnabled   = 0x0;

  1442.     info.filename         = gNullCharPtr;

  1443.     info.name             = gNullCharPtr;

  1444.     info.iconName         = gNullCharPtr;

  1445.     info.uniqueId         = 0;

  1446. 

  1447.     // cleanup

  1448.     if (info.label != gNullCharPtr)

  1449.     {

  1450.         delete[] info.label;

  1451.         info.label = gNullCharPtr;

  1452.     }

  1453. 

  1454.     if (info.maker != gNullCharPtr)

  1455.     {

  1456.         delete[] info.maker;

  1457.         info.maker = gNullCharPtr;

  1458.     }

  1459. 

  1460.     if (info.copyright != gNullCharPtr)

  1461.     {

  1462.         delete[] info.copyright;

  1463.         info.copyright = gNullCharPtr;

  1464.     }

  1465. 

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

  1467. 

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

  1469.     {

  1470.         char strBufLabel[STR_MAX+1];

  1471.         char strBufMaker[STR_MAX+1];

  1472.         char strBufCopyright[STR_MAX+1];

  1473. 

  1474.         carla_zeroChar(strBufLabel, STR_MAX+1);

  1475.         carla_zeroChar(strBufMaker, STR_MAX+1);

  1476.         carla_zeroChar(strBufCopyright, STR_MAX+1);

  1477. 

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

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

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

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

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

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

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

  1485. 

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

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

  1488. 

  1489.         plugin->getLabel(strBufLabel);

  1490.         info.label = carla_strdup(strBufLabel);

  1491. 

  1492.         plugin->getMaker(strBufMaker);

  1493.         info.maker = carla_strdup(strBufMaker);

  1494. 

  1495.         plugin->getCopyright(strBufCopyright);

  1496.         info.copyright = carla_strdup(strBufCopyright);

  1497. 

  1498.         checkStringPtr(info.filename);

  1499.         checkStringPtr(info.name);

  1500.         checkStringPtr(info.iconName);

  1501. 

  1502.         return &info;

  1503.     }

  1504. 

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

  1506.     return &info;

  1507. }

  1508. 

  1509. const CarlaPortCountInfo* carla_get_audio_port_count_info(uint pluginId)

  1510. {

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

  1512. 

  1513.     static CarlaPortCountInfo info;

  1514. 

  1515.     // reset

  1516.     info.ins   = 0;

  1517.     info.outs  = 0;

  1518. 

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

  1520. 

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

  1522.     {

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

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

  1525.         return &info;

  1526.     }

  1527. 

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

  1529.     return &info;

  1530. }

  1531. 

  1532. const CarlaPortCountInfo* carla_get_midi_port_count_info(uint pluginId)

  1533. {

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

  1535. 

  1536.     static CarlaPortCountInfo info;

  1537. 

  1538.     // reset

  1539.     info.ins   = 0;

  1540.     info.outs  = 0;

  1541. 

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

  1543. 

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

  1545.     {

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

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

  1548.         return &info;

  1549.     }

  1550. 

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

  1552.     return &info;

  1553. }

  1554. 

  1555. const CarlaPortCountInfo* carla_get_parameter_count_info(uint pluginId)

  1556. {

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

  1558. 

  1559.     static CarlaPortCountInfo info;

  1560. 

  1561.     // reset

  1562.     info.ins   = 0;

  1563.     info.outs  = 0;

  1564. 

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

  1566. 

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

  1568.     {

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

  1570.         return &info;

  1571.     }

  1572. 

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

  1574.     return &info;

  1575. }

  1576. 

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

  1578. {

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

  1580. 

  1581.     static CarlaParameterInfo info;

  1582. 

  1583.     // reset

  1584.     info.scalePointCount = 0;

  1585. 

  1586.     // cleanup

  1587.     if (info.name != gNullCharPtr)

  1588.     {

  1589.         delete[] info.name;

  1590.         info.name = gNullCharPtr;

  1591.     }

  1592. 

  1593.     if (info.symbol != gNullCharPtr)

  1594.     {

  1595.         delete[] info.symbol;

  1596.         info.symbol = gNullCharPtr;

  1597.     }

  1598. 

  1599.     if (info.unit != gNullCharPtr)

  1600.     {

  1601.         delete[] info.unit;

  1602.         info.unit = gNullCharPtr;

  1603.     }

  1604. 

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

  1606. 

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

  1608.     {

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

  1610.         {

  1611.             char strBufName[STR_MAX+1];

  1612.             char strBufSymbol[STR_MAX+1];

  1613.             char strBufUnit[STR_MAX+1];

  1614. 

  1615.             carla_zeroChar(strBufName, STR_MAX+1);

  1616.             carla_zeroChar(strBufSymbol, STR_MAX+1);

  1617.             carla_zeroChar(strBufUnit, STR_MAX+1);

  1618. 

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

  1620. 

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

  1622.             info.name = carla_strdup(strBufName);

  1623. 

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

  1625.             info.symbol = carla_strdup(strBufSymbol);

  1626. 

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

  1628.             info.unit = carla_strdup(strBufUnit);

  1629.         }

  1630.         else

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

  1632. 

  1633.         return &info;

  1634.     }

  1635. 

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

  1637.     return &info;

  1638. }

  1639. 

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

  1641. {

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

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

  1644. 

  1645.     static CarlaScalePointInfo info;

  1646. 

  1647.     // reset

  1648.     info.value = 0.0f;

  1649. 

  1650.     // cleanup

  1651.     if (info.label != gNullCharPtr)

  1652.     {

  1653.         delete[] info.label;

  1654.         info.label = gNullCharPtr;

  1655.     }

  1656. 

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

  1658. 

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

  1660.     {

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

  1662.         {

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

  1664.             {

  1665.                 char strBufLabel[STR_MAX+1];

  1666.                 carla_zeroChar(strBufLabel, STR_MAX+1);

  1667. 

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

  1669. 

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

  1671.                 info.label = carla_strdup(strBufLabel);

  1672.             }

  1673.             else

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

  1675.         }

  1676.         else

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

  1678. 

  1679.         return &info;

  1680.     }

  1681. 

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

  1683.     return &info;

  1684. }

  1685. 

  1686. // -------------------------------------------------------------------------------------------------------------------

  1687. 

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

  1689. {

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

  1691. 

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

  1693. 

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

  1695. 

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

  1697.     {

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

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

  1700. 

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

  1702.         return &fallbackParameterData;

  1703.     }

  1704. 

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

  1706.     return &fallbackParameterData;

  1707. }

  1708. 

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

  1710. {

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

  1712. 

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

  1714. 

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

  1716. 

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

  1718.     {

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

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

  1721. 

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

  1723.         return &fallbackParamRanges;

  1724.     }

  1725. 

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

  1727.     return &fallbackParamRanges;

  1728. }

  1729. 

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

  1731. {

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

  1733. 

  1734.     static MidiProgramData midiProgData;

  1735. 

  1736.     // reset

  1737.     midiProgData.bank    = 0;

  1738.     midiProgData.program = 0;

  1739.     midiProgData.name    = gNullCharPtr;

  1740. 

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

  1742. 

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

  1744.     {

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

  1746.         {

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

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

  1749.             checkStringPtr(midiProgData.name);

  1750.             return &midiProgData;

  1751.         }

  1752. 

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

  1754.         return &midiProgData;

  1755.     }

  1756. 

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

  1758.     return &midiProgData;

  1759. }

  1760. 

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

  1762. {

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

  1764. 

  1765.     static CustomData customData;

  1766. 

  1767.     // reset

  1768.     customData.type  = gNullCharPtr;

  1769.     customData.key   = gNullCharPtr;

  1770.     customData.value = gNullCharPtr;

  1771. 

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

  1773. 

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

  1775.     {

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

  1777.         {

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

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

  1780.             checkStringPtr(customData.type);

  1781.             checkStringPtr(customData.key);

  1782.             checkStringPtr(customData.value);

  1783.             return &customData;

  1784.         }

  1785. 

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

  1787.         return &customData;

  1788.     }

  1789. 

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

  1791.     return &customData;

  1792. }

  1793. 

  1794. const char* carla_get_chunk_data(uint pluginId)

  1795. {

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

  1797. 

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

  1799. 

  1800.     static CarlaString chunkData;

  1801. 

  1802.     // cleanup

  1803.     chunkData.clear();

  1804. 

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

  1806.     {

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

  1808.         {

  1809.             void* data = nullptr;

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

  1811. 

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

  1813.             {

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

  1815. 

  1816.                 return chunkData;

  1817.             }

  1818.             else

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

  1820.         }

  1821.         else

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

  1823. 

  1824.         return nullptr;

  1825.     }

  1826. 

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

  1828.     return nullptr;

  1829. }

  1830. 

  1831. // -------------------------------------------------------------------------------------------------------------------

  1832. 

  1833. uint32_t carla_get_parameter_count(uint pluginId)

  1834. {

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

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

  1837. 

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

  1839.         return plugin->getParameterCount();

  1840. 

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

  1842.     return 0;

  1843. }

  1844. 

  1845. uint32_t carla_get_program_count(uint pluginId)

  1846. {

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

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

  1849. 

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

  1851.         return plugin->getProgramCount();

  1852. 

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

  1854.     return 0;

  1855. }

  1856. 

  1857. uint32_t carla_get_midi_program_count(uint pluginId)

  1858. {

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

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

  1861. 

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

  1863.         return plugin->getMidiProgramCount();

  1864. 

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

  1866.     return 0;

  1867. }

  1868. 

  1869. uint32_t carla_get_custom_data_count(uint pluginId)

  1870. {

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

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

  1873. 

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

  1875.         return plugin->getCustomDataCount();

  1876. 

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

  1878.     return 0;

  1879. }

  1880. 

  1881. // -------------------------------------------------------------------------------------------------------------------

  1882. 

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

  1884. {

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

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

  1887. 

  1888.     static char textBuf[STR_MAX+1];

  1889. 

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

  1891.     {

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

  1893.         {

  1894.             carla_zeroChar(textBuf, STR_MAX+1);

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

  1896.             return textBuf;

  1897.         }

  1898. 

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

  1900.         return nullptr;

  1901.     }

  1902. 

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

  1904.     return nullptr;

  1905. }

  1906. 

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

  1908. {

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

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

  1911. 

  1912.     static char programName[STR_MAX+1];

  1913. 

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

  1915.     {

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

  1917.         {

  1918.             carla_zeroChar(programName, STR_MAX+1);

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

  1920.             return programName;

  1921.         }

  1922. 

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

  1924.         return nullptr;

  1925.     }

  1926. 

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

  1928.     return nullptr;

  1929. }

  1930. 

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

  1932. {

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

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

  1935. 

  1936.     static char midiProgramName[STR_MAX+1];

  1937. 

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

  1939.     {

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

  1941.         {

  1942.             carla_zeroChar(midiProgramName, STR_MAX+1);

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

  1944.             return midiProgramName;

  1945.         }

  1946. 

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

  1948.         return nullptr;

  1949.     }

  1950. 

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

  1952.     return nullptr;

  1953. }

  1954. 

  1955. const char* carla_get_real_plugin_name(uint pluginId)

  1956. {

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

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

  1959. 

  1960.     static char realPluginName[STR_MAX+1];

  1961. 

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

  1963.     {

  1964.         carla_zeroChar(realPluginName, STR_MAX+1);

  1965.         plugin->getRealName(realPluginName);

  1966.         return realPluginName;

  1967.     }

  1968. 

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

  1970.     return nullptr;

  1971. }

  1972. 

  1973. // -------------------------------------------------------------------------------------------------------------------

  1974. 

  1975. int32_t carla_get_current_program_index(uint pluginId)

  1976. {

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

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

  1979. 

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

  1981.         return plugin->getCurrentProgram();

  1982. 

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

  1984.     return -1;

  1985. }

  1986. 

  1987. int32_t carla_get_current_midi_program_index(uint pluginId)

  1988. {

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

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

  1991. 

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

  1993.         return plugin->getCurrentMidiProgram();

  1994. 

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

  1996.     return -1;

  1997. }

  1998. 

  1999. // -------------------------------------------------------------------------------------------------------------------

  2000. 

  2001. float carla_get_default_parameter_value(uint pluginId, uint32_t parameterId)

  2002. {

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

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

  2005. 

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

  2007.     {

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

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

  2010. 

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

  2012.         return 0.0f;

  2013.     }

  2014. 

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

  2016.     return 0.0f;

  2017. }

  2018. 

  2019. float carla_get_current_parameter_value(uint pluginId, uint32_t parameterId)

  2020. {

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

  2022. 

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

  2024.     {

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

  2026.             return plugin->getParameterValue(parameterId);

  2027. 

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

  2029.         return 0.0f;

  2030.     }

  2031. 

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

  2033.     return 0.0f;

  2034. }

  2035. 

  2036. float carla_get_internal_parameter_value(uint pluginId, int32_t parameterId)

  2037. {

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

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

  2040. 

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

  2042.         return plugin->getInternalParameterValue(parameterId);

  2043. 

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

  2045.     return 0.0f;

  2046. }

  2047. 

  2048. // -------------------------------------------------------------------------------------------------------------------

  2049. 

  2050. float carla_get_input_peak_value(uint pluginId, bool isLeft)

  2051. {

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

  2053. 

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

  2055. }

  2056. 

  2057. float carla_get_output_peak_value(uint pluginId, bool isLeft)

  2058. {

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

  2060. 

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

  2062. }

  2063. 

  2064. // -------------------------------------------------------------------------------------------------------------------

  2065. 

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

  2067. {

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

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

  2070. 

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

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

  2073. 

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

  2075. }

  2076. 

  2077. void carla_set_active(uint pluginId, bool onOff)

  2078. {

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

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

  2081. 

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

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

  2084. 

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

  2086. }

  2087. 

  2088. #ifndef BUILD_BRIDGE

  2089. void carla_set_drywet(uint pluginId, float value)

  2090. {

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

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

  2093. 

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

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

  2096. 

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

  2098. }

  2099. 

  2100. void carla_set_volume(uint pluginId, float value)

  2101. {

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

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

  2104. 

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

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

  2107. 

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

  2109. }

  2110. 

  2111. void carla_set_balance_left(uint pluginId, float value)

  2112. {

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

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

  2115. 

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

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

  2118. 

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

  2120. }

  2121. 

  2122. void carla_set_balance_right(uint pluginId, float value)

  2123. {

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

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

  2126. 

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

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

  2129. 

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

  2131. }

  2132. 

  2133. void carla_set_panning(uint pluginId, float value)

  2134. {

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

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

  2137. 

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

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

  2140. 

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

  2142. }

  2143. #endif

  2144. 

  2145. void carla_set_ctrl_channel(uint pluginId, int8_t channel)

  2146. {

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

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

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

  2150. 

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

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

  2153. 

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

  2155. }

  2156. 

  2157. // -------------------------------------------------------------------------------------------------------------------

  2158. 

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

  2160. {

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

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

  2163. 

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

  2165.     {

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

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

  2168. 

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

  2170.         return;

  2171.     }

  2172. 

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

  2174. }

  2175. 

  2176. #ifndef BUILD_BRIDGE

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

  2178. {

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

  2180.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

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

  2182. 

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

  2184.     {

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

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

  2187. 

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

  2189.         return;

  2190.     }

  2191. 

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

  2193. }

  2194. 

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

  2196. {

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

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

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

  2200. 

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

  2202.     {

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

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

  2205. 

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

  2207.         return;

  2208.     }

  2209. 

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

  2211. }

  2212. #endif

  2213. 

  2214. // -------------------------------------------------------------------------------------------------------------------

  2215. 

  2216. void carla_set_program(uint pluginId, uint32_t programId)

  2217. {

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

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

  2220. 

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

  2222.     {

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

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

  2225. 

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

  2227.         return;

  2228.     }

  2229. 

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

  2231. }

  2232. 

  2233. void carla_set_midi_program(uint pluginId, uint32_t midiProgramId)

  2234. {

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

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

  2237. 

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

  2239.     {

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

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

  2242. 

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

  2244.         return;

  2245.     }

  2246. 

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

  2248. }

  2249. 

  2250. // -------------------------------------------------------------------------------------------------------------------

  2251. 

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

  2253. {

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

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

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

  2257.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

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

  2259. 

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

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

  2262. 

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

  2264. }

  2265. 

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

  2267. {

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

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

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

  2271. 

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

  2273.     {

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

  2275.             return plugin->setChunkData(chunkData);

  2276. 

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

  2278.         return;

  2279.     }

  2280. 

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

  2282. }

  2283. 

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

  2285. 

  2286. void carla_prepare_for_save(uint pluginId)

  2287. {

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

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

  2290. 

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

  2292.         return plugin->prepareForSave();

  2293. 

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

  2295. }

  2296. 

  2297. void carla_reset_parameters(uint pluginId)

  2298. {

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

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

  2301. 

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

  2303.         return plugin->resetParameters();

  2304. 

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

  2306. }

  2307. 

  2308. void carla_randomize_parameters(uint pluginId)

  2309. {

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

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

  2312. 

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

  2314.         return plugin->randomizeParameters();

  2315. 

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

  2317. }

  2318. 

  2319. #ifndef BUILD_BRIDGE

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

  2321. {

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

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

  2324. 

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

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

  2327. 

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

  2329. }

  2330. #endif

  2331. 

  2332. void carla_show_custom_ui(uint pluginId, bool yesNo)

  2333. {

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

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

  2336. 

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

  2338.         return plugin->showCustomUI(yesNo);

  2339. 

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

  2341. }

  2342. 

  2343. // -------------------------------------------------------------------------------------------------------------------

  2344. 

  2345. uint32_t carla_get_buffer_size()

  2346. {

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

  2348.     carla_debug("carla_get_buffer_size()");

  2349. 

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

  2351. }

  2352. 

  2353. double carla_get_sample_rate()

  2354. {

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

  2356.     carla_debug("carla_get_sample_rate()");

  2357. 

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

  2359. }

  2360. 

  2361. // -------------------------------------------------------------------------------------------------------------------

  2362. 

  2363. const char* carla_get_last_error()

  2364. {

  2365.     carla_debug("carla_get_last_error()");

  2366. 

  2367.     if (gStandalone.engine != nullptr)

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

  2369. 

  2370.     return gStandalone.lastError;

  2371. }

  2372. 

  2373. const char* carla_get_host_osc_url_tcp()

  2374. {

  2375.     carla_debug("carla_get_host_osc_url_tcp()");

  2376. 

  2377.     if (gStandalone.engine == nullptr)

  2378.     {

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

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

  2381.         return nullptr;

  2382.     }

  2383. 

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

  2385. }

  2386. 

  2387. const char* carla_get_host_osc_url_udp()

  2388. {

  2389.     carla_debug("carla_get_host_osc_url_udp()");

  2390. 

  2391.     if (gStandalone.engine == nullptr)

  2392.     {

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

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

  2395.         return nullptr;

  2396.     }

  2397. 

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

  2399. }

  2400. 

  2401. // -------------------------------------------------------------------------------------------------------------------

  2402. 

  2403. #ifdef WANT_DSSI

  2404. # include "CarlaDssiUtils.cpp"

  2405. #endif

  2406. 

  2407. #include "CarlaStateUtils.cpp"

  2408. 

  2409. #if 0

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

  2411. {

  2412.     return 0;

  2413. }

  2414. #endif

  2415. 

  2416. // -------------------------------------------------------------------------------------------------------------------