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.
7040 Commits
17 Branches
940MB
Tree: 5e505428f3
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '5e505428f3'
${ noResults }
Carla/source/utils/CarlaBackendUtils.hpp

910 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_CTRL_CHANNEL:

  200.         return "PARAMETER_CTRL_CHANNEL";

  201. #endif

  202.     case PARAMETER_MAX:

  203.         return "PARAMETER_MAX";

  204.     }

  205. 

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

  207.     return "";

  208. }

  209. 

  210. static inline

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

  212. {

  213.     switch (opcode)

  214.     {

  215.     case ENGINE_CALLBACK_DEBUG:

  216.         return "ENGINE_CALLBACK_DEBUG";

  217.     case ENGINE_CALLBACK_PLUGIN_ADDED:

  218.         return "ENGINE_CALLBACK_PLUGIN_ADDED";

  219.     case ENGINE_CALLBACK_PLUGIN_REMOVED:

  220.         return "ENGINE_CALLBACK_PLUGIN_REMOVED";

  221.     case ENGINE_CALLBACK_PLUGIN_RENAMED:

  222.         return "ENGINE_CALLBACK_PLUGIN_RENAMED";

  223.     case ENGINE_CALLBACK_PLUGIN_UNAVAILABLE:

  224.         return "ENGINE_CALLBACK_PLUGIN_UNAVAILABLE";

  225.     case ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED:

  226.         return "ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED";

  227.     case ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED:

  228.         return "ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED";

  229. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  230.     case ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED:

  231.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED";

  232.     case ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:

  233.         return "ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";

  234.     case ENGINE_CALLBACK_OPTION_CHANGED:

  235.         return "ENGINE_CALLBACK_OPTION_CHANGED";

  236. #endif

  237.     case ENGINE_CALLBACK_PROGRAM_CHANGED:

  238.         return "ENGINE_CALLBACK_PROGRAM_CHANGED";

  239.     case ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED:

  240.         return "ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED";

  241.     case ENGINE_CALLBACK_UI_STATE_CHANGED:

  242.         return "ENGINE_CALLBACK_UI_STATE_CHANGED";

  243.     case ENGINE_CALLBACK_NOTE_ON:

  244.         return "ENGINE_CALLBACK_NOTE_ON";

  245.     case ENGINE_CALLBACK_NOTE_OFF:

  246.         return "ENGINE_CALLBACK_NOTE_OFF";

  247.     case ENGINE_CALLBACK_UPDATE:

  248.         return "ENGINE_CALLBACK_UPDATE";

  249.     case ENGINE_CALLBACK_RELOAD_INFO:

  250.         return "ENGINE_CALLBACK_RELOAD_INFO";

  251.     case ENGINE_CALLBACK_RELOAD_PARAMETERS:

  252.         return "ENGINE_CALLBACK_RELOAD_PARAMETERS";

  253.     case ENGINE_CALLBACK_RELOAD_PROGRAMS:

  254.         return "ENGINE_CALLBACK_RELOAD_PROGRAMS";

  255.     case ENGINE_CALLBACK_RELOAD_ALL:

  256.         return "ENGINE_CALLBACK_RELOAD_ALL";

  257. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  258.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED:

  259.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED";

  260.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED:

  261.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED";

  262.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED:

  263.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED";

  264.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED:

  265.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED";

  266.     case ENGINE_CALLBACK_PATCHBAY_PORT_ADDED:

  267.         return "ENGINE_CALLBACK_PATCHBAY_PORT_ADDED";

  268.     case ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED:

  269.         return "ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED";

  270.     case ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED:

  271.         return "ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED";

  272.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED:

  273.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED";

  274.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED:

  275.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED";

  276. #endif

  277.     case ENGINE_CALLBACK_ENGINE_STARTED:

  278.         return "ENGINE_CALLBACK_ENGINE_STARTED";

  279.     case ENGINE_CALLBACK_ENGINE_STOPPED:

  280.         return "ENGINE_CALLBACK_ENGINE_STOPPED";

  281.     case ENGINE_CALLBACK_PROCESS_MODE_CHANGED:

  282.         return "ENGINE_CALLBACK_PROCESS_MODE_CHANGED";

  283.     case ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED:

  284.         return "ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED";

  285.     case ENGINE_CALLBACK_BUFFER_SIZE_CHANGED:

  286.         return "ENGINE_CALLBACK_BUFFER_SIZE_CHANGED";

  287.     case ENGINE_CALLBACK_SAMPLE_RATE_CHANGED:

  288.         return "ENGINE_CALLBACK_SAMPLE_RATE_CHANGED";

  289.     case ENGINE_CALLBACK_CANCELABLE_ACTION:

  290.         return "ENGINE_CALLBACK_CANCELABLE_ACTION";

  291.     case ENGINE_CALLBACK_PROJECT_LOAD_FINISHED:

  292.         return "ENGINE_CALLBACK_PROJECT_LOAD_FINISHED";

  293.     case ENGINE_CALLBACK_NSM:

  294.         return "ENGINE_CALLBACK_NSM";

  295.     case ENGINE_CALLBACK_IDLE:

  296.         return "ENGINE_CALLBACK_IDLE";

  297.     case ENGINE_CALLBACK_INFO:

  298.         return "ENGINE_CALLBACK_INFO";

  299.     case ENGINE_CALLBACK_ERROR:

  300.         return "ENGINE_CALLBACK_ERROR";

  301.     case ENGINE_CALLBACK_QUIT:

  302.         return "ENGINE_CALLBACK_QUIT";

  303.     case ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW:

  304.         return "ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW";

  305.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED:

  306.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED";

  307.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED:

  308.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED";

  309.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED:

  310.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED";

  311.     case ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED:

  312.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED";

  313.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED:

  314.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED";

  315.     case ENGINE_CALLBACK_EMBED_UI_RESIZED:

  316.         return "ENGINE_CALLBACK_EMBED_UI_RESIZED";

  317.     }

  318. 

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

  320.     return "";

  321. }

  322. 

  323. static inline

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

  325. {

  326.     switch (option)

  327.     {

  328.     case ENGINE_OPTION_DEBUG:

  329.         return "ENGINE_OPTION_DEBUG";

  330.     case ENGINE_OPTION_PROCESS_MODE:

  331.         return "ENGINE_OPTION_PROCESS_MODE";

  332.     case ENGINE_OPTION_TRANSPORT_MODE:

  333.         return "ENGINE_OPTION_TRANSPORT_MODE";

  334.     case ENGINE_OPTION_FORCE_STEREO:

  335.         return "ENGINE_OPTION_FORCE_STEREO";

  336.     case ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

  337.         return "ENGINE_OPTION_PREFER_PLUGIN_BRIDGES";

  338.     case ENGINE_OPTION_PREFER_UI_BRIDGES:

  339.         return "ENGINE_OPTION_PREFER_UI_BRIDGES";

  340.     case ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

  341.         return "ENGINE_OPTION_UIS_ALWAYS_ON_TOP";

  342.     case ENGINE_OPTION_MAX_PARAMETERS:

  343.         return "ENGINE_OPTION_MAX_PARAMETERS";

  344.     case ENGINE_OPTION_RESET_XRUNS:

  345.         return "ENGINE_OPTION_RESET_XRUNS";

  346.     case ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  347.         return "ENGINE_OPTION_UI_BRIDGES_TIMEOUT";

  348.     case ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  349.         return "ENGINE_OPTION_AUDIO_BUFFER_SIZE";

  350.     case ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  351.         return "ENGINE_OPTION_AUDIO_SAMPLE_RATE";

  352.     case ENGINE_OPTION_AUDIO_TRIPLE_BUFFER:

  353.         return "ENGINE_OPTION_AUDIO_TRIPLE_BUFFER";

  354.     case ENGINE_OPTION_AUDIO_DRIVER:

  355.         return "ENGINE_OPTION_AUDIO_DRIVER";

  356.     case ENGINE_OPTION_AUDIO_DEVICE:

  357.         return "ENGINE_OPTION_AUDIO_DEVICE";

  358. #ifndef BUILD_BRIDGE

  359.     case ENGINE_OPTION_OSC_ENABLED:

  360.         return "ENGINE_OPTION_OSC_ENABLED";

  361.     case ENGINE_OPTION_OSC_PORT_UDP:

  362.         return "ENGINE_OPTION_OSC_PORT_UDP";

  363.     case ENGINE_OPTION_OSC_PORT_TCP:

  364.         return "ENGINE_OPTION_OSC_PORT_TCP";

  365. #endif

  366.     case ENGINE_OPTION_FILE_PATH:

  367.         return "ENGINE_OPTION_FILE_PATH";

  368.     case ENGINE_OPTION_PLUGIN_PATH:

  369.         return "ENGINE_OPTION_PLUGIN_PATH";

  370.     case ENGINE_OPTION_PATH_BINARIES:

  371.         return "ENGINE_OPTION_PATH_BINARIES";

  372.     case ENGINE_OPTION_PATH_RESOURCES:

  373.         return "ENGINE_OPTION_PATH_RESOURCES";

  374.     case ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

  375.         return "ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR";

  376.     case ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR:

  377.         return "ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR";

  378.     case ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR:

  379.         return "ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR";

  380.     case ENGINE_OPTION_FRONTEND_UI_SCALE:

  381.         return "ENGINE_OPTION_FRONTEND_UI_SCALE";

  382.     case ENGINE_OPTION_FRONTEND_WIN_ID:

  383.         return "ENGINE_OPTION_FRONTEND_WIN_ID";

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

  385.     case ENGINE_OPTION_WINE_EXECUTABLE:

  386.         return "ENGINE_OPTION_WINE_EXECUTABLE";

  387.     case ENGINE_OPTION_WINE_AUTO_PREFIX:

  388.         return "ENGINE_OPTION_WINE_AUTO_PREFIX";

  389.     case ENGINE_OPTION_WINE_FALLBACK_PREFIX:

  390.         return "ENGINE_OPTION_WINE_FALLBACK_PREFIX";

  391.     case ENGINE_OPTION_WINE_RT_PRIO_ENABLED:

  392.         return "ENGINE_OPTION_WINE_RT_PRIO_ENABLED";

  393.     case ENGINE_OPTION_WINE_BASE_RT_PRIO:

  394.         return "ENGINE_OPTION_WINE_BASE_RT_PRIO";

  395.     case ENGINE_OPTION_WINE_SERVER_RT_PRIO:

  396.         return "ENGINE_OPTION_WINE_SERVER_RT_PRIO";

  397. #endif

  398. #ifndef BUILD_BRIDGE

  399.     case ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT:

  400.         return "ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT";

  401. #endif

  402.     case ENGINE_OPTION_CLIENT_NAME_PREFIX:

  403.         return "ENGINE_OPTION_CLIENT_NAME_PREFIX";

  404.     case ENGINE_OPTION_PLUGINS_ARE_STANDALONE:

  405.         return "ENGINE_OPTION_PLUGINS_ARE_STANDALONE";

  406.     }

  407. 

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

  409.     return "";

  410. }

  411. 

  412. static inline

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

  414. {

  415.     switch (mode)

  416.     {

  417.     case ENGINE_PROCESS_MODE_SINGLE_CLIENT:

  418.         return "ENGINE_PROCESS_MODE_SINGLE_CLIENT";

  419.     case ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS:

  420.         return "ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS";

  421.     case ENGINE_PROCESS_MODE_CONTINUOUS_RACK:

  422.         return "ENGINE_PROCESS_MODE_CONTINUOUS_RACK";

  423.     case ENGINE_PROCESS_MODE_PATCHBAY:

  424.         return "ENGINE_PROCESS_MODE_PATCHBAY";

  425.     case ENGINE_PROCESS_MODE_BRIDGE:

  426.         return "ENGINE_PROCESS_MODE_BRIDGE";

  427.     }

  428. 

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

  430.     return "";

  431. }

  432. 

  433. static inline

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

  435. {

  436.     switch (mode)

  437.     {

  438.     case ENGINE_TRANSPORT_MODE_DISABLED:

  439.         return "ENGINE_TRANSPORT_MODE_DISABLED";

  440.     case ENGINE_TRANSPORT_MODE_INTERNAL:

  441.         return "ENGINE_TRANSPORT_MODE_INTERNAL";

  442.     case ENGINE_TRANSPORT_MODE_JACK:

  443.         return "ENGINE_TRANSPORT_MODE_JACK";

  444.     case ENGINE_TRANSPORT_MODE_PLUGIN:

  445.         return "ENGINE_TRANSPORT_MODE_PLUGIN";

  446.     case ENGINE_TRANSPORT_MODE_BRIDGE:

  447.         return "ENGINE_TRANSPORT_MODE_BRIDGE";

  448.     }

  449. 

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

  451.     return "";

  452. }

  453. 

  454. static inline

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

  456. {

  457.     switch (opcode)

  458.     {

  459.     case FILE_CALLBACK_DEBUG:

  460.         return "FILE_CALLBACK_DEBUG";

  461.     case FILE_CALLBACK_OPEN:

  462.         return "FILE_CALLBACK_OPEN";

  463.     case FILE_CALLBACK_SAVE:

  464.         return "FILE_CALLBACK_SAVE";

  465.     }

  466. 

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

  468.     return "";

  469. }

  470. 

  471. static inline

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

  473. {

  474.     switch (icon)

  475.     {

  476.     case PATCHBAY_ICON_APPLICATION:

  477.         return "PATCHBAY_ICON_APPLICATION";

  478.     case PATCHBAY_ICON_PLUGIN:

  479.         return "PATCHBAY_ICON_PLUGIN";

  480.     case PATCHBAY_ICON_HARDWARE:

  481.         return "PATCHBAY_ICON_HARDWARE";

  482.     case PATCHBAY_ICON_CARLA:

  483.         return "PATCHBAY_ICON_CARLA";

  484.     case PATCHBAY_ICON_DISTRHO:

  485.         return "PATCHBAY_ICON_DISTRHO";

  486.     case PATCHBAY_ICON_FILE:

  487.         return "PATCHBAY_ICON_FILE";

  488.     }

  489. 

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

  491.     return "";

  492. }

  493. 

  494. // -----------------------------------------------------------------------

  495. 

  496. static inline

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

  498. {

  499.     switch (opcode)

  500.     {

  501.     case NATIVE_PLUGIN_OPCODE_NULL:

  502.         return "NATIVE_PLUGIN_OPCODE_NULL";

  503.     case NATIVE_PLUGIN_OPCODE_BUFFER_SIZE_CHANGED:

  504.         return "NATIVE_PLUGIN_OPCODE_BUFFER_SIZE_CHANGED";

  505.     case NATIVE_PLUGIN_OPCODE_SAMPLE_RATE_CHANGED:

  506.         return "NATIVE_PLUGIN_OPCODE_SAMPLE_RATE_CHANGED";

  507.     case NATIVE_PLUGIN_OPCODE_OFFLINE_CHANGED:

  508.         return "NATIVE_PLUGIN_OPCODE_OFFLINE_CHANGED";

  509.     case NATIVE_PLUGIN_OPCODE_UI_NAME_CHANGED:

  510.         return "NATIVE_PLUGIN_OPCODE_UI_NAME_CHANGED";

  511.     case NATIVE_PLUGIN_OPCODE_GET_INTERNAL_HANDLE:

  512.         return "NATIVE_PLUGIN_OPCODE_GET_INTERNAL_HANDLE";

  513.     case NATIVE_PLUGIN_OPCODE_IDLE:

  514.         return "NATIVE_PLUGIN_OPCODE_IDLE";

  515.     case NATIVE_PLUGIN_OPCODE_UI_MIDI_EVENT:

  516.         return "NATIVE_PLUGIN_OPCODE_UI_MIDI_EVENT";

  517.     case NATIVE_PLUGIN_OPCODE_HOST_USES_EMBED:

  518.         return "NATIVE_PLUGIN_OPCODE_HOST_USES_EMBED";

  519.     case NATIVE_PLUGIN_OPCODE_HOST_OPTION:

  520.         return "NATIVE_PLUGIN_OPCODE_HOST_OPTION";

  521.     }

  522. 

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

  524.     return "";

  525. }

  526. 

  527. static inline

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

  529. {

  530.     switch (opcode)

  531.     {

  532.     case NATIVE_HOST_OPCODE_NULL:

  533.         return "NATIVE_HOST_OPCODE_NULL";

  534.     case NATIVE_HOST_OPCODE_UPDATE_PARAMETER:

  535.         return "NATIVE_HOST_OPCODE_UPDATE_PARAMETER";

  536.     case NATIVE_HOST_OPCODE_UPDATE_MIDI_PROGRAM:

  537.         return "NATIVE_HOST_OPCODE_UPDATE_MIDI_PROGRAM";

  538.     case NATIVE_HOST_OPCODE_RELOAD_PARAMETERS:

  539.         return "NATIVE_HOST_OPCODE_RELOAD_PARAMETERS";

  540.     case NATIVE_HOST_OPCODE_RELOAD_MIDI_PROGRAMS:

  541.         return "NATIVE_HOST_OPCODE_RELOAD_MIDI_PROGRAMS";

  542.     case NATIVE_HOST_OPCODE_RELOAD_ALL:

  543.         return "NATIVE_HOST_OPCODE_RELOAD_ALL";

  544.     case NATIVE_HOST_OPCODE_UI_UNAVAILABLE:

  545.         return "NATIVE_HOST_OPCODE_UI_UNAVAILABLE";

  546.     case NATIVE_HOST_OPCODE_HOST_IDLE:

  547.         return "NATIVE_HOST_OPCODE_HOST_IDLE";

  548.     case NATIVE_HOST_OPCODE_INTERNAL_PLUGIN:

  549.         return "NATIVE_HOST_OPCODE_INTERNAL_PLUGIN";

  550.     case NATIVE_HOST_OPCODE_QUEUE_INLINE_DISPLAY:

  551.         return "NATIVE_HOST_OPCODE_QUEUE_INLINE_DISPLAY";

  552.     case NATIVE_HOST_OPCODE_UI_TOUCH_PARAMETER:

  553.         return "NATIVE_HOST_OPCODE_UI_TOUCH_PARAMETER";

  554.     case NATIVE_HOST_OPCODE_REQUEST_IDLE:

  555.         return "NATIVE_HOST_OPCODE_REQUEST_IDLE";

  556.     case NATIVE_HOST_OPCODE_GET_FILE_PATH:

  557.         return "NATIVE_HOST_OPCODE_GET_FILE_PATH";

  558.     case NATIVE_HOST_OPCODE_UI_RESIZE:

  559.         return "NATIVE_HOST_OPCODE_UI_RESIZE";

  560.     case NATIVE_HOST_OPCODE_PREVIEW_BUFFER_DATA:

  561.         return "NATIVE_HOST_OPCODE_PREVIEW_BUFFER_DATA";

  562.     }

  563. 

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

  565.     return "";

  566. }

  567. 

  568. // -----------------------------------------------------------------------

  569. 

  570. static inline

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

  572. {

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

  574. 

  575.     if (type == BINARY_NATIVE)

  576.         return "native";

  577. 

  578.     switch (type)

  579.     {

  580.     case BINARY_NONE:

  581.         return "none";

  582.     case BINARY_POSIX32:

  583.         return "posix32";

  584.     case BINARY_POSIX64:

  585.         return "posix64";

  586.     case BINARY_WIN32:

  587.         return "win32";

  588.     case BINARY_WIN64:

  589.         return "win64";

  590.     case BINARY_OTHER:

  591.         return "other";

  592.     }

  593. 

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

  595.     return "NONE";

  596. }

  597. 

  598. static inline

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

  600. {

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

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

  603. 

  604.     String stype(ctype);

  605. 

  606.     if (stype.isEmpty())

  607.         return BINARY_NONE;

  608. 

  609.     stype.toLower();

  610. 

  611.     if (stype == "none")

  612.         return BINARY_NONE;

  613.     if (stype == "native")

  614.         return BINARY_NATIVE;

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

  616.         return BINARY_POSIX32;

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

  618.         return BINARY_POSIX64;

  619.     if (stype == "win32")

  620.         return BINARY_WIN32;

  621.     if (stype == "win64")

  622.         return BINARY_WIN64;

  623.     if (stype == "other")

  624.         return BINARY_OTHER;

  625. 

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

  627.     return BINARY_NONE;

  628. }

  629. 

  630. // -----------------------------------------------------------------------

  631. 

  632. static inline

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

  634. {

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

  636. 

  637.     switch (category)

  638.     {

  639.     case PLUGIN_CATEGORY_NONE:

  640.         return "none";

  641.     case PLUGIN_CATEGORY_SYNTH:

  642.         return "synth";

  643.     case PLUGIN_CATEGORY_DELAY:

  644.         return "delay";

  645.     case PLUGIN_CATEGORY_EQ:

  646.         return "eq";

  647.     case PLUGIN_CATEGORY_FILTER:

  648.         return "filter";

  649.     case PLUGIN_CATEGORY_DISTORTION:

  650.         return "distortion";

  651.     case PLUGIN_CATEGORY_DYNAMICS:

  652.         return "dynamics";

  653.     case PLUGIN_CATEGORY_MODULATOR:

  654.         return "modulator";

  655.     case PLUGIN_CATEGORY_UTILITY:

  656.         return "utility";

  657.     case PLUGIN_CATEGORY_OTHER:

  658.         return "other";

  659.     }

  660. 

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

  662.     return "NONE";

  663. }

  664. 

  665. static inline

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

  667. {

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

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

  670. 

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

  672.         return PLUGIN_CATEGORY_NONE;

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

  674.         return PLUGIN_CATEGORY_SYNTH;

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

  676.         return PLUGIN_CATEGORY_DELAY;

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

  678.         return PLUGIN_CATEGORY_EQ;

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

  680.         return PLUGIN_CATEGORY_FILTER;

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

  682.         return PLUGIN_CATEGORY_DISTORTION;

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

  684.         return PLUGIN_CATEGORY_DYNAMICS;

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

  686.         return PLUGIN_CATEGORY_MODULATOR;

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

  688.         return PLUGIN_CATEGORY_UTILITY;

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

  690.         return PLUGIN_CATEGORY_OTHER;

  691. 

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

  693.     return PLUGIN_CATEGORY_NONE;

  694. }

  695. 

  696. // -----------------------------------------------------------------------

  697. 

  698. static inline

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

  700. {

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

  702. 

  703.     switch (type)

  704.     {

  705.     case PLUGIN_NONE:

  706.         return "NONE";

  707.     case PLUGIN_INTERNAL:

  708.         return "INTERNAL";

  709.     case PLUGIN_LADSPA:

  710.         return "LADSPA";

  711.     case PLUGIN_DSSI:

  712.         return "DSSI";

  713.     case PLUGIN_LV2:

  714.         return "LV2";

  715.     case PLUGIN_VST2:

  716.         return "VST2";

  717.     case PLUGIN_VST3:

  718.         return "VST3";

  719.     case PLUGIN_AU:

  720.         return "AU";

  721.     case PLUGIN_DLS:

  722.         return "DLS";

  723.     case PLUGIN_GIG:

  724.         return "GIG";

  725.     case PLUGIN_SF2:

  726.         return "SF2";

  727.     case PLUGIN_SFZ:

  728.         return "SFZ";

  729.     case PLUGIN_JACK:

  730.         return "JACK";

  731.     case PLUGIN_JSFX:

  732.         return "JSFX";

  733.     case PLUGIN_CLAP:

  734.         return "CLAP";

  735.     case PLUGIN_TYPE_COUNT:

  736.         break;

  737.     }

  738. 

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

  740.     return "NONE";

  741. }

  742. 

  743. static inline

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

  745. {

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

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

  748. 

  749.     String stype(ctype);

  750. 

  751.     if (stype.isEmpty())

  752.         return PLUGIN_NONE;

  753. 

  754.     stype.toLower();

  755. 

  756.     if (stype == "none")

  757.         return PLUGIN_NONE;

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

  759.         return PLUGIN_INTERNAL;

  760.     if (stype == "ladspa")

  761.         return PLUGIN_LADSPA;

  762.     if (stype == "dssi")

  763.         return PLUGIN_DSSI;

  764.     if (stype == "lv2")

  765.         return PLUGIN_LV2;

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

  767.         return PLUGIN_VST2;

  768.     if (stype == "vst3")

  769.         return PLUGIN_VST3;

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

  771.         return PLUGIN_AU;

  772.     if (stype == "dls")

  773.         return PLUGIN_DLS;

  774.     if (stype == "gig")

  775.         return PLUGIN_GIG;

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

  777.         return PLUGIN_SF2;

  778.     if (stype == "sfz")

  779.         return PLUGIN_SFZ;

  780.     if (stype == "jack")

  781.         return PLUGIN_JACK;

  782.     if (stype == "jsfx")

  783.         return PLUGIN_JSFX;

  784.     if (stype == "clap")

  785.         return PLUGIN_CLAP;

  786. 

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

  788.     return PLUGIN_NONE;

  789. }

  790. 

  791. // -----------------------------------------------------------------------

  792. 

  793. static inline

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

  795. {

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

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

  798. 

  799.     String sname(name);

  800. 

  801.     if (sname.isEmpty())

  802.         return PLUGIN_CATEGORY_NONE;

  803. 

  804.     sname.toLower();

  805. 

  806.     // generic tags first

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

  808.         return PLUGIN_CATEGORY_DELAY;

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

  810.         return PLUGIN_CATEGORY_DELAY;

  811. 

  812.     // filter

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

  814.         return PLUGIN_CATEGORY_FILTER;

  815. 

  816.     // distortion

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

  818.         return PLUGIN_CATEGORY_DISTORTION;

  819. 

  820.     // dynamics

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

  822.         return PLUGIN_CATEGORY_DYNAMICS;

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

  824.         return PLUGIN_CATEGORY_DYNAMICS;

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

  826.         return PLUGIN_CATEGORY_DYNAMICS;

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

  828.         return PLUGIN_CATEGORY_DYNAMICS;

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

  830.         return PLUGIN_CATEGORY_DYNAMICS;

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

  832.         return PLUGIN_CATEGORY_DYNAMICS;

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

  834.         return PLUGIN_CATEGORY_DYNAMICS;

  835. 

  836.     // modulator

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

  838.         return PLUGIN_CATEGORY_MODULATOR;

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

  840.         return PLUGIN_CATEGORY_MODULATOR;

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

  842.         return PLUGIN_CATEGORY_MODULATOR;

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

  844.         return PLUGIN_CATEGORY_MODULATOR;

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

  846.         return PLUGIN_CATEGORY_MODULATOR;

  847. 

  848.     // utility

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

  850.         return PLUGIN_CATEGORY_UTILITY;

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

  852.         return PLUGIN_CATEGORY_UTILITY;

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

  854.         return PLUGIN_CATEGORY_UTILITY;

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

  856.         return PLUGIN_CATEGORY_UTILITY;

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

  858.         return PLUGIN_CATEGORY_UTILITY;

  859. 

  860.     // common tags

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

  862.         return PLUGIN_CATEGORY_DELAY;

  863. 

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

  865.         return PLUGIN_CATEGORY_EQ;

  866. 

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

  868.         return PLUGIN_CATEGORY_UTILITY;

  869. 

  870.     // synth

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

  872.         return PLUGIN_CATEGORY_SYNTH;

  873. 

  874.     // other

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

  876.         return PLUGIN_CATEGORY_OTHER;

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

  878.         return PLUGIN_CATEGORY_OTHER;

  879. 

  880.     return PLUGIN_CATEGORY_NONE;

  881. }

  882. 

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

  884. 

  885. static inline

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

  887. {

  888.     if (options == PLUGIN_OPTIONS_NULL)

  889.         return true;

  890.     if (options & option)

  891.         return true;

  892.     return false;

  893. }

  894. 

  895. static inline

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

  897. {

  898.     if (options == PLUGIN_OPTIONS_NULL)

  899.         return false;

  900.     if (options & option)

  901.         return true;

  902.     return false;

  903. }

  904. 

  905. // -----------------------------------------------------------------------

  906. 

  907. CARLA_BACKEND_END_NAMESPACE

  908. 

  909. #endif // CARLA_BACKEND_UTILS_HPP_INCLUDED