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.
2099 Commits
16 Branches
14GB
Tree: 04c5ea9a27
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '04c5ea9a27'
${ noResults }
Carla/source/backend/engine/CarlaEngine.cpp

1599 lines
50KB
Raw Blame History 

  1. /*

  2.  * Carla Plugin Host

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

  4.  *

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

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

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

  8.  * the License, or any later version.

  9.  *

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

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

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

  13.  * GNU General Public License for more details.

  14.  *

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

  16.  */

  17. 

  18. /* TODO:

  19.  * - complete processRack(): carefully add to input, sorted events

  20.  * - implement processPatchbay()

  21.  * - implement oscSend_control_switch_plugins()

  22.  * - proper find&load plugins

  23.  * - something about the peaks?

  24.  */

  25. 

  26. #include "CarlaEngineInternal.hpp"

  27. #include "CarlaPlugin.hpp"

  28. 

  29. #include "CarlaBackendUtils.hpp"

  30. #include "CarlaBinaryUtils.hpp"

  31. #include "CarlaEngineUtils.hpp"

  32. #include "CarlaMathUtils.hpp"

  33. #include "CarlaStateUtils.hpp"

  34. #include "CarlaMIDI.h"

  35. 

  36. #include "jackbridge/JackBridge.hpp"

  37. #include "juce_core.h"

  38. 

  39. using juce::File;

  40. using juce::MemoryOutputStream;

  41. using juce::ScopedPointer;

  42. using juce::String;

  43. using juce::XmlDocument;

  44. using juce::XmlElement;

  45. 

  46. CARLA_BACKEND_START_NAMESPACE

  47. 

  48. // -----------------------------------------------------------------------

  49. // Carla Engine

  50. 

  51. CarlaEngine::CarlaEngine()

  52.     : pData(new ProtectedData(this))

  53. {

  54.     carla_debug("CarlaEngine::CarlaEngine()");

  55. }

  56. 

  57. CarlaEngine::~CarlaEngine()

  58. {

  59.     carla_debug("CarlaEngine::~CarlaEngine()");

  60. 

  61.     delete pData;

  62. }

  63. 

  64. // -----------------------------------------------------------------------

  65. // Static calls

  66. 

  67. uint CarlaEngine::getDriverCount()

  68. {

  69.     carla_debug("CarlaEngine::getDriverCount()");

  70. 

  71.     uint count = 0;

  72. 

  73.     if (jackbridge_is_ok())

  74.         count += 1;

  75. 

  76. #ifndef BUILD_BRIDGE

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

  78.     count += getJuceApiCount();

  79. # else

  80.     count += getRtAudioApiCount();

  81. # endif

  82. #endif

  83. 

  84.     return count;

  85. }

  86. 

  87. const char* CarlaEngine::getDriverName(const uint index2)

  88. {

  89.     carla_debug("CarlaEngine::getDriverName(%i)", index2);

  90. 

  91.     uint index(index2);

  92. 

  93.     if (jackbridge_is_ok() && index-- == 0)

  94.         return "JACK";

  95. 

  96. #ifndef BUILD_BRIDGE

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

  98.     if (const uint count = getJuceApiCount())

  99.     {

  100.         if (index < count)

  101.             return getJuceApiName(index);

  102.         index -= count;

  103.     }

  104. # else

  105.     if (const uint count = getRtAudioApiCount())

  106.     {

  107.         if (index < count)

  108.             return getRtAudioApiName(index);

  109.         index -= count;

  110.     }

  111. # endif

  112. #endif

  113. 

  114.     carla_stderr("CarlaEngine::getDriverName(%i) - invalid index", index2);

  115.     return nullptr;

  116. }

  117. 

  118. const char* const* CarlaEngine::getDriverDeviceNames(const uint index2)

  119. {

  120.     carla_debug("CarlaEngine::getDriverDeviceNames(%i)", index2);

  121. 

  122.     uint index(index2);

  123. 

  124.     if (jackbridge_is_ok() && index-- == 0)

  125.     {

  126.         static const char* ret[3] = { "Auto-Connect OFF", "Auto-Connect ON", nullptr };

  127.         return ret;

  128.     }

  129. 

  130. #ifndef BUILD_BRIDGE

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

  132.     if (const uint count = getJuceApiCount())

  133.     {

  134.         if (index < count)

  135.             return getJuceApiDeviceNames(index);

  136.         index -= count;

  137.     }

  138. # else

  139.     if (const uint count = getRtAudioApiCount())

  140.     {

  141.         if (index < count)

  142.             return getRtAudioApiDeviceNames(index);

  143.         index -= count;

  144.     }

  145. # endif

  146. #endif

  147. 

  148.     carla_stderr("CarlaEngine::getDriverDeviceNames(%i) - invalid index", index2);

  149.     return nullptr;

  150. }

  151. 

  152. const EngineDriverDeviceInfo* CarlaEngine::getDriverDeviceInfo(const uint index2, const char* const deviceName)

  153. {

  154.     carla_debug("CarlaEngine::getDriverDeviceInfo(%i, \"%s\")", index2, deviceName);

  155. 

  156.     uint index(index2);

  157. 

  158.     if (jackbridge_is_ok() && index-- == 0)

  159.     {

  160.         static uint32_t bufSizes[11] = { 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192, 0 };

  161.         static EngineDriverDeviceInfo devInfo;

  162.         devInfo.hints       = ENGINE_DRIVER_DEVICE_VARIABLE_BUFFER_SIZE;

  163.         devInfo.bufferSizes = bufSizes;

  164.         devInfo.sampleRates = nullptr;

  165.         return &devInfo;

  166.     }

  167. 

  168. #ifndef BUILD_BRIDGE

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

  170.     if (const uint count = getJuceApiCount())

  171.     {

  172.         if (index < count)

  173.             return getJuceDeviceInfo(index, deviceName);

  174.         index -= count;

  175.     }

  176. # else

  177.     if (const uint count = getRtAudioApiCount())

  178.     {

  179.         if (index < count)

  180.             return getRtAudioDeviceInfo(index, deviceName);

  181.         index -= count;

  182.     }

  183. # endif

  184. #endif

  185. 

  186.     carla_stderr("CarlaEngine::getDriverDeviceNames(%i, \"%s\") - invalid index", index2, deviceName);

  187.     return nullptr;

  188. }

  189. 

  190. CarlaEngine* CarlaEngine::newDriverByName(const char* const driverName)

  191. {

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

  193.     carla_debug("CarlaEngine::newDriverByName(\"%s\")", driverName);

  194. 

  195.     if (std::strcmp(driverName, "JACK") == 0)

  196.         return newJack();

  197. 

  198. #ifndef BUILD_BRIDGE

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

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

  201.     // macos

  202. 

  203.     if (std::strcmp(driverName, "CoreAudio") == 0)

  204.         return newJuce(AUDIO_API_CORE);

  205. 

  206.     // -------------------------------------------------------------------

  207.     // windows

  208. 

  209.     if (std::strcmp(driverName, "ASIO") == 0)

  210.         return newJuce(AUDIO_API_ASIO);

  211.     if (std::strcmp(driverName, "DirectSound") == 0)

  212.         return newJuce(AUDIO_API_DS);

  213. #else

  214.     // -------------------------------------------------------------------

  215.     // common

  216. 

  217.     if (std::strncmp(driverName, "JACK ", 5) == 0)

  218.         return newRtAudio(AUDIO_API_JACK);

  219. 

  220.     // -------------------------------------------------------------------

  221.     // linux

  222. 

  223.     if (std::strcmp(driverName, "ALSA") == 0)

  224.         return newRtAudio(AUDIO_API_ALSA);

  225.     if (std::strcmp(driverName, "OSS") == 0)

  226.         return newRtAudio(AUDIO_API_OSS);

  227.     if (std::strcmp(driverName, "PulseAudio") == 0)

  228.         return newRtAudio(AUDIO_API_PULSE);

  229. # endif

  230. #endif

  231. 

  232.     carla_stderr("CarlaEngine::newDriverByName(\"%s\") - invalid driver name", driverName);

  233.     return nullptr;

  234. }

  235. 

  236. // -----------------------------------------------------------------------

  237. // Constant values

  238. 

  239. uint CarlaEngine::getMaxClientNameSize() const noexcept

  240. {

  241.     return STR_MAX/2;

  242. }

  243. 

  244. uint CarlaEngine::getMaxPortNameSize() const noexcept

  245. {

  246.     return STR_MAX;

  247. }

  248. 

  249. uint CarlaEngine::getCurrentPluginCount() const noexcept

  250. {

  251.     return pData->curPluginCount;

  252. }

  253. 

  254. uint CarlaEngine::getMaxPluginNumber() const noexcept

  255. {

  256.     return pData->maxPluginNumber;

  257. }

  258. 

  259. // -----------------------------------------------------------------------

  260. // Virtual, per-engine type calls

  261. 

  262. bool CarlaEngine::init(const char* const clientName)

  263. {

  264.     carla_debug("CarlaEngine::init(\"%s\")", clientName);

  265. 

  266.     if (! pData->init(clientName))

  267.         return false;

  268. 

  269.     callback(ENGINE_CALLBACK_ENGINE_STARTED, 0, pData->options.processMode, pData->options.transportMode, 0.0f, getCurrentDriverName());

  270.     return true;

  271. }

  272. 

  273. bool CarlaEngine::close()

  274. {

  275.     carla_debug("CarlaEngine::close()");

  276. 

  277.     if (pData->curPluginCount != 0)

  278.     {

  279.         pData->aboutToClose = true;

  280.         removeAllPlugins();

  281.     }

  282. 

  283. #ifndef BUILD_BRIDGE

  284.     if (pData->osc.isControlRegistered())

  285.         oscSend_control_exit();

  286. #endif

  287. 

  288.     pData->close();

  289. 

  290.     callback(ENGINE_CALLBACK_ENGINE_STOPPED, 0, 0, 0, 0.0f, nullptr);

  291.     return true;

  292. }

  293. 

  294. void CarlaEngine::idle() noexcept

  295. {

  296.     CARLA_SAFE_ASSERT_RETURN(pData->nextAction.opcode.get() == kEnginePostActionNull,); // FIXME REMOVE

  297.     CARLA_SAFE_ASSERT_RETURN(pData->nextPluginId == pData->maxPluginNumber,);

  298. 

  299.     for (uint i=0; i < pData->curPluginCount; ++i)

  300.     {

  301.         CarlaPlugin* const plugin(pData->plugins[i].plugin);

  302. 

  303.         if (plugin != nullptr && plugin->isEnabled())

  304.         {

  305.             try {

  306.                 plugin->idle();

  307.             } CARLA_SAFE_EXCEPTION_CONTINUE("Plugin idle");

  308.         }

  309.     }

  310. 

  311.     pData->osc.idle();

  312. }

  313. 

  314. CarlaEngineClient* CarlaEngine::addClient(CarlaPlugin* const)

  315. {

  316.     return new CarlaEngineClient(*this);

  317. }

  318. 

  319. // -----------------------------------------------------------------------

  320. // Plugin management

  321. 

  322. bool CarlaEngine::addPlugin(const BinaryType btype, const PluginType ptype, const char* const filename, const char* const name, const char* const label, const int64_t uniqueId, const void* const extra)

  323. {

  324.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  325.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins != nullptr, "Invalid engine internal data");

  326.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->nextPluginId <= pData->maxPluginNumber, "Invalid engine internal data");

  327.     CARLA_SAFE_ASSERT_RETURN_ERR(btype != BINARY_NONE, "Invalid plugin binary mode");

  328.     CARLA_SAFE_ASSERT_RETURN_ERR(ptype != PLUGIN_NONE, "Invalid plugin type");

  329.     CARLA_SAFE_ASSERT_RETURN_ERR((filename != nullptr && filename[0] != '\0') || (label != nullptr && label[0] != '\0'), "Invalid plugin filename and label");

  330.     carla_debug("CarlaEngine::addPlugin(%i:%s, %i:%s, \"%s\", \"%s\", \"%s\", " P_INT64 ", %p)", btype, BinaryType2Str(btype), ptype, PluginType2Str(ptype), filename, name, label, uniqueId, extra);

  331. 

  332.     uint id;

  333. 

  334. #ifndef BUILD_BRIDGE

  335.     CarlaPlugin* oldPlugin = nullptr;

  336. 

  337.     if (pData->nextPluginId < pData->curPluginCount)

  338.     {

  339.         id = pData->nextPluginId;

  340.         pData->nextPluginId = pData->maxPluginNumber;

  341. 

  342.         oldPlugin = pData->plugins[id].plugin;

  343. 

  344.         CARLA_SAFE_ASSERT_RETURN_ERR(oldPlugin != nullptr, "Invalid replace plugin Id");

  345.     }

  346.     else

  347. #endif

  348.     {

  349.         id = pData->curPluginCount;

  350. 

  351.         if (id == pData->maxPluginNumber)

  352.         {

  353.             setLastError("Maximum number of plugins reached");

  354.             return false;

  355.         }

  356. 

  357.         CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins[id].plugin == nullptr, "Invalid engine internal data");

  358.     }

  359. 

  360.     CarlaPlugin::Initializer initializer = {

  361.         this,

  362.         id,

  363.         filename,

  364.         name,

  365.         label,

  366.         uniqueId

  367.     };

  368. 

  369.     CarlaPlugin* plugin = nullptr;

  370. 

  371. #ifndef BUILD_BRIDGE

  372.     CarlaString bridgeBinary(pData->options.binaryDir);

  373. 

  374.     if (bridgeBinary.isNotEmpty())

  375.     {

  376. # ifndef CARLA_OS_WIN

  377.         if (btype == BINARY_NATIVE)

  378.         {

  379.             bridgeBinary += OS_SEP_STR "carla-bridge-native";

  380.         }

  381.         else

  382. # endif

  383.         {

  384.             switch (btype)

  385.             {

  386.             case BINARY_POSIX32:

  387.                 bridgeBinary += OS_SEP_STR "carla-bridge-posix32";

  388.                 break;

  389.             case BINARY_POSIX64:

  390.                 bridgeBinary += OS_SEP_STR "carla-bridge-posix64";

  391.                 break;

  392.             case BINARY_WIN32:

  393.                 bridgeBinary += OS_SEP_STR "carla-bridge-win32.exe";

  394.                 break;

  395.             case BINARY_WIN64:

  396.                 bridgeBinary += OS_SEP_STR "carla-bridge-win64.exe";

  397.                 break;

  398.             default:

  399.                 bridgeBinary.clear();

  400.                 break;

  401.             }

  402.         }

  403. 

  404.         if (! File(bridgeBinary.buffer()).existsAsFile())

  405.             bridgeBinary.clear();

  406.     }

  407. 

  408.     if (ptype != PLUGIN_INTERNAL && (btype != BINARY_NATIVE || (pData->options.preferPluginBridges && bridgeBinary.isNotEmpty())))

  409.     {

  410.         if (bridgeBinary.isNotEmpty())

  411.         {

  412.             plugin = CarlaPlugin::newBridge(initializer, btype, ptype, bridgeBinary);

  413.         }

  414. # ifdef CARLA_OS_LINUX

  415.         // fallback to dssi-vst if possible

  416.         else if (btype == BINARY_WIN32 && File("/usr/lib/dssi/dssi-vst.so").existsAsFile())

  417.         {

  418.             File file(filename);

  419. 

  420.             CarlaString label2(file.getFileName().toRawUTF8());

  421.             label2.replace(' ', '*');

  422. 

  423.             CarlaPlugin::Initializer init2 = {

  424.                 this,

  425.                 id,

  426.                 "/usr/lib/dssi/dssi-vst.so",

  427.                 name,

  428.                 label2,

  429.                 uniqueId

  430.             };

  431. 

  432.             char* const oldVstPath(getenv("VST_PATH"));

  433.             carla_setenv("VST_PATH", file.getParentDirectory().getFullPathName().toRawUTF8());

  434. 

  435.             plugin = CarlaPlugin::newDSSI(init2);

  436. 

  437.             if (oldVstPath != nullptr)

  438.                 carla_setenv("VST_PATH", oldVstPath);

  439.         }

  440. # endif

  441.         else

  442.         {

  443.             setLastError("This Carla build cannot handle this binary");

  444.             return false;

  445.         }

  446.     }

  447.     else

  448. #endif // ! BUILD_BRIDGE

  449.     {

  450.         bool use16Outs;

  451.         setLastError("Invalid or unsupported plugin type");

  452. 

  453.         switch (ptype)

  454.         {

  455.         case PLUGIN_NONE:

  456.             break;

  457. 

  458.         case PLUGIN_INTERNAL:

  459.             /*if (std::strcmp(label, "FluidSynth") == 0)

  460.             {

  461.                 use16Outs = (extra != nullptr && std::strcmp((const char*)extra, "true") == 0);

  462.                 plugin = CarlaPlugin::newFluidSynth(initializer, use16Outs);

  463.             }

  464.             else if (std::strcmp(label, "LinuxSampler (GIG)") == 0)

  465.             {

  466.                 use16Outs = (extra != nullptr && std::strcmp((const char*)extra, "true") == 0);

  467.                 plugin = CarlaPlugin::newLinuxSampler(initializer, "GIG", use16Outs);

  468.             }

  469.             else if (std::strcmp(label, "LinuxSampler (SF2)") == 0)

  470.             {

  471.                 use16Outs = (extra != nullptr && std::strcmp((const char*)extra, "true") == 0);

  472.                 plugin = CarlaPlugin::newLinuxSampler(initializer, "SF2", use16Outs);

  473.             }

  474.             else if (std::strcmp(label, "LinuxSampler (SFZ)") == 0)

  475.             {

  476.                 use16Outs = (extra != nullptr && std::strcmp((const char*)extra, "true") == 0);

  477.                 plugin = CarlaPlugin::newLinuxSampler(initializer, "SFZ", use16Outs);

  478.             }*/

  479.             plugin = CarlaPlugin::newNative(initializer);

  480.             break;

  481. 

  482.         case PLUGIN_LADSPA:

  483.             plugin = CarlaPlugin::newLADSPA(initializer, (const LADSPA_RDF_Descriptor*)extra);

  484.             break;

  485. 

  486.         case PLUGIN_DSSI:

  487.             plugin = CarlaPlugin::newDSSI(initializer);

  488.             break;

  489. 

  490.         case PLUGIN_LV2:

  491.             plugin = CarlaPlugin::newLV2(initializer);

  492.             break;

  493. 

  494.         case PLUGIN_VST:

  495.             plugin = CarlaPlugin::newVST(initializer);

  496.             break;

  497. 

  498.         case PLUGIN_VST3:

  499.             plugin = CarlaPlugin::newVST3(initializer);

  500.             break;

  501. 

  502.         case PLUGIN_AU:

  503.             plugin = CarlaPlugin::newAU(initializer);

  504.             break;

  505. 

  506.         case PLUGIN_GIG:

  507.             use16Outs = (extra != nullptr && std::strcmp((const char*)extra, "true") == 0);

  508.             plugin = CarlaPlugin::newFileGIG(initializer, use16Outs);

  509.             break;

  510. 

  511.         case PLUGIN_SF2:

  512.             use16Outs = (extra != nullptr && std::strcmp((const char*)extra, "true") == 0);

  513.             plugin = CarlaPlugin::newFileSF2(initializer, use16Outs);

  514.             break;

  515. 

  516.         case PLUGIN_SFZ:

  517.             plugin = CarlaPlugin::newFileSFZ(initializer);

  518.             break;

  519.         }

  520.     }

  521. 

  522.     if (plugin == nullptr)

  523.         return false;

  524. 

  525.     plugin->registerToOscClient();

  526. 

  527.     EnginePluginData& pluginData(pData->plugins[id]);

  528.     pluginData.plugin      = plugin;

  529.     pluginData.insPeak[0]  = 0.0f;

  530.     pluginData.insPeak[1]  = 0.0f;

  531.     pluginData.outsPeak[0] = 0.0f;

  532.     pluginData.outsPeak[1] = 0.0f;

  533. 

  534. #ifndef BUILD_BRIDGE

  535.     if (oldPlugin != nullptr)

  536.     {

  537.         // the engine thread might be reading from the old plugin

  538.         pData->thread.stopThread(500);

  539.         pData->thread.startThread();

  540. 

  541.         const bool  wasActive = oldPlugin->getInternalParameterValue(PARAMETER_ACTIVE) >= 0.5f;

  542.         const float oldDryWet = oldPlugin->getInternalParameterValue(PARAMETER_DRYWET);

  543.         const float oldVolume = oldPlugin->getInternalParameterValue(PARAMETER_VOLUME);

  544. 

  545.         delete oldPlugin;

  546. 

  547.         if (plugin->getHints() & PLUGIN_CAN_DRYWET)

  548.             plugin->setDryWet(oldDryWet, true, true);

  549. 

  550.         if (plugin->getHints() & PLUGIN_CAN_VOLUME)

  551.             plugin->setVolume(oldVolume, true, true);

  552. 

  553.         if (wasActive)

  554.             plugin->setActive(true, true, true);

  555. 

  556.         callback(ENGINE_CALLBACK_RELOAD_ALL, id, 0, 0, 0.0f, nullptr);

  557.     }

  558.     else

  559. #endif

  560.     {

  561.         ++pData->curPluginCount;

  562.         callback(ENGINE_CALLBACK_PLUGIN_ADDED, id, 0, 0, 0.0f, plugin->getName());

  563.     }

  564. 

  565.     return true;

  566. }

  567. 

  568. bool CarlaEngine::addPlugin(const PluginType ptype, const char* const filename, const char* const name, const char* const label, const int64_t uniqueId, const void* const extra)

  569. {

  570.     return addPlugin(BINARY_NATIVE, ptype, filename, name, label, uniqueId, extra);

  571. }

  572. 

  573. bool CarlaEngine::removePlugin(const uint id)

  574. {

  575.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  576.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins != nullptr, "Invalid engine internal data");

  577.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->curPluginCount != 0, "Invalid engine internal data");

  578.     CARLA_SAFE_ASSERT_RETURN_ERR(id < pData->curPluginCount, "Invalid plugin Id");

  579.     carla_debug("CarlaEngine::removePlugin(%i)", id);

  580. 

  581.     CarlaPlugin* const plugin(pData->plugins[id].plugin);

  582. 

  583.     CARLA_SAFE_ASSERT_RETURN_ERR(plugin != nullptr, "Could not find plugin to remove");

  584.     CARLA_SAFE_ASSERT_RETURN_ERR(plugin->getId() == id, "Invalid engine internal data");

  585. 

  586.     pData->thread.stopThread(500);

  587. 

  588. #ifndef BUILD_BRIDGE

  589.     const ScopedActionLock sal(pData, kEnginePostActionRemovePlugin, id, 0, isRunning());

  590. 

  591.     for (uint i=id; i < pData->curPluginCount; ++i)

  592.     {

  593.         CarlaPlugin* const plugin2(pData->plugins[i].plugin);

  594.         CARLA_SAFE_ASSERT_BREAK(plugin2 != nullptr);

  595.         plugin2->updateOscURL();

  596.     }

  597. 

  598.     if (isOscControlRegistered())

  599.         oscSend_control_remove_plugin(id);

  600. #else

  601.     pData->curPluginCount = 0;

  602.     carla_zeroStruct(pData->plugins, 1);

  603. #endif

  604. 

  605.     delete plugin;

  606. 

  607.     if (isRunning() && ! pData->aboutToClose)

  608.         pData->thread.startThread();

  609. 

  610.     callback(ENGINE_CALLBACK_PLUGIN_REMOVED, id, 0, 0, 0.0f, nullptr);

  611.     return true;

  612. }

  613. 

  614. bool CarlaEngine::removeAllPlugins()

  615. {

  616.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  617.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins != nullptr, "Invalid engine internal data");

  618.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->nextPluginId == pData->maxPluginNumber, "Invalid engine internal data");

  619.     carla_debug("CarlaEngine::removeAllPlugins()");

  620. 

  621.     if (pData->curPluginCount == 0)

  622.         return true;

  623. 

  624.     pData->thread.stopThread(500);

  625. 

  626.     const ScopedActionLock sal(pData, kEnginePostActionZeroCount, 0, 0, isRunning());

  627. 

  628.     callback(ENGINE_CALLBACK_IDLE, 0, 0, 0, 0.0f, nullptr);

  629. 

  630.     for (uint i=0; i < pData->maxPluginNumber; ++i)

  631.     {

  632.         EnginePluginData& pluginData(pData->plugins[i]);

  633. 

  634.         if (pluginData.plugin != nullptr)

  635.         {

  636.             delete pluginData.plugin;

  637.             pluginData.plugin = nullptr;

  638.         }

  639. 

  640.         pluginData.insPeak[0]  = 0.0f;

  641.         pluginData.insPeak[1]  = 0.0f;

  642.         pluginData.outsPeak[0] = 0.0f;

  643.         pluginData.outsPeak[1] = 0.0f;

  644. 

  645.         callback(ENGINE_CALLBACK_IDLE, 0, 0, 0, 0.0f, nullptr);

  646.     }

  647. 

  648.     if (isRunning() && ! pData->aboutToClose)

  649.         pData->thread.startThread();

  650. 

  651.     return true;

  652. }

  653. 

  654. #ifndef BUILD_BRIDGE

  655. const char* CarlaEngine::renamePlugin(const uint id, const char* const newName)

  656. {

  657.     CARLA_SAFE_ASSERT_RETURN_ERRN(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  658.     CARLA_SAFE_ASSERT_RETURN_ERRN(pData->plugins != nullptr, "Invalid engine internal data");

  659.     CARLA_SAFE_ASSERT_RETURN_ERRN(pData->curPluginCount != 0, "Invalid engine internal data");

  660.     CARLA_SAFE_ASSERT_RETURN_ERRN(id < pData->curPluginCount, "Invalid plugin Id");

  661.     CARLA_SAFE_ASSERT_RETURN_ERRN(newName != nullptr && newName[0] != '\0', "Invalid plugin name");

  662.     carla_debug("CarlaEngine::renamePlugin(%i, \"%s\")", id, newName);

  663. 

  664.     CarlaPlugin* const plugin(pData->plugins[id].plugin);

  665. 

  666.     CARLA_SAFE_ASSERT_RETURN_ERRN(plugin != nullptr, "Could not find plugin to rename");

  667.     CARLA_SAFE_ASSERT_RETURN_ERRN(plugin->getId() == id, "Invalid engine internal data");

  668. 

  669.     if (const char* const name = getUniquePluginName(newName))

  670.     {

  671.         plugin->setName(name);

  672.         return name;

  673.     }

  674. 

  675.     setLastError("Unable to get new unique plugin name");

  676.     return nullptr;

  677. }

  678. 

  679. bool CarlaEngine::clonePlugin(const uint id)

  680. {

  681.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  682.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins != nullptr, "Invalid engine internal data");

  683.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->curPluginCount != 0, "Invalid engine internal data");

  684.     CARLA_SAFE_ASSERT_RETURN_ERR(id < pData->curPluginCount, "Invalid plugin Id");

  685.     carla_debug("CarlaEngine::clonePlugin(%i)", id);

  686. 

  687.     CarlaPlugin* const plugin(pData->plugins[id].plugin);

  688. 

  689.     CARLA_SAFE_ASSERT_RETURN_ERR(plugin != nullptr, "Could not find plugin to clone");

  690.     CARLA_SAFE_ASSERT_RETURN_ERR(plugin->getId() == id, "Invalid engine internal data");

  691. 

  692.     char label[STR_MAX+1];

  693.     carla_zeroChar(label, STR_MAX+1);

  694.     plugin->getLabel(label);

  695. 

  696.     const uint pluginCountBefore(pData->curPluginCount);

  697. 

  698.     if (! addPlugin(plugin->getBinaryType(), plugin->getType(), plugin->getFilename(), plugin->getName(), label, plugin->getUniqueId(), plugin->getExtraStuff()))

  699.         return false;

  700. 

  701.     CARLA_SAFE_ASSERT_RETURN_ERR(pluginCountBefore+1 == pData->curPluginCount, "No new plugin found");

  702. 

  703.     if (CarlaPlugin* const newPlugin = pData->plugins[pluginCountBefore].plugin)

  704.         newPlugin->loadStateSave(plugin->getStateSave());

  705. 

  706.     return true;

  707. }

  708. 

  709. bool CarlaEngine::replacePlugin(const uint id) noexcept

  710. {

  711.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  712.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins != nullptr, "Invalid engine internal data");

  713.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->curPluginCount != 0, "Invalid engine internal data");

  714.     carla_debug("CarlaEngine::replacePlugin(%i)", id);

  715. 

  716.     // might use this to reset

  717.     if (id == pData->curPluginCount || id == pData->maxPluginNumber)

  718.     {

  719.         pData->nextPluginId = pData->maxPluginNumber;

  720.         return true;

  721.     }

  722. 

  723.     CARLA_SAFE_ASSERT_RETURN_ERR(id < pData->curPluginCount, "Invalid plugin Id");

  724. 

  725.     CarlaPlugin* const plugin(pData->plugins[id].plugin);

  726. 

  727.     CARLA_SAFE_ASSERT_RETURN_ERR(plugin != nullptr, "Could not find plugin to replace");

  728.     CARLA_SAFE_ASSERT_RETURN_ERR(plugin->getId() == id, "Invalid engine internal data");

  729. 

  730.     pData->nextPluginId = id;

  731. 

  732.     return true;

  733. }

  734. 

  735. bool CarlaEngine::switchPlugins(const uint idA, const uint idB) noexcept

  736. {

  737.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  738.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->plugins != nullptr, "Invalid engine internal data");

  739.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->curPluginCount >= 2, "Invalid engine internal data");

  740.     CARLA_SAFE_ASSERT_RETURN_ERR(idA != idB, "Invalid operation, cannot switch plugin with itself");

  741.     CARLA_SAFE_ASSERT_RETURN_ERR(idA < pData->curPluginCount, "Invalid plugin Id");

  742.     CARLA_SAFE_ASSERT_RETURN_ERR(idB < pData->curPluginCount, "Invalid plugin Id");

  743.     carla_debug("CarlaEngine::switchPlugins(%i)", idA, idB);

  744. 

  745.     CarlaPlugin* const pluginA(pData->plugins[idA].plugin);

  746.     CarlaPlugin* const pluginB(pData->plugins[idB].plugin);

  747. 

  748.     CARLA_SAFE_ASSERT_RETURN_ERR(pluginA != nullptr, "Could not find plugin to switch");

  749.     CARLA_SAFE_ASSERT_RETURN_ERR(pluginA != nullptr, "Could not find plugin to switch");

  750.     CARLA_SAFE_ASSERT_RETURN_ERR(pluginA->getId() == idA, "Invalid engine internal data");

  751.     CARLA_SAFE_ASSERT_RETURN_ERR(pluginB->getId() == idB, "Invalid engine internal data");

  752. 

  753.     pData->thread.stopThread(500);

  754. 

  755.     const ScopedActionLock sal(pData, kEnginePostActionSwitchPlugins, idA, idB, isRunning());

  756. 

  757.     if (CarlaPlugin* const plugin = pData->plugins[idA].plugin)

  758.         plugin->updateOscURL();

  759. 

  760.     if (CarlaPlugin* const plugin = pData->plugins[idB].plugin)

  761.         plugin->updateOscURL();

  762. 

  763.     // TODO

  764.     //if (isOscControlRegistered())

  765.     //    oscSend_control_switch_plugins(idA, idB);

  766. 

  767.     if (isRunning() && ! pData->aboutToClose)

  768.         pData->thread.startThread();

  769. 

  770.     return true;

  771. }

  772. #endif

  773. 

  774. CarlaPlugin* CarlaEngine::getPlugin(const uint id) const noexcept

  775. {

  776.     CARLA_SAFE_ASSERT_RETURN_ERRN(pData->plugins != nullptr, "Invalid engine internal data");

  777.     CARLA_SAFE_ASSERT_RETURN_ERRN(pData->curPluginCount != 0, "Invalid engine internal data");

  778.     CARLA_SAFE_ASSERT_RETURN_ERRN(id < pData->curPluginCount, "Invalid plugin Id");

  779. 

  780.     return pData->plugins[id].plugin;

  781. }

  782. 

  783. CarlaPlugin* CarlaEngine::getPluginUnchecked(const uint id) const noexcept

  784. {

  785.     return pData->plugins[id].plugin;

  786. }

  787. 

  788. const char* CarlaEngine::getUniquePluginName(const char* const name) const

  789. {

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

  791.     carla_debug("CarlaEngine::getUniquePluginName(\"%s\")", name);

  792. 

  793.     CarlaString sname;

  794.     sname = name;

  795. 

  796.     if (sname.isEmpty())

  797.     {

  798.         sname = "(No name)";

  799.         return sname.dup();

  800.     }

  801. 

  802.     const size_t maxNameSize(carla_min<uint>(getMaxClientNameSize(), 0xff, 6) - 6); // 6 = strlen(" (10)") + 1

  803. 

  804.     if (maxNameSize == 0 || ! isRunning())

  805.         return sname.dup();

  806. 

  807.     sname.truncate(maxNameSize);

  808.     sname.replace(':', '.'); // ':' is used in JACK1 to split client/port names

  809. 

  810.     for (uint i=0; i < pData->curPluginCount; ++i)

  811.     {

  812.         CARLA_SAFE_ASSERT_BREAK(pData->plugins[i].plugin != nullptr);

  813. 

  814.         // Check if unique name doesn't exist

  815.         if (const char* const pluginName = pData->plugins[i].plugin->getName())

  816.         {

  817.             if (sname != pluginName)

  818.                 continue;

  819.         }

  820. 

  821.         // Check if string has already been modified

  822.         {

  823.             const size_t len(sname.length());

  824. 

  825.             // 1 digit, ex: " (2)"

  826.             if (sname[len-4] == ' ' && sname[len-3] == '(' && sname.isDigit(len-2) && sname[len-1] == ')')

  827.             {

  828.                 int number = sname[len-2] - '0';

  829. 

  830.                 if (number == 9)

  831.                 {

  832.                     // next number is 10, 2 digits

  833.                     sname.truncate(len-4);

  834.                     sname += " (10)";

  835.                     //sname.replace(" (9)", " (10)");

  836.                 }

  837.                 else

  838.                     sname[len-2] = char('0' + number + 1);

  839. 

  840.                 continue;

  841.             }

  842. 

  843.             // 2 digits, ex: " (11)"

  844.             if (sname[len-5] == ' ' && sname[len-4] == '(' && sname.isDigit(len-3) && sname.isDigit(len-2) && sname[len-1] == ')')

  845.             {

  846.                 char n2 = sname[len-2];

  847.                 char n3 = sname[len-3];

  848. 

  849.                 if (n2 == '9')

  850.                 {

  851.                     n2 = '0';

  852.                     n3 = static_cast<char>(n3 + 1);

  853.                 }

  854.                 else

  855.                     n2 = static_cast<char>(n2 + 1);

  856. 

  857.                 sname[len-2] = n2;

  858.                 sname[len-3] = n3;

  859. 

  860.                 continue;

  861.             }

  862.         }

  863. 

  864.         // Modify string if not

  865.         sname += " (2)";

  866.     }

  867. 

  868.     return sname.dup();

  869. }

  870. 

  871. // -----------------------------------------------------------------------

  872. // Project management

  873. 

  874. bool CarlaEngine::loadFile(const char* const filename)

  875. {

  876.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  877.     CARLA_SAFE_ASSERT_RETURN_ERR(filename != nullptr && filename[0] != '\0', "Invalid filename");

  878.     carla_debug("CarlaEngine::loadFile(\"%s\")", filename);

  879. 

  880.     File file(filename);

  881.     CARLA_SAFE_ASSERT_RETURN_ERR(file.existsAsFile(), "Requested file does not exist or is not a readable file");

  882. 

  883.     CarlaString baseName(file.getFileName().toRawUTF8());

  884.     CarlaString extension(file.getFileExtension().replace(".","").toLowerCase().toRawUTF8());

  885. 

  886.     // -------------------------------------------------------------------

  887. 

  888.     if (extension == "carxp" || extension == "carxs")

  889.         return loadProject(filename);

  890. 

  891.     // -------------------------------------------------------------------

  892. 

  893.     if (extension == "gig")

  894.         return addPlugin(PLUGIN_GIG, filename, baseName, baseName, 0, nullptr);

  895. 

  896.     if (extension == "sf2")

  897.         return addPlugin(PLUGIN_SF2, filename, baseName, baseName, 0, nullptr);

  898. 

  899.     if (extension == "sfz")

  900.         return addPlugin(PLUGIN_SFZ, filename, baseName, baseName, 0, nullptr);

  901. 

  902.     // -------------------------------------------------------------------

  903. 

  904.     if (extension == "aif" || extension == "aiff" || extension == "bwf" || extension == "flac" || extension == "ogg" || extension == "wav")

  905.     {

  906.         if (addPlugin(PLUGIN_INTERNAL, nullptr, baseName, "audiofile", 0, nullptr))

  907.         {

  908.             if (CarlaPlugin* const plugin = getPlugin(pData->curPluginCount-1))

  909.                 plugin->setCustomData(CUSTOM_DATA_TYPE_STRING, "file", filename, true);

  910.             return true;

  911.         }

  912.         return false;

  913.     }

  914. 

  915.     // -------------------------------------------------------------------

  916. 

  917.     if (extension == "mid" || extension == "midi")

  918.     {

  919.         if (addPlugin(PLUGIN_INTERNAL, nullptr, baseName, "midifile", 0, nullptr))

  920.         {

  921.             if (CarlaPlugin* const plugin = getPlugin(pData->curPluginCount-1))

  922.                 plugin->setCustomData(CUSTOM_DATA_TYPE_STRING, "file", filename, true);

  923.             return true;

  924.         }

  925.         return false;

  926.     }

  927. 

  928.     // -------------------------------------------------------------------

  929.     // ZynAddSubFX

  930. 

  931.     if (extension == "xmz" || extension == "xiz")

  932.     {

  933. #ifdef WANT_ZYNADDSUBFX

  934.         if (addPlugin(PLUGIN_INTERNAL, nullptr, baseName, "zynaddsubfx", 0, nullptr))

  935.         {

  936.             if (CarlaPlugin* const plugin = getPlugin(pData->curPluginCount-1))

  937.                 plugin->setCustomData(CUSTOM_DATA_TYPE_STRING, (extension == "xmz") ? "CarlaAlternateFile1" : "CarlaAlternateFile2", filename, true);

  938.             return true;

  939.         }

  940.         return false;

  941. #else

  942.         setLastError("This Carla build does not have ZynAddSubFX support");

  943.         return false;

  944. #endif

  945.     }

  946. 

  947.     // -------------------------------------------------------------------

  948. 

  949.     setLastError("Unknown file extension");

  950.     return false;

  951. }

  952. 

  953. bool CarlaEngine::loadProject(const char* const filename)

  954. {

  955.     CARLA_SAFE_ASSERT_RETURN_ERR(pData->isIdling == 0, "An operation is still being processed, please wait for it to finish");

  956.     CARLA_SAFE_ASSERT_RETURN_ERR(filename != nullptr && filename[0] != '\0', "Invalid filename");

  957.     carla_debug("CarlaEngine::loadProject(\"%s\")", filename);

  958. 

  959.     File file(filename);

  960.     CARLA_SAFE_ASSERT_RETURN_ERR(file.existsAsFile(), "Requested file does not exist or is not a readable file");

  961. 

  962.     XmlDocument xml(file);

  963.     ScopedPointer<XmlElement> xmlElement(xml.getDocumentElement(true));

  964.     CARLA_SAFE_ASSERT_RETURN_ERR(xmlElement != nullptr, "Failed to parse project file");

  965. 

  966.     const String& xmlType(xmlElement->getTagName());

  967.     const bool isPreset(xmlType.equalsIgnoreCase("carla-preset"));

  968. 

  969.     if (! (xmlType.equalsIgnoreCase("carla-project") || isPreset))

  970.     {

  971.         setLastError("Not a valid Carla project or preset file");

  972.         return false;

  973.     }

  974. 

  975.     // completely load file

  976.     xmlElement = xml.getDocumentElement(false);

  977.     CARLA_SAFE_ASSERT_RETURN_ERR(xmlElement != nullptr, "Failed to completely parse project file");

  978. 

  979.     // handle plugins first

  980.     for (XmlElement* elem = xmlElement->getFirstChildElement(); elem != nullptr; elem = elem->getNextElement())

  981.     {

  982.         const String& tagName(elem->getTagName());

  983. 

  984.         if (isPreset || tagName.equalsIgnoreCase("plugin"))

  985.         {

  986.             StateSave stateSave;

  987.             stateSave.fillFromXmlElement(isPreset ? xmlElement.get() : elem);

  988. 

  989.             callback(ENGINE_CALLBACK_IDLE, 0, 0, 0, 0.0f, nullptr);

  990. 

  991.             CARLA_SAFE_ASSERT_CONTINUE(stateSave.type != nullptr);

  992. 

  993.             const void* extraStuff = nullptr;

  994. 

  995.             // check if using GIG or SF2 16outs

  996.             static const char kUse16OutsSuffix[] = " (16 outs)";

  997. 

  998.             const BinaryType btype(getBinaryTypeFromFile(stateSave.binary));

  999.             const PluginType ptype(getPluginTypeFromString(stateSave.type));

  1000. 

  1001.             if (CarlaString(stateSave.label).endsWith(kUse16OutsSuffix))

  1002.             {

  1003.                 if (ptype == PLUGIN_GIG || ptype == PLUGIN_SF2)

  1004.                     extraStuff = "true";

  1005.             }

  1006. 

  1007.             // TODO - proper find&load plugins

  1008. 

  1009.             if (addPlugin(btype, ptype, stateSave.binary, stateSave.name, stateSave.label, stateSave.uniqueId, extraStuff))

  1010.             {

  1011.                 if (CarlaPlugin* const plugin = getPlugin(pData->curPluginCount-1))

  1012.                     plugin->loadStateSave(stateSave);

  1013.             }

  1014.             else

  1015.                 carla_stderr2("Failed to load a plugin, error was:\n%s", getLastError());

  1016.         }

  1017. 

  1018.         if (isPreset)

  1019.             return true;

  1020.     }

  1021. 

  1022. #ifndef BUILD_BRIDGE

  1023.     callback(ENGINE_CALLBACK_IDLE, 0, 0, 0, 0.0f, nullptr);

  1024. 

  1025.     // if we're running inside some session-manager, let them handle the connections

  1026.     if (pData->options.processMode != ENGINE_PROCESS_MODE_PATCHBAY)

  1027.     {

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

  1029.             return true;

  1030.     }

  1031. 

  1032.     // now handle connections

  1033.     for (XmlElement* elem = xmlElement->getFirstChildElement(); elem != nullptr; elem = elem->getNextElement())

  1034.     {

  1035.         const String& tagName(elem->getTagName());

  1036. 

  1037.         if (tagName.equalsIgnoreCase("patchbay"))

  1038.         {

  1039.             CarlaString sourcePort, targetPort;

  1040. 

  1041.             for (XmlElement* patchElem = elem->getFirstChildElement(); patchElem != nullptr; patchElem = patchElem->getNextElement())

  1042.             {

  1043.                 const String& patchTag(patchElem->getTagName());

  1044. 

  1045.                 sourcePort.clear();

  1046.                 targetPort.clear();

  1047. 

  1048.                 if (! patchTag.equalsIgnoreCase("connection"))

  1049.                     continue;

  1050. 

  1051.                 for (XmlElement* connElem = patchElem->getFirstChildElement(); connElem != nullptr; connElem = connElem->getNextElement())

  1052.                 {

  1053.                     const String& tag(connElem->getTagName());

  1054.                     const String  text(connElem->getAllSubText().trim());

  1055. 

  1056.                     if (tag.equalsIgnoreCase("source"))

  1057.                         sourcePort = text.toRawUTF8();

  1058.                     else if (tag.equalsIgnoreCase("target"))

  1059.                         targetPort = text.toRawUTF8();

  1060.                 }

  1061. 

  1062.                 if (sourcePort.isNotEmpty() && targetPort.isNotEmpty())

  1063.                     restorePatchbayConnection(sourcePort, targetPort);

  1064.             }

  1065.             break;

  1066.         }

  1067.     }

  1068. #endif

  1069. 

  1070.     return true;

  1071. }

  1072. 

  1073. bool CarlaEngine::saveProject(const char* const filename)

  1074. {

  1075.     CARLA_SAFE_ASSERT_RETURN_ERR(filename != nullptr && filename[0] != '\0', "Invalid filename");

  1076.     carla_debug("CarlaEngine::saveProject(\"%s\")", filename);

  1077. 

  1078.     MemoryOutputStream out;

  1079.     out << "<?xml version='1.0' encoding='UTF-8'?>\n";

  1080.     out << "<!DOCTYPE CARLA-PROJECT>\n";

  1081.     out << "<CARLA-PROJECT VERSION='2.0'>\n";

  1082. 

  1083.     bool firstPlugin = true;

  1084.     char strBuf[STR_MAX+1];

  1085. 

  1086.     for (uint i=0; i < pData->curPluginCount; ++i)

  1087.     {

  1088.         CarlaPlugin* const plugin(pData->plugins[i].plugin);

  1089. 

  1090.         if (plugin != nullptr && plugin->isEnabled())

  1091.         {

  1092.             if (! firstPlugin)

  1093.                 out << "\n";

  1094. 

  1095.             strBuf[0] = '\0';

  1096. 

  1097.             plugin->getRealName(strBuf);

  1098. 

  1099.             //if (strBuf[0] != '\0')

  1100.             //    out << QString(" <!-- %1 -->\n").arg(xmlSafeString(strBuf, true));

  1101. 

  1102.             out << " <Plugin>\n";

  1103.             out << plugin->getStateSave().toString();

  1104.             out << " </Plugin>\n";

  1105. 

  1106.             firstPlugin = false;

  1107.         }

  1108.     }

  1109. 

  1110. #ifndef BUILD_BRIDGE

  1111.     bool saveConnections = true;

  1112. 

  1113.     // if we're running inside some session-manager, let them handle the connections

  1114.     if (pData->options.processMode != ENGINE_PROCESS_MODE_PATCHBAY)

  1115.     {

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

  1117.             saveConnections = false;

  1118.     }

  1119. 

  1120.     if (saveConnections)

  1121.     {

  1122.         if (const char* const* patchbayConns = getPatchbayConnections())

  1123.         {

  1124.             if (! firstPlugin)

  1125.                 out << "\n";

  1126. 

  1127.             out << " <Patchbay>\n";

  1128. 

  1129.             for (int i=0; patchbayConns[i] != nullptr && patchbayConns[i+1] != nullptr; ++i, ++i )

  1130.             {

  1131.                 const char* const connSource(patchbayConns[i]);

  1132.                 const char* const connTarget(patchbayConns[i+1]);

  1133. 

  1134.                 CARLA_SAFE_ASSERT_CONTINUE(connSource != nullptr && connSource[0] != '\0');

  1135.                 CARLA_SAFE_ASSERT_CONTINUE(connTarget != nullptr && connTarget[0] != '\0');

  1136. 

  1137.                 out << "  <Connection>\n";

  1138.                 out << "   <Source>" << connSource << "</Source>\n";

  1139.                 out << "   <Target>" << connTarget << "</Target>\n";

  1140.                 out << "  </Connection>\n";

  1141. 

  1142.                 delete[] connSource;

  1143.                 delete[] connTarget;

  1144.             }

  1145. 

  1146.             out << " </Patchbay>\n";

  1147.         }

  1148.     }

  1149. #endif

  1150. 

  1151.     out << "</CARLA-PROJECT>\n";

  1152. 

  1153.     File file(filename);

  1154. 

  1155.     if (file.replaceWithData(out.getData(), out.getDataSize()))

  1156.         return true;

  1157. 

  1158.     setLastError("Failed to write file");

  1159.     return false;

  1160. }

  1161. 

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

  1163. // Information (base)

  1164. 

  1165. uint CarlaEngine::getHints() const noexcept

  1166. {

  1167.     return pData->hints;

  1168. }

  1169. 

  1170. uint32_t CarlaEngine::getBufferSize() const noexcept

  1171. {

  1172.     return pData->bufferSize;

  1173. }

  1174. 

  1175. double CarlaEngine::getSampleRate() const noexcept

  1176. {

  1177.     return pData->sampleRate;

  1178. }

  1179. 

  1180. const char* CarlaEngine::getName() const noexcept

  1181. {

  1182.     return pData->name;

  1183. }

  1184. 

  1185. EngineProcessMode CarlaEngine::getProccessMode() const noexcept

  1186. {

  1187.     return pData->options.processMode;

  1188. }

  1189. 

  1190. const EngineOptions& CarlaEngine::getOptions() const noexcept

  1191. {

  1192.     return pData->options;

  1193. }

  1194. 

  1195. const EngineTimeInfo& CarlaEngine::getTimeInfo() const noexcept

  1196. {

  1197.     return pData->timeInfo;

  1198. }

  1199. 

  1200. // -----------------------------------------------------------------------

  1201. // Information (peaks)

  1202. 

  1203. float CarlaEngine::getInputPeak(const uint pluginId, const bool isLeft) const noexcept

  1204. {

  1205.     CARLA_SAFE_ASSERT_RETURN(pluginId < pData->curPluginCount, 0.0f);

  1206. 

  1207.     return pData->plugins[pluginId].insPeak[isLeft ? 0 : 1];

  1208. }

  1209. 

  1210. float CarlaEngine::getOutputPeak(const uint pluginId, const bool isLeft) const noexcept

  1211. {

  1212.     CARLA_SAFE_ASSERT_RETURN(pluginId < pData->curPluginCount, 0.0f);

  1213. 

  1214.     return pData->plugins[pluginId].outsPeak[isLeft ? 0 : 1];

  1215. }

  1216. 

  1217. // -----------------------------------------------------------------------

  1218. // Callback

  1219. 

  1220. void CarlaEngine::callback(const EngineCallbackOpcode action, const uint pluginId, const int value1, const int value2, const float value3, const char* const valueStr) noexcept

  1221. {

  1222.     carla_debug("CarlaEngine::callback(%i:%s, %i, %i, %i, %f, \"%s\")", action, EngineCallbackOpcode2Str(action), pluginId, value1, value2, value3, valueStr);

  1223. 

  1224. #ifdef BUILD_BRIDGE

  1225.     if (pData->isIdling)

  1226. #else

  1227.     if (pData->isIdling && action != ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED)

  1228. #endif

  1229.     {

  1230.         carla_stdout("callback while idling (%i:%s, %i, %i, %i, %f, \"%s\")", action, EngineCallbackOpcode2Str(action), pluginId, value1, value2, value3, valueStr);

  1231.     }

  1232. 

  1233.     if (action == ENGINE_CALLBACK_IDLE)

  1234.     {

  1235.         ++pData->isIdling;

  1236.     }

  1237. #ifdef BUILD_BRIDGE

  1238.     else if (pData->oscData != nullptr)

  1239.     {

  1240.         switch (action)

  1241.         {

  1242.         case ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED:

  1243.             CARLA_SAFE_ASSERT_BREAK(value1 >= 0);

  1244.             oscSend_bridge_parameter_value(static_cast<uint>(value1), value3);

  1245.             break;

  1246.         case ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED:

  1247.             CARLA_SAFE_ASSERT_BREAK(value1 >= 0);

  1248.             oscSend_bridge_default_value(static_cast<uint>(value1), value3);

  1249.             break;

  1250.         case ENGINE_CALLBACK_PROGRAM_CHANGED:

  1251.             CARLA_SAFE_ASSERT_BREAK(value1 >= -1);

  1252.             oscSend_bridge_current_program(value1);

  1253.             break;

  1254.         case ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED:

  1255.             CARLA_SAFE_ASSERT_BREAK(value1 >= -1);

  1256.             oscSend_bridge_current_midi_program(value1);

  1257.             break;

  1258.         case ENGINE_CALLBACK_UI_STATE_CHANGED:

  1259.             if (value1 != 1)

  1260.                 oscSend_bridge_configure("CarlaBridgeHideGUI", "");

  1261.             break;

  1262.         default:

  1263.             break;

  1264.         }

  1265.     }

  1266. #endif

  1267. 

  1268.     if (pData->callback != nullptr)

  1269.     {

  1270.         try {

  1271.             pData->callback(pData->callbackPtr, action, pluginId, value1, value2, value3, valueStr);

  1272.         } CARLA_SAFE_EXCEPTION("callback");

  1273.     }

  1274. 

  1275.     if (action == ENGINE_CALLBACK_IDLE)

  1276.         --pData->isIdling;

  1277. }

  1278. 

  1279. void CarlaEngine::setCallback(const EngineCallbackFunc func, void* const ptr) noexcept

  1280. {

  1281.     carla_debug("CarlaEngine::setCallback(%p, %p)", func, ptr);

  1282. 

  1283.     pData->callback    = func;

  1284.     pData->callbackPtr = ptr;

  1285. }

  1286. 

  1287. // -----------------------------------------------------------------------

  1288. // File Callback

  1289. 

  1290. const char* CarlaEngine::runFileCallback(const FileCallbackOpcode action, const bool isDir, const char* const title, const char* const filter) noexcept

  1291. {

  1292.     CARLA_SAFE_ASSERT_RETURN(title != nullptr && title[0] != '\0', nullptr);

  1293.     CARLA_SAFE_ASSERT_RETURN(filter != nullptr, nullptr);

  1294.     carla_debug("CarlaEngine::runFileCallback(%i:%s, %s, \"%s\", \"%s\")", action, FileCallbackOpcode2Str(action), bool2str(isDir), title, filter);

  1295. 

  1296.     const char* ret = nullptr;

  1297. 

  1298.     if (pData->fileCallback != nullptr)

  1299.     {

  1300.         try {

  1301.             ret = pData->fileCallback(pData->fileCallbackPtr, action, isDir, title, filter);

  1302.         } CARLA_SAFE_EXCEPTION("runFileCallback");

  1303.     }

  1304. 

  1305.     return ret;

  1306. }

  1307. 

  1308. void CarlaEngine::setFileCallback(const FileCallbackFunc func, void* const ptr) noexcept

  1309. {

  1310.     carla_debug("CarlaEngine::setFileCallback(%p, %p)", func, ptr);

  1311. 

  1312.     pData->fileCallback    = func;

  1313.     pData->fileCallbackPtr = ptr;

  1314. }

  1315. 

  1316. // -----------------------------------------------------------------------

  1317. // Transport

  1318. 

  1319. void CarlaEngine::transportPlay() noexcept

  1320. {

  1321.     pData->time.playing = true;

  1322. }

  1323. 

  1324. void CarlaEngine::transportPause() noexcept

  1325. {

  1326.     pData->time.playing = false;

  1327. }

  1328. 

  1329. void CarlaEngine::transportRelocate(const uint64_t frame) noexcept

  1330. {

  1331.     pData->time.frame = frame;

  1332. }

  1333. 

  1334. // -----------------------------------------------------------------------

  1335. // Error handling

  1336. 

  1337. const char* CarlaEngine::getLastError() const noexcept

  1338. {

  1339.     return pData->lastError;

  1340. }

  1341. 

  1342. void CarlaEngine::setLastError(const char* const error) const noexcept

  1343. {

  1344.     pData->lastError = error;

  1345. }

  1346. 

  1347. void CarlaEngine::setAboutToClose() noexcept

  1348. {

  1349.     carla_debug("CarlaEngine::setAboutToClose()");

  1350. 

  1351.     pData->aboutToClose = true;

  1352. }

  1353. 

  1354. // -----------------------------------------------------------------------

  1355. // Global options

  1356. 

  1357. void CarlaEngine::setOption(const EngineOption option, const int value, const char* const valueStr) noexcept

  1358. {

  1359.     carla_debug("CarlaEngine::setOption(%i:%s, %i, \"%s\")", option, EngineOption2Str(option), value, valueStr);

  1360. 

  1361.     if (isRunning() && (option == ENGINE_OPTION_PROCESS_MODE || option == ENGINE_OPTION_AUDIO_NUM_PERIODS || option == ENGINE_OPTION_AUDIO_DEVICE))

  1362.         return carla_stderr("CarlaEngine::setOption(%i:%s, %i, \"%s\") - Cannot set this option while engine is running!", option, EngineOption2Str(option), value, valueStr);

  1363. 

  1364.     switch (option)

  1365.     {

  1366.     case ENGINE_OPTION_DEBUG:

  1367.     case ENGINE_OPTION_NSM_INIT:

  1368.         break;

  1369. 

  1370.     case ENGINE_OPTION_PROCESS_MODE:

  1371.         CARLA_SAFE_ASSERT_RETURN(value >= ENGINE_PROCESS_MODE_SINGLE_CLIENT && value <= ENGINE_PROCESS_MODE_BRIDGE,);

  1372.         pData->options.processMode = static_cast<EngineProcessMode>(value);

  1373.         break;

  1374. 

  1375.     case ENGINE_OPTION_TRANSPORT_MODE:

  1376.         CARLA_SAFE_ASSERT_RETURN(value >= ENGINE_TRANSPORT_MODE_INTERNAL && value <= ENGINE_TRANSPORT_MODE_BRIDGE,);

  1377.         pData->options.transportMode = static_cast<EngineTransportMode>(value);

  1378.         break;

  1379. 

  1380.     case ENGINE_OPTION_FORCE_STEREO:

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

  1382.         pData->options.forceStereo = (value != 0);

  1383.         break;

  1384. 

  1385.     case ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

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

  1387.         pData->options.preferPluginBridges = (value != 0);

  1388.         break;

  1389. 

  1390.     case ENGINE_OPTION_PREFER_UI_BRIDGES:

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

  1392.         pData->options.preferUiBridges = (value != 0);

  1393.         break;

  1394. 

  1395.     case ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

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

  1397.         pData->options.uisAlwaysOnTop = (value != 0);

  1398.         break;

  1399. 

  1400.     case ENGINE_OPTION_MAX_PARAMETERS:

  1401.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

  1402.         pData->options.maxParameters = static_cast<uint>(value);

  1403.         break;

  1404. 

  1405.     case ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  1406.         CARLA_SAFE_ASSERT_RETURN(value >= 0,);

  1407.         pData->options.uiBridgesTimeout = static_cast<uint>(value);

  1408.         break;

  1409. 

  1410.     case ENGINE_OPTION_AUDIO_NUM_PERIODS:

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

  1412.         pData->options.audioNumPeriods = static_cast<uint>(value);

  1413.         break;

  1414. 

  1415.     case ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  1416.         CARLA_SAFE_ASSERT_RETURN(value >= 8,);

  1417.         pData->options.audioBufferSize = static_cast<uint>(value);

  1418.         break;

  1419. 

  1420.     case ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  1421.         CARLA_SAFE_ASSERT_RETURN(value >= 22050,);

  1422.         pData->options.audioSampleRate = static_cast<uint>(value);

  1423.         break;

  1424. 

  1425.     case ENGINE_OPTION_AUDIO_DEVICE:

  1426.         CARLA_SAFE_ASSERT_RETURN(valueStr != nullptr,);

  1427. 

  1428.         if (pData->options.audioDevice != nullptr)

  1429.             delete[] pData->options.audioDevice;

  1430. 

  1431.         pData->options.audioDevice = carla_strdup_safe(valueStr);

  1432.         break;

  1433. 

  1434.     case ENGINE_OPTION_PATH_BINARIES:

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

  1436. 

  1437.         if (pData->options.binaryDir != nullptr)

  1438.             delete[] pData->options.binaryDir;

  1439. 

  1440.         pData->options.binaryDir = carla_strdup_safe(valueStr);

  1441.         break;

  1442. 

  1443.     case ENGINE_OPTION_PATH_RESOURCES:

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

  1445. 

  1446.         if (pData->options.resourceDir != nullptr)

  1447.             delete[] pData->options.resourceDir;

  1448. 

  1449.         pData->options.resourceDir = carla_strdup_safe(valueStr);

  1450.         break;

  1451. 

  1452.     case ENGINE_OPTION_FRONTEND_WIN_ID:

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

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

  1455.         CARLA_SAFE_ASSERT_RETURN(winId >= 0,);

  1456.         pData->options.frontendWinId = static_cast<uintptr_t>(winId);

  1457.         break;

  1458.     }

  1459. }

  1460. 

  1461. // -----------------------------------------------------------------------

  1462. // OSC Stuff

  1463. 

  1464. #ifdef BUILD_BRIDGE

  1465. bool CarlaEngine::isOscBridgeRegistered() const noexcept

  1466. {

  1467.     return (pData->oscData != nullptr);

  1468. }

  1469. #else

  1470. bool CarlaEngine::isOscControlRegistered() const noexcept

  1471. {

  1472.     return pData->osc.isControlRegistered();

  1473. }

  1474. #endif

  1475. 

  1476. void CarlaEngine::idleOsc() const noexcept

  1477. {

  1478.     pData->osc.idle();

  1479. }

  1480. 

  1481. const char* CarlaEngine::getOscServerPathTCP() const noexcept

  1482. {

  1483.     return pData->osc.getServerPathTCP();

  1484. }

  1485. 

  1486. const char* CarlaEngine::getOscServerPathUDP() const noexcept

  1487. {

  1488.     return pData->osc.getServerPathUDP();

  1489. }

  1490. 

  1491. #ifdef BUILD_BRIDGE

  1492. void CarlaEngine::setOscBridgeData(CarlaOscData* const oscData) const noexcept

  1493. {

  1494.     pData->oscData = oscData;

  1495. }

  1496. #endif

  1497. 

  1498. // -----------------------------------------------------------------------

  1499. // Helper functions

  1500. 

  1501. EngineEvent* CarlaEngine::getInternalEventBuffer(const bool isInput) const noexcept

  1502. {

  1503.     return isInput ? pData->events.in : pData->events.out;

  1504. }

  1505. 

  1506. void CarlaEngine::registerEnginePlugin(const uint id, CarlaPlugin* const plugin) noexcept

  1507. {

  1508.     CARLA_SAFE_ASSERT_RETURN(id == pData->curPluginCount,);

  1509.     carla_debug("CarlaEngine::registerEnginePlugin(%i, %p)", id, plugin);

  1510. 

  1511.     pData->plugins[id].plugin = plugin;

  1512. }

  1513. 

  1514. // -----------------------------------------------------------------------

  1515. // Internal stuff

  1516. 

  1517. void CarlaEngine::bufferSizeChanged(const uint32_t newBufferSize)

  1518. {

  1519.     carla_debug("CarlaEngine::bufferSizeChanged(%i)", newBufferSize);

  1520. 

  1521. #ifndef BUILD_BRIDGE

  1522.     pData->graph.setBufferSize(newBufferSize);

  1523. #endif

  1524. 

  1525.     for (uint i=0; i < pData->curPluginCount; ++i)

  1526.     {

  1527.         CarlaPlugin* const plugin(pData->plugins[i].plugin);

  1528. 

  1529.         if (plugin != nullptr && plugin->isEnabled())

  1530.             plugin->bufferSizeChanged(newBufferSize);

  1531.     }

  1532. 

  1533.     callback(ENGINE_CALLBACK_BUFFER_SIZE_CHANGED, 0, static_cast<int>(newBufferSize), 0, 0.0f, nullptr);

  1534. }

  1535. 

  1536. void CarlaEngine::sampleRateChanged(const double newSampleRate)

  1537. {

  1538.     carla_debug("CarlaEngine::sampleRateChanged(%g)", newSampleRate);

  1539. 

  1540. #ifndef BUILD_BRIDGE

  1541.     pData->graph.setSampleRate(newSampleRate);

  1542. #endif

  1543. 

  1544.     for (uint i=0; i < pData->curPluginCount; ++i)

  1545.     {

  1546.         CarlaPlugin* const plugin(pData->plugins[i].plugin);

  1547. 

  1548.         if (plugin != nullptr && plugin->isEnabled())

  1549.             plugin->sampleRateChanged(newSampleRate);

  1550.     }

  1551. 

  1552.     callback(ENGINE_CALLBACK_SAMPLE_RATE_CHANGED, 0, 0, 0, static_cast<float>(newSampleRate), nullptr);

  1553. }

  1554. 

  1555. void CarlaEngine::offlineModeChanged(const bool isOfflineNow)

  1556. {

  1557.     carla_debug("CarlaEngine::offlineModeChanged(%s)", bool2str(isOfflineNow));

  1558. 

  1559. #ifndef BUILD_BRIDGE

  1560.     pData->graph.setOffline(isOfflineNow);

  1561. #endif

  1562. 

  1563.     for (uint i=0; i < pData->curPluginCount; ++i)

  1564.     {

  1565.         CarlaPlugin* const plugin(pData->plugins[i].plugin);

  1566. 

  1567.         if (plugin != nullptr && plugin->isEnabled())

  1568.             plugin->offlineModeChanged(isOfflineNow);

  1569.     }

  1570. }

  1571. 

  1572. void CarlaEngine::runPendingRtEvents() noexcept

  1573. {

  1574.     pData->doNextPluginAction(true);

  1575. 

  1576.     if (pData->time.playing)

  1577.         pData->time.frame += pData->bufferSize;

  1578. 

  1579.     if (pData->options.transportMode == ENGINE_TRANSPORT_MODE_INTERNAL)

  1580.     {

  1581.         pData->timeInfo.playing = pData->time.playing;

  1582.         pData->timeInfo.frame   = pData->time.frame;

  1583.     }

  1584. }

  1585. 

  1586. void CarlaEngine::setPluginPeaks(const uint pluginId, float const inPeaks[2], float const outPeaks[2]) noexcept

  1587. {

  1588.     EnginePluginData& pluginData(pData->plugins[pluginId]);

  1589. 

  1590.     pluginData.insPeak[0]  = inPeaks[0];

  1591.     pluginData.insPeak[1]  = inPeaks[1];

  1592.     pluginData.outsPeak[0] = outPeaks[0];

  1593.     pluginData.outsPeak[1] = outPeaks[1];

  1594. }

  1595. 

  1596. // -----------------------------------------------------------------------

  1597. 

  1598. CARLA_BACKEND_END_NAMESPACE