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.
182 Commits
16 Branches
3.6GB
Tree: e63cca4f73
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'e63cca4f73'
${ noResults }
Carla/source/utils/CarlaBackendUtils.hpp

517 lines
15KB
Raw Blame History 

  1. /*

  2.  * Carla Backend utils

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

  4.  *

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

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

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

  8.  * the License, or any later version.

  9.  *

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

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

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

  13.  * GNU General Public License for more details.

  14.  *

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

  16.  */

  17. 

  18. #ifndef __CARLA_BACKEND_UTILS_HPP__

  19. #define __CARLA_BACKEND_UTILS_HPP__

  20. 

  21. #include "CarlaBackend.hpp"

  22. #include "CarlaString.hpp"

  23. 

  24. CARLA_BACKEND_START_NAMESPACE

  25. 

  26. // -------------------------------------------------

  27. 

  28. static inline

  29. const char* PluginOption2Str(const unsigned int& option)

  30. {

  31.     switch (option)

  32.     {

  33.     case PLUGIN_OPTION_FIXED_BUFFER:

  34.         return "PLUGIN_OPTION_FIXED_BUFFER";

  35.     case PLUGIN_OPTION_FORCE_STEREO:

  36.         return "PLUGIN_OPTION_FORCE_STEREO";

  37.     case PLUGIN_OPTION_MAP_PROGRAM_CHANGES:

  38.         return "PLUGIN_OPTION_MAP_PROGRAM_CHANGES";

  39.     case PLUGIN_OPTION_USE_CHUNKS:

  40.         return "PLUGIN_OPTION_USE_CHUNKS";

  41.     case PLUGIN_OPTION_SEND_CONTROL_CHANGES:

  42.         return "PLUGIN_OPTION_SEND_CONTROL_CHANGES";

  43.     case PLUGIN_OPTION_SEND_CHANNEL_PRESSURE:

  44.         return "PLUGIN_OPTION_SEND_CHANNEL_PRESSURE";

  45.     case PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH:

  46.         return "PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH";

  47.     case PLUGIN_OPTION_SEND_PITCHBEND:

  48.         return "PLUGIN_OPTION_SEND_PITCHBEND";

  49.     case PLUGIN_OPTION_SEND_ALL_SOUND_OFF:

  50.         return "PLUGIN_OPTION_SEND_ALL_SOUND_OFF";

  51.     }

  52. 

  53.     carla_stderr("CarlaBackend::PluginOption2Str(%i) - invalid type", option);

  54.     return nullptr;

  55. }

  56. 

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

  58. 

  59. static inline

  60. const char* BinaryType2Str(const BinaryType& type)

  61. {

  62.     switch (type)

  63.     {

  64.     case BINARY_NONE:

  65.         return "BINARY_NONE";

  66.     case BINARY_POSIX32:

  67.         return "BINARY_POSIX32";

  68.     case BINARY_POSIX64:

  69.         return "BINARY_POSIX64";

  70.     case BINARY_WIN32:

  71.         return "BINARY_WIN32";

  72.     case BINARY_WIN64:

  73.         return "BINARY_WIN64";

  74.     case BINARY_OTHER:

  75.         return "BINARY_OTHER";

  76.     }

  77. 

  78.     carla_stderr("CarlaBackend::BinaryType2Str(%i) - invalid type", type);

  79.     return nullptr;

  80. }

  81. 

  82. static inline

  83. const char* PluginType2Str(const PluginType& type)

  84. {

  85.     switch (type)

  86.     {

  87.     case PLUGIN_NONE:

  88.         return "PLUGIN_NONE";

  89.     case PLUGIN_INTERNAL:

  90.         return "PLUGIN_INTERNAL";

  91.     case PLUGIN_LADSPA:

  92.         return "PLUGIN_LADSPA";

  93.     case PLUGIN_DSSI:

  94.         return "PLUGIN_DSSI";

  95.     case PLUGIN_LV2:

  96.         return "PLUGIN_LV2";

  97.     case PLUGIN_VST:

  98.         return "PLUGIN_VST";

  99.     case PLUGIN_GIG:

  100.         return "PLUGIN_GIG";

  101.     case PLUGIN_SF2:

  102.         return "PLUGIN_SF2";

  103.     case PLUGIN_SFZ:

  104.         return "PLUGIN_SFZ";

  105.     }

  106. 

  107.     carla_stderr("CarlaBackend::PluginType2Str(%i) - invalid type", type);

  108.     return nullptr;

  109. }

  110. 

  111. static inline

  112. const char* PluginCategory2Str(const PluginCategory& category)

  113. {

  114.     switch (category)

  115.     {

  116.     case PLUGIN_CATEGORY_NONE:

  117.         return "PLUGIN_CATEGORY_NONE";

  118.     case PLUGIN_CATEGORY_SYNTH:

  119.         return "PLUGIN_CATEGORY_SYNTH";

  120.     case PLUGIN_CATEGORY_DELAY:

  121.         return "PLUGIN_CATEGORY_DELAY";

  122.     case PLUGIN_CATEGORY_EQ:

  123.         return "PLUGIN_CATEGORY_EQ";

  124.     case PLUGIN_CATEGORY_FILTER:

  125.         return "PLUGIN_CATEGORY_FILTER";

  126.     case PLUGIN_CATEGORY_DYNAMICS:

  127.         return "PLUGIN_CATEGORY_DYNAMICS";

  128.     case PLUGIN_CATEGORY_MODULATOR:

  129.         return "PLUGIN_CATEGORY_MODULATOR";

  130.     case PLUGIN_CATEGORY_UTILITY:

  131.         return "PLUGIN_CATEGORY_UTILITY";

  132.     case PLUGIN_CATEGORY_OTHER:

  133.         return "PLUGIN_CATEGORY_OTHER";

  134.     }

  135. 

  136.     carla_stderr("CarlaBackend::PluginCategory2Str(%i) - invalid category", category);

  137.     return nullptr;

  138. }

  139. 

  140. static inline

  141. const char* ParameterType2Str(const ParameterType& type)

  142. {

  143.     switch (type)

  144.     {

  145.     case PARAMETER_UNKNOWN:

  146.         return "PARAMETER_UNKNOWN";

  147.     case PARAMETER_INPUT:

  148.         return "PARAMETER_INPUT";

  149.     case PARAMETER_OUTPUT:

  150.         return "PARAMETER_OUTPUT";

  151.     case PARAMETER_LATENCY:

  152.         return "PARAMETER_LATENCY";

  153.     case PARAMETER_SAMPLE_RATE:

  154.         return "PARAMETER_SAMPLE_RATE";

  155. #ifdef WANT_LV2

  156.     case PARAMETER_LV2_FREEWHEEL:

  157.         return "PARAMETER_LV2_FREEWHEEL";

  158.     case PARAMETER_LV2_TIME:

  159.         return "PARAMETER_LV2_TIME";

  160. #endif

  161.     }

  162. 

  163.     carla_stderr("CarlaBackend::ParameterType2Str(%i) - invalid type", type);

  164.     return nullptr;

  165. }

  166. 

  167. static inline

  168. const char* InternalParametersIndex2Str(const InternalParametersIndex& index)

  169. {

  170.     switch (index)

  171.     {

  172.     case PARAMETER_NULL:

  173.         return "PARAMETER_NULL";

  174.     case PARAMETER_ACTIVE:

  175.         return "PARAMETER_ACTIVE";

  176.     case PARAMETER_DRYWET:

  177.         return "PARAMETER_DRYWET";

  178.     case PARAMETER_VOLUME:

  179.         return "PARAMETER_VOLUME";

  180.     case PARAMETER_BALANCE_LEFT:

  181.         return "PARAMETER_BALANCE_LEFT";

  182.     case PARAMETER_BALANCE_RIGHT:

  183.         return "PARAMETER_BALANCE_RIGHT";

  184.     case PARAMETER_PANNING:

  185.         return "PARAMETER_PANNING";

  186.     case PARAMETER_CTRL_CHANNEL:

  187.         return "PARAMETER_CTRL_CHANNEL";

  188.     case PARAMETER_MAX:

  189.         return "PARAMETER_MAX";

  190.     }

  191. 

  192.     carla_stderr("CarlaBackend::InternalParametersIndex2Str(%i) - invalid index", index);

  193.     return nullptr;

  194. }

  195. 

  196. static inline

  197. const char* OptionsType2Str(const OptionsType& type)

  198. {

  199.     switch (type)

  200.     {

  201.     case OPTION_PROCESS_NAME:

  202.         return "OPTION_PROCESS_NAME";

  203.     case OPTION_PROCESS_MODE:

  204.         return "OPTION_PROCESS_MODE";

  205.     case OPTION_TRANSPORT_MODE:

  206.         return "OPTION_TRANSPORT_MODE";

  207.     case OPTION_FORCE_STEREO:

  208.         return "OPTION_FORCE_STEREO";

  209.     case OPTION_PREFER_PLUGIN_BRIDGES:

  210.         return "OPTION_PREFER_PLUGIN_BRIDGES";

  211.     case OPTION_PREFER_UI_BRIDGES:

  212.         return "OPTION_PREFER_UI_BRIDGES";

  213. #ifdef WANT_DSSI

  214.     case OPTION_USE_DSSI_VST_CHUNKS:

  215.         return "OPTION_USE_DSSI_VST_CHUNKS";

  216. #endif

  217.     case OPTION_MAX_PARAMETERS:

  218.         return "OPTION_MAX_PARAMETERS";

  219.     case OPTION_OSC_UI_TIMEOUT:

  220.         return "OPTION_OSC_UI_TIMEOUT";

  221.     case OPTION_PREFERRED_BUFFER_SIZE:

  222.         return "OPTION_PREFERRED_BUFFER_SIZE";

  223.     case OPTION_PREFERRED_SAMPLE_RATE:

  224.         return "OPTION_PREFERRED_SAMPLE_RATE";

  225. #ifndef BUILD_BRIDGE

  226.     case OPTION_PATH_BRIDGE_NATIVE:

  227.         return "OPTION_PATH_BRIDGE_NATIVE";

  228.     case OPTION_PATH_BRIDGE_POSIX32:

  229.         return "OPTION_PATH_BRIDGE_POSIX32";

  230.     case OPTION_PATH_BRIDGE_POSIX64:

  231.         return "OPTION_PATH_BRIDGE_POSIX64";

  232.     case OPTION_PATH_BRIDGE_WIN32:

  233.         return "OPTION_PATH_BRIDGE_WIN32";

  234.     case OPTION_PATH_BRIDGE_WIN64:

  235.         return "OPTION_PATH_BRIDGE_WIN64";

  236. #endif

  237. #ifdef WANT_LV2

  238.     case OPTION_PATH_BRIDGE_LV2_GTK2:

  239.         return "OPTION_PATH_BRIDGE_LV2_GTK2";

  240.     case OPTION_PATH_BRIDGE_LV2_GTK3:

  241.         return "OPTION_PATH_BRIDGE_LV2_GTK3";

  242.     case OPTION_PATH_BRIDGE_LV2_QT4:

  243.         return "OPTION_PATH_BRIDGE_LV2_QT4";

  244.     case OPTION_PATH_BRIDGE_LV2_QT5:

  245.         return "OPTION_PATH_BRIDGE_LV2_QT5";

  246.     case OPTION_PATH_BRIDGE_LV2_COCOA:

  247.         return "OPTION_PATH_BRIDGE_LV2_COCOA";

  248.     case OPTION_PATH_BRIDGE_LV2_WINDOWS:

  249.         return "OPTION_PATH_BRIDGE_LV2_WINDOWS";

  250.     case OPTION_PATH_BRIDGE_LV2_X11:

  251.         return "OPTION_PATH_BRIDGE_LV2_X11";

  252. #endif

  253. #ifdef WANT_VST

  254.     case OPTION_PATH_BRIDGE_VST_COCOA:

  255.         return "OPTION_PATH_BRIDGE_VST_COCOA";

  256.     case OPTION_PATH_BRIDGE_VST_HWND:

  257.         return "OPTION_PATH_BRIDGE_VST_HWND";

  258.     case OPTION_PATH_BRIDGE_VST_X11:

  259.         return "OPTION_PATH_BRIDGE_VST_X11";

  260. #endif

  261.     }

  262. 

  263.     carla_stderr("CarlaBackend::OptionsType2Str(%i) - invalid type", type);

  264.     return nullptr;

  265. }

  266. 

  267. static inline

  268. const char* CallbackType2Str(const CallbackType& type)

  269. {

  270.     switch (type)

  271.     {

  272.     case CALLBACK_DEBUG:

  273.         return "CALLBACK_DEBUG";

  274.     case CALLBACK_PLUGIN_ADDED:

  275.         return "CALLBACK_PLUGIN_ADDED";

  276.     case CALLBACK_PLUGIN_REMOVED:

  277.         return "CALLBACK_PLUGIN_REMOVED";

  278.     case CALLBACK_PARAMETER_VALUE_CHANGED:

  279.         return "CALLBACK_PARAMETER_VALUE_CHANGED";

  280.     case CALLBACK_PARAMETER_DEFAULT_CHANGED:

  281.         return "CALLBACK_PARAMETER_DEFAULT_CHANGED";

  282.     case CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:

  283.         return "CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";

  284.     case CALLBACK_PARAMETER_MIDI_CC_CHANGED:

  285.         return "CALLBACK_PARAMETER_MIDI_CC_CHANGED";

  286.     case CALLBACK_PROGRAM_CHANGED:

  287.         return "CALLBACK_PROGRAM_CHANGED";

  288.     case CALLBACK_MIDI_PROGRAM_CHANGED:

  289.         return "CALLBACK_MIDI_PROGRAM_CHANGED";

  290.     case CALLBACK_NOTE_ON:

  291.         return "CALLBACK_NOTE_ON";

  292.     case CALLBACK_NOTE_OFF:

  293.         return "CALLBACK_NOTE_OFF";

  294.     case CALLBACK_SHOW_GUI:

  295.         return "CALLBACK_SHOW_GUI";

  296.     case CALLBACK_UPDATE:

  297.         return "CALLBACK_UPDATE";

  298.     case CALLBACK_RELOAD_INFO:

  299.         return "CALLBACK_RELOAD_INFO";

  300.     case CALLBACK_RELOAD_PARAMETERS:

  301.         return "CALLBACK_RELOAD_PARAMETERS";

  302.     case CALLBACK_RELOAD_PROGRAMS:

  303.         return "CALLBACK_RELOAD_PROGRAMS";

  304.     case CALLBACK_RELOAD_ALL:

  305.         return "CALLBACK_RELOAD_ALL";

  306.     case CALLBACK_NSM_ANNOUNCE:

  307.         return "CALLBACK_NSM_ANNOUNCE";

  308.     case CALLBACK_NSM_OPEN1:

  309.         return "CALLBACK_NSM_OPEN1";

  310.     case CALLBACK_NSM_OPEN2:

  311.         return "CALLBACK_NSM_OPEN2";

  312.     case CALLBACK_NSM_SAVE:

  313.         return "CALLBACK_NSM_SAVE";

  314.     case CALLBACK_ERROR:

  315.         return "CALLBACK_ERROR";

  316.     case CALLBACK_QUIT:

  317.         return "CALLBACK_QUIT";

  318.     }

  319. 

  320.     carla_stderr("CarlaBackend::CallbackType2Str(%i) - invalid type", type);

  321.     return nullptr;

  322. }

  323. 

  324. static inline

  325. const char* ProcessMode2Str(const ProcessMode& mode)

  326. {

  327.     switch (mode)

  328.     {

  329.     case PROCESS_MODE_SINGLE_CLIENT:

  330.         return "PROCESS_MODE_SINGLE_CLIENT";

  331.     case PROCESS_MODE_MULTIPLE_CLIENTS:

  332.         return "PROCESS_MODE_MULTIPLE_CLIENTS";

  333.     case PROCESS_MODE_CONTINUOUS_RACK:

  334.         return "PROCESS_MODE_CONTINUOUS_RACK";

  335.     case PROCESS_MODE_PATCHBAY:

  336.         return "PROCESS_MODE_PATCHBAY";

  337.     case PROCESS_MODE_BRIDGE:

  338.         return "PROCESS_MODE_BRIDGE";

  339.     }

  340. 

  341.     carla_stderr("CarlaBackend::ProcessModeType2Str(%i) - invalid type", mode);

  342.     return nullptr;

  343. }

  344. 

  345. // -------------------------------------------------

  346. 

  347. static inline

  348. uintptr_t getAddressFromPointer(void* ptr)

  349. {

  350.     carla_debug("CarlaBackend::getAddressFromPointer(%p)", ptr);

  351.     CARLA_ASSERT(ptr != nullptr);

  352. 

  353.     uintptr_t* addr = (uintptr_t*)&ptr;

  354.     return *addr;

  355. }

  356. 

  357. static inline

  358. void* getPointerFromAddress(uintptr_t& addr)

  359. {

  360.     CARLA_ASSERT(addr != 0);

  361. 

  362.     uintptr_t** const ptr = (uintptr_t**)&addr;

  363.     return *ptr;

  364. }

  365. 

  366. // -------------------------------------------------

  367. 

  368. static inline

  369. const char* getPluginTypeAsString(const PluginType& type)

  370. {

  371.     carla_debug("CarlaBackend::getPluginTypeAsString(%s)", PluginType2Str(type));

  372. 

  373.     switch (type)

  374.     {

  375.     case PLUGIN_NONE:

  376.         return "NONE";

  377.     case PLUGIN_INTERNAL:

  378.         return "INTERNAL";

  379.     case PLUGIN_LADSPA:

  380.         return "LADSPA";

  381.     case PLUGIN_DSSI:

  382.         return "DSSI";

  383.     case PLUGIN_LV2:

  384.         return "LV2";

  385.     case PLUGIN_VST:

  386.         return "VST";

  387.     case PLUGIN_GIG:

  388.         return "GIG";

  389.     case PLUGIN_SF2:

  390.         return "SF2";

  391.     case PLUGIN_SFZ:

  392.         return "SFZ";

  393.     }

  394. 

  395.     carla_stderr("CarlaBackend::getPluginTypeAsString(%i) - invalid type", type);

  396.     return "NONE";

  397. }

  398. 

  399. static inline

  400. PluginType getPluginTypeFromString(const char* const stype)

  401. {

  402.     carla_debug("CarlaBackend::getPluginTypeFromString(%s)", stype);

  403. 

  404.     if (stype == nullptr)

  405.     {

  406.         carla_stderr("CarlaBackend::getPluginTypeFromString() - null string type");

  407.         return PLUGIN_NONE;

  408.     }

  409. 

  410.     if (std::strcmp(stype, "NONE") == 0)

  411.         return PLUGIN_NONE;

  412.     if (std::strcmp(stype, "INTERNAL") == 0 || std::strcmp(stype, "Internal") == 0)

  413.         return PLUGIN_INTERNAL;

  414.     if (std::strcmp(stype, "LADSPA") == 0)

  415.         return PLUGIN_LADSPA;

  416.     if (std::strcmp(stype, "DSSI") == 0)

  417.         return PLUGIN_DSSI;

  418.     if (std::strcmp(stype, "LV2") == 0)

  419.         return PLUGIN_LV2;

  420.     if (std::strcmp(stype, "VST") == 0)

  421.         return PLUGIN_VST;

  422.     if (std::strcmp(stype, "GIG") == 0)

  423.         return PLUGIN_GIG;

  424.     if (std::strcmp(stype, "SF2") == 0)

  425.         return PLUGIN_SF2;

  426.     if (std::strcmp(stype, "SFZ") == 0)

  427.         return PLUGIN_SFZ;

  428. 

  429.     carla_stderr("CarlaBackend::getPluginTypeFromString(%s) - invalid string type", stype);

  430.     return PLUGIN_NONE;

  431. }

  432. 

  433. // -------------------------------------------------

  434. 

  435. static inline

  436. PluginCategory getPluginCategoryFromName(const char* const name)

  437. {

  438.     carla_debug("CarlaBackend::getPluginCategoryFromName(\"%s\")", name);

  439.     CARLA_ASSERT(name);

  440. 

  441.     if (! name)

  442.         return PLUGIN_CATEGORY_NONE;

  443. 

  444.     CarlaString sname(name);

  445. 

  446.     if (sname.isEmpty())

  447.         return PLUGIN_CATEGORY_NONE;

  448. 

  449.     sname.toLower();

  450. 

  451.     // generic tags first

  452.     if (sname.contains("delay"))

  453.         return PLUGIN_CATEGORY_DELAY;

  454.     if (sname.contains("reverb"))

  455.         return PLUGIN_CATEGORY_DELAY;

  456. 

  457.     // filter

  458.     if (sname.contains("filter"))

  459.         return PLUGIN_CATEGORY_FILTER;

  460. 

  461.     // dynamics

  462.     if (sname.contains("dynamics"))

  463.         return PLUGIN_CATEGORY_DYNAMICS;

  464.     if (sname.contains("amplifier"))

  465.         return PLUGIN_CATEGORY_DYNAMICS;

  466.     if (sname.contains("compressor"))

  467.         return PLUGIN_CATEGORY_DYNAMICS;

  468.     if (sname.contains("enhancer"))

  469.         return PLUGIN_CATEGORY_DYNAMICS;

  470.     if (sname.contains("exciter"))

  471.         return PLUGIN_CATEGORY_DYNAMICS;

  472.     if (sname.contains("gate"))

  473.         return PLUGIN_CATEGORY_DYNAMICS;

  474.     if (sname.contains("limiter"))

  475.         return PLUGIN_CATEGORY_DYNAMICS;

  476. 

  477.     // modulator

  478.     if (sname.contains("modulator"))

  479.         return PLUGIN_CATEGORY_MODULATOR;

  480.     if (sname.contains("chorus"))

  481.         return PLUGIN_CATEGORY_MODULATOR;

  482.     if (sname.contains("flanger"))

  483.         return PLUGIN_CATEGORY_MODULATOR;

  484.     if (sname.contains("phaser"))

  485.         return PLUGIN_CATEGORY_MODULATOR;

  486.     if (sname.contains("saturator"))

  487.         return PLUGIN_CATEGORY_MODULATOR;

  488. 

  489.     // utility

  490.     if (sname.contains("utility"))

  491.         return PLUGIN_CATEGORY_UTILITY;

  492.     if (sname.contains("analyzer"))

  493.         return PLUGIN_CATEGORY_UTILITY;

  494.     if (sname.contains("converter"))

  495.         return PLUGIN_CATEGORY_UTILITY;

  496.     if (sname.contains("deesser"))

  497.         return PLUGIN_CATEGORY_UTILITY;

  498.     if (sname.contains("mixer"))

  499.         return PLUGIN_CATEGORY_UTILITY;

  500. 

  501.     // common tags

  502.     if (sname.contains("verb"))

  503.         return PLUGIN_CATEGORY_DELAY;

  504. 

  505.     if (sname.contains("eq"))

  506.         return PLUGIN_CATEGORY_EQ;

  507. 

  508.     if (sname.contains("tool"))

  509.         return PLUGIN_CATEGORY_UTILITY;

  510. 

  511.     return PLUGIN_CATEGORY_NONE;

  512. }

  513. 

  514. CARLA_BACKEND_END_NAMESPACE

  515. 

  516. #endif // __CARLA_BACKEND_UTILS_HPP__