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.
6529 Commits
16 Branches
14GB
Tree: 497b374848
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '497b374848'
${ noResults }
Carla/source/backend/plugin/CarlaPlugin.cpp

2738 lines
90KB
Raw Blame History 

  1. /*

  2.  * Carla Plugin

  3.  * Copyright (C) 2011-2022 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. #include "CarlaPluginInternal.hpp"

  19. #include "CarlaEngine.hpp"

  20. 

  21. #include "CarlaBackendUtils.hpp"

  22. #include "CarlaBase64Utils.hpp"

  23. #include "CarlaMathUtils.hpp"

  24. #include "CarlaMIDI.h"

  25. #include "CarlaPluginUI.hpp"

  26. #include "CarlaScopeUtils.hpp"

  27. #include "CarlaStringList.hpp"

  28. 

  29. #include <ctime>

  30. 

  31. #include "water/files/File.h"

  32. #include "water/streams/MemoryOutputStream.h"

  33. #include "water/xml/XmlDocument.h"

  34. #include "water/xml/XmlElement.h"

  35. 

  36. using water::CharPointer_UTF8;

  37. using water::File;

  38. using water::MemoryOutputStream;

  39. using water::Result;

  40. using water::String;

  41. using water::XmlDocument;

  42. using water::XmlElement;

  43. 

  44. CARLA_BACKEND_START_NAMESPACE

  45. 

  46. // -------------------------------------------------------------------------------------------------------------------

  47. // Fallback data

  48. 

  49. static const ParameterData   kParameterDataNull   = { PARAMETER_UNKNOWN, 0x0, PARAMETER_NULL, -1, 0, CONTROL_INDEX_NONE, 0.0f, 1.0f, 0x0 };

  50. static const ParameterRanges kParameterRangesNull = { 0.0f, 0.0f, 1.0f, 0.01f, 0.0001f, 0.1f };

  51. static const MidiProgramData kMidiProgramDataNull = { 0, 0, nullptr };

  52. 

  53. static const CustomData        kCustomDataFallback        = { nullptr, nullptr, nullptr };

  54. static /* */ CustomData        kCustomDataFallbackNC      = { nullptr, nullptr, nullptr };

  55. static const PluginPostRtEvent kPluginPostRtEventFallback = { kPluginPostRtEventNull, false, {} };

  56. 

  57. // -------------------------------------------------------------------------------------------------------------------

  58. // ParamSymbol struct, needed for CarlaPlugin::loadStateSave()

  59. 

  60. struct ParamSymbol {

  61.     int32_t index;

  62.     const char* symbol;

  63. 

  64.     ParamSymbol(const uint32_t i, const char* const s)

  65.         : index(static_cast<int32_t>(i)),

  66.           symbol(carla_strdup(s)) {}

  67. 

  68.     ~ParamSymbol() noexcept

  69.     {

  70.         CARLA_SAFE_ASSERT_RETURN(symbol != nullptr,)

  71. 

  72.         delete[] symbol;

  73.         symbol = nullptr;

  74.     }

  75. 

  76. #ifdef CARLA_PROPER_CPP11_SUPPORT

  77.     ParamSymbol() = delete;

  78.     CARLA_DECLARE_NON_COPYABLE(ParamSymbol)

  79. #endif

  80. };

  81. 

  82. // -------------------------------------------------------------------------------------------------------------------

  83. // Constructor and destructor

  84. 

  85. CarlaPlugin::CarlaPlugin(CarlaEngine* const engine, const uint id)

  86.     : pData(new ProtectedData(engine, id))

  87. {

  88.     CARLA_SAFE_ASSERT_RETURN(engine != nullptr,);

  89.     CARLA_SAFE_ASSERT(id < engine->getMaxPluginNumber());

  90.     carla_debug("CarlaPlugin::CarlaPlugin(%p, %i)", engine, id);

  91. 

  92.     switch (engine->getProccessMode())

  93.     {

  94.     case ENGINE_PROCESS_MODE_SINGLE_CLIENT:

  95.     case ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS:

  96.         CARLA_SAFE_ASSERT(id < MAX_DEFAULT_PLUGINS);

  97.         break;

  98. 

  99.     case ENGINE_PROCESS_MODE_CONTINUOUS_RACK:

  100.         CARLA_SAFE_ASSERT(id < MAX_RACK_PLUGINS);

  101.         break;

  102. 

  103.     case ENGINE_PROCESS_MODE_PATCHBAY:

  104.         CARLA_SAFE_ASSERT(id < MAX_PATCHBAY_PLUGINS);

  105.         break;

  106. 

  107.     case ENGINE_PROCESS_MODE_BRIDGE:

  108.         CARLA_SAFE_ASSERT(id == 0);

  109.         break;

  110.     }

  111. }

  112. 

  113. CarlaPlugin::~CarlaPlugin()

  114. {

  115.     carla_debug("CarlaPlugin::~CarlaPlugin()");

  116. 

  117.     delete pData;

  118. }

  119. 

  120. // -------------------------------------------------------------------

  121. // Information (base)

  122. 

  123. uint CarlaPlugin::getId() const noexcept

  124. {

  125.     return pData->id;

  126. }

  127. 

  128. uint CarlaPlugin::getHints() const noexcept

  129. {

  130.     return pData->hints;

  131. }

  132. 

  133. uint CarlaPlugin::getOptionsEnabled() const noexcept

  134. {

  135.     return pData->options;

  136. }

  137. 

  138. bool CarlaPlugin::isEnabled() const noexcept

  139. {

  140.     return pData->enabled;

  141. }

  142. 

  143. const char* CarlaPlugin::getName() const noexcept

  144. {

  145.     return pData->name;

  146. }

  147. 

  148. const char* CarlaPlugin::getFilename() const noexcept

  149. {

  150.     return pData->filename;

  151. }

  152. 

  153. const char* CarlaPlugin::getIconName() const noexcept

  154. {

  155.     return pData->iconName;

  156. }

  157. 

  158. PluginCategory CarlaPlugin::getCategory() const noexcept

  159. {

  160.     return getPluginCategoryFromName(pData->name);

  161. }

  162. 

  163. int64_t CarlaPlugin::getUniqueId() const noexcept

  164. {

  165.     return 0;

  166. }

  167. 

  168. uint32_t CarlaPlugin::getLatencyInFrames() const noexcept

  169. {

  170.     return 0;

  171. }

  172. 

  173. // -------------------------------------------------------------------

  174. // Information (count)

  175. 

  176. uint32_t CarlaPlugin::getAudioInCount() const noexcept

  177. {

  178.     return pData->audioIn.count;

  179. }

  180. 

  181. uint32_t CarlaPlugin::getAudioOutCount() const noexcept

  182. {

  183.     return pData->audioOut.count;

  184. }

  185. 

  186. uint32_t CarlaPlugin::getCVInCount() const noexcept

  187. {

  188.     return pData->cvIn.count;

  189. }

  190. 

  191. uint32_t CarlaPlugin::getCVOutCount() const noexcept

  192. {

  193.     return pData->cvOut.count;

  194. }

  195. 

  196. uint32_t CarlaPlugin::getMidiInCount() const noexcept

  197. {

  198.     return (pData->extraHints & PLUGIN_EXTRA_HINT_HAS_MIDI_IN) ? 1 : 0;

  199. }

  200. 

  201. uint32_t CarlaPlugin::getMidiOutCount() const noexcept

  202. {

  203.     return (pData->extraHints & PLUGIN_EXTRA_HINT_HAS_MIDI_OUT) ? 1 : 0;

  204. }

  205. 

  206. uint32_t CarlaPlugin::getParameterCount() const noexcept

  207. {

  208.     return pData->param.count;

  209. }

  210. 

  211. uint32_t CarlaPlugin::getParameterScalePointCount(const uint32_t parameterId) const noexcept

  212. {

  213.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count, 0);

  214.     return 0;

  215. }

  216. 

  217. uint32_t CarlaPlugin::getProgramCount() const noexcept

  218. {

  219.     return pData->prog.count;

  220. }

  221. 

  222. uint32_t CarlaPlugin::getMidiProgramCount() const noexcept

  223. {

  224.     return pData->midiprog.count;

  225. }

  226. 

  227. uint32_t CarlaPlugin::getCustomDataCount() const noexcept

  228. {

  229.     return static_cast<uint32_t>(pData->custom.count());

  230. }

  231. 

  232. // -------------------------------------------------------------------

  233. // Information (current data)

  234. 

  235. int32_t CarlaPlugin::getCurrentProgram() const noexcept

  236. {

  237.     return pData->prog.current;

  238. }

  239. 

  240. int32_t CarlaPlugin::getCurrentMidiProgram() const noexcept

  241. {

  242.     return pData->midiprog.current;

  243. }

  244. 

  245. uint CarlaPlugin::getAudioPortHints(bool, uint32_t) const noexcept

  246. {

  247.     return 0x0;

  248. }

  249. 

  250. const ParameterData& CarlaPlugin::getParameterData(const uint32_t parameterId) const noexcept

  251. {

  252.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count, kParameterDataNull);

  253.     return pData->param.data[parameterId];

  254. }

  255. 

  256. const ParameterRanges& CarlaPlugin::getParameterRanges(const uint32_t parameterId) const noexcept

  257. {

  258.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count, kParameterRangesNull);

  259.     return pData->param.ranges[parameterId];

  260. }

  261. 

  262. bool CarlaPlugin::isParameterOutput(const uint32_t parameterId) const noexcept

  263. {

  264.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count, false);

  265.     return (pData->param.data[parameterId].type == PARAMETER_OUTPUT);

  266. }

  267. 

  268. const MidiProgramData& CarlaPlugin::getMidiProgramData(const uint32_t index) const noexcept

  269. {

  270.     CARLA_SAFE_ASSERT_RETURN(index < pData->midiprog.count, kMidiProgramDataNull);

  271.     return pData->midiprog.data[index];

  272. }

  273. 

  274. const CustomData& CarlaPlugin::getCustomData(const uint32_t index) const noexcept

  275. {

  276.     return pData->custom.getAt(index, kCustomDataFallback);

  277. }

  278. 

  279. std::size_t CarlaPlugin::getChunkData(void** const dataPtr) noexcept

  280. {

  281.     CARLA_SAFE_ASSERT_RETURN(dataPtr != nullptr, 0);

  282.     CARLA_SAFE_ASSERT(false); // this should never happen

  283.     return 0;

  284. }

  285. 

  286. // -------------------------------------------------------------------

  287. // Information (per-plugin data)

  288. 

  289. uint CarlaPlugin::getOptionsAvailable() const noexcept

  290. {

  291.     CARLA_SAFE_ASSERT(false); // this should never happen

  292.     return 0x0;

  293. }

  294. 

  295. float CarlaPlugin::getParameterValue(const uint32_t parameterId) const noexcept

  296. {

  297.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), 0.0f);

  298.     CARLA_SAFE_ASSERT(false); // this should never happen

  299.     return 0.0f;

  300. }

  301. 

  302. float CarlaPlugin::getParameterScalePointValue(const uint32_t parameterId, const uint32_t scalePointId) const noexcept

  303. {

  304.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), 0.0f);

  305.     CARLA_SAFE_ASSERT_RETURN(scalePointId < getParameterScalePointCount(parameterId), 0.0f);

  306.     CARLA_SAFE_ASSERT(false); // this should never happen

  307.     return 0.0f;

  308. }

  309. 

  310. bool CarlaPlugin::getLabel(char* const strBuf) const noexcept

  311. {

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

  313.     return false;

  314. }

  315. 

  316. bool CarlaPlugin::getMaker(char* const strBuf) const noexcept

  317. {

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

  319.     return false;

  320. }

  321. 

  322. bool CarlaPlugin::getCopyright(char* const strBuf) const noexcept

  323. {

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

  325.     return false;

  326. }

  327. 

  328. bool CarlaPlugin::getRealName(char* const strBuf) const noexcept

  329. {

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

  331.     return false;

  332. }

  333. 

  334. bool CarlaPlugin::getParameterName(const uint32_t parameterId, char* const strBuf) const noexcept

  335. {

  336.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

  337.     CARLA_SAFE_ASSERT(false); // this should never happen

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

  339.     return false;

  340. }

  341. 

  342. bool CarlaPlugin::getParameterSymbol(const uint32_t parameterId, char* const strBuf) const noexcept

  343. {

  344.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

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

  346.     return false;

  347. }

  348. 

  349. bool CarlaPlugin::getParameterText(const uint32_t parameterId, char* const strBuf) noexcept

  350. {

  351.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

  352.     CARLA_SAFE_ASSERT(false); // this should never happen

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

  354.     return false;

  355. }

  356. 

  357. bool CarlaPlugin::getParameterUnit(const uint32_t parameterId, char* const strBuf) const noexcept

  358. {

  359.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

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

  361.     return false;

  362. }

  363. 

  364. bool CarlaPlugin::getParameterComment(const uint32_t parameterId, char* const strBuf) const noexcept

  365. {

  366.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

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

  368.     return false;

  369. }

  370. 

  371. bool CarlaPlugin::getParameterGroupName(const uint32_t parameterId, char* const strBuf) const noexcept

  372. {

  373.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

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

  375.     return false;

  376. }

  377. 

  378. bool CarlaPlugin::getParameterScalePointLabel(const uint32_t parameterId, const uint32_t scalePointId, char* const strBuf) const noexcept

  379. {

  380.     CARLA_SAFE_ASSERT_RETURN(parameterId < getParameterCount(), false);

  381.     CARLA_SAFE_ASSERT_RETURN(scalePointId < getParameterScalePointCount(parameterId), false);

  382.     CARLA_SAFE_ASSERT(false); // this should never happen

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

  384.     return false;

  385. }

  386. 

  387. float CarlaPlugin::getInternalParameterValue(const int32_t parameterId) const noexcept

  388. {

  389. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  390.     CARLA_SAFE_ASSERT_RETURN(parameterId != PARAMETER_NULL && parameterId > PARAMETER_MAX, 0.0f);

  391. 

  392.     switch (parameterId)

  393.     {

  394.     case PARAMETER_ACTIVE:

  395.         return pData->active;

  396.     case PARAMETER_CTRL_CHANNEL:

  397.         return pData->ctrlChannel;

  398.     case PARAMETER_DRYWET:

  399.         return pData->postProc.dryWet;

  400.     case PARAMETER_VOLUME:

  401.         return pData->postProc.volume;

  402.     case PARAMETER_BALANCE_LEFT:

  403.         return pData->postProc.balanceLeft;

  404.     case PARAMETER_BALANCE_RIGHT:

  405.         return pData->postProc.balanceRight;

  406.     case PARAMETER_PANNING:

  407.         return pData->postProc.panning;

  408.     };

  409. #endif

  410.     CARLA_SAFE_ASSERT_RETURN(parameterId >= 0, 0.0f);

  411. 

  412.     return getParameterValue(static_cast<uint32_t>(parameterId));

  413. }

  414. 

  415. bool CarlaPlugin::getProgramName(const uint32_t index, char* const strBuf) const noexcept

  416. {

  417.     CARLA_SAFE_ASSERT_RETURN(index < pData->prog.count, false);

  418.     CARLA_SAFE_ASSERT_RETURN(pData->prog.names[index] != nullptr, false);

  419.     std::strncpy(strBuf, pData->prog.names[index], STR_MAX);

  420.     return true;

  421. }

  422. 

  423. bool CarlaPlugin::getMidiProgramName(const uint32_t index, char* const strBuf) const noexcept

  424. {

  425.     CARLA_SAFE_ASSERT_RETURN(index < pData->midiprog.count, false);

  426.     CARLA_SAFE_ASSERT_RETURN(pData->midiprog.data[index].name != nullptr, false);

  427.     std::strncpy(strBuf, pData->midiprog.data[index].name, STR_MAX);

  428.     return true;

  429. }

  430. 

  431. void CarlaPlugin::getParameterCountInfo(uint32_t& ins, uint32_t& outs) const noexcept

  432. {

  433.     ins  = 0;

  434.     outs = 0;

  435. 

  436.     for (uint32_t i=0; i < pData->param.count; ++i)

  437.     {

  438.         if (pData->param.data[i].type == PARAMETER_INPUT)

  439.             ++ins;

  440.         else if (pData->param.data[i].type == PARAMETER_OUTPUT)

  441.             ++outs;

  442.     }

  443. }

  444. 

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

  446. // Set data (state)

  447. 

  448. void CarlaPlugin::prepareForSave(bool)

  449. {

  450. }

  451. 

  452. void CarlaPlugin::resetParameters() noexcept

  453. {

  454.     for (uint i=0; i < pData->param.count; ++i)

  455.     {

  456.         const ParameterData&   paramData(pData->param.data[i]);

  457.         const ParameterRanges& paramRanges(pData->param.ranges[i]);

  458. 

  459.         if (paramData.type != PARAMETER_INPUT)

  460.             continue;

  461.         if ((paramData.hints & PARAMETER_IS_ENABLED) == 0)

  462.             continue;

  463. 

  464.         setParameterValue(i, paramRanges.def, true, true, true);

  465.     }

  466. }

  467. 

  468. void CarlaPlugin::randomizeParameters() noexcept

  469. {

  470.     float value, random;

  471. 

  472.     char strBuf[STR_MAX+1];

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

  474. 

  475.     std::srand(static_cast<uint>(std::time(nullptr)));

  476. 

  477.     for (uint i=0; i < pData->param.count; ++i)

  478.     {

  479.         const ParameterData& paramData(pData->param.data[i]);

  480. 

  481.         if (paramData.type != PARAMETER_INPUT)

  482.             continue;

  483.         if ((paramData.hints & PARAMETER_IS_ENABLED) == 0)

  484.             continue;

  485. 

  486.         if (! getParameterName(i, strBuf))

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

  488. 

  489.         if (std::strstr(strBuf, "olume") != nullptr)

  490.             continue;

  491.         if (std::strstr(strBuf, "Master") != nullptr)

  492.             continue;

  493. 

  494.         const ParameterRanges& paramRanges(pData->param.ranges[i]);

  495. 

  496.         if (paramData.hints & PARAMETER_IS_BOOLEAN)

  497.         {

  498.             random = static_cast<float>(std::rand()) / static_cast<float>(RAND_MAX);

  499.             value  = random > 0.5f ? paramRanges.max : paramRanges.min;

  500.         }

  501.         else

  502.         {

  503.             random = static_cast<float>(std::rand()) / static_cast<float>(RAND_MAX);

  504.             value  = random * (paramRanges.max - paramRanges.min) + paramRanges.min;

  505. 

  506.             if (paramData.hints & PARAMETER_IS_INTEGER)

  507.                 value = std::rint(value);

  508.         }

  509. 

  510.         setParameterValue(i, value, true, true, true);

  511.     }

  512. }

  513. 

  514. const CarlaStateSave& CarlaPlugin::getStateSave(const bool callPrepareForSave)

  515. {

  516.     pData->stateSave.clear();

  517. 

  518.     if (callPrepareForSave)

  519.     {

  520.         pData->stateSave.temporary = true;

  521.         prepareForSave(true);

  522.     }

  523. 

  524.     const PluginType pluginType(getType());

  525. 

  526.     char strBuf[STR_MAX+1];

  527.     carla_zeroChars(strBuf, STR_MAX+1);

  528. 

  529.     // ---------------------------------------------------------------

  530.     // Basic info

  531. 

  532.     if (! getLabel(strBuf))

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

  534. 

  535.     pData->stateSave.type     = carla_strdup(getPluginTypeAsString(pluginType));

  536.     pData->stateSave.name     = carla_strdup(pData->name);

  537.     pData->stateSave.label    = carla_strdup(strBuf);

  538.     pData->stateSave.uniqueId = getUniqueId();

  539. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  540.     pData->stateSave.options  = pData->options;

  541. #endif

  542. 

  543.     if (pData->filename != nullptr)

  544.         pData->stateSave.binary = carla_strdup(pData->filename);

  545. 

  546. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  547.     // ---------------------------------------------------------------

  548.     // Internals

  549. 

  550.     pData->stateSave.active       = pData->active;

  551.     pData->stateSave.dryWet       = pData->postProc.dryWet;

  552.     pData->stateSave.volume       = pData->postProc.volume;

  553.     pData->stateSave.balanceLeft  = pData->postProc.balanceLeft;

  554.     pData->stateSave.balanceRight = pData->postProc.balanceRight;

  555.     pData->stateSave.panning      = pData->postProc.panning;

  556.     pData->stateSave.ctrlChannel  = pData->ctrlChannel;

  557. #endif

  558. 

  559.     if (pData->hints & PLUGIN_IS_BRIDGE)

  560.         waitForBridgeSaveSignal();

  561. 

  562.     // ---------------------------------------------------------------

  563.     // Chunk

  564. 

  565.     bool usingChunk = false;

  566. 

  567.     if (pData->options & PLUGIN_OPTION_USE_CHUNKS)

  568.     {

  569.         void* data = nullptr;

  570.         const std::size_t dataSize(getChunkData(&data));

  571. 

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

  573.         {

  574.             pData->stateSave.chunk = CarlaString::asBase64(data, dataSize).dup();

  575. 

  576.             if (pluginType != PLUGIN_INTERNAL && pluginType != PLUGIN_JSFX)

  577.                 usingChunk = true;

  578.         }

  579.     }

  580. 

  581.     // ---------------------------------------------------------------

  582.     // Current Program

  583. 

  584.     if (pData->prog.current >= 0 && pluginType != PLUGIN_LV2)

  585.     {

  586.         pData->stateSave.currentProgramIndex = pData->prog.current;

  587.         pData->stateSave.currentProgramName  = carla_strdup(pData->prog.names[pData->prog.current]);

  588.     }

  589. 

  590.     // ---------------------------------------------------------------

  591.     // Current MIDI Program

  592. 

  593.     if (pData->midiprog.current >= 0 && pluginType != PLUGIN_LV2 && pluginType != PLUGIN_SF2)

  594.     {

  595.         const MidiProgramData& mpData(pData->midiprog.getCurrent());

  596. 

  597.         pData->stateSave.currentMidiBank    = static_cast<int32_t>(mpData.bank);

  598.         pData->stateSave.currentMidiProgram = static_cast<int32_t>(mpData.program);

  599.     }

  600. 

  601.     // ---------------------------------------------------------------

  602.     // Parameters

  603. 

  604.     const float sampleRate(static_cast<float>(pData->engine->getSampleRate()));

  605. 

  606.     for (uint32_t i=0; i < pData->param.count; ++i)

  607.     {

  608.         const ParameterData& paramData(pData->param.data[i]);

  609. 

  610.         if ((paramData.hints & PARAMETER_IS_ENABLED) == 0)

  611.             continue;

  612.         if (paramData.hints & PARAMETER_IS_NOT_SAVED)

  613.             continue;

  614. 

  615.         const bool dummy = paramData.type != PARAMETER_INPUT || usingChunk;

  616. 

  617.         if (dummy && paramData.mappedControlIndex <= CONTROL_INDEX_NONE)

  618.             continue;

  619. 

  620.         CarlaStateSave::Parameter* const stateParameter(new CarlaStateSave::Parameter());

  621. 

  622.         stateParameter->dummy = dummy;

  623.         stateParameter->index = paramData.index;

  624. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  625.         if (paramData.mappedControlIndex != CONTROL_INDEX_MIDI_LEARN)

  626.         {

  627.             stateParameter->mappedControlIndex = paramData.mappedControlIndex;

  628.             stateParameter->midiChannel        = paramData.midiChannel;

  629. 

  630.             if (paramData.hints & PARAMETER_MAPPED_RANGES_SET)

  631.             {

  632.                 stateParameter->mappedMinimum = paramData.mappedMinimum;

  633.                 stateParameter->mappedMaximum = paramData.mappedMaximum;

  634.                 stateParameter->mappedRangeValid = true;

  635. 

  636.                 if (paramData.hints & PARAMETER_USES_SAMPLERATE)

  637.                 {

  638.                     stateParameter->mappedMinimum /= sampleRate;

  639.                     stateParameter->mappedMaximum /= sampleRate;

  640.                 }

  641.             }

  642.         }

  643. #endif

  644. 

  645.         if (! getParameterName(i, strBuf))

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

  647.         stateParameter->name = carla_strdup(strBuf);

  648. 

  649.         if (! getParameterSymbol(i, strBuf))

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

  651.         stateParameter->symbol = carla_strdup(strBuf);;

  652. 

  653.         if (! dummy)

  654.         {

  655.             stateParameter->value = getParameterValue(i);

  656. 

  657.             if (paramData.hints & PARAMETER_USES_SAMPLERATE)

  658.                 stateParameter->value /= sampleRate;

  659.         }

  660. 

  661.         pData->stateSave.parameters.append(stateParameter);

  662.     }

  663. 

  664.     // ---------------------------------------------------------------

  665.     // Custom Data

  666. 

  667.     for (LinkedList<CustomData>::Itenerator it = pData->custom.begin2(); it.valid(); it.next())

  668.     {

  669.         const CustomData& cData(it.getValue(kCustomDataFallback));

  670.         CARLA_SAFE_ASSERT_CONTINUE(cData.isValid());

  671. 

  672.         CarlaStateSave::CustomData* stateCustomData(new CarlaStateSave::CustomData());

  673. 

  674.         stateCustomData->type  = carla_strdup(cData.type);

  675.         stateCustomData->key   = carla_strdup(cData.key);

  676.         stateCustomData->value = carla_strdup(cData.value);

  677. 

  678.         pData->stateSave.customData.append(stateCustomData);

  679.     }

  680. 

  681.     return pData->stateSave;

  682. }

  683. 

  684. void CarlaPlugin::loadStateSave(const CarlaStateSave& stateSave)

  685. {

  686.     const bool usesMultiProgs(pData->hints & PLUGIN_USES_MULTI_PROGS);

  687.     const PluginType pluginType(getType());

  688. 

  689.     char strBuf[STR_MAX+1];

  690.     carla_zeroChars(strBuf, STR_MAX+1);

  691. 

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

  693.     // Part 1 - PRE-set custom data (only those which reload programs)

  694. 

  695.     for (CarlaStateSave::CustomDataItenerator it = stateSave.customData.begin2(); it.valid(); it.next())

  696.     {

  697.         const CarlaStateSave::CustomData* const stateCustomData(it.getValue(nullptr));

  698.         CARLA_SAFE_ASSERT_CONTINUE(stateCustomData != nullptr);

  699.         CARLA_SAFE_ASSERT_CONTINUE(stateCustomData->isValid());

  700. 

  701.         const char* const key(stateCustomData->key);

  702. 

  703.         /**/ if (pluginType == PLUGIN_DSSI && (std::strcmp (key, "reloadprograms") == 0 ||

  704.                                                std::strcmp (key, "load"          ) == 0 ||

  705.                                                std::strncmp(key, "patches",     7) == 0 ))

  706.             pass();

  707.         else if (usesMultiProgs && std::strcmp(key, "midiPrograms") == 0)

  708.             pass();

  709.         else

  710.             continue;

  711. 

  712.         setCustomData(stateCustomData->type, key, stateCustomData->value, true);

  713.     }

  714. 

  715.     // ---------------------------------------------------------------

  716.     // Part 2 - set program

  717. 

  718.     if (stateSave.currentProgramIndex >= 0 && stateSave.currentProgramName != nullptr)

  719.     {

  720.         int32_t programId = -1;

  721. 

  722.         // index < count

  723.         if (stateSave.currentProgramIndex < static_cast<int32_t>(pData->prog.count))

  724.         {

  725.             programId = stateSave.currentProgramIndex;

  726.         }

  727.         // index not valid, try to find by name

  728.         else

  729.         {

  730.             for (uint32_t i=0; i < pData->prog.count; ++i)

  731.             {

  732.                 if (getProgramName(i, strBuf) && std::strcmp(stateSave.currentProgramName, strBuf) == 0)

  733.                 {

  734.                     programId = static_cast<int32_t>(i);

  735.                     break;

  736.                 }

  737.             }

  738.         }

  739. 

  740.         // set program now, if valid

  741.         if (programId >= 0)

  742.             setProgram(programId, true, true, true);

  743.     }

  744. 

  745.     // ---------------------------------------------------------------

  746.     // Part 3 - set midi program

  747. 

  748.     if (stateSave.currentMidiBank >= 0 && stateSave.currentMidiProgram >= 0 && ! usesMultiProgs)

  749.         setMidiProgramById(static_cast<uint32_t>(stateSave.currentMidiBank), static_cast<uint32_t>(stateSave.currentMidiProgram), true, true, true);

  750. 

  751.     // ---------------------------------------------------------------

  752.     // Part 4a - get plugin parameter symbols

  753. 

  754.     LinkedList<ParamSymbol*> paramSymbols;

  755. 

  756.     if (pluginType == PLUGIN_LADSPA || pluginType == PLUGIN_LV2)

  757.     {

  758.         for (uint32_t i=0; i < pData->param.count; ++i)

  759.         {

  760.             if (pData->param.data[i].hints & PARAMETER_IS_NOT_SAVED)

  761.                 continue;

  762. 

  763.             if (getParameterSymbol(i, strBuf))

  764.             {

  765.                 ParamSymbol* const paramSymbol(new ParamSymbol(i, strBuf));

  766.                 paramSymbols.append(paramSymbol);

  767.             }

  768.         }

  769.     }

  770. 

  771.     // ---------------------------------------------------------------

  772.     // Part 4b - set parameter values (carefully)

  773. 

  774.     const float sampleRate(static_cast<float>(pData->engine->getSampleRate()));

  775. 

  776.     for (CarlaStateSave::ParameterItenerator it = stateSave.parameters.begin2(); it.valid(); it.next())

  777.     {

  778.         CarlaStateSave::Parameter* const stateParameter(it.getValue(nullptr));

  779.         CARLA_SAFE_ASSERT_CONTINUE(stateParameter != nullptr);

  780. 

  781.         int32_t index = -1;

  782. 

  783.         if (pluginType == PLUGIN_LADSPA)

  784.         {

  785.             // Try to set by symbol, otherwise use index

  786.             if (stateParameter->symbol != nullptr && stateParameter->symbol[0] != '\0')

  787.             {

  788.                 for (LinkedList<ParamSymbol*>::Itenerator it2 = paramSymbols.begin2(); it2.valid(); it2.next())

  789.                 {

  790.                     ParamSymbol* const paramSymbol(it2.getValue(nullptr));

  791.                     CARLA_SAFE_ASSERT_CONTINUE(paramSymbol != nullptr);

  792.                     CARLA_SAFE_ASSERT_CONTINUE(paramSymbol->symbol != nullptr);

  793. 

  794.                     if (std::strcmp(stateParameter->symbol, paramSymbol->symbol) == 0)

  795.                     {

  796.                         index = paramSymbol->index;

  797.                         break;

  798.                     }

  799.                 }

  800.                 if (index == -1)

  801.                     index = stateParameter->index;

  802.             }

  803.             else

  804.             {

  805.                 index = stateParameter->index;

  806.             }

  807.         }

  808.         else if (pluginType == PLUGIN_LV2)

  809.         {

  810.             // Symbol only

  811.             if (stateParameter->symbol != nullptr && stateParameter->symbol[0] != '\0')

  812.             {

  813.                 for (LinkedList<ParamSymbol*>::Itenerator it2 = paramSymbols.begin2(); it2.valid(); it2.next())

  814.                 {

  815.                     ParamSymbol* const paramSymbol(it2.getValue(nullptr));

  816.                     CARLA_SAFE_ASSERT_CONTINUE(paramSymbol != nullptr);

  817.                     CARLA_SAFE_ASSERT_CONTINUE(paramSymbol->symbol != nullptr);

  818. 

  819.                     if (std::strcmp(stateParameter->symbol, paramSymbol->symbol) == 0)

  820.                     {

  821.                         index = paramSymbol->index;

  822.                         break;

  823.                     }

  824.                 }

  825.                 if (index == -1)

  826.                     carla_stderr("Failed to find LV2 parameter symbol '%s' for '%s'",

  827.                                  stateParameter->symbol, pData->name);

  828.             }

  829.             else

  830.             {

  831.                 carla_stderr("LV2 Plugin parameter '%s' has no symbol", stateParameter->name);

  832.             }

  833.         }

  834.         else

  835.         {

  836.             // Index only

  837.             index = stateParameter->index;

  838.         }

  839. 

  840.         // Now set parameter

  841.         if (index >= 0 && index < static_cast<int32_t>(pData->param.count))

  842.         {

  843.             //CARLA_SAFE_ASSERT(stateParameter->isInput == (pData

  844. 

  845.             if (! stateParameter->dummy)

  846.             {

  847.                 if (pData->param.data[index].hints & PARAMETER_USES_SAMPLERATE)

  848.                     stateParameter->value *= sampleRate;

  849. 

  850.                 setParameterValue(static_cast<uint32_t>(index), stateParameter->value, true, true, true);

  851.             }

  852. 

  853. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  854.             if (stateParameter->mappedRangeValid)

  855.             {

  856.                 if (pData->param.data[index].hints & PARAMETER_USES_SAMPLERATE)

  857.                 {

  858.                     stateParameter->mappedMinimum *= sampleRate;

  859.                     stateParameter->mappedMaximum *= sampleRate;

  860.                 }

  861. 

  862.                 setParameterMappedRange(static_cast<uint32_t>(index),

  863.                                         stateParameter->mappedMinimum,

  864.                                         stateParameter->mappedMaximum, true, true);

  865.             }

  866. 

  867.             setParameterMappedControlIndex(static_cast<uint32_t>(index),

  868.                                            stateParameter->mappedControlIndex, true, true, false);

  869.             setParameterMidiChannel(static_cast<uint32_t>(index), stateParameter->midiChannel, true, true);

  870. #endif

  871.         }

  872.         else

  873.             carla_stderr("Could not set parameter '%s' value for '%s'",

  874.                          stateParameter->name, pData->name);

  875.     }

  876. 

  877.     // ---------------------------------------------------------------

  878.     // Part 4c - clear

  879. 

  880.     for (LinkedList<ParamSymbol*>::Itenerator it = paramSymbols.begin2(); it.valid(); it.next())

  881.     {

  882.         ParamSymbol* const paramSymbol(it.getValue(nullptr));

  883.         delete paramSymbol;

  884.     }

  885. 

  886.     paramSymbols.clear();

  887. 

  888.     // ---------------------------------------------------------------

  889.     // Part 5 - set custom data

  890. 

  891.     for (CarlaStateSave::CustomDataItenerator it = stateSave.customData.begin2(); it.valid(); it.next())

  892.     {

  893.         const CarlaStateSave::CustomData* const stateCustomData(it.getValue(nullptr));

  894.         CARLA_SAFE_ASSERT_CONTINUE(stateCustomData != nullptr);

  895.         CARLA_SAFE_ASSERT_CONTINUE(stateCustomData->isValid());

  896. 

  897.         const char* const key(stateCustomData->key);

  898. 

  899.         if (pluginType == PLUGIN_DSSI && (std::strcmp (key, "reloadprograms") == 0 ||

  900.                                           std::strcmp (key, "load"          ) == 0 ||

  901.                                           std::strncmp(key, "patches",     7) == 0 ))

  902.             continue;

  903.         if (usesMultiProgs && std::strcmp(key, "midiPrograms") == 0)

  904.             continue;

  905. 

  906.         setCustomData(stateCustomData->type, key, stateCustomData->value, true);

  907.     }

  908. 

  909.     // ---------------------------------------------------------------

  910.     // Part 5x - set lv2 state

  911. 

  912.     if (pluginType == PLUGIN_LV2)

  913.     {

  914.         for (LinkedList<CustomData>::Itenerator it = pData->custom.begin2(); it.valid(); it.next())

  915.         {

  916.             const CustomData& customData(it.getValue(kCustomDataFallback));

  917.             CARLA_SAFE_ASSERT_CONTINUE(customData.isValid());

  918. 

  919.             if (std::strcmp(customData.type, CUSTOM_DATA_TYPE_PROPERTY) == 0)

  920.                 continue;

  921. 

  922.             restoreLV2State(stateSave.temporary);

  923.             break;

  924.         }

  925.     }

  926. 

  927.     // ---------------------------------------------------------------

  928.     // Part 6 - set chunk

  929. 

  930.     if (stateSave.chunk != nullptr && (pData->options & PLUGIN_OPTION_USE_CHUNKS) != 0)

  931.     {

  932.         std::vector<uint8_t> chunk(carla_getChunkFromBase64String(stateSave.chunk));

  933. #ifdef CARLA_PROPER_CPP11_SUPPORT

  934.         setChunkData(chunk.data(), chunk.size());

  935. #else

  936.         setChunkData(&chunk.front(), chunk.size());

  937. #endif

  938.     }

  939. 

  940. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  941.     // ---------------------------------------------------------------

  942.     // Part 6 - set internal stuff

  943. 

  944.     const uint availOptions(getOptionsAvailable());

  945. 

  946.     for (uint i=0; i<10; ++i) // FIXME - get this value somehow...

  947.     {

  948.         const uint option(1u << i);

  949. 

  950.         if (availOptions & option)

  951.             setOption(option, (stateSave.options & option) != 0, true);

  952.     }

  953. 

  954.     setDryWet(stateSave.dryWet, true, true);

  955.     setVolume(stateSave.volume, true, true);

  956.     setBalanceLeft(stateSave.balanceLeft, true, true);

  957.     setBalanceRight(stateSave.balanceRight, true, true);

  958.     setPanning(stateSave.panning, true, true);

  959.     setCtrlChannel(stateSave.ctrlChannel, true, true);

  960.     setActive(stateSave.active, true, true);

  961. 

  962.     if (! pData->engine->isLoadingProject())

  963.         pData->engine->callback(true, true, ENGINE_CALLBACK_UPDATE, pData->id, 0, 0, 0, 0.0f, nullptr);

  964. #endif

  965. }

  966. 

  967. bool CarlaPlugin::saveStateToFile(const char* const filename)

  968. {

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

  970.     carla_debug("CarlaPlugin::saveStateToFile(\"%s\")", filename);

  971. 

  972.     MemoryOutputStream out, streamState;

  973.     getStateSave().dumpToMemoryStream(streamState);

  974. 

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

  976.     out << "<!DOCTYPE CARLA-PRESET>\n";

  977.     out << "<CARLA-PRESET VERSION='2.0'>\n";

  978.     out << streamState;

  979.     out << "</CARLA-PRESET>\n";

  980. 

  981.     const String jfilename = String(CharPointer_UTF8(filename));

  982.     File file(jfilename);

  983. 

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

  985.         return true;

  986. 

  987.     pData->engine->setLastError("Failed to write file");

  988.     return false;

  989. }

  990. 

  991. bool CarlaPlugin::loadStateFromFile(const char* const filename)

  992. {

  993.     // TODO set errors

  994. 

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

  996.     carla_debug("CarlaPlugin::loadStateFromFile(\"%s\")", filename);

  997. 

  998.     const String jfilename = String(CharPointer_UTF8(filename));

  999.     File file(jfilename);

  1000.     CARLA_SAFE_ASSERT_RETURN(file.existsAsFile(), false);

  1001. 

  1002.     XmlDocument xml(file);

  1003.     CarlaScopedPointer<XmlElement> xmlElement(xml.getDocumentElement(true));

  1004.     CARLA_SAFE_ASSERT_RETURN(xmlElement != nullptr, false);

  1005.     CARLA_SAFE_ASSERT_RETURN(xmlElement->getTagName().equalsIgnoreCase("carla-preset"), false);

  1006. 

  1007.     // completely load file

  1008.     xmlElement = xml.getDocumentElement(false);

  1009.     CARLA_SAFE_ASSERT_RETURN(xmlElement != nullptr, false);

  1010. 

  1011.     if (pData->stateSave.fillFromXmlElement(xmlElement))

  1012.     {

  1013.         loadStateSave(pData->stateSave);

  1014.         return true;

  1015.     }

  1016. 

  1017.     return false;

  1018. }

  1019. 

  1020. bool CarlaPlugin::exportAsLV2(const char* const lv2path)

  1021. {

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

  1023.     carla_debug("CarlaPlugin::exportAsLV2(\"%s\")", lv2path);

  1024. 

  1025.     CarlaString bundlepath(lv2path);

  1026. 

  1027.     if (! bundlepath.endsWith(".lv2"))

  1028.         bundlepath += ".lv2";

  1029. 

  1030.     const File bundlefolder(bundlepath.buffer());

  1031. 

  1032.     if (bundlefolder.existsAsFile())

  1033.     {

  1034.         pData->engine->setLastError("Requested filename already exists as file, use a folder instead");

  1035.         return false;

  1036.     }

  1037. 

  1038.     if (! bundlefolder.exists())

  1039.     {

  1040.         const Result res(bundlefolder.createDirectory());

  1041. 

  1042.         if (res.failed())

  1043.         {

  1044.             pData->engine->setLastError(res.getErrorMessage().c_str());

  1045.             return false;

  1046.         }

  1047.     }

  1048. 

  1049.     CarlaString symbol(pData->name);

  1050.     symbol.toBasic();

  1051. 

  1052.     {

  1053.         const CarlaString pluginFilename(bundlepath + CARLA_OS_SEP_STR + symbol + ".xml");

  1054. 

  1055.         if (! saveStateToFile(pluginFilename))

  1056.             return false;

  1057.     }

  1058. 

  1059.     {

  1060.         MemoryOutputStream manifestStream;

  1061. 

  1062.         manifestStream << "@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .\n";

  1063.         manifestStream << "@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .\n";

  1064.         manifestStream << "@prefix ui:   <http://lv2plug.in/ns/extensions/ui#> .\n";

  1065.         manifestStream << "\n";

  1066.         manifestStream << "<" << symbol.buffer() << ".ttl>\n";

  1067.         manifestStream << "    a lv2:Plugin ;\n";

  1068.         manifestStream << "    lv2:binary <" << symbol.buffer() << CARLA_LIB_EXT "> ;\n";

  1069.         manifestStream << "    rdfs:seeAlso <" << symbol.buffer() << ".ttl> .\n";

  1070.         manifestStream << "\n";

  1071.         manifestStream << "<ext-ui>\n";

  1072.         manifestStream << "    a <http://kxstudio.sf.net/ns/lv2ext/external-ui#Widget> ;\n";

  1073.         manifestStream << "    ui:binary <" << symbol.buffer() << CARLA_LIB_EXT "> ;\n";

  1074.         manifestStream << "    lv2:extensionData <http://lv2plug.in/ns/extensions/ui#idleInterface> ,\n";

  1075.         manifestStream << "                      <http://lv2plug.in/ns/extensions/ui#showInterface> ;\n";

  1076.         manifestStream << "    lv2:requiredFeature <http://lv2plug.in/ns/ext/instance-access> .\n";

  1077.         manifestStream << "\n";

  1078. 

  1079.         const CarlaString manifestFilename(bundlepath + CARLA_OS_SEP_STR "manifest.ttl");

  1080.         const File manifestFile(manifestFilename.buffer());

  1081. 

  1082.         if (! manifestFile.replaceWithData(manifestStream.getData(), manifestStream.getDataSize()))

  1083.         {

  1084.             pData->engine->setLastError("Failed to write manifest.ttl file");

  1085.             return false;

  1086.         }

  1087.     }

  1088. 

  1089.     {

  1090.         MemoryOutputStream mainStream;

  1091. 

  1092.         mainStream << "@prefix atom: <http://lv2plug.in/ns/ext/atom#> .\n";

  1093.         mainStream << "@prefix doap: <http://usefulinc.com/ns/doap#> .\n";

  1094.         mainStream << "@prefix foaf: <http://xmlns.com/foaf/0.1/> .\n";

  1095.         mainStream << "@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .\n";

  1096.         mainStream << "@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .\n";

  1097.         mainStream << "@prefix ui:   <http://lv2plug.in/ns/extensions/ui#> .\n";

  1098.         mainStream << "\n";

  1099.         mainStream << "<>\n";

  1100.         mainStream << "    a lv2:Plugin ;\n";

  1101.         mainStream << "\n";

  1102.         mainStream << "    lv2:requiredFeature <http://lv2plug.in/ns/ext/buf-size#boundedBlockLength> ,\n";

  1103.         mainStream << "                        <http://lv2plug.in/ns/ext/options#options> ,\n";

  1104.         mainStream << "                        <http://lv2plug.in/ns/ext/urid#map> ;\n";

  1105.         mainStream << "\n";

  1106. 

  1107.         if (pData->hints & PLUGIN_HAS_CUSTOM_UI)

  1108.         {

  1109.             mainStream << "    ui:ui <ext-ui> ;\n";

  1110.             mainStream << "\n";

  1111.         }

  1112. 

  1113.         const uint32_t midiIns  = getMidiInCount();

  1114.         const uint32_t midiOuts = getMidiOutCount();

  1115. 

  1116.         int portIndex = 0;

  1117. 

  1118.         if (midiIns > 0)

  1119.         {

  1120.             mainStream << "    lv2:port [\n";

  1121.             mainStream << "        a lv2:InputPort, atom:AtomPort ;\n";

  1122.             mainStream << "        lv2:index 0 ;\n";

  1123.             mainStream << "        lv2:symbol \"clv2_events_in\" ;\n";

  1124.             mainStream << "        lv2:name \"Events Input\" ;\n";

  1125.             mainStream << "        atom:bufferType atom:Sequence ;\n";

  1126.             mainStream << "        atom:supports <http://lv2plug.in/ns/ext/midi#MidiEvent> ,\n";

  1127.             mainStream << "                      <http://lv2plug.in/ns/ext/time#Position> ;\n";

  1128.             mainStream << "    ] ;\n";

  1129.             ++portIndex;

  1130. 

  1131.             for (uint32_t i=1; i<midiIns; ++i)

  1132.             {

  1133.                 const String portIndexNum(portIndex++);

  1134.                 const String portIndexLabel(portIndex);

  1135. 

  1136.                 mainStream << "    lv2:port [\n";

  1137.                 mainStream << "        a lv2:InputPort, atom:AtomPort ;\n";

  1138.                 mainStream << "        lv2:index " << portIndexNum << " ;\n";

  1139.                 mainStream << "        lv2:symbol \"clv2_midi_in_" << portIndexLabel << "\" ;\n";

  1140.                 mainStream << "        lv2:name \"MIDI Input " << portIndexLabel << "\" ;\n";

  1141.                 mainStream << "    ] ;\n";

  1142.             }

  1143.         }

  1144.         else

  1145.         {

  1146.             mainStream << "    lv2:port [\n";

  1147.             mainStream << "        a lv2:InputPort, atom:AtomPort ;\n";

  1148.             mainStream << "        lv2:index 0 ;\n";

  1149.             mainStream << "        lv2:symbol \"clv2_time_info\" ;\n";

  1150.             mainStream << "        lv2:name \"Time Info\" ;\n";

  1151.             mainStream << "        atom:bufferType atom:Sequence ;\n";

  1152.             mainStream << "        atom:supports <http://lv2plug.in/ns/ext/time#Position> ;\n";

  1153.             mainStream << "    ] ;\n";

  1154.             ++portIndex;

  1155.         }

  1156. 

  1157.         for (uint32_t i=0; i<midiOuts; ++i)

  1158.         {

  1159.             const String portIndexNum(portIndex++);

  1160.             const String portIndexLabel(portIndex);

  1161. 

  1162.             mainStream << "    lv2:port [\n";

  1163.             mainStream << "        a lv2:InputPort, atom:AtomPort ;\n";

  1164.             mainStream << "        lv2:index " << portIndexNum << " ;\n";

  1165.             mainStream << "        lv2:symbol \"clv2_midi_out_" << portIndexLabel << "\" ;\n";

  1166.             mainStream << "        lv2:name \"MIDI Output " << portIndexLabel << "\" ;\n";

  1167.             mainStream << "        atom:bufferType atom:Sequence ;\n";

  1168.             mainStream << "        atom:supports <http://lv2plug.in/ns/ext/midi#MidiEvent> ;\n";

  1169.             mainStream << "    ] ;\n";

  1170.         }

  1171. 

  1172.         mainStream << "    lv2:port [\n";

  1173.         mainStream << "        a lv2:InputPort, lv2:ControlPort ;\n";

  1174.         mainStream << "        lv2:index " << String(portIndex++) << " ;\n";

  1175.         mainStream << "        lv2:name \"freewheel\" ;\n";

  1176.         mainStream << "        lv2:symbol \"clv2_freewheel\" ;\n";

  1177.         mainStream << "        lv2:default 0 ;\n";

  1178.         mainStream << "        lv2:minimum 0 ;\n";

  1179.         mainStream << "        lv2:maximum 1 ;\n";

  1180.         mainStream << "        lv2:designation lv2:freeWheeling ;\n";

  1181.         mainStream << "        lv2:portProperty lv2:toggled , lv2:integer ;\n";

  1182.         mainStream << "        lv2:portProperty <http://lv2plug.in/ns/ext/port-props#notOnGUI> ;\n";

  1183.         mainStream << "    ] ;\n";

  1184. 

  1185.         for (uint32_t i=0; i<pData->audioIn.count; ++i)

  1186.         {

  1187.             const String portIndexNum(portIndex++);

  1188.             const String portIndexLabel(i+1);

  1189. 

  1190.             mainStream << "    lv2:port [\n";

  1191.             mainStream << "        a lv2:InputPort, lv2:AudioPort ;\n";

  1192.             mainStream << "        lv2:index " << portIndexNum << " ;\n";

  1193.             mainStream << "        lv2:symbol \"clv2_audio_in_" << portIndexLabel << "\" ;\n";

  1194.             mainStream << "        lv2:name \"Audio Input " << portIndexLabel << "\" ;\n";

  1195.             mainStream << "    ] ;\n";

  1196.         }

  1197. 

  1198.         for (uint32_t i=0; i<pData->audioOut.count; ++i)

  1199.         {

  1200.             const String portIndexNum(portIndex++);

  1201.             const String portIndexLabel(i+1);

  1202. 

  1203.             mainStream << "    lv2:port [\n";

  1204.             mainStream << "        a lv2:OutputPort, lv2:AudioPort ;\n";

  1205.             mainStream << "        lv2:index " << portIndexNum << " ;\n";

  1206.             mainStream << "        lv2:symbol \"clv2_audio_out_" << portIndexLabel << "\" ;\n";

  1207.             mainStream << "        lv2:name \"Audio Output " << portIndexLabel << "\" ;\n";

  1208.             mainStream << "    ] ;\n";

  1209.         }

  1210. 

  1211.         CarlaStringList uniqueSymbolNames;

  1212. 

  1213.         char strBufName[STR_MAX+1];

  1214.         char strBufSymbol[STR_MAX+1];

  1215.         carla_zeroChars(strBufName, STR_MAX+1);

  1216.         carla_zeroChars(strBufSymbol, STR_MAX+1);

  1217. 

  1218.         for (uint32_t i=0; i<pData->param.count; ++i)

  1219.         {

  1220.             const ParameterData&   paramData(pData->param.data[i]);

  1221.             const ParameterRanges& paramRanges(pData->param.ranges[i]);

  1222. 

  1223.             const String portIndexNum(portIndex++);

  1224. 

  1225.             mainStream << "    lv2:port [\n";

  1226. 

  1227.             if (paramData.type == PARAMETER_INPUT)

  1228.                 mainStream << "        a lv2:InputPort, lv2:ControlPort ;\n";

  1229.             else

  1230.                 mainStream << "        a lv2:OutputPort, lv2:ControlPort ;\n";

  1231. 

  1232.             if (paramData.hints & PARAMETER_IS_BOOLEAN)

  1233.                 mainStream << "        lv2:portProperty lv2:toggled ;\n";

  1234. 

  1235.             if (paramData.hints & PARAMETER_IS_INTEGER)

  1236.                 mainStream << "        lv2:portProperty lv2:integer ;\n";

  1237. 

  1238.             // TODO logarithmic, enabled (not on gui), automatable, samplerate, scalepoints

  1239. 

  1240.             if (! getParameterName(i, strBufName))

  1241.                 strBufName[0] = '\0';

  1242.             if (! getParameterSymbol(i, strBufSymbol))

  1243.                 strBufSymbol[0] = '\0';

  1244. 

  1245.             if (strBufSymbol[0] == '\0')

  1246.             {

  1247.                 CarlaString s(strBufName);

  1248.                 s.toBasic();

  1249.                 std::memcpy(strBufSymbol, s.buffer(), s.length()+1);

  1250. 

  1251.                 if (strBufSymbol[0] >= '0' && strBufSymbol[0] <= '9')

  1252.                 {

  1253.                     const size_t len(std::strlen(strBufSymbol));

  1254.                     std::memmove(strBufSymbol+1, strBufSymbol, len);

  1255.                     strBufSymbol[0]   = '_';

  1256.                     strBufSymbol[len+1] = '\0';

  1257.                 }

  1258.             }

  1259. 

  1260.             if (uniqueSymbolNames.contains(strBufSymbol))

  1261.                 std::snprintf(strBufSymbol, STR_MAX, "clv2_param_%d", i+1);

  1262. 

  1263.             mainStream << "        lv2:index " << portIndexNum << " ;\n";

  1264.             mainStream << "        lv2:symbol \"" << strBufSymbol << "\" ;\n";

  1265.             mainStream << "        lv2:name \"\"\"" << strBufName << "\"\"\" ;\n";

  1266.             mainStream << "        lv2:default " << String(paramRanges.def) << " ;\n";

  1267.             mainStream << "        lv2:minimum " << String(paramRanges.min) << " ;\n";

  1268.             mainStream << "        lv2:maximum " << String(paramRanges.max) << " ;\n";

  1269. 

  1270.             // TODO midiCC, midiChannel

  1271. 

  1272.             mainStream << "    ] ;\n";

  1273.         }

  1274. 

  1275.         char strBuf[STR_MAX+1];

  1276.         carla_zeroChars(strBuf, STR_MAX+1);

  1277. 

  1278.         if (! getMaker(strBuf))

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

  1280. 

  1281.         mainStream << "    rdfs:comment \"Plugin generated using Carla LV2 export.\" ;\n";

  1282.         mainStream << "    doap:name \"\"\"" << getName() << "\"\"\" ;\n";

  1283.         mainStream << "    doap:maintainer [ foaf:name \"\"\"" << strBuf << "\"\"\" ] .\n";

  1284.         mainStream << "\n";

  1285. 

  1286.         const CarlaString mainFilename(bundlepath + CARLA_OS_SEP_STR + symbol + ".ttl");

  1287.         const File mainFile(mainFilename.buffer());

  1288. 

  1289.         if (! mainFile.replaceWithData(mainStream.getData(), mainStream.getDataSize()))

  1290.         {

  1291.             pData->engine->setLastError("Failed to write main plugin ttl file");

  1292.             return false;

  1293.         }

  1294.     }

  1295. 

  1296.     const CarlaString binaryFilename(bundlepath + CARLA_OS_SEP_STR + symbol + CARLA_LIB_EXT);

  1297. 

  1298.     const File binaryFileSource(File::getSpecialLocation(File::currentExecutableFile).getSiblingFile("carla-bridge-lv2" CARLA_LIB_EXT));

  1299.     const File binaryFileTarget(binaryFilename.buffer());

  1300. 

  1301.     const EngineOptions& opts(pData->engine->getOptions());

  1302. 

  1303.     const CarlaString binFolderTarget(bundlepath + CARLA_OS_SEP_STR + "bin");

  1304.     const CarlaString resFolderTarget(bundlepath + CARLA_OS_SEP_STR + "res");

  1305. 

  1306.     if (! binaryFileSource.copyFileTo(binaryFileTarget))

  1307.     {

  1308.         pData->engine->setLastError("Failed to copy plugin binary");

  1309.         return false;

  1310.     }

  1311. 

  1312. #ifdef CARLA_OS_WIN

  1313.     File(opts.resourceDir).copyDirectoryTo(File(resFolderTarget.buffer()));

  1314. 

  1315.     // Copying all the binaries is pointless, just go through the expected needed bits

  1316.     const File binFolder1(opts.binaryDir);

  1317.     const File binFolder2(binFolderTarget.buffer());

  1318.     binFolder2.createDirectory();

  1319. 

  1320.     static const char* files[] = {

  1321.       "carla-bridge-native.exe",

  1322.       "carla-bridge-win32.exe",

  1323.       "carla-discovery-win32.exe",

  1324.       "carla-discovery-win64.exe",

  1325.       "libcarla_utils.dll"

  1326.     };

  1327. 

  1328.     for (int i=0; i<5; ++i)

  1329.         binFolder1.getChildFile(files[i]).copyFileTo(binFolder2.getChildFile(files[i]));;

  1330. #else

  1331.     File(opts.binaryDir).createSymbolicLink(File(binFolderTarget.buffer()), true);

  1332.     File(opts.resourceDir).createSymbolicLink(File(resFolderTarget.buffer()), true);

  1333. #endif

  1334. 

  1335.     return true;

  1336. }

  1337. 

  1338. // -------------------------------------------------------------------

  1339. // Set data (internal stuff)

  1340. 

  1341. void CarlaPlugin::setId(const uint newId) noexcept

  1342. {

  1343.     pData->id = newId;

  1344. }

  1345. 

  1346. void CarlaPlugin::setName(const char* const newName)

  1347. {

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

  1349. 

  1350.     if (pData->name != nullptr)

  1351.         delete[] pData->name;

  1352. 

  1353.     pData->name = carla_strdup(newName);

  1354. }

  1355. 

  1356. void CarlaPlugin::setOption(const uint option, const bool yesNo, const bool sendCallback)

  1357. {

  1358.     CARLA_SAFE_ASSERT_UINT2_RETURN(getOptionsAvailable() & option, getOptionsAvailable(), option,);

  1359. 

  1360.     if (yesNo)

  1361.         pData->options |= option;

  1362.     else

  1363.         pData->options &= ~option;

  1364. 

  1365. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1366.     if (sendCallback)

  1367.         pData->engine->callback(true, true,

  1368.                                 ENGINE_CALLBACK_OPTION_CHANGED,

  1369.                                 pData->id,

  1370.                                 static_cast<int>(option),

  1371.                                 yesNo ? 1 : 0,

  1372.                                 0, 0.0f, nullptr);

  1373. #else

  1374.     // unused

  1375.     return; (void)sendCallback;

  1376. #endif

  1377. }

  1378. 

  1379. void CarlaPlugin::setEnabled(const bool yesNo) noexcept

  1380. {

  1381.     if (pData->enabled == yesNo)

  1382.         return;

  1383. 

  1384.     pData->masterMutex.lock();

  1385.     pData->enabled = yesNo;

  1386. 

  1387.     if (yesNo && ! pData->client->isActive())

  1388.         pData->client->activate();

  1389. 

  1390.     pData->masterMutex.unlock();

  1391. }

  1392. 

  1393. void CarlaPlugin::setActive(const bool active, const bool sendOsc, const bool sendCallback) noexcept

  1394. {

  1395.     if (pData->engineBridged) {

  1396.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1397.     } else if (pData->enginePlugin) {

  1398.         // nothing here

  1399.     } else {

  1400.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1401.     }

  1402. 

  1403.     if (pData->active == active)

  1404.         return;

  1405. 

  1406.     {

  1407.         const ScopedSingleProcessLocker spl(this, true);

  1408. 

  1409.         if (active)

  1410.             activate();

  1411.         else

  1412.             deactivate();

  1413.     }

  1414. 

  1415.     pData->active = active;

  1416. 

  1417. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1418.     const float value = active ? 1.0f : 0.0f;

  1419. 

  1420.     pData->engine->callback(sendCallback, sendOsc,

  1421.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1422.                             pData->id,

  1423.                             PARAMETER_ACTIVE,

  1424.                             0, 0,

  1425.                             value,

  1426.                             nullptr);

  1427. #endif

  1428. }

  1429. 

  1430. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1431. void CarlaPlugin::setDryWet(const float value, const bool sendOsc, const bool sendCallback) noexcept

  1432. {

  1433.     if (pData->engineBridged) {

  1434.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1435.     } else {

  1436.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1437.     }

  1438.     CARLA_SAFE_ASSERT(value >= 0.0f && value <= 1.0f);

  1439. 

  1440.     const float fixedValue(carla_fixedValue<float>(0.0f, 1.0f, value));

  1441. 

  1442.     if (carla_isEqual(pData->postProc.dryWet, fixedValue))

  1443.         return;

  1444. 

  1445.     pData->postProc.dryWet = fixedValue;

  1446. 

  1447.     pData->engine->callback(sendCallback, sendOsc,

  1448.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1449.                             pData->id,

  1450.                             PARAMETER_DRYWET,

  1451.                             0, 0,

  1452.                             fixedValue,

  1453.                             nullptr);

  1454. }

  1455. 

  1456. void CarlaPlugin::setVolume(const float value, const bool sendOsc, const bool sendCallback) noexcept

  1457. {

  1458.     if (pData->engineBridged) {

  1459.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1460.     } else {

  1461.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1462.     }

  1463.     CARLA_SAFE_ASSERT(value >= 0.0f && value <= 1.27f);

  1464. 

  1465.     const float fixedValue(carla_fixedValue<float>(0.0f, 1.27f, value));

  1466. 

  1467.     if (carla_isEqual(pData->postProc.volume, fixedValue))

  1468.         return;

  1469. 

  1470.     pData->postProc.volume = fixedValue;

  1471. 

  1472.     pData->engine->callback(sendCallback, sendOsc,

  1473.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1474.                             pData->id,

  1475.                             PARAMETER_VOLUME,

  1476.                             0, 0,

  1477.                             fixedValue,

  1478.                             nullptr);

  1479. }

  1480. 

  1481. void CarlaPlugin::setBalanceLeft(const float value, const bool sendOsc, const bool sendCallback) noexcept

  1482. {

  1483.     if (pData->engineBridged) {

  1484.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1485.     } else {

  1486.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1487.     }

  1488.     CARLA_SAFE_ASSERT(value >= -1.0f && value <= 1.0f);

  1489. 

  1490.     const float fixedValue(carla_fixedValue<float>(-1.0f, 1.0f, value));

  1491. 

  1492.     if (carla_isEqual(pData->postProc.balanceLeft, fixedValue))

  1493.         return;

  1494. 

  1495.     pData->postProc.balanceLeft = fixedValue;

  1496. 

  1497.     pData->engine->callback(sendCallback, sendOsc,

  1498.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1499.                             pData->id,

  1500.                             PARAMETER_BALANCE_LEFT,

  1501.                             0, 0,

  1502.                             fixedValue,

  1503.                             nullptr);

  1504. }

  1505. 

  1506. void CarlaPlugin::setBalanceRight(const float value, const bool sendOsc, const bool sendCallback) noexcept

  1507. {

  1508.     if (pData->engineBridged) {

  1509.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1510.     } else {

  1511.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1512.     }

  1513.     CARLA_SAFE_ASSERT(value >= -1.0f && value <= 1.0f);

  1514. 

  1515.     const float fixedValue(carla_fixedValue<float>(-1.0f, 1.0f, value));

  1516. 

  1517.     if (carla_isEqual(pData->postProc.balanceRight, fixedValue))

  1518.         return;

  1519. 

  1520.     pData->postProc.balanceRight = fixedValue;

  1521. 

  1522.     pData->engine->callback(sendCallback, sendOsc,

  1523.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1524.                             pData->id,

  1525.                             PARAMETER_BALANCE_RIGHT,

  1526.                             0, 0,

  1527.                             fixedValue,

  1528.                             nullptr);

  1529. }

  1530. 

  1531. void CarlaPlugin::setPanning(const float value, const bool sendOsc, const bool sendCallback) noexcept

  1532. {

  1533.     if (pData->engineBridged) {

  1534.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1535.     } else {

  1536.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1537.     }

  1538.     CARLA_SAFE_ASSERT(value >= -1.0f && value <= 1.0f);

  1539. 

  1540.     const float fixedValue(carla_fixedValue<float>(-1.0f, 1.0f, value));

  1541. 

  1542.     if (carla_isEqual(pData->postProc.panning, fixedValue))

  1543.         return;

  1544. 

  1545.     pData->postProc.panning = fixedValue;

  1546. 

  1547.     pData->engine->callback(sendCallback, sendOsc,

  1548.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1549.                             pData->id,

  1550.                             PARAMETER_PANNING,

  1551.                             0, 0,

  1552.                             fixedValue,

  1553.                             nullptr);

  1554. }

  1555. 

  1556. void CarlaPlugin::setDryWetRT(const float value, const bool sendCallbackLater) noexcept

  1557. {

  1558.     CARLA_SAFE_ASSERT(value >= 0.0f && value <= 1.0f);

  1559. 

  1560.     const float fixedValue(carla_fixedValue<float>(0.0f, 1.0f, value));

  1561. 

  1562.     if (carla_isEqual(pData->postProc.dryWet, fixedValue))

  1563.         return;

  1564. 

  1565.     pData->postProc.dryWet = fixedValue;

  1566.     pData->postponeParameterChangeRtEvent(sendCallbackLater, PARAMETER_DRYWET, fixedValue);

  1567. }

  1568. 

  1569. void CarlaPlugin::setVolumeRT(const float value, const bool sendCallbackLater) noexcept

  1570. {

  1571.     CARLA_SAFE_ASSERT(value >= 0.0f && value <= 1.27f);

  1572. 

  1573.     const float fixedValue(carla_fixedValue<float>(0.0f, 1.27f, value));

  1574. 

  1575.     if (carla_isEqual(pData->postProc.volume, fixedValue))

  1576.         return;

  1577. 

  1578.     pData->postProc.volume = fixedValue;

  1579.     pData->postponeParameterChangeRtEvent(sendCallbackLater, PARAMETER_VOLUME, fixedValue);

  1580. }

  1581. 

  1582. void CarlaPlugin::setBalanceLeftRT(const float value, const bool sendCallbackLater) noexcept

  1583. {

  1584.     CARLA_SAFE_ASSERT(value >= -1.0f && value <= 1.0f);

  1585. 

  1586.     const float fixedValue(carla_fixedValue<float>(-1.0f, 1.0f, value));

  1587. 

  1588.     if (carla_isEqual(pData->postProc.balanceLeft, fixedValue))

  1589.         return;

  1590. 

  1591.     pData->postProc.balanceLeft = fixedValue;

  1592.     pData->postponeParameterChangeRtEvent(sendCallbackLater, PARAMETER_BALANCE_LEFT, fixedValue);

  1593. }

  1594. 

  1595. void CarlaPlugin::setBalanceRightRT(const float value, const bool sendCallbackLater) noexcept

  1596. {

  1597.     CARLA_SAFE_ASSERT(value >= -1.0f && value <= 1.0f);

  1598. 

  1599.     const float fixedValue(carla_fixedValue<float>(-1.0f, 1.0f, value));

  1600. 

  1601.     if (carla_isEqual(pData->postProc.balanceRight, fixedValue))

  1602.         return;

  1603. 

  1604.     pData->postProc.balanceRight = fixedValue;

  1605.     pData->postponeParameterChangeRtEvent(sendCallbackLater, PARAMETER_BALANCE_RIGHT, fixedValue);

  1606. }

  1607. 

  1608. void CarlaPlugin::setPanningRT(const float value, const bool sendCallbackLater) noexcept

  1609. {

  1610.     CARLA_SAFE_ASSERT(value >= -1.0f && value <= 1.0f);

  1611. 

  1612.     const float fixedValue(carla_fixedValue<float>(-1.0f, 1.0f, value));

  1613. 

  1614.     if (carla_isEqual(pData->postProc.panning, fixedValue))

  1615.         return;

  1616. 

  1617.     pData->postProc.panning = fixedValue;

  1618.     pData->postponeParameterChangeRtEvent(sendCallbackLater, PARAMETER_PANNING, fixedValue);

  1619. }

  1620. #endif // ! BUILD_BRIDGE_ALTERNATIVE_ARCH

  1621. 

  1622. void CarlaPlugin::setCtrlChannel(const int8_t channel, const bool sendOsc, const bool sendCallback) noexcept

  1623. {

  1624.     if (pData->engineBridged) {

  1625.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1626.     } else {

  1627.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1628.     }

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

  1630. 

  1631.     if (pData->ctrlChannel == channel)

  1632.         return;

  1633. 

  1634.     pData->ctrlChannel = channel;

  1635. 

  1636. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1637.     const float channelf = static_cast<float>(channel);

  1638. 

  1639.     pData->engine->callback(sendCallback, sendOsc,

  1640.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1641.                             pData->id,

  1642.                             PARAMETER_CTRL_CHANNEL,

  1643.                             0, 0,

  1644.                             channelf, nullptr);

  1645. #endif

  1646. }

  1647. 

  1648. // -------------------------------------------------------------------

  1649. // Set data (plugin-specific stuff)

  1650. 

  1651. void CarlaPlugin::setParameterValue(const uint32_t parameterId, const float value, const bool sendGui, const bool sendOsc, const bool sendCallback) noexcept

  1652. {

  1653.     if (pData->engineBridged) {

  1654.         // NOTE: some LV2 plugins feedback messages to UI on purpose

  1655.         CARLA_SAFE_ASSERT_RETURN(getType() == PLUGIN_LV2 || !sendGui,);

  1656.     } else if (pData->enginePlugin) {

  1657.         // nothing here

  1658.     } else {

  1659.         CARLA_SAFE_ASSERT_RETURN(sendGui || sendOsc || sendCallback,); // never call this from RT

  1660.     }

  1661.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count,);

  1662. 

  1663.     if (sendGui && (pData->hints & PLUGIN_HAS_CUSTOM_UI) != 0)

  1664.         uiParameterChange(parameterId, value);

  1665. 

  1666.     pData->engine->callback(sendCallback, sendOsc,

  1667.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1668.                             pData->id,

  1669.                             static_cast<int>(parameterId),

  1670.                             0, 0,

  1671.                             value,

  1672.                             nullptr);

  1673. }

  1674. 

  1675. void CarlaPlugin::setParameterValueRT(const uint32_t parameterId, const float value, uint32_t, const bool sendCallbackLater) noexcept

  1676. {

  1677.     pData->postponeParameterChangeRtEvent(sendCallbackLater, static_cast<int32_t>(parameterId), value);

  1678. }

  1679. 

  1680. void CarlaPlugin::setParameterValueByRealIndex(const int32_t rindex, const float value, const bool sendGui, const bool sendOsc, const bool sendCallback) noexcept

  1681. {

  1682. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1683.     CARLA_SAFE_ASSERT_RETURN(rindex > PARAMETER_MAX && rindex != PARAMETER_NULL,);

  1684. 

  1685.     switch (rindex)

  1686.     {

  1687.     case PARAMETER_ACTIVE:

  1688.         return setActive((value > 0.0f), sendOsc, sendCallback);

  1689.     case PARAMETER_CTRL_CHANNEL:

  1690.         return setCtrlChannel(int8_t(value), sendOsc, sendCallback);

  1691.     case PARAMETER_DRYWET:

  1692.         return setDryWet(value, sendOsc, sendCallback);

  1693.     case PARAMETER_VOLUME:

  1694.         return setVolume(value, sendOsc, sendCallback);

  1695.     case PARAMETER_BALANCE_LEFT:

  1696.         return setBalanceLeft(value, sendOsc, sendCallback);

  1697.     case PARAMETER_BALANCE_RIGHT:

  1698.         return setBalanceRight(value, sendOsc, sendCallback);

  1699.     case PARAMETER_PANNING:

  1700.         return setPanning(value, sendOsc, sendCallback);

  1701.     }

  1702. #endif

  1703.     CARLA_SAFE_ASSERT_RETURN(rindex >= 0,);

  1704. 

  1705.     for (uint32_t i=0; i < pData->param.count; ++i)

  1706.     {

  1707.         if (pData->param.data[i].rindex == rindex)

  1708.         {

  1709.             //if (carla_isNotEqual(getParameterValue(i), value))

  1710.             setParameterValue(i, value, sendGui, sendOsc, sendCallback);

  1711.             break;

  1712.         }

  1713.     }

  1714. }

  1715. 

  1716. void CarlaPlugin::setParameterMidiChannel(const uint32_t parameterId, const uint8_t channel, const bool sendOsc, const bool sendCallback) noexcept

  1717. {

  1718.     if (pData->engineBridged) {

  1719.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1720.     } else {

  1721.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1722.     }

  1723.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count,);

  1724.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  1725. 

  1726.     if (pData->param.data[parameterId].midiChannel == channel)

  1727.         return;

  1728. 

  1729.     pData->param.data[parameterId].midiChannel = channel;

  1730. 

  1731. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1732.     pData->engine->callback(sendCallback, sendOsc,

  1733.                             ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED,

  1734.                             pData->id,

  1735.                             static_cast<int>(parameterId),

  1736.                             channel,

  1737.                             0, 0.0f, nullptr);

  1738. #endif

  1739. }

  1740. 

  1741. void CarlaPlugin::setParameterMappedControlIndex(const uint32_t parameterId, const int16_t index,

  1742.                                                  const bool sendOsc, const bool sendCallback,

  1743.                                                  const bool reconfigureNow) noexcept

  1744. {

  1745.     if (pData->engineBridged) {

  1746.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1747.     } else {

  1748.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1749.     }

  1750.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count,);

  1751.     CARLA_SAFE_ASSERT_RETURN(index >= CONTROL_INDEX_NONE && index <= CONTROL_INDEX_MAX_ALLOWED,);

  1752. 

  1753.     ParameterData& paramData(pData->param.data[parameterId]);

  1754. 

  1755.     if (paramData.mappedControlIndex == index)

  1756.         return;

  1757. 

  1758.     const ParameterRanges& paramRanges(pData->param.ranges[parameterId]);

  1759. 

  1760.     if ((paramData.hints & PARAMETER_MAPPED_RANGES_SET) == 0x0)

  1761.         setParameterMappedRange(parameterId, paramRanges.min, paramRanges.max, true, true);

  1762. 

  1763. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1764.     char strBuf[STR_MAX+1];

  1765.     carla_zeroChars(strBuf, STR_MAX+1);

  1766.     if (! getParameterName(parameterId, strBuf))

  1767.         std::snprintf(strBuf, STR_MAX, "Param %u", parameterId);

  1768. 

  1769.     const uint portNameSize = pData->engine->getMaxPortNameSize();

  1770.     if (portNameSize < STR_MAX)

  1771.         strBuf[portNameSize] = '\0';

  1772. 

  1773.     // was learning something else before, stop that first

  1774.     if (pData->midiLearnParameterIndex >= 0 && pData->midiLearnParameterIndex != static_cast<int32_t>(parameterId))

  1775.     {

  1776.         const int32_t oldParameterId = pData->midiLearnParameterIndex;

  1777.         pData->midiLearnParameterIndex = -1;

  1778. 

  1779.         CARLA_SAFE_ASSERT_RETURN(oldParameterId < static_cast<int32_t>(pData->param.count),);

  1780. 

  1781.         pData->param.data[oldParameterId].mappedControlIndex = CONTROL_INDEX_NONE;

  1782.         pData->engine->callback(true, true,

  1783.                                 ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED,

  1784.                                 pData->id,

  1785.                                 oldParameterId,

  1786.                                 CONTROL_INDEX_NONE,

  1787.                                 0, 0.0f, nullptr);

  1788.     }

  1789. 

  1790.     // mapping new parameter to CV

  1791.     if (index == CONTROL_INDEX_CV)

  1792.     {

  1793.         CARLA_SAFE_ASSERT_RETURN(pData->event.cvSourcePorts != nullptr,);

  1794.         CARLA_SAFE_ASSERT_RETURN(paramData.type == PARAMETER_INPUT,);

  1795.         CARLA_SAFE_ASSERT_RETURN(paramData.hints & PARAMETER_CAN_BE_CV_CONTROLLED,);

  1796. 

  1797.         CarlaEngineCVPort* const cvPort =

  1798.             (CarlaEngineCVPort*)pData->client->addPort(kEnginePortTypeCV, strBuf, true, parameterId);

  1799.         cvPort->setRange(paramData.mappedMinimum, paramData.mappedMaximum);

  1800.         pData->event.cvSourcePorts->addCVSource(cvPort, parameterId, reconfigureNow);

  1801.     }

  1802.     // unmapping from CV

  1803.     else if (paramData.mappedControlIndex == CONTROL_INDEX_CV)

  1804.     {

  1805.         CARLA_SAFE_ASSERT_RETURN(pData->event.cvSourcePorts != nullptr,);

  1806. 

  1807.         CARLA_SAFE_ASSERT(pData->client->removePort(kEnginePortTypeCV, strBuf, true));

  1808.         CARLA_SAFE_ASSERT(pData->event.cvSourcePorts->removeCVSource(parameterId));

  1809.     }

  1810.     // mapping to something new

  1811.     else if (paramData.mappedControlIndex == CONTROL_INDEX_NONE)

  1812.     {

  1813.         // when doing MIDI CC mapping, ensure ranges are within bounds

  1814.         if (paramData.mappedMinimum < paramRanges.min || paramData.mappedMaximum > paramRanges.max)

  1815.             setParameterMappedRange(parameterId,

  1816.                                     std::max(paramData.mappedMinimum, paramRanges.min),

  1817.                                     std::min(paramData.mappedMaximum, paramRanges.max),

  1818.                                     true, true);

  1819.     }

  1820. #endif

  1821. 

  1822.     paramData.mappedControlIndex = index;

  1823. 

  1824. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1825.     if (index == CONTROL_INDEX_MIDI_LEARN)

  1826.         pData->midiLearnParameterIndex = static_cast<int32_t>(parameterId);

  1827.     else

  1828.         pData->midiLearnParameterIndex = -1;

  1829. 

  1830.     pData->engine->callback(sendCallback, sendOsc,

  1831.                             ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED,

  1832.                             pData->id,

  1833.                             static_cast<int>(parameterId),

  1834.                             index,

  1835.                             0, 0.0f, nullptr);

  1836. #else

  1837.     return;

  1838.     // unused

  1839.     (void)reconfigureNow;

  1840. #endif

  1841. }

  1842. 

  1843. void CarlaPlugin::setParameterMappedRange(const uint32_t parameterId, const float minimum, const float maximum,

  1844.                                           const bool sendOsc, const bool sendCallback) noexcept

  1845. {

  1846.     if (pData->engineBridged) {

  1847.         CARLA_SAFE_ASSERT_RETURN(!sendOsc && !sendCallback,);

  1848.     } else {

  1849.         CARLA_SAFE_ASSERT_RETURN(sendOsc || sendCallback,); // never call this from RT

  1850.     }

  1851.     CARLA_SAFE_ASSERT_RETURN(parameterId < pData->param.count,);

  1852. 

  1853.     ParameterData& paramData(pData->param.data[parameterId]);

  1854. 

  1855.     if (carla_isEqual(paramData.mappedMinimum, minimum) &&

  1856.         carla_isEqual(paramData.mappedMaximum, maximum) &&

  1857.         (paramData.hints & PARAMETER_MAPPED_RANGES_SET) != 0x0)

  1858.         return;

  1859. 

  1860.     if (paramData.mappedControlIndex != CONTROL_INDEX_NONE && paramData.mappedControlIndex != CONTROL_INDEX_CV)

  1861.     {

  1862.         const ParameterRanges& paramRanges(pData->param.ranges[parameterId]);

  1863.         CARLA_SAFE_ASSERT_RETURN(minimum >= paramRanges.min,);

  1864.         CARLA_SAFE_ASSERT_RETURN(maximum <= paramRanges.max,);

  1865.     }

  1866. 

  1867.     paramData.hints |= PARAMETER_MAPPED_RANGES_SET;

  1868.     paramData.mappedMinimum = minimum;

  1869.     paramData.mappedMaximum = maximum;

  1870. 

  1871. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1872.     if (pData->event.cvSourcePorts != nullptr && paramData.mappedControlIndex == CONTROL_INDEX_CV)

  1873.         pData->event.cvSourcePorts->setCVSourceRange(parameterId, minimum, maximum);

  1874. 

  1875.     char strBuf[STR_MAX+1];

  1876.     carla_zeroChars(strBuf, STR_MAX+1);

  1877.     std::snprintf(strBuf, STR_MAX, "%.12g:%.12g", static_cast<double>(minimum), static_cast<double>(maximum));

  1878. 

  1879.     pData->engine->callback(sendCallback, sendOsc,

  1880.                             ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED,

  1881.                             pData->id,

  1882.                             static_cast<int>(parameterId),

  1883.                             0, 0, 0.0f,

  1884.                             strBuf);

  1885. #endif

  1886. }

  1887. 

  1888. void CarlaPlugin::setCustomData(const char* const type, const char* const key, const char* const value, const bool)

  1889. {

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

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

  1892.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

  1893. 

  1894.     // Ignore some keys

  1895.     if (std::strcmp(type, CUSTOM_DATA_TYPE_STRING) == 0)

  1896.     {

  1897.         const PluginType ptype = getType();

  1898. 

  1899.         if ((ptype == PLUGIN_INTERNAL && std::strncmp(key, "CarlaAlternateFile", 18) == 0) ||

  1900.             (ptype == PLUGIN_DSSI     && std::strcmp (key, "guiVisible") == 0) ||

  1901.             (ptype == PLUGIN_LV2      && std::strncmp(key, "OSC:", 4) == 0))

  1902.             return;

  1903.     }

  1904. 

  1905.     // Check if we already have this key

  1906.     for (LinkedList<CustomData>::Itenerator it = pData->custom.begin2(); it.valid(); it.next())

  1907.     {

  1908.         CustomData& customData(it.getValue(kCustomDataFallbackNC));

  1909.         CARLA_SAFE_ASSERT_CONTINUE(customData.isValid());

  1910. 

  1911.         if (std::strcmp(customData.key, key) == 0)

  1912.         {

  1913.             if (customData.value != nullptr)

  1914.                 delete[] customData.value;

  1915. 

  1916.             customData.value = carla_strdup(value);

  1917.             return;

  1918.         }

  1919.     }

  1920. 

  1921.     // Otherwise store it

  1922.     CustomData customData;

  1923.     customData.type  = carla_strdup(type);

  1924.     customData.key   = carla_strdup(key);

  1925.     customData.value = carla_strdup(value);

  1926.     pData->custom.append(customData);

  1927. }

  1928. 

  1929. void CarlaPlugin::setChunkData(const void* const data, const std::size_t dataSize)

  1930. {

  1931.     CARLA_SAFE_ASSERT_RETURN(data != nullptr,);

  1932.     CARLA_SAFE_ASSERT_RETURN(dataSize > 0,);

  1933.     CARLA_SAFE_ASSERT(false); // this should never happen

  1934. }

  1935. 

  1936. void CarlaPlugin::setProgram(const int32_t index,

  1937.                              const bool sendGui, const bool sendOsc, const bool sendCallback, const bool) noexcept

  1938. {

  1939.     CARLA_SAFE_ASSERT_RETURN(index >= -1 && index < static_cast<int32_t>(pData->prog.count),);

  1940. 

  1941.     pData->prog.current = index;

  1942. 

  1943.     pData->engine->callback(sendCallback, sendOsc,

  1944.                             ENGINE_CALLBACK_PROGRAM_CHANGED,

  1945.                             pData->id,

  1946.                             index,

  1947.                             0, 0, 0.0f, nullptr);

  1948. 

  1949.     // Change default parameter values

  1950.     if (index >= 0)

  1951.     {

  1952.         if (sendGui && (pData->hints & PLUGIN_HAS_CUSTOM_UI) != 0)

  1953.             uiProgramChange(static_cast<uint32_t>(index));

  1954. 

  1955.         switch (getType())

  1956.         {

  1957.         case PLUGIN_SF2:

  1958.         case PLUGIN_SFZ:

  1959.             break;

  1960. 

  1961.         default:

  1962.             pData->updateParameterValues(this, sendCallback, sendOsc, true);

  1963.             break;

  1964.         }

  1965.     }

  1966. }

  1967. 

  1968. void CarlaPlugin::setMidiProgram(const int32_t index,

  1969.                                  const bool sendGui, const bool sendOsc, const bool sendCallback, const bool) noexcept

  1970. {

  1971.     CARLA_SAFE_ASSERT_RETURN(index >= -1 && index < static_cast<int32_t>(pData->midiprog.count),);

  1972. 

  1973.     pData->midiprog.current = index;

  1974. 

  1975.     pData->engine->callback(sendCallback, sendOsc,

  1976.                             ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED,

  1977.                             pData->id,

  1978.                             index,

  1979.                             0, 0, 0.0f, nullptr);

  1980. 

  1981.     // Change default parameter values

  1982.     if (index >= 0)

  1983.     {

  1984.         if (sendGui && (pData->hints & PLUGIN_HAS_CUSTOM_UI) != 0)

  1985.             uiMidiProgramChange(static_cast<uint32_t>(index));

  1986. 

  1987.         switch (getType())

  1988.         {

  1989.         case PLUGIN_SF2:

  1990.         case PLUGIN_SFZ:

  1991.             break;

  1992. 

  1993.         default:

  1994.             pData->updateParameterValues(this, sendCallback, sendOsc, true);

  1995.             break;

  1996.         }

  1997.     }

  1998. }

  1999. 

  2000. void CarlaPlugin::setMidiProgramById(const uint32_t bank, const uint32_t program, const bool sendGui, const bool sendOsc, const bool sendCallback) noexcept

  2001. {

  2002.     for (uint32_t i=0; i < pData->midiprog.count; ++i)

  2003.     {

  2004.         if (pData->midiprog.data[i].bank == bank && pData->midiprog.data[i].program == program)

  2005.             return setMidiProgram(static_cast<int32_t>(i), sendGui, sendOsc, sendCallback);

  2006.     }

  2007. }

  2008. 

  2009. void CarlaPlugin::setProgramRT(const uint32_t uindex, const bool sendCallbackLater) noexcept

  2010. {

  2011.     CARLA_SAFE_ASSERT_RETURN(uindex < pData->prog.count,);

  2012. 

  2013.     const int32_t index = static_cast<int32_t>(uindex);

  2014.     pData->prog.current = index;

  2015. 

  2016.     // Change default parameter values

  2017.     switch (getType())

  2018.     {

  2019.     case PLUGIN_SF2:

  2020.     case PLUGIN_SFZ:

  2021.         break;

  2022. 

  2023.     default:

  2024.         pData->updateDefaultParameterValues(this);

  2025.         break;

  2026.     }

  2027. 

  2028.     pData->postponeProgramChangeRtEvent(sendCallbackLater, uindex);

  2029. }

  2030. 

  2031. void CarlaPlugin::setMidiProgramRT(const uint32_t uindex, const bool sendCallbackLater) noexcept

  2032. {

  2033.     CARLA_SAFE_ASSERT_RETURN(uindex < pData->midiprog.count,);

  2034. 

  2035.     const int32_t index = static_cast<int32_t>(uindex);

  2036.     pData->midiprog.current = index;

  2037. 

  2038.     // Change default parameter values

  2039.     switch (getType())

  2040.     {

  2041.     case PLUGIN_SF2:

  2042.     case PLUGIN_SFZ:

  2043.         break;

  2044. 

  2045.     default:

  2046.         pData->updateDefaultParameterValues(this);

  2047.         break;

  2048.     }

  2049. 

  2050.     pData->postponeMidiProgramChangeRtEvent(sendCallbackLater, uindex);

  2051. }

  2052. 

  2053. // -------------------------------------------------------------------

  2054. // Plugin state

  2055. 

  2056. void CarlaPlugin::reloadPrograms(const bool)

  2057. {

  2058. }

  2059. 

  2060. // -------------------------------------------------------------------

  2061. // Plugin processing

  2062. 

  2063. void CarlaPlugin::activate() noexcept

  2064. {

  2065.     CARLA_SAFE_ASSERT(! pData->active);

  2066. }

  2067. 

  2068. void CarlaPlugin::deactivate() noexcept

  2069. {

  2070.     CARLA_SAFE_ASSERT(pData->active);

  2071. }

  2072. 

  2073. void CarlaPlugin::bufferSizeChanged(const uint32_t)

  2074. {

  2075. }

  2076. 

  2077. void CarlaPlugin::sampleRateChanged(const double)

  2078. {

  2079. }

  2080. 

  2081. void CarlaPlugin::offlineModeChanged(const bool)

  2082. {

  2083. }

  2084. 

  2085. // -------------------------------------------------------------------

  2086. // Misc

  2087. 

  2088. void CarlaPlugin::idle()

  2089. {

  2090.     if (! pData->enabled)

  2091.         return;

  2092. 

  2093.     const bool hasUI(pData->hints & PLUGIN_HAS_CUSTOM_UI);

  2094.     const bool needsUiMainThread(pData->hints & PLUGIN_NEEDS_UI_MAIN_THREAD);

  2095.     const uint32_t latency(getLatencyInFrames());

  2096. 

  2097.     if (pData->latency.frames != latency)

  2098.     {

  2099.         carla_stdout("latency changed to %i samples", latency);

  2100. 

  2101.         const ScopedSingleProcessLocker sspl(this, true);

  2102. 

  2103.         pData->client->setLatency(latency);

  2104. #ifndef BUILD_BRIDGE

  2105.         pData->latency.recreateBuffers(pData->latency.channels, latency);

  2106. #else

  2107.         pData->latency.frames = latency;

  2108. #endif

  2109.     }

  2110. 

  2111.     ProtectedData::PostRtEvents::Access rtEvents(pData->postRtEvents);

  2112. 

  2113.     if (rtEvents.isEmpty())

  2114.         return;

  2115. 

  2116.     for (RtLinkedList<PluginPostRtEvent>::Itenerator it = rtEvents.getDataIterator(); it.valid(); it.next())

  2117.     {

  2118.         const PluginPostRtEvent& event(it.getValue(kPluginPostRtEventFallback));

  2119.         CARLA_SAFE_ASSERT_CONTINUE(event.type != kPluginPostRtEventNull);

  2120. 

  2121.         switch (event.type)

  2122.         {

  2123.         case kPluginPostRtEventNull: {

  2124.         } break;

  2125. 

  2126.         case kPluginPostRtEventParameterChange: {

  2127.             // Update UI

  2128.             if (event.parameter.index >= 0 && hasUI)

  2129.             {

  2130.                 if (needsUiMainThread)

  2131.                     pData->postUiEvents.append(event);

  2132.                 else

  2133.                     uiParameterChange(static_cast<uint32_t>(event.parameter.index), event.parameter.value);

  2134.             }

  2135. 

  2136.             if (event.sendCallback)

  2137.             {

  2138.                 // Update Host

  2139.                 pData->engine->callback(true, true,

  2140.                                         ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  2141.                                         pData->id,

  2142.                                         event.parameter.index,

  2143.                                         0, 0,

  2144.                                         event.parameter.value,

  2145.                                         nullptr);

  2146.             }

  2147.         } break;

  2148. 

  2149.         case kPluginPostRtEventProgramChange: {

  2150.             // Update UI

  2151.             if (hasUI)

  2152.             {

  2153.                 if (needsUiMainThread)

  2154.                     pData->postUiEvents.append(event);

  2155.                 else

  2156.                     uiProgramChange(event.program.index);

  2157.             }

  2158. 

  2159.             // Update param values

  2160.             for (uint32_t j=0; j < pData->param.count; ++j)

  2161.             {

  2162.                 const float paramDefault(pData->param.ranges[j].def);

  2163.                 const float paramValue(getParameterValue(j));

  2164. 

  2165.                 pData->engine->callback(true, true,

  2166.                                         ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  2167.                                         pData->id,

  2168.                                         static_cast<int>(j),

  2169.                                         0, 0,

  2170.                                         paramValue,

  2171.                                         nullptr);

  2172.                 pData->engine->callback(true, true,

  2173.                                         ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED,

  2174.                                         pData->id,

  2175.                                         static_cast<int>(j),

  2176.                                         0, 0,

  2177.                                         paramDefault,

  2178.                                         nullptr);

  2179.             }

  2180. 

  2181.             if (event.sendCallback)

  2182.             {

  2183.                 // Update Host

  2184.                 pData->engine->callback(true, true,

  2185.                                         ENGINE_CALLBACK_PROGRAM_CHANGED,

  2186.                                         pData->id,

  2187.                                         static_cast<int>(event.program.index),

  2188.                                         0, 0, 0.0f, nullptr);

  2189.             }

  2190.         } break;

  2191. 

  2192.         case kPluginPostRtEventMidiProgramChange: {

  2193.             // Update UI

  2194.             if (hasUI)

  2195.             {

  2196.                 if (needsUiMainThread)

  2197.                     pData->postUiEvents.append(event);

  2198.                 else

  2199.                     uiMidiProgramChange(event.program.index);

  2200.             }

  2201. 

  2202.             // Update param values

  2203.             for (uint32_t j=0; j < pData->param.count; ++j)

  2204.             {

  2205.                 const float paramDefault(pData->param.ranges[j].def);

  2206.                 const float paramValue(getParameterValue(j));

  2207. 

  2208.                 pData->engine->callback(true, true,

  2209.                                         ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  2210.                                         pData->id,

  2211.                                         static_cast<int>(j),

  2212.                                         0, 0,

  2213.                                         paramValue,

  2214.                                         nullptr);

  2215.                 pData->engine->callback(true, true,

  2216.                                         ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED,

  2217.                                         pData->id,

  2218.                                         static_cast<int>(j),

  2219.                                         0, 0,

  2220.                                         paramDefault,

  2221.                                         nullptr);

  2222.             }

  2223. 

  2224.             if (event.sendCallback)

  2225.             {

  2226.                 // Update Host

  2227.                 pData->engine->callback(true, true,

  2228.                                         ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED,

  2229.                                         pData->id,

  2230.                                         static_cast<int>(event.program.index),

  2231.                                         0, 0, 0.0f, nullptr);

  2232.             }

  2233.         } break;

  2234. 

  2235.         case kPluginPostRtEventNoteOn: {

  2236.             CARLA_SAFE_ASSERT_BREAK(event.note.channel  < MAX_MIDI_CHANNELS);

  2237.             CARLA_SAFE_ASSERT_BREAK(event.note.note     < MAX_MIDI_NOTE);

  2238.             CARLA_SAFE_ASSERT_BREAK(event.note.velocity < MAX_MIDI_VALUE);

  2239. 

  2240.             // Update UI

  2241.             if (hasUI)

  2242.             {

  2243.                 if (needsUiMainThread)

  2244.                     pData->postUiEvents.append(event);

  2245.                 else

  2246.                     uiNoteOn(event.note.channel, event.note.note, event.note.velocity);

  2247.             }

  2248. 

  2249.             if (event.sendCallback)

  2250.             {

  2251.                 // Update Host

  2252.                 pData->engine->callback(true, true,

  2253.                                         ENGINE_CALLBACK_NOTE_ON,

  2254.                                         pData->id,

  2255.                                         static_cast<int>(event.note.channel),

  2256.                                         static_cast<int>(event.note.note),

  2257.                                         static_cast<int>(event.note.velocity),

  2258.                                         0.0f, nullptr);

  2259.             }

  2260.         } break;

  2261. 

  2262.         case kPluginPostRtEventNoteOff: {

  2263.             CARLA_SAFE_ASSERT_BREAK(event.note.channel  < MAX_MIDI_CHANNELS);

  2264.             CARLA_SAFE_ASSERT_BREAK(event.note.note     < MAX_MIDI_NOTE);

  2265. 

  2266.             // Update UI

  2267.             if (hasUI)

  2268.             {

  2269.                 if (needsUiMainThread)

  2270.                     pData->postUiEvents.append(event);

  2271.                 else

  2272.                     uiNoteOff(event.note.channel, event.note.note);

  2273.             }

  2274. 

  2275.             if (event.sendCallback)

  2276.             {

  2277.                 // Update Host

  2278.                 pData->engine->callback(true, true,

  2279.                                         ENGINE_CALLBACK_NOTE_OFF,

  2280.                                         pData->id,

  2281.                                         static_cast<int>(event.note.channel),

  2282.                                         static_cast<int>(event.note.note),

  2283.                                         0, 0.0f, nullptr);

  2284.             }

  2285.         } break;

  2286. 

  2287.         case kPluginPostRtEventMidiLearn: {

  2288.             CARLA_SAFE_ASSERT_BREAK(event.midiLearn.cc      < MAX_MIDI_VALUE);

  2289.             CARLA_SAFE_ASSERT_BREAK(event.midiLearn.channel < MAX_MIDI_CHANNELS);

  2290. 

  2291. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2292.             if (event.sendCallback)

  2293.             {

  2294.                 pData->engine->callback(true, true,

  2295.                                         ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED,

  2296.                                         pData->id,

  2297.                                         static_cast<int>(event.midiLearn.parameter),

  2298.                                         static_cast<int>(event.midiLearn.cc),

  2299.                                         0, 0.0f, nullptr);

  2300. 

  2301.                 pData->engine->callback(true, true,

  2302.                                         ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED,

  2303.                                         pData->id,

  2304.                                         static_cast<int>(event.midiLearn.parameter),

  2305.                                         static_cast<int>(event.midiLearn.channel),

  2306.                                         0, 0.0f, nullptr);

  2307.             }

  2308. #endif

  2309.         } break;

  2310.         }

  2311.     }

  2312. }

  2313. 

  2314. bool CarlaPlugin::tryLock(const bool forcedOffline) noexcept

  2315. {

  2316.     if (forcedOffline)

  2317.     {

  2318. #ifndef STOAT_TEST_BUILD

  2319.         pData->masterMutex.lock();

  2320.         return true;

  2321. #endif

  2322.     }

  2323. 

  2324.     return pData->masterMutex.tryLock();

  2325. }

  2326. 

  2327. void CarlaPlugin::unlock() noexcept

  2328. {

  2329.     pData->masterMutex.unlock();

  2330. }

  2331. 

  2332. // -------------------------------------------------------------------

  2333. // Plugin buffers

  2334. 

  2335. void CarlaPlugin::initBuffers() const noexcept

  2336. {

  2337.     pData->audioIn.initBuffers();

  2338.     pData->audioOut.initBuffers();

  2339.     pData->cvIn.initBuffers();

  2340.     pData->cvOut.initBuffers();

  2341.     pData->event.initBuffers();

  2342. }

  2343. 

  2344. void CarlaPlugin::clearBuffers() noexcept

  2345. {

  2346.     pData->clearBuffers();

  2347. }

  2348. 

  2349. // -------------------------------------------------------------------

  2350. // OSC stuff

  2351. 

  2352. // FIXME

  2353. void CarlaPlugin::handleOscMessage(const char* const, const int, const void* const, const char* const, const lo_message)

  2354. {

  2355.     // do nothing

  2356. }

  2357. 

  2358. // -------------------------------------------------------------------

  2359. // MIDI events

  2360. 

  2361. void CarlaPlugin::sendMidiSingleNote(const uint8_t channel, const uint8_t note, const uint8_t velo, const bool sendGui, const bool sendOsc, const bool sendCallback)

  2362. {

  2363.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2364.     CARLA_SAFE_ASSERT_RETURN(note < MAX_MIDI_NOTE,);

  2365.     CARLA_SAFE_ASSERT_RETURN(velo < MAX_MIDI_VALUE,);

  2366. 

  2367.     if (! pData->active)

  2368.         return;

  2369. 

  2370.     ExternalMidiNote extNote;

  2371.     extNote.channel = static_cast<int8_t>(channel);

  2372.     extNote.note    = note;

  2373.     extNote.velo    = velo;

  2374. 

  2375.     pData->extNotes.appendNonRT(extNote);

  2376. 

  2377.     if (sendGui && (pData->hints & PLUGIN_HAS_CUSTOM_UI) != 0)

  2378.     {

  2379.         if (velo > 0)

  2380.             uiNoteOn(channel, note, velo);

  2381.         else

  2382.             uiNoteOff(channel, note);

  2383.     }

  2384. 

  2385.     pData->engine->callback(sendCallback, sendOsc,

  2386.                             (velo > 0) ? ENGINE_CALLBACK_NOTE_ON : ENGINE_CALLBACK_NOTE_OFF,

  2387.                             pData->id,

  2388.                             channel,

  2389.                             note,

  2390.                             velo,

  2391.                             0.0f, nullptr);

  2392. }

  2393. 

  2394. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2395. void CarlaPlugin::postponeRtAllNotesOff()

  2396. {

  2397.     if (pData->ctrlChannel < 0 || pData->ctrlChannel >= MAX_MIDI_CHANNELS)

  2398.         return;

  2399. 

  2400.     PluginPostRtEvent postEvent = { kPluginPostRtEventNoteOff, true, {} };

  2401.     postEvent.note.channel = static_cast<uint8_t>(pData->ctrlChannel);

  2402. 

  2403.     for (uint8_t i=0; i < MAX_MIDI_NOTE; ++i)

  2404.     {

  2405.         postEvent.note.note = i;

  2406.         pData->postRtEvents.appendRT(postEvent);

  2407.     }

  2408. }

  2409. #endif

  2410. 

  2411. // -------------------------------------------------------------------

  2412. // UI Stuff

  2413. 

  2414. void CarlaPlugin::setCustomUITitle(const char* const title) noexcept

  2415. {

  2416.     pData->uiTitle = title;

  2417. }

  2418. 

  2419. void CarlaPlugin::showCustomUI(const bool yesNo)

  2420. {

  2421.     if (yesNo) {

  2422.         CARLA_SAFE_ASSERT(false);

  2423.     }

  2424. }

  2425. 

  2426. void* CarlaPlugin::embedCustomUI(void*)

  2427. {

  2428.     return nullptr;

  2429. }

  2430. 

  2431. void CarlaPlugin::uiIdle()

  2432. {

  2433.     if (pData->hints & PLUGIN_NEEDS_UI_MAIN_THREAD)

  2434.     {

  2435.         // Update parameter outputs

  2436.         for (uint32_t i=0; i < pData->param.count; ++i)

  2437.         {

  2438.             if (pData->param.data[i].type == PARAMETER_OUTPUT)

  2439.                 uiParameterChange(i, getParameterValue(i));

  2440.         }

  2441. 

  2442.         const CarlaMutexLocker sl(pData->postUiEvents.mutex);

  2443. 

  2444.         for (LinkedList<PluginPostRtEvent>::Itenerator it = pData->postUiEvents.data.begin2(); it.valid(); it.next())

  2445.         {

  2446.             const PluginPostRtEvent& event(it.getValue(kPluginPostRtEventFallback));

  2447.             CARLA_SAFE_ASSERT_CONTINUE(event.type != kPluginPostRtEventNull);

  2448. 

  2449.             switch (event.type)

  2450.             {

  2451.             case kPluginPostRtEventNull:

  2452.             case kPluginPostRtEventMidiLearn:

  2453.                 break;

  2454. 

  2455.             case kPluginPostRtEventParameterChange:

  2456.                 uiParameterChange(static_cast<uint32_t>(event.parameter.index), event.parameter.value);

  2457.                 break;

  2458. 

  2459.             case kPluginPostRtEventProgramChange:

  2460.                 uiProgramChange(event.program.index);

  2461.                 break;

  2462. 

  2463.             case kPluginPostRtEventMidiProgramChange:

  2464.                 uiMidiProgramChange(event.program.index);

  2465.                 break;

  2466. 

  2467.             case kPluginPostRtEventNoteOn:

  2468.                 uiNoteOn(event.note.channel, event.note.note, event.note.velocity);

  2469.                 break;

  2470. 

  2471.             case kPluginPostRtEventNoteOff:

  2472.                 uiNoteOff(event.note.channel, event.note.note);

  2473.                 break;

  2474.             }

  2475.         }

  2476. 

  2477.         pData->postUiEvents.data.clear();

  2478.     }

  2479. 

  2480. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2481.     if (pData->transientTryCounter == 0)

  2482.         return;

  2483.     if (++pData->transientTryCounter % 10 != 0)

  2484.         return;

  2485.     if (pData->transientTryCounter >= 200)

  2486.         return;

  2487. 

  2488.     carla_stdout("Trying to get window...");

  2489. 

  2490.     CarlaString uiTitle;

  2491. 

  2492.     if (pData->uiTitle.isNotEmpty())

  2493.     {

  2494.         uiTitle = pData->uiTitle;

  2495.     }

  2496.     else

  2497.     {

  2498.         uiTitle  = pData->name;

  2499.         uiTitle += " (GUI)";

  2500.     }

  2501. 

  2502.     if (CarlaPluginUI::tryTransientWinIdMatch(getUiBridgeProcessId(), uiTitle,

  2503.                                               pData->engine->getOptions().frontendWinId, pData->transientFirstTry))

  2504.     {

  2505.         pData->transientTryCounter = 0;

  2506.         pData->transientFirstTry = false;

  2507.     }

  2508. #endif

  2509. }

  2510. 

  2511. void CarlaPlugin::uiParameterChange(const uint32_t index, const float value) noexcept

  2512. {

  2513.     CARLA_SAFE_ASSERT_RETURN(index < getParameterCount(),);

  2514.     return;

  2515. 

  2516.     // unused

  2517.     (void)value;

  2518. }

  2519. 

  2520. void CarlaPlugin::uiProgramChange(const uint32_t index) noexcept

  2521. {

  2522.     CARLA_SAFE_ASSERT_RETURN(index < getProgramCount(),);

  2523. }

  2524. 

  2525. void CarlaPlugin::uiMidiProgramChange(const uint32_t index) noexcept

  2526. {

  2527.     CARLA_SAFE_ASSERT_RETURN(index < getMidiProgramCount(),);

  2528. }

  2529. 

  2530. void CarlaPlugin::uiNoteOn(const uint8_t channel, const uint8_t note, const uint8_t velo) noexcept

  2531. {

  2532.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2533.     CARLA_SAFE_ASSERT_RETURN(note < MAX_MIDI_NOTE,);

  2534.     CARLA_SAFE_ASSERT_RETURN(velo > 0 && velo < MAX_MIDI_VALUE,);

  2535. }

  2536. 

  2537. void CarlaPlugin::uiNoteOff(const uint8_t channel, const uint8_t note) noexcept

  2538. {

  2539.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2540.     CARLA_SAFE_ASSERT_RETURN(note < MAX_MIDI_NOTE,);

  2541. }

  2542. 

  2543. CarlaEngine* CarlaPlugin::getEngine() const noexcept

  2544. {

  2545.     return pData->engine;

  2546. }

  2547. 

  2548. CarlaEngineClient* CarlaPlugin::getEngineClient() const noexcept

  2549. {

  2550.     return pData->client;

  2551. }

  2552. 

  2553. CarlaEngineAudioPort* CarlaPlugin::getAudioInPort(const uint32_t index) const noexcept

  2554. {

  2555.     return pData->audioIn.ports[index].port;

  2556. }

  2557. 

  2558. CarlaEngineAudioPort* CarlaPlugin::getAudioOutPort(const uint32_t index) const noexcept

  2559. {

  2560.     return pData->audioOut.ports[index].port;

  2561. }

  2562. 

  2563. CarlaEngineCVPort* CarlaPlugin::getCVInPort(const uint32_t index) const noexcept

  2564. {

  2565.     return pData->cvIn.ports[index].port;

  2566. }

  2567. 

  2568. CarlaEngineCVPort* CarlaPlugin::getCVOutPort(const uint32_t index) const noexcept

  2569. {

  2570.     return pData->cvOut.ports[index].port;

  2571. }

  2572. 

  2573. CarlaEngineEventPort* CarlaPlugin::getDefaultEventInPort() const noexcept

  2574. {

  2575.     return pData->event.portIn;

  2576. }

  2577. 

  2578. CarlaEngineEventPort* CarlaPlugin::getDefaultEventOutPort() const noexcept

  2579. {

  2580.     return pData->event.portOut;

  2581. }

  2582. 

  2583. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2584. void CarlaPlugin::checkForMidiLearn(EngineEvent& event) noexcept

  2585. {

  2586.     if (pData->midiLearnParameterIndex < 0)

  2587.         return;

  2588.     if (event.ctrl.param == MIDI_CONTROL_BANK_SELECT || event.ctrl.param == MIDI_CONTROL_BANK_SELECT__LSB)

  2589.         return;

  2590.     if (event.ctrl.param >= MAX_MIDI_CONTROL)

  2591.         return;

  2592. 

  2593.     const uint32_t parameterId = static_cast<uint32_t>(pData->midiLearnParameterIndex);

  2594.     CARLA_SAFE_ASSERT_UINT2_RETURN(parameterId < pData->param.count, parameterId, pData->param.count,);

  2595. 

  2596.     ParameterData& paramData(pData->param.data[parameterId]);

  2597.     CARLA_SAFE_ASSERT_INT_RETURN(paramData.mappedControlIndex == CONTROL_INDEX_MIDI_LEARN,

  2598.                                  paramData.mappedControlIndex,);

  2599. 

  2600.     event.ctrl.handled = true;

  2601.     paramData.mappedControlIndex = static_cast<int16_t>(event.ctrl.param);

  2602.     paramData.midiChannel = event.channel;

  2603. 

  2604.     pData->postponeMidiLearnRtEvent(true, parameterId, static_cast<uint8_t>(event.ctrl.param), event.channel);

  2605.     pData->midiLearnParameterIndex = -1;

  2606. }

  2607. #endif

  2608. 

  2609. void* CarlaPlugin::getNativeHandle() const noexcept

  2610. {

  2611.     return nullptr;

  2612. }

  2613. 

  2614. const void* CarlaPlugin::getNativeDescriptor() const noexcept

  2615. {

  2616.     return nullptr;

  2617. }

  2618. 

  2619. uintptr_t CarlaPlugin::getUiBridgeProcessId() const noexcept

  2620. {

  2621.     return 0;

  2622. }

  2623. 

  2624. // -------------------------------------------------------------------

  2625. 

  2626. uint32_t CarlaPlugin::getPatchbayNodeId() const noexcept

  2627. {

  2628.     return pData->nodeId;

  2629. }

  2630. 

  2631. void CarlaPlugin::setPatchbayNodeId(const uint32_t nodeId) noexcept

  2632. {

  2633.     pData->nodeId = nodeId;

  2634. }

  2635. 

  2636. // -------------------------------------------------------------------

  2637. 

  2638. void CarlaPlugin::cloneLV2Files(const CarlaPlugin&)

  2639. {

  2640.     carla_stderr2("Warning: cloneLV2Files() called for non-implemented type");

  2641. }

  2642. 

  2643. void CarlaPlugin::restoreLV2State(const bool temporary) noexcept

  2644. {

  2645.     carla_stderr2("Warning: restoreLV2State(%s) called for non-implemented type", bool2str(temporary));

  2646. }

  2647. 

  2648. void CarlaPlugin::prepareForDeletion() noexcept

  2649. {

  2650.     carla_debug("CarlaPlugin::prepareForDeletion");

  2651. 

  2652.     const CarlaMutexLocker cml(pData->masterMutex);

  2653. 

  2654.     pData->client->deactivate(true);

  2655. }

  2656. 

  2657. void CarlaPlugin::waitForBridgeSaveSignal() noexcept

  2658. {

  2659. }

  2660. 

  2661. // -------------------------------------------------------------------

  2662. // Scoped Disabler

  2663. 

  2664. CarlaPlugin::ScopedDisabler::ScopedDisabler(CarlaPlugin* const plugin) noexcept

  2665.     : fPlugin(plugin),

  2666.       fWasEnabled(false)

  2667. {

  2668.     CARLA_SAFE_ASSERT_RETURN(plugin != nullptr,);

  2669.     CARLA_SAFE_ASSERT_RETURN(plugin->pData != nullptr,);

  2670.     CARLA_SAFE_ASSERT_RETURN(plugin->pData->client != nullptr,);

  2671.     carla_debug("CarlaPlugin::ScopedDisabler(%p)", plugin);

  2672. 

  2673.     plugin->pData->masterMutex.lock();

  2674. 

  2675.     if (plugin->pData->enabled)

  2676.     {

  2677.         fWasEnabled = true;

  2678.         plugin->pData->enabled = false;

  2679. 

  2680.         if (plugin->pData->client->isActive())

  2681.             plugin->pData->client->deactivate(false);

  2682.     }

  2683. }

  2684. 

  2685. CarlaPlugin::ScopedDisabler::~ScopedDisabler() noexcept

  2686. {

  2687.     CARLA_SAFE_ASSERT_RETURN(fPlugin != nullptr,);

  2688.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData != nullptr,);

  2689.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData->client != nullptr,);

  2690.     carla_debug("CarlaPlugin::~ScopedDisabler()");

  2691. 

  2692.     if (fWasEnabled)

  2693.     {

  2694.         fPlugin->pData->enabled = true;

  2695.         fPlugin->pData->client->activate();

  2696.     }

  2697. 

  2698.     fPlugin->pData->masterMutex.unlock();

  2699. }

  2700. 

  2701. // -------------------------------------------------------------------

  2702. // Scoped Process Locker

  2703. 

  2704. CarlaPlugin::ScopedSingleProcessLocker::ScopedSingleProcessLocker(CarlaPlugin* const plugin, const bool block) noexcept

  2705.     : fPlugin(plugin),

  2706.       fBlock(block)

  2707. {

  2708.     CARLA_SAFE_ASSERT_RETURN(fPlugin != nullptr,);

  2709.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData != nullptr,);

  2710.     carla_debug("CarlaPlugin::ScopedSingleProcessLocker(%p, %s)", plugin, bool2str(block));

  2711. 

  2712.     if (! fBlock)

  2713.         return;

  2714. 

  2715.     plugin->pData->singleMutex.lock();

  2716. }

  2717. 

  2718. CarlaPlugin::ScopedSingleProcessLocker::~ScopedSingleProcessLocker() noexcept

  2719. {

  2720.     CARLA_SAFE_ASSERT_RETURN(fPlugin != nullptr,);

  2721.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData != nullptr,);

  2722.     carla_debug("CarlaPlugin::~ScopedSingleProcessLocker()");

  2723. 

  2724.     if (! fBlock)

  2725.         return;

  2726. 

  2727. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2728.     if (fPlugin->pData->singleMutex.wasTryLockCalled())

  2729.         fPlugin->pData->needsReset = true;

  2730. #endif

  2731. 

  2732.     fPlugin->pData->singleMutex.unlock();

  2733. }

  2734. 

  2735. // -------------------------------------------------------------------

  2736. 

  2737. CARLA_BACKEND_END_NAMESPACE