falkTX
/
Carla
mirror of https://github.com/falkTX/Carla
1
0
Fork 0
Code Releases 43 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.
7030 Commits
17 Branches
341MB
Tree: 220e58f169
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '220e58f169'
${ noResults }
Carla/source/utils/CarlaBackendUtils.hpp

912 lines
29KB
Raw Blame History 

  1. // SPDX-FileCopyrightText: 2011-2025 Filipe Coelho <falktx@falktx.com>

  2. // SPDX-License-Identifier: GPL-2.0-or-later

  3. 

  4. #ifndef CARLA_BACKEND_UTILS_HPP_INCLUDED

  5. #define CARLA_BACKEND_UTILS_HPP_INCLUDED

  6. 

  7. #include "CarlaBackend.h"

  8. #include "CarlaNative.h"

  9. #include "CarlaUtils.hpp"

  10. 

  11. #include "distrho/extra/String.hpp"

  12. 

  13. CARLA_BACKEND_START_NAMESPACE

  14. 

  15. // -----------------------------------------------------------------------

  16. 

  17. static inline

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

  19. {

  20.     switch (option)

  21.     {

  22.     case PLUGIN_OPTION_FIXED_BUFFERS:

  23.         return "PLUGIN_OPTION_FIXED_BUFFERS";

  24.     case PLUGIN_OPTION_FORCE_STEREO:

  25.         return "PLUGIN_OPTION_FORCE_STEREO";

  26.     case PLUGIN_OPTION_MAP_PROGRAM_CHANGES:

  27.         return "PLUGIN_OPTION_MAP_PROGRAM_CHANGES";

  28.     case PLUGIN_OPTION_USE_CHUNKS:

  29.         return "PLUGIN_OPTION_USE_CHUNKS";

  30.     case PLUGIN_OPTION_SEND_CONTROL_CHANGES:

  31.         return "PLUGIN_OPTION_SEND_CONTROL_CHANGES";

  32.     case PLUGIN_OPTION_SEND_CHANNEL_PRESSURE:

  33.         return "PLUGIN_OPTION_SEND_CHANNEL_PRESSURE";

  34.     case PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH:

  35.         return "PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH";

  36.     case PLUGIN_OPTION_SEND_PITCHBEND:

  37.         return "PLUGIN_OPTION_SEND_PITCHBEND";

  38.     case PLUGIN_OPTION_SEND_ALL_SOUND_OFF:

  39.         return "PLUGIN_OPTION_SEND_ALL_SOUND_OFF";

  40.     }

  41. 

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

  43.     return "";

  44. }

  45. 

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

  47. 

  48. static inline

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

  50. {

  51.     switch (type)

  52.     {

  53.     case BINARY_NONE:

  54.         return "BINARY_NONE";

  55.     case BINARY_POSIX32:

  56.         return "BINARY_POSIX32";

  57.     case BINARY_POSIX64:

  58.         return "BINARY_POSIX64";

  59.     case BINARY_WIN32:

  60.         return "BINARY_WIN32";

  61.     case BINARY_WIN64:

  62.         return "BINARY_WIN64";

  63.     case BINARY_OTHER:

  64.         return "BINARY_OTHER";

  65.     }

  66. 

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

  68.     return "";

  69. }

  70. 

  71. static inline

  72. const char* FileType2Str(const FileType type) noexcept

  73. {

  74.     switch (type)

  75.     {

  76.     case FILE_NONE:

  77.         return "FILE_NONE";

  78.     case FILE_AUDIO:

  79.         return "FILE_AUDIO";

  80.     case FILE_MIDI:

  81.         return "FILE_MIDI";

  82.     }

  83. 

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

  85.     return "";

  86. }

  87. 

  88. static inline

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

  90. {

  91.     switch (type)

  92.     {

  93.     case PLUGIN_NONE:

  94.         return "PLUGIN_NONE";

  95.     case PLUGIN_INTERNAL:

  96.         return "PLUGIN_INTERNAL";

  97.     case PLUGIN_LADSPA:

  98.         return "PLUGIN_LADSPA";

  99.     case PLUGIN_DSSI:

  100.         return "PLUGIN_DSSI";

  101.     case PLUGIN_LV2:

  102.         return "PLUGIN_LV2";

  103.     case PLUGIN_VST2:

  104.         return "PLUGIN_VST2";

  105.     case PLUGIN_VST3:

  106.         return "PLUGIN_VST3";

  107.     case PLUGIN_AU:

  108.         return "PLUGIN_AU";

  109.     case PLUGIN_DLS:

  110.         return "PLUGIN_DLS";

  111.     case PLUGIN_GIG:

  112.         return "PLUGIN_GIG";

  113.     case PLUGIN_SF2:

  114.         return "PLUGIN_SF2";

  115.     case PLUGIN_SFZ:

  116.         return "PLUGIN_SFZ";

  117.     case PLUGIN_JACK:

  118.         return "PLUGIN_JACK";

  119.     case PLUGIN_JSFX:

  120.         return "PLUGIN_JSFX";

  121.     case PLUGIN_CLAP:

  122.         return "PLUGIN_CLAP";

  123.     case PLUGIN_TYPE_COUNT:

  124.         break;

  125.     }

  126. 

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

  128.     return "";

  129. }

  130. 

  131. static inline

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

  133. {

  134.     switch (category)

  135.     {

  136.     case PLUGIN_CATEGORY_NONE:

  137.         return "PLUGIN_CATEGORY_NONE";

  138.     case PLUGIN_CATEGORY_SYNTH:

  139.         return "PLUGIN_CATEGORY_SYNTH";

  140.     case PLUGIN_CATEGORY_DELAY:

  141.         return "PLUGIN_CATEGORY_DELAY";

  142.     case PLUGIN_CATEGORY_EQ:

  143.         return "PLUGIN_CATEGORY_EQ";

  144.     case PLUGIN_CATEGORY_FILTER:

  145.         return "PLUGIN_CATEGORY_FILTER";

  146.     case PLUGIN_CATEGORY_DISTORTION:

  147.         return "PLUGIN_CATEGORY_DISTORTION";

  148.     case PLUGIN_CATEGORY_DYNAMICS:

  149.         return "PLUGIN_CATEGORY_DYNAMICS";

  150.     case PLUGIN_CATEGORY_MODULATOR:

  151.         return "PLUGIN_CATEGORY_MODULATOR";

  152.     case PLUGIN_CATEGORY_UTILITY:

  153.         return "PLUGIN_CATEGORY_UTILITY";

  154.     case PLUGIN_CATEGORY_OTHER:

  155.         return "PLUGIN_CATEGORY_OTHER";

  156.     }

  157. 

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

  159.     return "";

  160. }

  161. 

  162. static inline

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

  164. {

  165.     switch (type)

  166.     {

  167.     case PARAMETER_UNKNOWN:

  168.         return "PARAMETER_UNKNOWN";

  169.     case PARAMETER_INPUT:

  170.         return "PARAMETER_INPUT";

  171.     case PARAMETER_OUTPUT:

  172.         return "PARAMETER_OUTPUT";

  173.     }

  174. 

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

  176.     return "";

  177. }

  178. 

  179. static inline

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

  181. {

  182.     switch (index)

  183.     {

  184.     case PARAMETER_NULL:

  185.         return "PARAMETER_NULL";

  186. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  187.     case PARAMETER_ACTIVE:

  188.         return "PARAMETER_ACTIVE";

  189.     case PARAMETER_DRYWET:

  190.         return "PARAMETER_DRYWET";

  191.     case PARAMETER_VOLUME:

  192.         return "PARAMETER_VOLUME";

  193.     case PARAMETER_BALANCE_LEFT:

  194.         return "PARAMETER_BALANCE_LEFT";

  195.     case PARAMETER_BALANCE_RIGHT:

  196.         return "PARAMETER_BALANCE_RIGHT";

  197.     case PARAMETER_PANNING:

  198.         return "PARAMETER_PANNING";

  199.     case PARAMETER_FORTH:

  200.         return "PARAMETER_FORTH";

  201.     case PARAMETER_CTRL_CHANNEL:

  202.         return "PARAMETER_CTRL_CHANNEL";

  203. #endif

  204.     case PARAMETER_MAX:

  205.         return "PARAMETER_MAX";

  206.     }

  207. 

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

  209.     return "";

  210. }

  211. 

  212. static inline

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

  214. {

  215.     switch (opcode)

  216.     {

  217.     case ENGINE_CALLBACK_DEBUG:

  218.         return "ENGINE_CALLBACK_DEBUG";

  219.     case ENGINE_CALLBACK_PLUGIN_ADDED:

  220.         return "ENGINE_CALLBACK_PLUGIN_ADDED";

  221.     case ENGINE_CALLBACK_PLUGIN_REMOVED:

  222.         return "ENGINE_CALLBACK_PLUGIN_REMOVED";

  223.     case ENGINE_CALLBACK_PLUGIN_RENAMED:

  224.         return "ENGINE_CALLBACK_PLUGIN_RENAMED";

  225.     case ENGINE_CALLBACK_PLUGIN_UNAVAILABLE:

  226.         return "ENGINE_CALLBACK_PLUGIN_UNAVAILABLE";

  227.     case ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED:

  228.         return "ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED";

  229.     case ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED:

  230.         return "ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED";

  231. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  232.     case ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED:

  233.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED";

  234.     case ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:

  235.         return "ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";

  236.     case ENGINE_CALLBACK_OPTION_CHANGED:

  237.         return "ENGINE_CALLBACK_OPTION_CHANGED";

  238. #endif

  239.     case ENGINE_CALLBACK_PROGRAM_CHANGED:

  240.         return "ENGINE_CALLBACK_PROGRAM_CHANGED";

  241.     case ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED:

  242.         return "ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED";

  243.     case ENGINE_CALLBACK_UI_STATE_CHANGED:

  244.         return "ENGINE_CALLBACK_UI_STATE_CHANGED";

  245.     case ENGINE_CALLBACK_NOTE_ON:

  246.         return "ENGINE_CALLBACK_NOTE_ON";

  247.     case ENGINE_CALLBACK_NOTE_OFF:

  248.         return "ENGINE_CALLBACK_NOTE_OFF";

  249.     case ENGINE_CALLBACK_UPDATE:

  250.         return "ENGINE_CALLBACK_UPDATE";

  251.     case ENGINE_CALLBACK_RELOAD_INFO:

  252.         return "ENGINE_CALLBACK_RELOAD_INFO";

  253.     case ENGINE_CALLBACK_RELOAD_PARAMETERS:

  254.         return "ENGINE_CALLBACK_RELOAD_PARAMETERS";

  255.     case ENGINE_CALLBACK_RELOAD_PROGRAMS:

  256.         return "ENGINE_CALLBACK_RELOAD_PROGRAMS";

  257.     case ENGINE_CALLBACK_RELOAD_ALL:

  258.         return "ENGINE_CALLBACK_RELOAD_ALL";

  259. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  260.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED:

  261.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED";

  262.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED:

  263.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED";

  264.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED:

  265.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED";

  266.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED:

  267.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED";

  268.     case ENGINE_CALLBACK_PATCHBAY_PORT_ADDED:

  269.         return "ENGINE_CALLBACK_PATCHBAY_PORT_ADDED";

  270.     case ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED:

  271.         return "ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED";

  272.     case ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED:

  273.         return "ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED";

  274.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED:

  275.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED";

  276.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED:

  277.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED";

  278. #endif

  279.     case ENGINE_CALLBACK_ENGINE_STARTED:

  280.         return "ENGINE_CALLBACK_ENGINE_STARTED";

  281.     case ENGINE_CALLBACK_ENGINE_STOPPED:

  282.         return "ENGINE_CALLBACK_ENGINE_STOPPED";

  283.     case ENGINE_CALLBACK_PROCESS_MODE_CHANGED:

  284.         return "ENGINE_CALLBACK_PROCESS_MODE_CHANGED";

  285.     case ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED:

  286.         return "ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED";

  287.     case ENGINE_CALLBACK_BUFFER_SIZE_CHANGED:

  288.         return "ENGINE_CALLBACK_BUFFER_SIZE_CHANGED";

  289.     case ENGINE_CALLBACK_SAMPLE_RATE_CHANGED:

  290.         return "ENGINE_CALLBACK_SAMPLE_RATE_CHANGED";

  291.     case ENGINE_CALLBACK_CANCELABLE_ACTION:

  292.         return "ENGINE_CALLBACK_CANCELABLE_ACTION";

  293.     case ENGINE_CALLBACK_PROJECT_LOAD_FINISHED:

  294.         return "ENGINE_CALLBACK_PROJECT_LOAD_FINISHED";

  295.     case ENGINE_CALLBACK_NSM:

  296.         return "ENGINE_CALLBACK_NSM";

  297.     case ENGINE_CALLBACK_IDLE:

  298.         return "ENGINE_CALLBACK_IDLE";

  299.     case ENGINE_CALLBACK_INFO:

  300.         return "ENGINE_CALLBACK_INFO";

  301.     case ENGINE_CALLBACK_ERROR:

  302.         return "ENGINE_CALLBACK_ERROR";

  303.     case ENGINE_CALLBACK_QUIT:

  304.         return "ENGINE_CALLBACK_QUIT";

  305.     case ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW:

  306.         return "ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW";

  307.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED:

  308.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED";

  309.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED:

  310.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED";

  311.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED:

  312.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED";

  313.     case ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED:

  314.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED";

  315.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED:

  316.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED";

  317.     case ENGINE_CALLBACK_EMBED_UI_RESIZED:

  318.         return "ENGINE_CALLBACK_EMBED_UI_RESIZED";

  319.     }

  320. 

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

  322.     return "";

  323. }

  324. 

  325. static inline

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

  327. {

  328.     switch (option)

  329.     {

  330.     case ENGINE_OPTION_DEBUG:

  331.         return "ENGINE_OPTION_DEBUG";

  332.     case ENGINE_OPTION_PROCESS_MODE:

  333.         return "ENGINE_OPTION_PROCESS_MODE";

  334.     case ENGINE_OPTION_TRANSPORT_MODE:

  335.         return "ENGINE_OPTION_TRANSPORT_MODE";

  336.     case ENGINE_OPTION_FORCE_STEREO:

  337.         return "ENGINE_OPTION_FORCE_STEREO";

  338.     case ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

  339.         return "ENGINE_OPTION_PREFER_PLUGIN_BRIDGES";

  340.     case ENGINE_OPTION_PREFER_UI_BRIDGES:

  341.         return "ENGINE_OPTION_PREFER_UI_BRIDGES";

  342.     case ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

  343.         return "ENGINE_OPTION_UIS_ALWAYS_ON_TOP";

  344.     case ENGINE_OPTION_MAX_PARAMETERS:

  345.         return "ENGINE_OPTION_MAX_PARAMETERS";

  346.     case ENGINE_OPTION_RESET_XRUNS:

  347.         return "ENGINE_OPTION_RESET_XRUNS";

  348.     case ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  349.         return "ENGINE_OPTION_UI_BRIDGES_TIMEOUT";

  350.     case ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  351.         return "ENGINE_OPTION_AUDIO_BUFFER_SIZE";

  352.     case ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  353.         return "ENGINE_OPTION_AUDIO_SAMPLE_RATE";

  354.     case ENGINE_OPTION_AUDIO_TRIPLE_BUFFER:

  355.         return "ENGINE_OPTION_AUDIO_TRIPLE_BUFFER";

  356.     case ENGINE_OPTION_AUDIO_DRIVER:

  357.         return "ENGINE_OPTION_AUDIO_DRIVER";

  358.     case ENGINE_OPTION_AUDIO_DEVICE:

  359.         return "ENGINE_OPTION_AUDIO_DEVICE";

  360. #ifndef BUILD_BRIDGE

  361.     case ENGINE_OPTION_OSC_ENABLED:

  362.         return "ENGINE_OPTION_OSC_ENABLED";

  363.     case ENGINE_OPTION_OSC_PORT_UDP:

  364.         return "ENGINE_OPTION_OSC_PORT_UDP";

  365.     case ENGINE_OPTION_OSC_PORT_TCP:

  366.         return "ENGINE_OPTION_OSC_PORT_TCP";

  367. #endif

  368.     case ENGINE_OPTION_FILE_PATH:

  369.         return "ENGINE_OPTION_FILE_PATH";

  370.     case ENGINE_OPTION_PLUGIN_PATH:

  371.         return "ENGINE_OPTION_PLUGIN_PATH";

  372.     case ENGINE_OPTION_PATH_BINARIES:

  373.         return "ENGINE_OPTION_PATH_BINARIES";

  374.     case ENGINE_OPTION_PATH_RESOURCES:

  375.         return "ENGINE_OPTION_PATH_RESOURCES";

  376.     case ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

  377.         return "ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR";

  378.     case ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR:

  379.         return "ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR";

  380.     case ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR:

  381.         return "ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR";

  382.     case ENGINE_OPTION_FRONTEND_UI_SCALE:

  383.         return "ENGINE_OPTION_FRONTEND_UI_SCALE";

  384.     case ENGINE_OPTION_FRONTEND_WIN_ID:

  385.         return "ENGINE_OPTION_FRONTEND_WIN_ID";

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

  387.     case ENGINE_OPTION_WINE_EXECUTABLE:

  388.         return "ENGINE_OPTION_WINE_EXECUTABLE";

  389.     case ENGINE_OPTION_WINE_AUTO_PREFIX:

  390.         return "ENGINE_OPTION_WINE_AUTO_PREFIX";

  391.     case ENGINE_OPTION_WINE_FALLBACK_PREFIX:

  392.         return "ENGINE_OPTION_WINE_FALLBACK_PREFIX";

  393.     case ENGINE_OPTION_WINE_RT_PRIO_ENABLED:

  394.         return "ENGINE_OPTION_WINE_RT_PRIO_ENABLED";

  395.     case ENGINE_OPTION_WINE_BASE_RT_PRIO:

  396.         return "ENGINE_OPTION_WINE_BASE_RT_PRIO";

  397.     case ENGINE_OPTION_WINE_SERVER_RT_PRIO:

  398.         return "ENGINE_OPTION_WINE_SERVER_RT_PRIO";

  399. #endif

  400. #ifndef BUILD_BRIDGE

  401.     case ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT:

  402.         return "ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT";

  403. #endif

  404.     case ENGINE_OPTION_CLIENT_NAME_PREFIX:

  405.         return "ENGINE_OPTION_CLIENT_NAME_PREFIX";

  406.     case ENGINE_OPTION_PLUGINS_ARE_STANDALONE:

  407.         return "ENGINE_OPTION_PLUGINS_ARE_STANDALONE";

  408.     }

  409. 

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

  411.     return "";

  412. }

  413. 

  414. static inline

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

  416. {

  417.     switch (mode)

  418.     {

  419.     case ENGINE_PROCESS_MODE_SINGLE_CLIENT:

  420.         return "ENGINE_PROCESS_MODE_SINGLE_CLIENT";

  421.     case ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS:

  422.         return "ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS";

  423.     case ENGINE_PROCESS_MODE_CONTINUOUS_RACK:

  424.         return "ENGINE_PROCESS_MODE_CONTINUOUS_RACK";

  425.     case ENGINE_PROCESS_MODE_PATCHBAY:

  426.         return "ENGINE_PROCESS_MODE_PATCHBAY";

  427.     case ENGINE_PROCESS_MODE_BRIDGE:

  428.         return "ENGINE_PROCESS_MODE_BRIDGE";

  429.     }

  430. 

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

  432.     return "";

  433. }

  434. 

  435. static inline

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

  437. {

  438.     switch (mode)

  439.     {

  440.     case ENGINE_TRANSPORT_MODE_DISABLED:

  441.         return "ENGINE_TRANSPORT_MODE_DISABLED";

  442.     case ENGINE_TRANSPORT_MODE_INTERNAL:

  443.         return "ENGINE_TRANSPORT_MODE_INTERNAL";

  444.     case ENGINE_TRANSPORT_MODE_JACK:

  445.         return "ENGINE_TRANSPORT_MODE_JACK";

  446.     case ENGINE_TRANSPORT_MODE_PLUGIN:

  447.         return "ENGINE_TRANSPORT_MODE_PLUGIN";

  448.     case ENGINE_TRANSPORT_MODE_BRIDGE:

  449.         return "ENGINE_TRANSPORT_MODE_BRIDGE";

  450.     }

  451. 

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

  453.     return "";

  454. }

  455. 

  456. static inline

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

  458. {

  459.     switch (opcode)

  460.     {

  461.     case FILE_CALLBACK_DEBUG:

  462.         return "FILE_CALLBACK_DEBUG";

  463.     case FILE_CALLBACK_OPEN:

  464.         return "FILE_CALLBACK_OPEN";

  465.     case FILE_CALLBACK_SAVE:

  466.         return "FILE_CALLBACK_SAVE";

  467.     }

  468. 

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

  470.     return "";

  471. }

  472. 

  473. static inline

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

  475. {

  476.     switch (icon)

  477.     {

  478.     case PATCHBAY_ICON_APPLICATION:

  479.         return "PATCHBAY_ICON_APPLICATION";

  480.     case PATCHBAY_ICON_PLUGIN:

  481.         return "PATCHBAY_ICON_PLUGIN";

  482.     case PATCHBAY_ICON_HARDWARE:

  483.         return "PATCHBAY_ICON_HARDWARE";

  484.     case PATCHBAY_ICON_CARLA:

  485.         return "PATCHBAY_ICON_CARLA";

  486.     case PATCHBAY_ICON_DISTRHO:

  487.         return "PATCHBAY_ICON_DISTRHO";

  488.     case PATCHBAY_ICON_FILE:

  489.         return "PATCHBAY_ICON_FILE";

  490.     }

  491. 

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

  493.     return "";

  494. }

  495. 

  496. // -----------------------------------------------------------------------

  497. 

  498. static inline

  499. const char* NativePluginDispatcherOpcode2Str(const NativePluginDispatcherOpcode opcode) noexcept

  500. {

  501.     switch (opcode)

  502.     {

  503.     case NATIVE_PLUGIN_OPCODE_NULL:

  504.         return "NATIVE_PLUGIN_OPCODE_NULL";

  505.     case NATIVE_PLUGIN_OPCODE_BUFFER_SIZE_CHANGED:

  506.         return "NATIVE_PLUGIN_OPCODE_BUFFER_SIZE_CHANGED";

  507.     case NATIVE_PLUGIN_OPCODE_SAMPLE_RATE_CHANGED:

  508.         return "NATIVE_PLUGIN_OPCODE_SAMPLE_RATE_CHANGED";

  509.     case NATIVE_PLUGIN_OPCODE_OFFLINE_CHANGED:

  510.         return "NATIVE_PLUGIN_OPCODE_OFFLINE_CHANGED";

  511.     case NATIVE_PLUGIN_OPCODE_UI_NAME_CHANGED:

  512.         return "NATIVE_PLUGIN_OPCODE_UI_NAME_CHANGED";

  513.     case NATIVE_PLUGIN_OPCODE_GET_INTERNAL_HANDLE:

  514.         return "NATIVE_PLUGIN_OPCODE_GET_INTERNAL_HANDLE";

  515.     case NATIVE_PLUGIN_OPCODE_IDLE:

  516.         return "NATIVE_PLUGIN_OPCODE_IDLE";

  517.     case NATIVE_PLUGIN_OPCODE_UI_MIDI_EVENT:

  518.         return "NATIVE_PLUGIN_OPCODE_UI_MIDI_EVENT";

  519.     case NATIVE_PLUGIN_OPCODE_HOST_USES_EMBED:

  520.         return "NATIVE_PLUGIN_OPCODE_HOST_USES_EMBED";

  521.     case NATIVE_PLUGIN_OPCODE_HOST_OPTION:

  522.         return "NATIVE_PLUGIN_OPCODE_HOST_OPTION";

  523.     }

  524. 

  525.     carla_stderr("CarlaBackend::NativePluginDispatcherOpcode2Str(%i) - invalid icon", opcode);

  526.     return "";

  527. }

  528. 

  529. static inline

  530. const char* NativeHostDispatcherOpcode2Str(const NativeHostDispatcherOpcode opcode) noexcept

  531. {

  532.     switch (opcode)

  533.     {

  534.     case NATIVE_HOST_OPCODE_NULL:

  535.         return "NATIVE_HOST_OPCODE_NULL";

  536.     case NATIVE_HOST_OPCODE_UPDATE_PARAMETER:

  537.         return "NATIVE_HOST_OPCODE_UPDATE_PARAMETER";

  538.     case NATIVE_HOST_OPCODE_UPDATE_MIDI_PROGRAM:

  539.         return "NATIVE_HOST_OPCODE_UPDATE_MIDI_PROGRAM";

  540.     case NATIVE_HOST_OPCODE_RELOAD_PARAMETERS:

  541.         return "NATIVE_HOST_OPCODE_RELOAD_PARAMETERS";

  542.     case NATIVE_HOST_OPCODE_RELOAD_MIDI_PROGRAMS:

  543.         return "NATIVE_HOST_OPCODE_RELOAD_MIDI_PROGRAMS";

  544.     case NATIVE_HOST_OPCODE_RELOAD_ALL:

  545.         return "NATIVE_HOST_OPCODE_RELOAD_ALL";

  546.     case NATIVE_HOST_OPCODE_UI_UNAVAILABLE:

  547.         return "NATIVE_HOST_OPCODE_UI_UNAVAILABLE";

  548.     case NATIVE_HOST_OPCODE_HOST_IDLE:

  549.         return "NATIVE_HOST_OPCODE_HOST_IDLE";

  550.     case NATIVE_HOST_OPCODE_INTERNAL_PLUGIN:

  551.         return "NATIVE_HOST_OPCODE_INTERNAL_PLUGIN";

  552.     case NATIVE_HOST_OPCODE_QUEUE_INLINE_DISPLAY:

  553.         return "NATIVE_HOST_OPCODE_QUEUE_INLINE_DISPLAY";

  554.     case NATIVE_HOST_OPCODE_UI_TOUCH_PARAMETER:

  555.         return "NATIVE_HOST_OPCODE_UI_TOUCH_PARAMETER";

  556.     case NATIVE_HOST_OPCODE_REQUEST_IDLE:

  557.         return "NATIVE_HOST_OPCODE_REQUEST_IDLE";

  558.     case NATIVE_HOST_OPCODE_GET_FILE_PATH:

  559.         return "NATIVE_HOST_OPCODE_GET_FILE_PATH";

  560.     case NATIVE_HOST_OPCODE_UI_RESIZE:

  561.         return "NATIVE_HOST_OPCODE_UI_RESIZE";

  562.     case NATIVE_HOST_OPCODE_PREVIEW_BUFFER_DATA:

  563.         return "NATIVE_HOST_OPCODE_PREVIEW_BUFFER_DATA";

  564.     }

  565. 

  566.     carla_stderr("CarlaBackend::NativeHostDispatcherOpcode2Str(%i) - invalid icon", opcode);

  567.     return "";

  568. }

  569. 

  570. // -----------------------------------------------------------------------

  571. 

  572. static inline

  573. const char* getBinaryTypeAsString(const BinaryType type) noexcept

  574. {

  575.     carla_debug("CarlaBackend::getBinaryTypeAsString(%i:%s)", type, BinaryType2Str(type));

  576. 

  577.     if (type == BINARY_NATIVE)

  578.         return "native";

  579. 

  580.     switch (type)

  581.     {

  582.     case BINARY_NONE:

  583.         return "none";

  584.     case BINARY_POSIX32:

  585.         return "posix32";

  586.     case BINARY_POSIX64:

  587.         return "posix64";

  588.     case BINARY_WIN32:

  589.         return "win32";

  590.     case BINARY_WIN64:

  591.         return "win64";

  592.     case BINARY_OTHER:

  593.         return "other";

  594.     }

  595. 

  596.     carla_stderr("CarlaBackend::getBinaryTypeAsString(%i) - invalid type", type);

  597.     return "NONE";

  598. }

  599. 

  600. static inline

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

  602. {

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

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

  605. 

  606.     String stype(ctype);

  607. 

  608.     if (stype.isEmpty())

  609.         return BINARY_NONE;

  610. 

  611.     stype.toLower();

  612. 

  613.     if (stype == "none")

  614.         return BINARY_NONE;

  615.     if (stype == "native")

  616.         return BINARY_NATIVE;

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

  618.         return BINARY_POSIX32;

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

  620.         return BINARY_POSIX64;

  621.     if (stype == "win32")

  622.         return BINARY_WIN32;

  623.     if (stype == "win64")

  624.         return BINARY_WIN64;

  625.     if (stype == "other")

  626.         return BINARY_OTHER;

  627. 

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

  629.     return BINARY_NONE;

  630. }

  631. 

  632. // -----------------------------------------------------------------------

  633. 

  634. static inline

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

  636. {

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

  638. 

  639.     switch (category)

  640.     {

  641.     case PLUGIN_CATEGORY_NONE:

  642.         return "none";

  643.     case PLUGIN_CATEGORY_SYNTH:

  644.         return "synth";

  645.     case PLUGIN_CATEGORY_DELAY:

  646.         return "delay";

  647.     case PLUGIN_CATEGORY_EQ:

  648.         return "eq";

  649.     case PLUGIN_CATEGORY_FILTER:

  650.         return "filter";

  651.     case PLUGIN_CATEGORY_DISTORTION:

  652.         return "distortion";

  653.     case PLUGIN_CATEGORY_DYNAMICS:

  654.         return "dynamics";

  655.     case PLUGIN_CATEGORY_MODULATOR:

  656.         return "modulator";

  657.     case PLUGIN_CATEGORY_UTILITY:

  658.         return "utility";

  659.     case PLUGIN_CATEGORY_OTHER:

  660.         return "other";

  661.     }

  662. 

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

  664.     return "NONE";

  665. }

  666. 

  667. static inline

  668. PluginCategory getPluginCategoryFromString(const char* const category) noexcept

  669. {

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

  671.     carla_debug("CarlaBackend::getPluginCategoryFromString(\"%s\")", category);

  672. 

  673.     if (std::strcmp(category, "none") == 0)

  674.         return PLUGIN_CATEGORY_NONE;

  675.     if (std::strcmp(category, "synth") == 0)

  676.         return PLUGIN_CATEGORY_SYNTH;

  677.     if (std::strcmp(category, "delay") == 0)

  678.         return PLUGIN_CATEGORY_DELAY;

  679.     if (std::strcmp(category, "eq") == 0)

  680.         return PLUGIN_CATEGORY_EQ;

  681.     if (std::strcmp(category, "filter") == 0)

  682.         return PLUGIN_CATEGORY_FILTER;

  683.     if (std::strcmp(category, "distortion") == 0)

  684.         return PLUGIN_CATEGORY_DISTORTION;

  685.     if (std::strcmp(category, "dynamics") == 0)

  686.         return PLUGIN_CATEGORY_DYNAMICS;

  687.     if (std::strcmp(category, "modulator") == 0)

  688.         return PLUGIN_CATEGORY_MODULATOR;

  689.     if (std::strcmp(category, "utility") == 0)

  690.         return PLUGIN_CATEGORY_UTILITY;

  691.     if (std::strcmp(category, "other") == 0)

  692.         return PLUGIN_CATEGORY_OTHER;

  693. 

  694.     carla_stderr("CarlaBackend::getPluginCategoryFromString(\"%s\") - invalid category", category);

  695.     return PLUGIN_CATEGORY_NONE;

  696. }

  697. 

  698. // -----------------------------------------------------------------------

  699. 

  700. static inline

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

  702. {

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

  704. 

  705.     switch (type)

  706.     {

  707.     case PLUGIN_NONE:

  708.         return "NONE";

  709.     case PLUGIN_INTERNAL:

  710.         return "INTERNAL";

  711.     case PLUGIN_LADSPA:

  712.         return "LADSPA";

  713.     case PLUGIN_DSSI:

  714.         return "DSSI";

  715.     case PLUGIN_LV2:

  716.         return "LV2";

  717.     case PLUGIN_VST2:

  718.         return "VST2";

  719.     case PLUGIN_VST3:

  720.         return "VST3";

  721.     case PLUGIN_AU:

  722.         return "AU";

  723.     case PLUGIN_DLS:

  724.         return "DLS";

  725.     case PLUGIN_GIG:

  726.         return "GIG";

  727.     case PLUGIN_SF2:

  728.         return "SF2";

  729.     case PLUGIN_SFZ:

  730.         return "SFZ";

  731.     case PLUGIN_JACK:

  732.         return "JACK";

  733.     case PLUGIN_JSFX:

  734.         return "JSFX";

  735.     case PLUGIN_CLAP:

  736.         return "CLAP";

  737.     case PLUGIN_TYPE_COUNT:

  738.         break;

  739.     }

  740. 

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

  742.     return "NONE";

  743. }

  744. 

  745. static inline

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

  747. {

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

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

  750. 

  751.     String stype(ctype);

  752. 

  753.     if (stype.isEmpty())

  754.         return PLUGIN_NONE;

  755. 

  756.     stype.toLower();

  757. 

  758.     if (stype == "none")

  759.         return PLUGIN_NONE;

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

  761.         return PLUGIN_INTERNAL;

  762.     if (stype == "ladspa")

  763.         return PLUGIN_LADSPA;

  764.     if (stype == "dssi")

  765.         return PLUGIN_DSSI;

  766.     if (stype == "lv2")

  767.         return PLUGIN_LV2;

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

  769.         return PLUGIN_VST2;

  770.     if (stype == "vst3")

  771.         return PLUGIN_VST3;

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

  773.         return PLUGIN_AU;

  774.     if (stype == "dls")

  775.         return PLUGIN_DLS;

  776.     if (stype == "gig")

  777.         return PLUGIN_GIG;

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

  779.         return PLUGIN_SF2;

  780.     if (stype == "sfz")

  781.         return PLUGIN_SFZ;

  782.     if (stype == "jack")

  783.         return PLUGIN_JACK;

  784.     if (stype == "jsfx")

  785.         return PLUGIN_JSFX;

  786.     if (stype == "clap")

  787.         return PLUGIN_CLAP;

  788. 

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

  790.     return PLUGIN_NONE;

  791. }

  792. 

  793. // -----------------------------------------------------------------------

  794. 

  795. static inline

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

  797. {

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

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

  800. 

  801.     String sname(name);

  802. 

  803.     if (sname.isEmpty())

  804.         return PLUGIN_CATEGORY_NONE;

  805. 

  806.     sname.toLower();

  807. 

  808.     // generic tags first

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

  810.         return PLUGIN_CATEGORY_DELAY;

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

  812.         return PLUGIN_CATEGORY_DELAY;

  813. 

  814.     // filter

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

  816.         return PLUGIN_CATEGORY_FILTER;

  817. 

  818.     // distortion

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

  820.         return PLUGIN_CATEGORY_DISTORTION;

  821. 

  822.     // dynamics

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

  824.         return PLUGIN_CATEGORY_DYNAMICS;

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

  826.         return PLUGIN_CATEGORY_DYNAMICS;

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

  828.         return PLUGIN_CATEGORY_DYNAMICS;

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

  830.         return PLUGIN_CATEGORY_DYNAMICS;

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

  832.         return PLUGIN_CATEGORY_DYNAMICS;

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

  834.         return PLUGIN_CATEGORY_DYNAMICS;

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

  836.         return PLUGIN_CATEGORY_DYNAMICS;

  837. 

  838.     // modulator

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

  840.         return PLUGIN_CATEGORY_MODULATOR;

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

  842.         return PLUGIN_CATEGORY_MODULATOR;

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

  844.         return PLUGIN_CATEGORY_MODULATOR;

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

  846.         return PLUGIN_CATEGORY_MODULATOR;

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

  848.         return PLUGIN_CATEGORY_MODULATOR;

  849. 

  850.     // utility

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

  852.         return PLUGIN_CATEGORY_UTILITY;

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

  854.         return PLUGIN_CATEGORY_UTILITY;

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

  856.         return PLUGIN_CATEGORY_UTILITY;

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

  858.         return PLUGIN_CATEGORY_UTILITY;

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

  860.         return PLUGIN_CATEGORY_UTILITY;

  861. 

  862.     // common tags

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

  864.         return PLUGIN_CATEGORY_DELAY;

  865. 

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

  867.         return PLUGIN_CATEGORY_EQ;

  868. 

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

  870.         return PLUGIN_CATEGORY_UTILITY;

  871. 

  872.     // synth

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

  874.         return PLUGIN_CATEGORY_SYNTH;

  875. 

  876.     // other

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

  878.         return PLUGIN_CATEGORY_OTHER;

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

  880.         return PLUGIN_CATEGORY_OTHER;

  881. 

  882.     return PLUGIN_CATEGORY_NONE;

  883. }

  884. 

  885. // -----------------------------------------------------------------------

  886. 

  887. static inline

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

  889. {

  890.     if (options == PLUGIN_OPTIONS_NULL)

  891.         return true;

  892.     if (options & option)

  893.         return true;

  894.     return false;

  895. }

  896. 

  897. static inline

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

  899. {

  900.     if (options == PLUGIN_OPTIONS_NULL)

  901.         return false;

  902.     if (options & option)

  903.         return true;

  904.     return false;

  905. }

  906. 

  907. // -----------------------------------------------------------------------

  908. 

  909. CARLA_BACKEND_END_NAMESPACE

  910. 

  911. #endif // CARLA_BACKEND_UTILS_HPP_INCLUDED