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

2761 lines
91KB
Raw Blame History 

  1. /*

  2.  * Carla Plugin

  3.  * Copyright (C) 2011-2020 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, 0, 0, 0, 0.0f };

  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_COPY_STRUCT(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. const ParameterData& CarlaPlugin::getParameterData(const uint32_t parameterId) const noexcept

  246. {

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

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

  249. }

  250. 

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

  252. {

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

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

  255. }

  256. 

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

  258. {

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

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

  261. }

  262. 

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

  264. {

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

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

  267. }

  268. 

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

  270. {

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

  272. }

  273. 

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

  275. {

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

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

  278.     return 0;

  279. }

  280. 

  281. // -------------------------------------------------------------------

  282. // Information (per-plugin data)

  283. 

  284. uint CarlaPlugin::getOptionsAvailable() const noexcept

  285. {

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

  287.     return 0x0;

  288. }

  289. 

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

  291. {

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

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

  294.     return 0.0f;

  295. }

  296. 

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

  298. {

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

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

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

  302.     return 0.0f;

  303. }

  304. 

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

  306. {

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

  308.     return false;

  309. }

  310. 

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

  312. {

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

  314.     return false;

  315. }

  316. 

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

  318. {

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

  320.     return false;

  321. }

  322. 

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

  324. {

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

  326.     return false;

  327. }

  328. 

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

  330. {

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

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

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

  334.     return false;

  335. }

  336. 

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

  338. {

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

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

  341.     return false;

  342. }

  343. 

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

  345. {

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

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

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

  349.     return false;

  350. }

  351. 

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

  353. {

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

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

  356.     return false;

  357. }

  358. 

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

  360. {

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

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

  363.     return false;

  364. }

  365. 

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

  367. {

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

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

  370.     return false;

  371. }

  372. 

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

  374. {

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

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

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

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

  379.     return false;

  380. }

  381. 

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

  383. {

  384. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  386. 

  387.     switch (parameterId)

  388.     {

  389.     case PARAMETER_ACTIVE:

  390.         return pData->active;

  391.     case PARAMETER_CTRL_CHANNEL:

  392.         return pData->ctrlChannel;

  393.     case PARAMETER_DRYWET:

  394.         return pData->postProc.dryWet;

  395.     case PARAMETER_VOLUME:

  396.         return pData->postProc.volume;

  397.     case PARAMETER_BALANCE_LEFT:

  398.         return pData->postProc.balanceLeft;

  399.     case PARAMETER_BALANCE_RIGHT:

  400.         return pData->postProc.balanceRight;

  401.     case PARAMETER_PANNING:

  402.         return pData->postProc.panning;

  403.     };

  404. #endif

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

  406. 

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

  408. }

  409. 

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

  411. {

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

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

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

  415.     return true;

  416. }

  417. 

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

  419. {

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

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

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

  423.     return true;

  424. }

  425. 

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

  427. {

  428.     ins  = 0;

  429.     outs = 0;

  430. 

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

  432.     {

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

  434.             ++ins;

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

  436.             ++outs;

  437.     }

  438. }

  439. 

  440. // -------------------------------------------------------------------

  441. // Set data (state)

  442. 

  443. void CarlaPlugin::prepareForSave(bool)

  444. {

  445. }

  446. 

  447. void CarlaPlugin::resetParameters() noexcept

  448. {

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

  450.     {

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

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

  453. 

  454.         if (paramData.type != PARAMETER_INPUT)

  455.             continue;

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

  457.             continue;

  458. 

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

  460.     }

  461. }

  462. 

  463. void CarlaPlugin::randomizeParameters() noexcept

  464. {

  465.     float value, random;

  466. 

  467.     char strBuf[STR_MAX+1];

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

  469. 

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

  471. 

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

  473.     {

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

  475. 

  476.         if (paramData.type != PARAMETER_INPUT)

  477.             continue;

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

  479.             continue;

  480. 

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

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

  483. 

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

  485.             continue;

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

  487.             continue;

  488. 

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

  490. 

  491.         if (paramData.hints & PARAMETER_IS_BOOLEAN)

  492.         {

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

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

  495.         }

  496.         else

  497.         {

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

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

  500. 

  501.             if (paramData.hints & PARAMETER_IS_INTEGER)

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

  503.         }

  504. 

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

  506.     }

  507. }

  508. 

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

  510. {

  511.     pData->stateSave.clear();

  512. 

  513.     if (callPrepareForSave)

  514.     {

  515.         pData->stateSave.temporary = true;

  516.         prepareForSave(true);

  517.     }

  518. 

  519.     const PluginType pluginType(getType());

  520. 

  521.     char strBuf[STR_MAX+1];

  522.     carla_zeroChars(strBuf, STR_MAX+1);

  523. 

  524.     // ---------------------------------------------------------------

  525.     // Basic info

  526. 

  527.     if (! getLabel(strBuf))

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

  529. 

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

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

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

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

  534. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  536. #endif

  537. 

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

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

  540. 

  541. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  542.     // ---------------------------------------------------------------

  543.     // Internals

  544. 

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

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

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

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

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

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

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

  552. #endif

  553. 

  554.     if (pData->hints & PLUGIN_IS_BRIDGE)

  555.         waitForBridgeSaveSignal();

  556. 

  557.     // ---------------------------------------------------------------

  558.     // Chunk

  559. 

  560.     bool usingChunk = false;

  561. 

  562.     if (pData->options & PLUGIN_OPTION_USE_CHUNKS)

  563.     {

  564.         void* data = nullptr;

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

  566. 

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

  568.         {

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

  570. 

  571.             if (pluginType != PLUGIN_INTERNAL)

  572.                 usingChunk = true;

  573.         }

  574.     }

  575. 

  576.     // ---------------------------------------------------------------

  577.     // Current Program

  578. 

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

  580.     {

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

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

  583.     }

  584. 

  585.     // ---------------------------------------------------------------

  586.     // Current MIDI Program

  587. 

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

  589.     {

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

  591. 

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

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

  594.     }

  595. 

  596.     // ---------------------------------------------------------------

  597.     // Parameters

  598. 

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

  600. 

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

  602.     {

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

  604. 

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

  606.             continue;

  607.         if (paramData.hints & PARAMETER_IS_NOT_SAVED)

  608.             continue;

  609. 

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

  611. 

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

  613.             continue;

  614. 

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

  616. 

  617.         stateParameter->dummy = dummy;

  618.         stateParameter->index = paramData.index;

  619. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  620.         if (paramData.mappedControlIndex != CONTROL_INDEX_MIDI_LEARN)

  621.         {

  622.             stateParameter->mappedControlIndex = paramData.mappedControlIndex;

  623.             stateParameter->midiChannel        = paramData.midiChannel;

  624. 

  625.             if (paramData.hints & PARAMETER_MAPPED_RANGES_SET)

  626.             {

  627.                 stateParameter->mappedMinimum = paramData.mappedMinimum;

  628.                 stateParameter->mappedMaximum = paramData.mappedMaximum;

  629.                 stateParameter->mappedRangeValid = true;

  630. 

  631.                 if (paramData.hints & PARAMETER_USES_SAMPLERATE)

  632.                 {

  633.                     stateParameter->mappedMinimum /= sampleRate;

  634.                     stateParameter->mappedMaximum /= sampleRate;

  635.                 }

  636.             }

  637.         }

  638. #endif

  639. 

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

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

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

  643. 

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

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

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

  647. 

  648.         if (! dummy)

  649.         {

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

  651. 

  652.             if (paramData.hints & PARAMETER_USES_SAMPLERATE)

  653.                 stateParameter->value /= sampleRate;

  654.         }

  655. 

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

  657.     }

  658. 

  659.     // ---------------------------------------------------------------

  660.     // Custom Data

  661. 

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

  663.     {

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

  665.         CARLA_SAFE_ASSERT_CONTINUE(cData.isValid());

  666. 

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

  668. 

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

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

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

  672. 

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

  674.     }

  675. 

  676.     return pData->stateSave;

  677. }

  678. 

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

  680. {

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

  682.     const PluginType pluginType(getType());

  683. 

  684.     char strBuf[STR_MAX+1];

  685.     carla_zeroChars(strBuf, STR_MAX+1);

  686. 

  687.     // ---------------------------------------------------------------

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

  689. 

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

  691.     {

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

  693.         CARLA_SAFE_ASSERT_CONTINUE(stateCustomData != nullptr);

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

  695. 

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

  697. 

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

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

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

  701.             pass();

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

  703.             pass();

  704.         else

  705.             continue;

  706. 

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

  708.     }

  709. 

  710.     // ---------------------------------------------------------------

  711.     // Part 2 - set program

  712. 

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

  714.     {

  715.         int32_t programId = -1;

  716. 

  717.         // index < count

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

  719.         {

  720.             programId = stateSave.currentProgramIndex;

  721.         }

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

  723.         else

  724.         {

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

  726.             {

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

  728.                 {

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

  730.                     break;

  731.                 }

  732.             }

  733.         }

  734. 

  735.         // set program now, if valid

  736.         if (programId >= 0)

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

  738.     }

  739. 

  740.     // ---------------------------------------------------------------

  741.     // Part 3 - set midi program

  742. 

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

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

  745. 

  746.     // ---------------------------------------------------------------

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

  748. 

  749.     LinkedList<ParamSymbol*> paramSymbols;

  750. 

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

  752.     {

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

  754.         {

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

  756.                 continue;

  757. 

  758.             if (getParameterSymbol(i, strBuf))

  759.             {

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

  761.                 paramSymbols.append(paramSymbol);

  762.             }

  763.         }

  764.     }

  765. 

  766.     // ---------------------------------------------------------------

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

  768. 

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

  770. 

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

  772.     {

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

  774.         CARLA_SAFE_ASSERT_CONTINUE(stateParameter != nullptr);

  775. 

  776.         int32_t index = -1;

  777. 

  778.         if (pluginType == PLUGIN_LADSPA)

  779.         {

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

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

  782.             {

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

  784.                 {

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

  786.                     CARLA_SAFE_ASSERT_CONTINUE(paramSymbol != nullptr);

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

  788. 

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

  790.                     {

  791.                         index = paramSymbol->index;

  792.                         break;

  793.                     }

  794.                 }

  795.                 if (index == -1)

  796.                     index = stateParameter->index;

  797.             }

  798.             else

  799.             {

  800.                 index = stateParameter->index;

  801.             }

  802.         }

  803.         else if (pluginType == PLUGIN_LV2)

  804.         {

  805.             // Symbol only

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

  807.             {

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

  809.                 {

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

  811.                     CARLA_SAFE_ASSERT_CONTINUE(paramSymbol != nullptr);

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

  813. 

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

  815.                     {

  816.                         index = paramSymbol->index;

  817.                         break;

  818.                     }

  819.                 }

  820.                 if (index == -1)

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

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

  823.             }

  824.             else

  825.             {

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

  827.             }

  828.         }

  829.         else

  830.         {

  831.             // Index only

  832.             index = stateParameter->index;

  833.         }

  834. 

  835.         // Now set parameter

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

  837.         {

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

  839. 

  840.             if (! stateParameter->dummy)

  841.             {

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

  843.                     stateParameter->value *= sampleRate;

  844. 

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

  846.             }

  847. 

  848. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  849.             if (stateParameter->mappedRangeValid)

  850.             {

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

  852.                 {

  853.                     stateParameter->mappedMinimum *= sampleRate;

  854.                     stateParameter->mappedMaximum *= sampleRate;

  855.                 }

  856. 

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

  858.                                         stateParameter->mappedMinimum,

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

  860.             }

  861. 

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

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

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

  865. #endif

  866.         }

  867.         else

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

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

  870.     }

  871. 

  872.     // ---------------------------------------------------------------

  873.     // Part 4c - clear

  874. 

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

  876.     {

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

  878.         delete paramSymbol;

  879.     }

  880. 

  881.     paramSymbols.clear();

  882. 

  883.     // ---------------------------------------------------------------

  884.     // Part 5 - set custom data

  885. 

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

  887.     {

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

  889.         CARLA_SAFE_ASSERT_CONTINUE(stateCustomData != nullptr);

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

  891. 

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

  893. 

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

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

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

  897.             continue;

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

  899.             continue;

  900. 

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

  902.     }

  903. 

  904.     // ---------------------------------------------------------------

  905.     // Part 5x - set lv2 state

  906. 

  907.     if (pluginType == PLUGIN_LV2)

  908.     {

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

  910.         {

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

  912.             CARLA_SAFE_ASSERT_CONTINUE(customData.isValid());

  913. 

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

  915.                 continue;

  916. 

  917.             restoreLV2State(stateSave.temporary);

  918.             break;

  919.         }

  920.     }

  921. 

  922.     // ---------------------------------------------------------------

  923.     // Part 6 - set chunk

  924. 

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

  926.     {

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

  928. #ifdef CARLA_PROPER_CPP11_SUPPORT

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

  930. #else

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

  932. #endif

  933.     }

  934. 

  935. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  936.     // ---------------------------------------------------------------

  937.     // Part 6 - set internal stuff

  938. 

  939.     const uint availOptions(getOptionsAvailable());

  940. 

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

  942.     {

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

  944. 

  945.         if (availOptions & option)

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

  947.     }

  948. 

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

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

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

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

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

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

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

  956. 

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

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

  959. #endif

  960. }

  961. 

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

  963. {

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

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

  966. 

  967.     MemoryOutputStream out, streamState;

  968.     getStateSave().dumpToMemoryStream(streamState);

  969. 

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

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

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

  973.     out << streamState;

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

  975. 

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

  977.     File file(jfilename);

  978. 

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

  980.         return true;

  981. 

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

  983.     return false;

  984. }

  985. 

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

  987. {

  988.     // TODO set errors

  989. 

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

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

  992. 

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

  994.     File file(jfilename);

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

  996. 

  997.     XmlDocument xml(file);

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

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

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

  1001. 

  1002.     // completely load file

  1003.     xmlElement = xml.getDocumentElement(false);

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

  1005. 

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

  1007.     {

  1008.         loadStateSave(pData->stateSave);

  1009.         return true;

  1010.     }

  1011. 

  1012.     return false;

  1013. }

  1014. 

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

  1016. {

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

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

  1019. 

  1020.     CarlaString bundlepath(lv2path);

  1021. 

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

  1023.         bundlepath += ".lv2";

  1024. 

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

  1026. 

  1027.     if (bundlefolder.existsAsFile())

  1028.     {

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

  1030.         return false;

  1031.     }

  1032. 

  1033.     if (! bundlefolder.exists())

  1034.     {

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

  1036. 

  1037.         if (res.failed())

  1038.         {

  1039.             pData->engine->setLastError(res.getErrorMessage().toRawUTF8());

  1040.             return false;

  1041.         }

  1042.     }

  1043. 

  1044.     CarlaString symbol(pData->name);

  1045.     symbol.toBasic();

  1046. 

  1047.     {

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

  1049. 

  1050.         if (! saveStateToFile(pluginFilename))

  1051.             return false;

  1052.     }

  1053. 

  1054.     {

  1055.         MemoryOutputStream manifestStream;

  1056. 

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

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

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

  1060.         manifestStream << "\n";

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

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

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

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

  1065.         manifestStream << "\n";

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

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

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

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

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

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

  1072.         manifestStream << "\n";

  1073. 

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

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

  1076. 

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

  1078.         {

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

  1080.             return false;

  1081.         }

  1082.     }

  1083. 

  1084.     {

  1085.         MemoryOutputStream mainStream;

  1086. 

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

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

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

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

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

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

  1093.         mainStream << "\n";

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

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

  1096.         mainStream << "\n";

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

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

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

  1100.         mainStream << "\n";

  1101. 

  1102.         if (pData->hints & PLUGIN_HAS_CUSTOM_UI)

  1103.         {

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

  1105.             mainStream << "\n";

  1106.         }

  1107. 

  1108.         const uint32_t midiIns  = getMidiInCount();

  1109.         const uint32_t midiOuts = getMidiOutCount();

  1110. 

  1111.         int portIndex = 0;

  1112. 

  1113.         if (midiIns > 0)

  1114.         {

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

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

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

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

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

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

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

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

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

  1124.             ++portIndex;

  1125. 

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

  1127.             {

  1128.                 const String portIndexNum(portIndex++);

  1129.                 const String portIndexLabel(portIndex);

  1130. 

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

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

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

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

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

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

  1137.             }

  1138.         }

  1139.         else

  1140.         {

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

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

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

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

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

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

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

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

  1149.             ++portIndex;

  1150.         }

  1151. 

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

  1153.         {

  1154.             const String portIndexNum(portIndex++);

  1155.             const String portIndexLabel(portIndex);

  1156. 

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

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

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

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

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

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

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

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

  1165.         }

  1166. 

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

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

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

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

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

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

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

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

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

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

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

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

  1179. 

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

  1181.         {

  1182.             const String portIndexNum(portIndex++);

  1183.             const String portIndexLabel(i+1);

  1184. 

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

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

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

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

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

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

  1191.         }

  1192. 

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

  1194.         {

  1195.             const String portIndexNum(portIndex++);

  1196.             const String portIndexLabel(i+1);

  1197. 

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

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

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

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

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

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

  1204.         }

  1205. 

  1206.         CarlaStringList uniqueSymbolNames;

  1207. 

  1208.         char strBufName[STR_MAX+1];

  1209.         char strBufSymbol[STR_MAX+1];

  1210.         carla_zeroChars(strBufName, STR_MAX+1);

  1211.         carla_zeroChars(strBufSymbol, STR_MAX+1);

  1212. 

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

  1214.         {

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

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

  1217. 

  1218.             const String portIndexNum(portIndex++);

  1219. 

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

  1221. 

  1222.             if (paramData.type == PARAMETER_INPUT)

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

  1224.             else

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

  1226. 

  1227.             if (paramData.hints & PARAMETER_IS_BOOLEAN)

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

  1229. 

  1230.             if (paramData.hints & PARAMETER_IS_INTEGER)

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

  1232. 

  1233.             // TODO logarithmic, enabled (not on gui), automable, samplerate, scalepoints

  1234. 

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

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

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

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

  1239. 

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

  1241.             {

  1242.                 CarlaString s(strBufName);

  1243.                 s.toBasic();

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

  1245. 

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

  1247.                 {

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

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

  1250.                     strBufSymbol[0]   = '_';

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

  1252.                 }

  1253.             }

  1254. 

  1255.             if (uniqueSymbolNames.contains(strBufSymbol))

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

  1257. 

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

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

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

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

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

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

  1264. 

  1265.             // TODO midiCC, midiChannel

  1266. 

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

  1268.         }

  1269. 

  1270.         char strBuf[STR_MAX+1];

  1271.         carla_zeroChars(strBuf, STR_MAX+1);

  1272. 

  1273.         if (! getMaker(strBuf))

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

  1275. 

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

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

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

  1279.         mainStream << "\n";

  1280. 

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

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

  1283. 

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

  1285.         {

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

  1287.             return false;

  1288.         }

  1289.     }

  1290. 

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

  1292. 

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

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

  1295. 

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

  1297. 

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

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

  1300. 

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

  1302.     {

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

  1304.         return false;

  1305.     }

  1306. 

  1307. #ifdef CARLA_OS_WIN

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

  1309. 

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

  1311.     const File binFolder1(opts.binaryDir);

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

  1313.     binFolder2.createDirectory();

  1314. 

  1315.     static const char* files[] = {

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

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

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

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

  1320.       "libcarla_utils.dll"

  1321.     };

  1322. 

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

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

  1325. #else

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

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

  1328. #endif

  1329. 

  1330.     return true;

  1331. }

  1332. 

  1333. // -------------------------------------------------------------------

  1334. // Set data (internal stuff)

  1335. 

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

  1337. {

  1338.     pData->id = newId;

  1339. }

  1340. 

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

  1342. {

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

  1344. 

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

  1346.         delete[] pData->name;

  1347. 

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

  1349. }

  1350. 

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

  1352. {

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

  1354. 

  1355.     if (yesNo)

  1356.         pData->options |= option;

  1357.     else

  1358.         pData->options &= ~option;

  1359. 

  1360. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1361.     if (sendCallback)

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

  1363.                                 ENGINE_CALLBACK_OPTION_CHANGED,

  1364.                                 pData->id,

  1365.                                 static_cast<int>(option),

  1366.                                 yesNo ? 1 : 0,

  1367.                                 0, 0.0f, nullptr);

  1368. #else

  1369.     // unused

  1370.     return; (void)sendCallback;

  1371. #endif

  1372. }

  1373. 

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

  1375. {

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

  1377.         return;

  1378. 

  1379.     pData->masterMutex.lock();

  1380.     pData->enabled = yesNo;

  1381. 

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

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

  1384. 

  1385.     pData->masterMutex.unlock();

  1386. }

  1387. 

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

  1389. {

  1390.     if (pData->engineBridged) {

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

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

  1393.         // nothing here

  1394.     } else {

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

  1396.     }

  1397. 

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

  1399.         return;

  1400. 

  1401.     {

  1402.         const ScopedSingleProcessLocker spl(this, true);

  1403. 

  1404.         if (active)

  1405.             activate();

  1406.         else

  1407.             deactivate();

  1408.     }

  1409. 

  1410.     pData->active = active;

  1411. 

  1412. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  1414. 

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

  1416.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1417.                             pData->id,

  1418.                             PARAMETER_ACTIVE,

  1419.                             0, 0,

  1420.                             value,

  1421.                             nullptr);

  1422. #endif

  1423. }

  1424. 

  1425. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  1427. {

  1428.     if (pData->engineBridged) {

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

  1430.     } else {

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

  1432.     }

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

  1434. 

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

  1436. 

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

  1438.         return;

  1439. 

  1440.     pData->postProc.dryWet = fixedValue;

  1441. 

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

  1443.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1444.                             pData->id,

  1445.                             PARAMETER_DRYWET,

  1446.                             0, 0,

  1447.                             fixedValue,

  1448.                             nullptr);

  1449. }

  1450. 

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

  1452. {

  1453.     if (pData->engineBridged) {

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

  1455.     } else {

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

  1457.     }

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

  1459. 

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

  1461. 

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

  1463.         return;

  1464. 

  1465.     pData->postProc.volume = fixedValue;

  1466. 

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

  1468.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1469.                             pData->id,

  1470.                             PARAMETER_VOLUME,

  1471.                             0, 0,

  1472.                             fixedValue,

  1473.                             nullptr);

  1474. }

  1475. 

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

  1477. {

  1478.     if (pData->engineBridged) {

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

  1480.     } else {

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

  1482.     }

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

  1484. 

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

  1486. 

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

  1488.         return;

  1489. 

  1490.     pData->postProc.balanceLeft = fixedValue;

  1491. 

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

  1493.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1494.                             pData->id,

  1495.                             PARAMETER_BALANCE_LEFT,

  1496.                             0, 0,

  1497.                             fixedValue,

  1498.                             nullptr);

  1499. }

  1500. 

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

  1502. {

  1503.     if (pData->engineBridged) {

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

  1505.     } else {

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

  1507.     }

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

  1509. 

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

  1511. 

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

  1513.         return;

  1514. 

  1515.     pData->postProc.balanceRight = fixedValue;

  1516. 

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

  1518.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1519.                             pData->id,

  1520.                             PARAMETER_BALANCE_RIGHT,

  1521.                             0, 0,

  1522.                             fixedValue,

  1523.                             nullptr);

  1524. }

  1525. 

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

  1527. {

  1528.     if (pData->engineBridged) {

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

  1530.     } else {

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

  1532.     }

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

  1534. 

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

  1536. 

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

  1538.         return;

  1539. 

  1540.     pData->postProc.panning = fixedValue;

  1541. 

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

  1543.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1544.                             pData->id,

  1545.                             PARAMETER_PANNING,

  1546.                             0, 0,

  1547.                             fixedValue,

  1548.                             nullptr);

  1549. }

  1550. 

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

  1552. {

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

  1554. 

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

  1556. 

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

  1558.         return;

  1559. 

  1560.     pData->postProc.dryWet = fixedValue;

  1561.     pData->postponeRtEvent(kPluginPostRtEventParameterChange, sendCallbackLater, PARAMETER_DRYWET, 0, 0, fixedValue);

  1562. }

  1563. 

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

  1565. {

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

  1567. 

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

  1569. 

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

  1571.         return;

  1572. 

  1573.     pData->postProc.volume = fixedValue;

  1574.     pData->postponeRtEvent(kPluginPostRtEventParameterChange, sendCallbackLater, PARAMETER_VOLUME, 0, 0, fixedValue);

  1575. }

  1576. 

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

  1578. {

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

  1580. 

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

  1582. 

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

  1584.         return;

  1585. 

  1586.     pData->postProc.balanceLeft = fixedValue;

  1587.     pData->postponeRtEvent(kPluginPostRtEventParameterChange, sendCallbackLater, PARAMETER_BALANCE_LEFT, 0, 0, fixedValue);

  1588. }

  1589. 

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

  1591. {

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

  1593. 

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

  1595. 

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

  1597.         return;

  1598. 

  1599.     pData->postProc.balanceRight = fixedValue;

  1600.     pData->postponeRtEvent(kPluginPostRtEventParameterChange, sendCallbackLater, PARAMETER_BALANCE_RIGHT, 0, 0, fixedValue);

  1601. }

  1602. 

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

  1604. {

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

  1606. 

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

  1608. 

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

  1610.         return;

  1611. 

  1612.     pData->postProc.panning = fixedValue;

  1613.     pData->postponeRtEvent(kPluginPostRtEventParameterChange, sendCallbackLater, PARAMETER_PANNING, 0, 0, fixedValue);

  1614. }

  1615. #endif // ! BUILD_BRIDGE_ALTERNATIVE_ARCH

  1616. 

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

  1618. {

  1619.     if (pData->engineBridged) {

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

  1621.     } else {

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

  1623.     }

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

  1625. 

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

  1627.         return;

  1628. 

  1629.     pData->ctrlChannel = channel;

  1630. 

  1631. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  1633. 

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

  1635.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1636.                             pData->id,

  1637.                             PARAMETER_CTRL_CHANNEL,

  1638.                             0, 0,

  1639.                             channelf, nullptr);

  1640. #endif

  1641. }

  1642. 

  1643. // -------------------------------------------------------------------

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

  1645. 

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

  1647. {

  1648.     if (pData->engineBridged) {

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

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

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

  1652.         // nothing here

  1653.     } else {

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

  1655.     }

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

  1657. 

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

  1659.         uiParameterChange(parameterId, value);

  1660. 

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

  1662.                             ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  1663.                             pData->id,

  1664.                             static_cast<int>(parameterId),

  1665.                             0, 0,

  1666.                             value,

  1667.                             nullptr);

  1668. }

  1669. 

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

  1671. {

  1672.     pData->postponeRtEvent(kPluginPostRtEventParameterChange,

  1673.                            sendCallbackLater, static_cast<int32_t>(parameterId), 0, 0, value);

  1674. }

  1675. 

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

  1677. {

  1678. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  1680. 

  1681.     switch (rindex)

  1682.     {

  1683.     case PARAMETER_ACTIVE:

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

  1685.     case PARAMETER_CTRL_CHANNEL:

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

  1687.     case PARAMETER_DRYWET:

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

  1689.     case PARAMETER_VOLUME:

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

  1691.     case PARAMETER_BALANCE_LEFT:

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

  1693.     case PARAMETER_BALANCE_RIGHT:

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

  1695.     case PARAMETER_PANNING:

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

  1697.     }

  1698. #endif

  1699.     CARLA_SAFE_ASSERT_RETURN(rindex >= 0,);

  1700. 

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

  1702.     {

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

  1704.         {

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

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

  1707.             break;

  1708.         }

  1709.     }

  1710. }

  1711. 

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

  1713. {

  1714.     if (pData->engineBridged) {

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

  1716.     } else {

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

  1718.     }

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

  1720.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  1721. 

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

  1723.         return;

  1724. 

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

  1726. 

  1727. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  1729.                             ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED,

  1730.                             pData->id,

  1731.                             static_cast<int>(parameterId),

  1732.                             channel,

  1733.                             0, 0.0f, nullptr);

  1734. #endif

  1735. }

  1736. 

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

  1738.                                                  const bool sendOsc, const bool sendCallback,

  1739.                                                  const bool reconfigureNow) noexcept

  1740. {

  1741.     if (pData->engineBridged) {

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

  1743.     } else {

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

  1745.     }

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

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

  1748. 

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

  1750. 

  1751.     if (paramData.mappedControlIndex == index)

  1752.         return;

  1753. 

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

  1755. 

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

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

  1758. 

  1759. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1760.     char strBuf[STR_MAX+1];

  1761.     carla_zeroChars(strBuf, STR_MAX+1);

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

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

  1764. 

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

  1766.     if (portNameSize < STR_MAX)

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

  1768. 

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

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

  1771.     {

  1772.         const int32_t oldParameterId = pData->midiLearnParameterIndex;

  1773.         pData->midiLearnParameterIndex = -1;

  1774. 

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

  1776. 

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

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

  1779.                                 ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED,

  1780.                                 pData->id,

  1781.                                 oldParameterId,

  1782.                                 CONTROL_INDEX_NONE,

  1783.                                 0, 0.0f, nullptr);

  1784.     }

  1785. 

  1786.     // mapping new parameter to CV

  1787.     if (index == CONTROL_INDEX_CV)

  1788.     {

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

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

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

  1792. 

  1793.         CarlaEngineCVPort* const cvPort =

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

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

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

  1797.     }

  1798.     // unmapping from CV

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

  1800.     {

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

  1802. 

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

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

  1805.     }

  1806.     // mapping to something new

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

  1808.     {

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

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

  1811.             setParameterMappedRange(parameterId,

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

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

  1814.                                     true, true);

  1815.     }

  1816. #endif

  1817. 

  1818.     paramData.mappedControlIndex = index;

  1819. 

  1820. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  1821.     if (index == CONTROL_INDEX_MIDI_LEARN)

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

  1823.     else

  1824.         pData->midiLearnParameterIndex = -1;

  1825. 

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

  1827.                             ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED,

  1828.                             pData->id,

  1829.                             static_cast<int>(parameterId),

  1830.                             index,

  1831.                             0, 0.0f, nullptr);

  1832. #else

  1833.     return;

  1834.     // unused

  1835.     (void)reconfigureNow;

  1836. #endif

  1837. }

  1838. 

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

  1840.                                           const bool sendOsc, const bool sendCallback) noexcept

  1841. {

  1842.     if (pData->engineBridged) {

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

  1844.     } else {

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

  1846.     }

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

  1848. 

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

  1850. 

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

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

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

  1854.         return;

  1855. 

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

  1857.     {

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

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

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

  1861.     }

  1862. 

  1863.     paramData.hints |= PARAMETER_MAPPED_RANGES_SET;

  1864.     paramData.mappedMinimum = minimum;

  1865.     paramData.mappedMaximum = maximum;

  1866. 

  1867. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

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

  1870. 

  1871.     char strBuf[STR_MAX+1];

  1872.     carla_zeroChars(strBuf, STR_MAX+1);

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

  1874. 

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

  1876.                             ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED,

  1877.                             pData->id,

  1878.                             static_cast<int>(parameterId),

  1879.                             0, 0, 0.0f,

  1880.                             strBuf);

  1881. #endif

  1882. }

  1883. 

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

  1885. {

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

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

  1888.     CARLA_SAFE_ASSERT_RETURN(value != nullptr,);

  1889. 

  1890.     // Ignore some keys

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

  1892.     {

  1893.         const PluginType ptype = getType();

  1894. 

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

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

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

  1898.             return;

  1899.     }

  1900. 

  1901.     // Check if we already have this key

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

  1903.     {

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

  1905.         CARLA_SAFE_ASSERT_CONTINUE(customData.isValid());

  1906. 

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

  1908.         {

  1909.             if (customData.value != nullptr)

  1910.                 delete[] customData.value;

  1911. 

  1912.             customData.value = carla_strdup(value);

  1913.             return;

  1914.         }

  1915.     }

  1916. 

  1917.     // Otherwise store it

  1918.     CustomData customData;

  1919.     customData.type  = carla_strdup(type);

  1920.     customData.key   = carla_strdup(key);

  1921.     customData.value = carla_strdup(value);

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

  1923. }

  1924. 

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

  1926. {

  1927.     CARLA_SAFE_ASSERT_RETURN(data != nullptr,);

  1928.     CARLA_SAFE_ASSERT_RETURN(dataSize > 0,);

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

  1930. }

  1931. 

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

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

  1934. {

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

  1936. 

  1937.     pData->prog.current = index;

  1938. 

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

  1940.                             ENGINE_CALLBACK_PROGRAM_CHANGED,

  1941.                             pData->id,

  1942.                             index,

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

  1944. 

  1945.     // Change default parameter values

  1946.     if (index >= 0)

  1947.     {

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

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

  1950. 

  1951.         switch (getType())

  1952.         {

  1953.         case PLUGIN_SF2:

  1954.         case PLUGIN_SFZ:

  1955.             break;

  1956. 

  1957.         default:

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

  1959.             break;

  1960.         }

  1961.     }

  1962. }

  1963. 

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

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

  1966. {

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

  1968. 

  1969.     pData->midiprog.current = index;

  1970. 

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

  1972.                             ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED,

  1973.                             pData->id,

  1974.                             index,

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

  1976. 

  1977.     // Change default parameter values

  1978.     if (index >= 0)

  1979.     {

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

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

  1982. 

  1983.         switch (getType())

  1984.         {

  1985.         case PLUGIN_SF2:

  1986.         case PLUGIN_SFZ:

  1987.             break;

  1988. 

  1989.         default:

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

  1991.             break;

  1992.         }

  1993.     }

  1994. }

  1995. 

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

  1997. {

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

  1999.     {

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

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

  2002.     }

  2003. }

  2004. 

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

  2006. {

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

  2008. 

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

  2010.     pData->prog.current = index;

  2011. 

  2012.     // Change default parameter values

  2013.     switch (getType())

  2014.     {

  2015.     case PLUGIN_SF2:

  2016.     case PLUGIN_SFZ:

  2017.         break;

  2018. 

  2019.     default:

  2020.         pData->updateDefaultParameterValues(this);

  2021.         break;

  2022.     }

  2023. 

  2024.     pData->postponeRtEvent(kPluginPostRtEventProgramChange, sendCallbackLater, index, 0, 0, 0.0f);

  2025. }

  2026. 

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

  2028. {

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

  2030. 

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

  2032.     pData->midiprog.current = index;

  2033. 

  2034.     // Change default parameter values

  2035.     switch (getType())

  2036.     {

  2037.     case PLUGIN_SF2:

  2038.     case PLUGIN_SFZ:

  2039.         break;

  2040. 

  2041.     default:

  2042.         pData->updateDefaultParameterValues(this);

  2043.         break;

  2044.     }

  2045. 

  2046.     pData->postponeRtEvent(kPluginPostRtEventMidiProgramChange, sendCallbackLater, index, 0, 0, 0.0f);

  2047. }

  2048. 

  2049. // -------------------------------------------------------------------

  2050. // Plugin state

  2051. 

  2052. void CarlaPlugin::reloadPrograms(const bool)

  2053. {

  2054. }

  2055. 

  2056. // -------------------------------------------------------------------

  2057. // Plugin processing

  2058. 

  2059. void CarlaPlugin::activate() noexcept

  2060. {

  2061.     CARLA_SAFE_ASSERT(! pData->active);

  2062. }

  2063. 

  2064. void CarlaPlugin::deactivate() noexcept

  2065. {

  2066.     CARLA_SAFE_ASSERT(pData->active);

  2067. }

  2068. 

  2069. void CarlaPlugin::bufferSizeChanged(const uint32_t)

  2070. {

  2071. }

  2072. 

  2073. void CarlaPlugin::sampleRateChanged(const double)

  2074. {

  2075. }

  2076. 

  2077. void CarlaPlugin::offlineModeChanged(const bool)

  2078. {

  2079. }

  2080. 

  2081. // -------------------------------------------------------------------

  2082. // Misc

  2083. 

  2084. void CarlaPlugin::idle()

  2085. {

  2086.     if (! pData->enabled)

  2087.         return;

  2088. 

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

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

  2091.     const uint32_t latency(getLatencyInFrames());

  2092. 

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

  2094.     {

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

  2096. 

  2097.         const ScopedSingleProcessLocker sspl(this, true);

  2098. 

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

  2100. #ifndef BUILD_BRIDGE

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

  2102. #else

  2103.         pData->latency.frames = latency;

  2104. #endif

  2105.     }

  2106. 

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

  2108. 

  2109.     if (rtEvents.isEmpty())

  2110.         return;

  2111. 

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

  2113.     {

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

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

  2116. 

  2117.         switch (event.type)

  2118.         {

  2119.         case kPluginPostRtEventNull: {

  2120.         } break;

  2121. 

  2122.         case kPluginPostRtEventDebug: {

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

  2124.                                     ENGINE_CALLBACK_DEBUG, pData->id,

  2125.                                     event.value1, event.value2, event.value3, event.valuef, nullptr);

  2126.         } break;

  2127. 

  2128.         case kPluginPostRtEventParameterChange: {

  2129.             // Update UI

  2130.             if (event.value1 >= 0 && hasUI)

  2131.             {

  2132.                 if (needsUiMainThread)

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

  2134.                 else

  2135.                     uiParameterChange(static_cast<uint32_t>(event.value1), event.valuef);

  2136.             }

  2137. 

  2138.             if (event.sendCallback)

  2139.             {

  2140.                 // Update Host

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

  2142.                                         ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  2143.                                         pData->id,

  2144.                                         event.value1,

  2145.                                         0, 0,

  2146.                                         event.valuef,

  2147.                                         nullptr);

  2148.             }

  2149.         } break;

  2150. 

  2151.         case kPluginPostRtEventProgramChange: {

  2152.             // Update UI

  2153.             if (event.value1 >= 0 && hasUI)

  2154.             {

  2155.                 if (needsUiMainThread)

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

  2157.                 else

  2158.                     uiProgramChange(static_cast<uint32_t>(event.value1));

  2159.             }

  2160. 

  2161.             // Update param values

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

  2163.             {

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

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

  2166. 

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

  2168.                                         ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  2169.                                         pData->id,

  2170.                                         static_cast<int>(j),

  2171.                                         0, 0,

  2172.                                         paramValue,

  2173.                                         nullptr);

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

  2175.                                         ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED,

  2176.                                         pData->id,

  2177.                                         static_cast<int>(j),

  2178.                                         0, 0,

  2179.                                         paramDefault,

  2180.                                         nullptr);

  2181.             }

  2182. 

  2183.             if (event.sendCallback)

  2184.             {

  2185.                 // Update Host

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

  2187.                                         ENGINE_CALLBACK_PROGRAM_CHANGED,

  2188.                                         pData->id,

  2189.                                         event.value1,

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

  2191.             }

  2192.         } break;

  2193. 

  2194.         case kPluginPostRtEventMidiProgramChange: {

  2195.             // Update UI

  2196.             if (event.value1 >= 0 && hasUI)

  2197.             {

  2198.                 if (needsUiMainThread)

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

  2200.                 else

  2201.                     uiMidiProgramChange(static_cast<uint32_t>(event.value1));

  2202.             }

  2203. 

  2204.             // Update param values

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

  2206.             {

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

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

  2209. 

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

  2211.                                         ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED,

  2212.                                         pData->id,

  2213.                                         static_cast<int>(j),

  2214.                                         0, 0,

  2215.                                         paramValue,

  2216.                                         nullptr);

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

  2218.                                         ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED,

  2219.                                         pData->id,

  2220.                                         static_cast<int>(j),

  2221.                                         0, 0,

  2222.                                         paramDefault,

  2223.                                         nullptr);

  2224.             }

  2225. 

  2226.             if (event.sendCallback)

  2227.             {

  2228.                 // Update Host

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

  2230.                                         ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED,

  2231.                                         pData->id,

  2232.                                         event.value1,

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

  2234.             }

  2235.         } break;

  2236. 

  2237.         case kPluginPostRtEventNoteOn: {

  2238.             CARLA_SAFE_ASSERT_BREAK(event.value1 >= 0 && event.value1 < MAX_MIDI_CHANNELS);

  2239.             CARLA_SAFE_ASSERT_BREAK(event.value2 >= 0 && event.value2 < MAX_MIDI_NOTE);

  2240.             CARLA_SAFE_ASSERT_BREAK(event.value3 >= 0 && event.value3 < MAX_MIDI_VALUE);

  2241. 

  2242.             const uint8_t channel  = static_cast<uint8_t>(event.value1);

  2243.             const uint8_t note     = static_cast<uint8_t>(event.value2);

  2244.             const uint8_t velocity = static_cast<uint8_t>(event.value3);

  2245. 

  2246.             // Update UI

  2247.             if (hasUI)

  2248.             {

  2249.                 if (needsUiMainThread)

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

  2251.                 else

  2252.                     uiNoteOn(channel, note, velocity);

  2253.             }

  2254. 

  2255.             if (event.sendCallback)

  2256.             {

  2257.                 // Update Host

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

  2259.                                         ENGINE_CALLBACK_NOTE_ON,

  2260.                                         pData->id,

  2261.                                         event.value1,

  2262.                                         event.value2,

  2263.                                         event.value3,

  2264.                                         0.0f, nullptr);

  2265.             }

  2266.         } break;

  2267. 

  2268.         case kPluginPostRtEventNoteOff: {

  2269.             CARLA_SAFE_ASSERT_BREAK(event.value1 >= 0 && event.value1 < MAX_MIDI_CHANNELS);

  2270.             CARLA_SAFE_ASSERT_BREAK(event.value2 >= 0 && event.value2 < MAX_MIDI_NOTE);

  2271. 

  2272.             const uint8_t channel = static_cast<uint8_t>(event.value1);

  2273.             const uint8_t note    = static_cast<uint8_t>(event.value2);

  2274. 

  2275.             // Update UI

  2276.             if (hasUI)

  2277.             {

  2278.                 if (needsUiMainThread)

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

  2280.                 else

  2281.                     uiNoteOff(channel, note);

  2282.             }

  2283. 

  2284.             if (event.sendCallback)

  2285.             {

  2286.                 // Update Host

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

  2288.                                         ENGINE_CALLBACK_NOTE_OFF,

  2289.                                         pData->id,

  2290.                                         event.value1,

  2291.                                         event.value2,

  2292.                                         0, 0.0f, nullptr);

  2293.             }

  2294.         } break;

  2295. 

  2296.         case kPluginPostRtEventMidiLearn: {

  2297.             CARLA_SAFE_ASSERT_BREAK(event.value1 >= 0 && event.value1 < MAX_MIDI_CHANNELS);

  2298.             CARLA_SAFE_ASSERT_BREAK(event.value2 >= 0 && event.value2 < MAX_MIDI_NOTE);

  2299. 

  2300. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2301.             if (event.sendCallback)

  2302.             {

  2303.                 const int32_t parameterId = event.value1;

  2304.                 const int32_t midiCC      = event.value2;

  2305.                 const int32_t midiChannel = event.value3;

  2306. 

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

  2308.                                         ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED,

  2309.                                         pData->id,

  2310.                                         parameterId,

  2311.                                         midiCC,

  2312.                                         0, 0.0f, nullptr);

  2313. 

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

  2315.                                         ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED,

  2316.                                         pData->id,

  2317.                                         parameterId,

  2318.                                         midiChannel,

  2319.                                         0, 0.0f, nullptr);

  2320. 

  2321.             }

  2322. #endif

  2323.         } break;

  2324.         }

  2325.     }

  2326. }

  2327. 

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

  2329. {

  2330.     if (forcedOffline)

  2331.     {

  2332. #ifndef STOAT_TEST_BUILD

  2333.         pData->masterMutex.lock();

  2334.         return true;

  2335. #endif

  2336.     }

  2337. 

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

  2339. }

  2340. 

  2341. void CarlaPlugin::unlock() noexcept

  2342. {

  2343.     pData->masterMutex.unlock();

  2344. }

  2345. 

  2346. // -------------------------------------------------------------------

  2347. // Plugin buffers

  2348. 

  2349. void CarlaPlugin::initBuffers() const noexcept

  2350. {

  2351.     pData->audioIn.initBuffers();

  2352.     pData->audioOut.initBuffers();

  2353.     pData->cvIn.initBuffers();

  2354.     pData->cvOut.initBuffers();

  2355.     pData->event.initBuffers();

  2356. }

  2357. 

  2358. void CarlaPlugin::clearBuffers() noexcept

  2359. {

  2360.     pData->clearBuffers();

  2361. }

  2362. 

  2363. // -------------------------------------------------------------------

  2364. // OSC stuff

  2365. 

  2366. // FIXME

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

  2368. {

  2369.     // do nothing

  2370. }

  2371. 

  2372. // -------------------------------------------------------------------

  2373. // MIDI events

  2374. 

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

  2376. {

  2377.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2378.     CARLA_SAFE_ASSERT_RETURN(note < MAX_MIDI_NOTE,);

  2379.     CARLA_SAFE_ASSERT_RETURN(velo < MAX_MIDI_VALUE,);

  2380. 

  2381.     if (! pData->active)

  2382.         return;

  2383. 

  2384.     ExternalMidiNote extNote;

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

  2386.     extNote.note    = note;

  2387.     extNote.velo    = velo;

  2388. 

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

  2390. 

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

  2392.     {

  2393.         if (velo > 0)

  2394.             uiNoteOn(channel, note, velo);

  2395.         else

  2396.             uiNoteOff(channel, note);

  2397.     }

  2398. 

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

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

  2401.                             pData->id,

  2402.                             channel,

  2403.                             note,

  2404.                             velo,

  2405.                             0.0f, nullptr);

  2406. }

  2407. 

  2408. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2409. void CarlaPlugin::postponeRtAllNotesOff()

  2410. {

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

  2412.         return;

  2413. 

  2414.     PluginPostRtEvent postEvent = {

  2415.         kPluginPostRtEventNoteOff,

  2416.         true,

  2417.         pData->ctrlChannel,

  2418.         0, 0, 0.0f

  2419.     };

  2420. 

  2421.     for (int32_t i=0; i < MAX_MIDI_NOTE; ++i)

  2422.     {

  2423.         postEvent.value2 = i;

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

  2425.     }

  2426. }

  2427. #endif

  2428. 

  2429. // -------------------------------------------------------------------

  2430. // UI Stuff

  2431. 

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

  2433. {

  2434.     pData->uiTitle = title;

  2435. }

  2436. 

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

  2438. {

  2439.     if (yesNo) {

  2440.         CARLA_SAFE_ASSERT(false);

  2441.     }

  2442. }

  2443. 

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

  2445. {

  2446.     return nullptr;

  2447. }

  2448. 

  2449. void CarlaPlugin::uiIdle()

  2450. {

  2451.     if (pData->hints & PLUGIN_NEEDS_UI_MAIN_THREAD)

  2452.     {

  2453.         // Update parameter outputs

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

  2455.         {

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

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

  2458.         }

  2459. 

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

  2461. 

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

  2463.         {

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

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

  2466. 

  2467.             switch (event.type)

  2468.             {

  2469.             case kPluginPostRtEventNull:

  2470.             case kPluginPostRtEventDebug:

  2471.             case kPluginPostRtEventMidiLearn:

  2472.                 break;

  2473. 

  2474.             case kPluginPostRtEventParameterChange:

  2475.                 uiParameterChange(static_cast<uint32_t>(event.value1), event.valuef);

  2476.                 break;

  2477. 

  2478.             case kPluginPostRtEventProgramChange:

  2479.                 uiProgramChange(static_cast<uint32_t>(event.value1));

  2480.                 break;

  2481. 

  2482.             case kPluginPostRtEventMidiProgramChange:

  2483.                 uiMidiProgramChange(static_cast<uint32_t>(event.value1));

  2484.                 break;

  2485. 

  2486.             case kPluginPostRtEventNoteOn:

  2487.                 uiNoteOn(static_cast<uint8_t>(event.value1),

  2488.                          static_cast<uint8_t>(event.value2),

  2489.                          static_cast<uint8_t>(event.value3));

  2490.                 break;

  2491. 

  2492.             case kPluginPostRtEventNoteOff:

  2493.                 uiNoteOff(static_cast<uint8_t>(event.value1),

  2494.                           static_cast<uint8_t>(event.value2));

  2495.                 break;

  2496.             }

  2497.         }

  2498. 

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

  2500.     }

  2501. 

  2502. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  2504.         return;

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

  2506.         return;

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

  2508.         return;

  2509. 

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

  2511. 

  2512.     CarlaString uiTitle;

  2513. 

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

  2515.     {

  2516.         uiTitle = pData->uiTitle;

  2517.     }

  2518.     else

  2519.     {

  2520.         uiTitle  = pData->name;

  2521.         uiTitle += " (GUI)";

  2522.     }

  2523. 

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

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

  2526.     {

  2527.         pData->transientTryCounter = 0;

  2528.         pData->transientFirstTry = false;

  2529.     }

  2530. #endif

  2531. }

  2532. 

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

  2534. {

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

  2536.     return;

  2537. 

  2538.     // unused

  2539.     (void)value;

  2540. }

  2541. 

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

  2543. {

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

  2545. }

  2546. 

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

  2548. {

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

  2550. }

  2551. 

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

  2553. {

  2554.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2555.     CARLA_SAFE_ASSERT_RETURN(note < MAX_MIDI_NOTE,);

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

  2557. }

  2558. 

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

  2560. {

  2561.     CARLA_SAFE_ASSERT_RETURN(channel < MAX_MIDI_CHANNELS,);

  2562.     CARLA_SAFE_ASSERT_RETURN(note < MAX_MIDI_NOTE,);

  2563. }

  2564. 

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

  2566. {

  2567.     return pData->engine;

  2568. }

  2569. 

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

  2571. {

  2572.     return pData->client;

  2573. }

  2574. 

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

  2576. {

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

  2578. }

  2579. 

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

  2581. {

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

  2583. }

  2584. 

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

  2586. {

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

  2588. }

  2589. 

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

  2591. {

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

  2593. }

  2594. 

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

  2596. {

  2597.     return pData->event.portIn;

  2598. }

  2599. 

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

  2601. {

  2602.     return pData->event.portOut;

  2603. }

  2604. 

  2605. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

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

  2607. {

  2608.     if (pData->midiLearnParameterIndex < 0)

  2609.         return;

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

  2611.         return;

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

  2613.         return;

  2614. 

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

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

  2617. 

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

  2619.     CARLA_SAFE_ASSERT_INT_RETURN(paramData.mappedControlIndex == CONTROL_INDEX_MIDI_LEARN,

  2620.                                  paramData.mappedControlIndex,);

  2621. 

  2622.     event.ctrl.handled = true;

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

  2624.     paramData.midiChannel = event.channel;

  2625. 

  2626.     pData->postponeRtEvent(kPluginPostRtEventMidiLearn, true,

  2627.                            pData->midiLearnParameterIndex, event.ctrl.param, event.channel, 0.0f);

  2628.     pData->midiLearnParameterIndex = -1;

  2629. }

  2630. #endif

  2631. 

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

  2633. {

  2634.     return nullptr;

  2635. }

  2636. 

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

  2638. {

  2639.     return nullptr;

  2640. }

  2641. 

  2642. uintptr_t CarlaPlugin::getUiBridgeProcessId() const noexcept

  2643. {

  2644.     return 0;

  2645. }

  2646. 

  2647. // -------------------------------------------------------------------

  2648. 

  2649. uint32_t CarlaPlugin::getPatchbayNodeId() const noexcept

  2650. {

  2651.     return pData->nodeId;

  2652. }

  2653. 

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

  2655. {

  2656.     pData->nodeId = nodeId;

  2657. }

  2658. 

  2659. // -------------------------------------------------------------------

  2660. 

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

  2662. {

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

  2664. }

  2665. 

  2666. void CarlaPlugin::restoreLV2State(const bool temporary) noexcept

  2667. {

  2668.     carla_stderr2("Warning: restoreLV2State(%s) called for non-implemented type", bool2str(temporary));

  2669. }

  2670. 

  2671. void CarlaPlugin::prepareForDeletion() noexcept

  2672. {

  2673.     carla_debug("CarlaPlugin::prepareForDeletion");

  2674. 

  2675.     const CarlaMutexLocker cml(pData->masterMutex);

  2676. 

  2677.     pData->client->deactivate(true);

  2678. }

  2679. 

  2680. void CarlaPlugin::waitForBridgeSaveSignal() noexcept

  2681. {

  2682. }

  2683. 

  2684. // -------------------------------------------------------------------

  2685. // Scoped Disabler

  2686. 

  2687. CarlaPlugin::ScopedDisabler::ScopedDisabler(CarlaPlugin* const plugin) noexcept

  2688.     : fPlugin(plugin),

  2689.       fWasEnabled(false)

  2690. {

  2691.     CARLA_SAFE_ASSERT_RETURN(plugin != nullptr,);

  2692.     CARLA_SAFE_ASSERT_RETURN(plugin->pData != nullptr,);

  2693.     CARLA_SAFE_ASSERT_RETURN(plugin->pData->client != nullptr,);

  2694.     carla_debug("CarlaPlugin::ScopedDisabler(%p)", plugin);

  2695. 

  2696.     plugin->pData->masterMutex.lock();

  2697. 

  2698.     if (plugin->pData->enabled)

  2699.     {

  2700.         fWasEnabled = true;

  2701.         plugin->pData->enabled = false;

  2702. 

  2703.         if (plugin->pData->client->isActive())

  2704.             plugin->pData->client->deactivate(false);

  2705.     }

  2706. }

  2707. 

  2708. CarlaPlugin::ScopedDisabler::~ScopedDisabler() noexcept

  2709. {

  2710.     CARLA_SAFE_ASSERT_RETURN(fPlugin != nullptr,);

  2711.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData != nullptr,);

  2712.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData->client != nullptr,);

  2713.     carla_debug("CarlaPlugin::~ScopedDisabler()");

  2714. 

  2715.     if (fWasEnabled)

  2716.     {

  2717.         fPlugin->pData->enabled = true;

  2718.         fPlugin->pData->client->activate();

  2719.     }

  2720. 

  2721.     fPlugin->pData->masterMutex.unlock();

  2722. }

  2723. 

  2724. // -------------------------------------------------------------------

  2725. // Scoped Process Locker

  2726. 

  2727. CarlaPlugin::ScopedSingleProcessLocker::ScopedSingleProcessLocker(CarlaPlugin* const plugin, const bool block) noexcept

  2728.     : fPlugin(plugin),

  2729.       fBlock(block)

  2730. {

  2731.     CARLA_SAFE_ASSERT_RETURN(fPlugin != nullptr,);

  2732.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData != nullptr,);

  2733.     carla_debug("CarlaPlugin::ScopedSingleProcessLocker(%p, %s)", plugin, bool2str(block));

  2734. 

  2735.     if (! fBlock)

  2736.         return;

  2737. 

  2738.     plugin->pData->singleMutex.lock();

  2739. }

  2740. 

  2741. CarlaPlugin::ScopedSingleProcessLocker::~ScopedSingleProcessLocker() noexcept

  2742. {

  2743.     CARLA_SAFE_ASSERT_RETURN(fPlugin != nullptr,);

  2744.     CARLA_SAFE_ASSERT_RETURN(fPlugin->pData != nullptr,);

  2745.     carla_debug("CarlaPlugin::~ScopedSingleProcessLocker()");

  2746. 

  2747.     if (! fBlock)

  2748.         return;

  2749. 

  2750. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  2751.     if (fPlugin->pData->singleMutex.wasTryLockCalled())

  2752.         fPlugin->pData->needsReset = true;

  2753. #endif

  2754. 

  2755.     fPlugin->pData->singleMutex.unlock();

  2756. }

  2757. 

  2758. // -------------------------------------------------------------------

  2759. 

  2760. CARLA_BACKEND_END_NAMESPACE