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

784 lines
24KB
Raw Blame History 

  1. /*

  2.  * Carla Backend utils

  3.  * Copyright (C) 2011-2021 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. #ifndef CARLA_BACKEND_UTILS_HPP_INCLUDED

  19. #define CARLA_BACKEND_UTILS_HPP_INCLUDED

  20. 

  21. #include "CarlaBackend.h"

  22. #include "CarlaString.hpp"

  23. 

  24. CARLA_BACKEND_START_NAMESPACE

  25. 

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

  27. 

  28. static inline

  29. const char* PluginOption2Str(const uint option) noexcept

  30. {

  31.     switch (option)

  32.     {

  33.     case PLUGIN_OPTION_FIXED_BUFFERS:

  34.         return "PLUGIN_OPTION_FIXED_BUFFERS";

  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 option", option);

  54.     return nullptr;

  55. }

  56. 

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

  58. 

  59. static inline

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

  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* FileType2Str(const FileType type) noexcept

  84. {

  85.     switch (type)

  86.     {

  87.     case FILE_NONE:

  88.         return "FILE_NONE";

  89.     case FILE_AUDIO:

  90.         return "FILE_AUDIO";

  91.     case FILE_MIDI:

  92.         return "FILE_MIDI";

  93.     }

  94. 

  95.     carla_stderr("CarlaBackend::FileType2Str(%i) - invalid type", type);

  96.     return nullptr;

  97. }

  98. 

  99. static inline

  100. const char* PluginType2Str(const PluginType type) noexcept

  101. {

  102.     switch (type)

  103.     {

  104.     case PLUGIN_NONE:

  105.         return "PLUGIN_NONE";

  106.     case PLUGIN_INTERNAL:

  107.         return "PLUGIN_INTERNAL";

  108.     case PLUGIN_LADSPA:

  109.         return "PLUGIN_LADSPA";

  110.     case PLUGIN_DSSI:

  111.         return "PLUGIN_DSSI";

  112.     case PLUGIN_LV2:

  113.         return "PLUGIN_LV2";

  114.     case PLUGIN_VST2:

  115.         return "PLUGIN_VST2";

  116.     case PLUGIN_VST3:

  117.         return "PLUGIN_VST3";

  118.     case PLUGIN_AU:

  119.         return "PLUGIN_AU";

  120.     case PLUGIN_DLS:

  121.         return "PLUGIN_DLS";

  122.     case PLUGIN_GIG:

  123.         return "PLUGIN_GIG";

  124.     case PLUGIN_SF2:

  125.         return "PLUGIN_SF2";

  126.     case PLUGIN_SFZ:

  127.         return "PLUGIN_SFZ";

  128.     case PLUGIN_JACK:

  129.         return "PLUGIN_JACK";

  130.     case PLUGIN_JSFX:

  131.         return "PLUGIN_JSFX";

  132.     case PLUGIN_CLAP:

  133.         return "PLUGIN_CLAP";

  134.     case PLUGIN_TYPE_COUNT:

  135.         break;

  136.     }

  137. 

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

  139.     return nullptr;

  140. }

  141. 

  142. static inline

  143. const char* PluginCategory2Str(const PluginCategory category) noexcept

  144. {

  145.     switch (category)

  146.     {

  147.     case PLUGIN_CATEGORY_NONE:

  148.         return "PLUGIN_CATEGORY_NONE";

  149.     case PLUGIN_CATEGORY_SYNTH:

  150.         return "PLUGIN_CATEGORY_SYNTH";

  151.     case PLUGIN_CATEGORY_DELAY:

  152.         return "PLUGIN_CATEGORY_DELAY";

  153.     case PLUGIN_CATEGORY_EQ:

  154.         return "PLUGIN_CATEGORY_EQ";

  155.     case PLUGIN_CATEGORY_FILTER:

  156.         return "PLUGIN_CATEGORY_FILTER";

  157.     case PLUGIN_CATEGORY_DISTORTION:

  158.         return "PLUGIN_CATEGORY_DISTORTION";

  159.     case PLUGIN_CATEGORY_DYNAMICS:

  160.         return "PLUGIN_CATEGORY_DYNAMICS";

  161.     case PLUGIN_CATEGORY_MODULATOR:

  162.         return "PLUGIN_CATEGORY_MODULATOR";

  163.     case PLUGIN_CATEGORY_UTILITY:

  164.         return "PLUGIN_CATEGORY_UTILITY";

  165.     case PLUGIN_CATEGORY_OTHER:

  166.         return "PLUGIN_CATEGORY_OTHER";

  167.     }

  168. 

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

  170.     return nullptr;

  171. }

  172. 

  173. static inline

  174. const char* ParameterType2Str(const ParameterType type) noexcept

  175. {

  176.     switch (type)

  177.     {

  178.     case PARAMETER_UNKNOWN:

  179.         return "PARAMETER_UNKNOWN";

  180.     case PARAMETER_INPUT:

  181.         return "PARAMETER_INPUT";

  182.     case PARAMETER_OUTPUT:

  183.         return "PARAMETER_OUTPUT";

  184.     }

  185. 

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

  187.     return nullptr;

  188. }

  189. 

  190. static inline

  191. const char* InternalParameterIndex2Str(const InternalParameterIndex index) noexcept

  192. {

  193.     switch (index)

  194.     {

  195.     case PARAMETER_NULL:

  196.         return "PARAMETER_NULL";

  197. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  198.     case PARAMETER_ACTIVE:

  199.         return "PARAMETER_ACTIVE";

  200.     case PARAMETER_DRYWET:

  201.         return "PARAMETER_DRYWET";

  202.     case PARAMETER_VOLUME:

  203.         return "PARAMETER_VOLUME";

  204.     case PARAMETER_BALANCE_LEFT:

  205.         return "PARAMETER_BALANCE_LEFT";

  206.     case PARAMETER_BALANCE_RIGHT:

  207.         return "PARAMETER_BALANCE_RIGHT";

  208.     case PARAMETER_PANNING:

  209.         return "PARAMETER_PANNING";

  210.     case PARAMETER_CTRL_CHANNEL:

  211.         return "PARAMETER_CTRL_CHANNEL";

  212. #endif

  213.     case PARAMETER_MAX:

  214.         return "PARAMETER_MAX";

  215.     }

  216. 

  217.     carla_stderr("CarlaBackend::InternalParameterIndex2Str(%i) - invalid index", index);

  218.     return nullptr;

  219. }

  220. 

  221. static inline

  222. const char* EngineCallbackOpcode2Str(const EngineCallbackOpcode opcode) noexcept

  223. {

  224.     switch (opcode)

  225.     {

  226.     case ENGINE_CALLBACK_DEBUG:

  227.         return "ENGINE_CALLBACK_DEBUG";

  228.     case ENGINE_CALLBACK_PLUGIN_ADDED:

  229.         return "ENGINE_CALLBACK_PLUGIN_ADDED";

  230.     case ENGINE_CALLBACK_PLUGIN_REMOVED:

  231.         return "ENGINE_CALLBACK_PLUGIN_REMOVED";

  232.     case ENGINE_CALLBACK_PLUGIN_RENAMED:

  233.         return "ENGINE_CALLBACK_PLUGIN_RENAMED";

  234.     case ENGINE_CALLBACK_PLUGIN_UNAVAILABLE:

  235.         return "ENGINE_CALLBACK_PLUGIN_UNAVAILABLE";

  236.     case ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED:

  237.         return "ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED";

  238.     case ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED:

  239.         return "ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED";

  240. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  241.     case ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED:

  242.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED";

  243.     case ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:

  244.         return "ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";

  245.     case ENGINE_CALLBACK_OPTION_CHANGED:

  246.         return "ENGINE_CALLBACK_OPTION_CHANGED";

  247. #endif

  248.     case ENGINE_CALLBACK_PROGRAM_CHANGED:

  249.         return "ENGINE_CALLBACK_PROGRAM_CHANGED";

  250.     case ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED:

  251.         return "ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED";

  252.     case ENGINE_CALLBACK_UI_STATE_CHANGED:

  253.         return "ENGINE_CALLBACK_UI_STATE_CHANGED";

  254.     case ENGINE_CALLBACK_NOTE_ON:

  255.         return "ENGINE_CALLBACK_NOTE_ON";

  256.     case ENGINE_CALLBACK_NOTE_OFF:

  257.         return "ENGINE_CALLBACK_NOTE_OFF";

  258.     case ENGINE_CALLBACK_UPDATE:

  259.         return "ENGINE_CALLBACK_UPDATE";

  260.     case ENGINE_CALLBACK_RELOAD_INFO:

  261.         return "ENGINE_CALLBACK_RELOAD_INFO";

  262.     case ENGINE_CALLBACK_RELOAD_PARAMETERS:

  263.         return "ENGINE_CALLBACK_RELOAD_PARAMETERS";

  264.     case ENGINE_CALLBACK_RELOAD_PROGRAMS:

  265.         return "ENGINE_CALLBACK_RELOAD_PROGRAMS";

  266.     case ENGINE_CALLBACK_RELOAD_ALL:

  267.         return "ENGINE_CALLBACK_RELOAD_ALL";

  268. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  269.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED:

  270.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED";

  271.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED:

  272.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED";

  273.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED:

  274.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED";

  275.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED:

  276.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED";

  277.     case ENGINE_CALLBACK_PATCHBAY_PORT_ADDED:

  278.         return "ENGINE_CALLBACK_PATCHBAY_PORT_ADDED";

  279.     case ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED:

  280.         return "ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED";

  281.     case ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED:

  282.         return "ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED";

  283.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED:

  284.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED";

  285.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED:

  286.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED";

  287. #endif

  288.     case ENGINE_CALLBACK_ENGINE_STARTED:

  289.         return "ENGINE_CALLBACK_ENGINE_STARTED";

  290.     case ENGINE_CALLBACK_ENGINE_STOPPED:

  291.         return "ENGINE_CALLBACK_ENGINE_STOPPED";

  292.     case ENGINE_CALLBACK_PROCESS_MODE_CHANGED:

  293.         return "ENGINE_CALLBACK_PROCESS_MODE_CHANGED";

  294.     case ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED:

  295.         return "ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED";

  296.     case ENGINE_CALLBACK_BUFFER_SIZE_CHANGED:

  297.         return "ENGINE_CALLBACK_BUFFER_SIZE_CHANGED";

  298.     case ENGINE_CALLBACK_SAMPLE_RATE_CHANGED:

  299.         return "ENGINE_CALLBACK_SAMPLE_RATE_CHANGED";

  300.     case ENGINE_CALLBACK_CANCELABLE_ACTION:

  301.         return "ENGINE_CALLBACK_CANCELABLE_ACTION";

  302.     case ENGINE_CALLBACK_PROJECT_LOAD_FINISHED:

  303.         return "ENGINE_CALLBACK_PROJECT_LOAD_FINISHED";

  304.     case ENGINE_CALLBACK_NSM:

  305.         return "ENGINE_CALLBACK_NSM";

  306.     case ENGINE_CALLBACK_IDLE:

  307.         return "ENGINE_CALLBACK_IDLE";

  308.     case ENGINE_CALLBACK_INFO:

  309.         return "ENGINE_CALLBACK_INFO";

  310.     case ENGINE_CALLBACK_ERROR:

  311.         return "ENGINE_CALLBACK_ERROR";

  312.     case ENGINE_CALLBACK_QUIT:

  313.         return "ENGINE_CALLBACK_QUIT";

  314.     case ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW:

  315.         return "ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW";

  316.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED:

  317.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED";

  318.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED:

  319.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED";

  320.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED:

  321.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED";

  322.     case ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED:

  323.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED";

  324.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED:

  325.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED";

  326.     case ENGINE_CALLBACK_EMBED_UI_RESIZED:

  327.         return "ENGINE_CALLBACK_EMBED_UI_RESIZED";

  328.     }

  329. 

  330.     carla_stderr("CarlaBackend::EngineCallbackOpcode2Str(%i) - invalid opcode", opcode);

  331.     return nullptr;

  332. }

  333. 

  334. static inline

  335. const char* EngineOption2Str(const EngineOption option) noexcept

  336. {

  337.     switch (option)

  338.     {

  339.     case ENGINE_OPTION_DEBUG:

  340.         return "ENGINE_OPTION_DEBUG";

  341.     case ENGINE_OPTION_PROCESS_MODE:

  342.         return "ENGINE_OPTION_PROCESS_MODE";

  343.     case ENGINE_OPTION_TRANSPORT_MODE:

  344.         return "ENGINE_OPTION_TRANSPORT_MODE";

  345.     case ENGINE_OPTION_FORCE_STEREO:

  346.         return "ENGINE_OPTION_FORCE_STEREO";

  347.     case ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

  348.         return "ENGINE_OPTION_PREFER_PLUGIN_BRIDGES";

  349.     case ENGINE_OPTION_PREFER_UI_BRIDGES:

  350.         return "ENGINE_OPTION_PREFER_UI_BRIDGES";

  351.     case ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

  352.         return "ENGINE_OPTION_UIS_ALWAYS_ON_TOP";

  353.     case ENGINE_OPTION_MAX_PARAMETERS:

  354.         return "ENGINE_OPTION_MAX_PARAMETERS";

  355.     case ENGINE_OPTION_RESET_XRUNS:

  356.         return "ENGINE_OPTION_RESET_XRUNS";

  357.     case ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  358.         return "ENGINE_OPTION_UI_BRIDGES_TIMEOUT";

  359.     case ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  360.         return "ENGINE_OPTION_AUDIO_BUFFER_SIZE";

  361.     case ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  362.         return "ENGINE_OPTION_AUDIO_SAMPLE_RATE";

  363.     case ENGINE_OPTION_AUDIO_TRIPLE_BUFFER:

  364.         return "ENGINE_OPTION_AUDIO_TRIPLE_BUFFER";

  365.     case ENGINE_OPTION_AUDIO_DRIVER:

  366.         return "ENGINE_OPTION_AUDIO_DRIVER";

  367.     case ENGINE_OPTION_AUDIO_DEVICE:

  368.         return "ENGINE_OPTION_AUDIO_DEVICE";

  369. #ifndef BUILD_BRIDGE

  370.     case ENGINE_OPTION_OSC_ENABLED:

  371.         return "ENGINE_OPTION_OSC_ENABLED";

  372.     case ENGINE_OPTION_OSC_PORT_UDP:

  373.         return "ENGINE_OPTION_OSC_PORT_UDP";

  374.     case ENGINE_OPTION_OSC_PORT_TCP:

  375.         return "ENGINE_OPTION_OSC_PORT_TCP";

  376. #endif

  377.     case ENGINE_OPTION_FILE_PATH:

  378.         return "ENGINE_OPTION_FILE_PATH";

  379.     case ENGINE_OPTION_PLUGIN_PATH:

  380.         return "ENGINE_OPTION_PLUGIN_PATH";

  381.     case ENGINE_OPTION_PATH_BINARIES:

  382.         return "ENGINE_OPTION_PATH_BINARIES";

  383.     case ENGINE_OPTION_PATH_RESOURCES:

  384.         return "ENGINE_OPTION_PATH_RESOURCES";

  385.     case ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

  386.         return "ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR";

  387.     case ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR:

  388.         return "ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR";

  389.     case ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR:

  390.         return "ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR";

  391.     case ENGINE_OPTION_FRONTEND_UI_SCALE:

  392.         return "ENGINE_OPTION_FRONTEND_UI_SCALE";

  393.     case ENGINE_OPTION_FRONTEND_WIN_ID:

  394.         return "ENGINE_OPTION_FRONTEND_WIN_ID";

  395. #if !defined(BUILD_BRIDGE_ALTERNATIVE_ARCH) && !defined(CARLA_OS_WIN)

  396.     case ENGINE_OPTION_WINE_EXECUTABLE:

  397.         return "ENGINE_OPTION_WINE_EXECUTABLE";

  398.     case ENGINE_OPTION_WINE_AUTO_PREFIX:

  399.         return "ENGINE_OPTION_WINE_AUTO_PREFIX";

  400.     case ENGINE_OPTION_WINE_FALLBACK_PREFIX:

  401.         return "ENGINE_OPTION_WINE_FALLBACK_PREFIX";

  402.     case ENGINE_OPTION_WINE_RT_PRIO_ENABLED:

  403.         return "ENGINE_OPTION_WINE_RT_PRIO_ENABLED";

  404.     case ENGINE_OPTION_WINE_BASE_RT_PRIO:

  405.         return "ENGINE_OPTION_WINE_BASE_RT_PRIO";

  406.     case ENGINE_OPTION_WINE_SERVER_RT_PRIO:

  407.         return "ENGINE_OPTION_WINE_SERVER_RT_PRIO";

  408. #endif

  409. #ifndef BUILD_BRIDGE

  410.     case ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT:

  411.         return "ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT";

  412. #endif

  413.     case ENGINE_OPTION_CLIENT_NAME_PREFIX:

  414.         return "ENGINE_OPTION_CLIENT_NAME_PREFIX";

  415.     case ENGINE_OPTION_PLUGINS_ARE_STANDALONE:

  416.         return "ENGINE_OPTION_PLUGINS_ARE_STANDALONE";

  417.     }

  418. 

  419.     carla_stderr("CarlaBackend::EngineOption2Str(%i) - invalid option", option);

  420.     return nullptr;

  421. }

  422. 

  423. static inline

  424. const char* EngineProcessMode2Str(const EngineProcessMode mode) noexcept

  425. {

  426.     switch (mode)

  427.     {

  428.     case ENGINE_PROCESS_MODE_SINGLE_CLIENT:

  429.         return "ENGINE_PROCESS_MODE_SINGLE_CLIENT";

  430.     case ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS:

  431.         return "ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS";

  432.     case ENGINE_PROCESS_MODE_CONTINUOUS_RACK:

  433.         return "ENGINE_PROCESS_MODE_CONTINUOUS_RACK";

  434.     case ENGINE_PROCESS_MODE_PATCHBAY:

  435.         return "ENGINE_PROCESS_MODE_PATCHBAY";

  436.     case ENGINE_PROCESS_MODE_BRIDGE:

  437.         return "ENGINE_PROCESS_MODE_BRIDGE";

  438.     }

  439. 

  440.     carla_stderr("CarlaBackend::EngineProcessMode2Str(%i) - invalid mode", mode);

  441.     return nullptr;

  442. }

  443. 

  444. static inline

  445. const char* EngineTransportMode2Str(const EngineTransportMode mode) noexcept

  446. {

  447.     switch (mode)

  448.     {

  449.     case ENGINE_TRANSPORT_MODE_DISABLED:

  450.         return "ENGINE_TRANSPORT_MODE_DISABLED";

  451.     case ENGINE_TRANSPORT_MODE_INTERNAL:

  452.         return "ENGINE_TRANSPORT_MODE_INTERNAL";

  453.     case ENGINE_TRANSPORT_MODE_JACK:

  454.         return "ENGINE_TRANSPORT_MODE_JACK";

  455.     case ENGINE_TRANSPORT_MODE_PLUGIN:

  456.         return "ENGINE_TRANSPORT_MODE_PLUGIN";

  457.     case ENGINE_TRANSPORT_MODE_BRIDGE:

  458.         return "ENGINE_TRANSPORT_MODE_BRIDGE";

  459.     }

  460. 

  461.     carla_stderr("CarlaBackend::EngineTransportMode2Str(%i) - invalid mode", mode);

  462.     return nullptr;

  463. }

  464. 

  465. static inline

  466. const char* FileCallbackOpcode2Str(const FileCallbackOpcode opcode) noexcept

  467. {

  468.     switch (opcode)

  469.     {

  470.     case FILE_CALLBACK_DEBUG:

  471.         return "FILE_CALLBACK_DEBUG";

  472.     case FILE_CALLBACK_OPEN:

  473.         return "FILE_CALLBACK_OPEN";

  474.     case FILE_CALLBACK_SAVE:

  475.         return "FILE_CALLBACK_SAVE";

  476.     }

  477. 

  478.     carla_stderr("CarlaBackend::FileCallbackOpcode2Str(%i) - invalid opcode", opcode);

  479.     return nullptr;

  480. }

  481. 

  482. static inline

  483. const char* PatchbayIcon2Str(const PatchbayIcon icon) noexcept

  484. {

  485.     switch (icon)

  486.     {

  487.     case PATCHBAY_ICON_APPLICATION:

  488.         return "PATCHBAY_ICON_APPLICATION";

  489.     case PATCHBAY_ICON_PLUGIN:

  490.         return "PATCHBAY_ICON_PLUGIN";

  491.     case PATCHBAY_ICON_HARDWARE:

  492.         return "PATCHBAY_ICON_HARDWARE";

  493.     case PATCHBAY_ICON_CARLA:

  494.         return "PATCHBAY_ICON_CARLA";

  495.     case PATCHBAY_ICON_DISTRHO:

  496.         return "PATCHBAY_ICON_DISTRHO";

  497.     case PATCHBAY_ICON_FILE:

  498.         return "PATCHBAY_ICON_FILE";

  499.     }

  500. 

  501.     carla_stderr("CarlaBackend::PatchbayIcon2Str(%i) - invalid icon", icon);

  502.     return nullptr;

  503. }

  504. 

  505. // -----------------------------------------------------------------------

  506. 

  507. static inline

  508. BinaryType getBinaryTypeFromString(const char* const ctype) noexcept

  509. {

  510.     CARLA_SAFE_ASSERT_RETURN(ctype != nullptr && ctype[0] != '\0', BINARY_NONE);

  511.     carla_debug("CarlaBackend::getBinaryTypeFromString(\"%s\")", ctype);

  512. 

  513.     CarlaString stype(ctype);

  514. 

  515.     if (stype.isEmpty())

  516.         return BINARY_NONE;

  517. 

  518.     stype.toLower();

  519. 

  520.     if (stype == "none")

  521.         return BINARY_NONE;

  522.     if (stype == "native")

  523.         return BINARY_NATIVE;

  524.     if (stype == "posix32" || stype == "linux32" || stype == "mac32")

  525.         return BINARY_POSIX32;

  526.     if (stype == "posix64" || stype == "linux64" || stype == "mac64")

  527.         return BINARY_POSIX64;

  528.     if (stype == "win32")

  529.         return BINARY_WIN32;

  530.     if (stype == "win64")

  531.         return BINARY_WIN64;

  532. 

  533.     carla_stderr("CarlaBackend::getBinaryTypeFromString(\"%s\") - invalid string type", ctype);

  534.     return BINARY_NONE;

  535. }

  536. 

  537. // -----------------------------------------------------------------------

  538. 

  539. static inline

  540. const char* getPluginCategoryAsString(const PluginCategory category) noexcept

  541. {

  542.     carla_debug("CarlaBackend::getPluginCategoryAsString(%i:%s)", category, PluginCategory2Str(category));

  543. 

  544.     switch (category)

  545.     {

  546.     case PLUGIN_CATEGORY_NONE:

  547.         return "none";

  548.     case PLUGIN_CATEGORY_SYNTH:

  549.         return "synth";

  550.     case PLUGIN_CATEGORY_DELAY:

  551.         return "delay";

  552.     case PLUGIN_CATEGORY_EQ:

  553.         return "eq";

  554.     case PLUGIN_CATEGORY_FILTER:

  555.         return "filter";

  556.     case PLUGIN_CATEGORY_DISTORTION:

  557.         return "distortion";

  558.     case PLUGIN_CATEGORY_DYNAMICS:

  559.         return "dynamics";

  560.     case PLUGIN_CATEGORY_MODULATOR:

  561.         return "modulator";

  562.     case PLUGIN_CATEGORY_UTILITY:

  563.         return "utility";

  564.     case PLUGIN_CATEGORY_OTHER:

  565.         return "other";

  566.     }

  567. 

  568.     carla_stderr("CarlaBackend::getPluginCategoryAsString(%i) - invalid category", category);

  569.     return "NONE";

  570. }

  571. 

  572. static inline

  573. const char* getPluginTypeAsString(const PluginType type) noexcept

  574. {

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

  576. 

  577.     switch (type)

  578.     {

  579.     case PLUGIN_NONE:

  580.         return "NONE";

  581.     case PLUGIN_INTERNAL:

  582.         return "INTERNAL";

  583.     case PLUGIN_LADSPA:

  584.         return "LADSPA";

  585.     case PLUGIN_DSSI:

  586.         return "DSSI";

  587.     case PLUGIN_LV2:

  588.         return "LV2";

  589.     case PLUGIN_VST2:

  590.         return "VST2";

  591.     case PLUGIN_VST3:

  592.         return "VST3";

  593.     case PLUGIN_AU:

  594.         return "AU";

  595.     case PLUGIN_DLS:

  596.         return "DLS";

  597.     case PLUGIN_GIG:

  598.         return "GIG";

  599.     case PLUGIN_SF2:

  600.         return "SF2";

  601.     case PLUGIN_SFZ:

  602.         return "SFZ";

  603.     case PLUGIN_JACK:

  604.         return "JACK";

  605.     case PLUGIN_JSFX:

  606.         return "JSFX";

  607.     case PLUGIN_CLAP:

  608.         return "CLAP";

  609.     case PLUGIN_TYPE_COUNT:

  610.         break;

  611.     }

  612. 

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

  614.     return "NONE";

  615. }

  616. 

  617. static inline

  618. PluginType getPluginTypeFromString(const char* const ctype) noexcept

  619. {

  620.     CARLA_SAFE_ASSERT_RETURN(ctype != nullptr && ctype[0] != '\0', PLUGIN_NONE);

  621.     carla_debug("CarlaBackend::getPluginTypeFromString(\"%s\")", ctype);

  622. 

  623.     CarlaString stype(ctype);

  624. 

  625.     if (stype.isEmpty())

  626.         return PLUGIN_NONE;

  627. 

  628.     stype.toLower();

  629. 

  630.     if (stype == "none")

  631.         return PLUGIN_NONE;

  632.     if (stype == "internal" || stype == "native")

  633.         return PLUGIN_INTERNAL;

  634.     if (stype == "ladspa")

  635.         return PLUGIN_LADSPA;

  636.     if (stype == "dssi")

  637.         return PLUGIN_DSSI;

  638.     if (stype == "lv2")

  639.         return PLUGIN_LV2;

  640.     if (stype == "vst2" || stype == "vst")

  641.         return PLUGIN_VST2;

  642.     if (stype == "vst3")

  643.         return PLUGIN_VST3;

  644.     if (stype == "au" || stype == "audiounit")

  645.         return PLUGIN_AU;

  646.     if (stype == "dls")

  647.         return PLUGIN_DLS;

  648.     if (stype == "gig")

  649.         return PLUGIN_GIG;

  650.     if (stype == "sf2" || stype == "sf3")

  651.         return PLUGIN_SF2;

  652.     if (stype == "sfz")

  653.         return PLUGIN_SFZ;

  654.     if (stype == "jack")

  655.         return PLUGIN_JACK;

  656.     if (stype == "jsfx")

  657.         return PLUGIN_JSFX;

  658.     if (stype == "clap")

  659.         return PLUGIN_CLAP;

  660. 

  661.     carla_stderr("CarlaBackend::getPluginTypeFromString(\"%s\") - invalid string type", ctype);

  662.     return PLUGIN_NONE;

  663. }

  664. 

  665. // -----------------------------------------------------------------------

  666. 

  667. static inline

  668. PluginCategory getPluginCategoryFromName(const char* const name) noexcept

  669. {

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

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

  672. 

  673.     CarlaString sname(name);

  674. 

  675.     if (sname.isEmpty())

  676.         return PLUGIN_CATEGORY_NONE;

  677. 

  678.     sname.toLower();

  679. 

  680.     // generic tags first

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

  682.         return PLUGIN_CATEGORY_DELAY;

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

  684.         return PLUGIN_CATEGORY_DELAY;

  685. 

  686.     // filter

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

  688.         return PLUGIN_CATEGORY_FILTER;

  689. 

  690.     // distortion

  691.     if (sname.contains("distortion"))

  692.         return PLUGIN_CATEGORY_DISTORTION;

  693. 

  694.     // dynamics

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

  696.         return PLUGIN_CATEGORY_DYNAMICS;

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

  698.         return PLUGIN_CATEGORY_DYNAMICS;

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

  700.         return PLUGIN_CATEGORY_DYNAMICS;

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

  702.         return PLUGIN_CATEGORY_DYNAMICS;

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

  704.         return PLUGIN_CATEGORY_DYNAMICS;

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

  706.         return PLUGIN_CATEGORY_DYNAMICS;

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

  708.         return PLUGIN_CATEGORY_DYNAMICS;

  709. 

  710.     // modulator

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

  712.         return PLUGIN_CATEGORY_MODULATOR;

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

  714.         return PLUGIN_CATEGORY_MODULATOR;

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

  716.         return PLUGIN_CATEGORY_MODULATOR;

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

  718.         return PLUGIN_CATEGORY_MODULATOR;

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

  720.         return PLUGIN_CATEGORY_MODULATOR;

  721. 

  722.     // utility

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

  724.         return PLUGIN_CATEGORY_UTILITY;

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

  726.         return PLUGIN_CATEGORY_UTILITY;

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

  728.         return PLUGIN_CATEGORY_UTILITY;

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

  730.         return PLUGIN_CATEGORY_UTILITY;

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

  732.         return PLUGIN_CATEGORY_UTILITY;

  733. 

  734.     // common tags

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

  736.         return PLUGIN_CATEGORY_DELAY;

  737. 

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

  739.         return PLUGIN_CATEGORY_EQ;

  740. 

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

  742.         return PLUGIN_CATEGORY_UTILITY;

  743. 

  744.     // synth

  745.     if (sname.contains("synth"))

  746.         return PLUGIN_CATEGORY_SYNTH;

  747. 

  748.     // other

  749.     if (sname.contains("misc"))

  750.         return PLUGIN_CATEGORY_OTHER;

  751.     if (sname.contains("other"))

  752.         return PLUGIN_CATEGORY_OTHER;

  753. 

  754.     return PLUGIN_CATEGORY_NONE;

  755. }

  756. 

  757. // -----------------------------------------------------------------------

  758. 

  759. static inline

  760. bool isPluginOptionEnabled(const uint options, const uint option)

  761. {

  762.     if (options == PLUGIN_OPTIONS_NULL)

  763.         return true;

  764.     if (options & option)

  765.         return true;

  766.     return false;

  767. }

  768. 

  769. static inline

  770. bool isPluginOptionInverseEnabled(const uint options, const uint option)

  771. {

  772.     if (options == PLUGIN_OPTIONS_NULL)

  773.         return false;

  774.     if (options & option)

  775.         return true;

  776.     return false;

  777. }

  778. 

  779. // -----------------------------------------------------------------------

  780. 

  781. CARLA_BACKEND_END_NAMESPACE

  782. 

  783. #endif // CARLA_BACKEND_UTILS_HPP_INCLUDED