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

837 lines
26KB
Raw Blame History 

  1. /*

  2.  * Carla Backend utils

  3.  * Copyright (C) 2011-2023 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 "";

  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 "";

  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 "";

  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.     }

  133. 

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

  135.     return "";

  136. }

  137. 

  138. static inline

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

  140. {

  141.     switch (category)

  142.     {

  143.     case PLUGIN_CATEGORY_NONE:

  144.         return "PLUGIN_CATEGORY_NONE";

  145.     case PLUGIN_CATEGORY_SYNTH:

  146.         return "PLUGIN_CATEGORY_SYNTH";

  147.     case PLUGIN_CATEGORY_DELAY:

  148.         return "PLUGIN_CATEGORY_DELAY";

  149.     case PLUGIN_CATEGORY_EQ:

  150.         return "PLUGIN_CATEGORY_EQ";

  151.     case PLUGIN_CATEGORY_FILTER:

  152.         return "PLUGIN_CATEGORY_FILTER";

  153.     case PLUGIN_CATEGORY_DISTORTION:

  154.         return "PLUGIN_CATEGORY_DISTORTION";

  155.     case PLUGIN_CATEGORY_DYNAMICS:

  156.         return "PLUGIN_CATEGORY_DYNAMICS";

  157.     case PLUGIN_CATEGORY_MODULATOR:

  158.         return "PLUGIN_CATEGORY_MODULATOR";

  159.     case PLUGIN_CATEGORY_UTILITY:

  160.         return "PLUGIN_CATEGORY_UTILITY";

  161.     case PLUGIN_CATEGORY_OTHER:

  162.         return "PLUGIN_CATEGORY_OTHER";

  163.     }

  164. 

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

  166.     return "";

  167. }

  168. 

  169. static inline

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

  171. {

  172.     switch (type)

  173.     {

  174.     case PARAMETER_UNKNOWN:

  175.         return "PARAMETER_UNKNOWN";

  176.     case PARAMETER_INPUT:

  177.         return "PARAMETER_INPUT";

  178.     case PARAMETER_OUTPUT:

  179.         return "PARAMETER_OUTPUT";

  180.     }

  181. 

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

  183.     return "";

  184. }

  185. 

  186. static inline

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

  188. {

  189.     switch (index)

  190.     {

  191.     case PARAMETER_NULL:

  192.         return "PARAMETER_NULL";

  193. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  194.     case PARAMETER_ACTIVE:

  195.         return "PARAMETER_ACTIVE";

  196.     case PARAMETER_DRYWET:

  197.         return "PARAMETER_DRYWET";

  198.     case PARAMETER_VOLUME:

  199.         return "PARAMETER_VOLUME";

  200.     case PARAMETER_BALANCE_LEFT:

  201.         return "PARAMETER_BALANCE_LEFT";

  202.     case PARAMETER_BALANCE_RIGHT:

  203.         return "PARAMETER_BALANCE_RIGHT";

  204.     case PARAMETER_PANNING:

  205.         return "PARAMETER_PANNING";

  206.     case PARAMETER_CTRL_CHANNEL:

  207.         return "PARAMETER_CTRL_CHANNEL";

  208. #endif

  209.     case PARAMETER_MAX:

  210.         return "PARAMETER_MAX";

  211.     }

  212. 

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

  214.     return "";

  215. }

  216. 

  217. static inline

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

  219. {

  220.     switch (opcode)

  221.     {

  222.     case ENGINE_CALLBACK_DEBUG:

  223.         return "ENGINE_CALLBACK_DEBUG";

  224.     case ENGINE_CALLBACK_PLUGIN_ADDED:

  225.         return "ENGINE_CALLBACK_PLUGIN_ADDED";

  226.     case ENGINE_CALLBACK_PLUGIN_REMOVED:

  227.         return "ENGINE_CALLBACK_PLUGIN_REMOVED";

  228.     case ENGINE_CALLBACK_PLUGIN_RENAMED:

  229.         return "ENGINE_CALLBACK_PLUGIN_RENAMED";

  230.     case ENGINE_CALLBACK_PLUGIN_UNAVAILABLE:

  231.         return "ENGINE_CALLBACK_PLUGIN_UNAVAILABLE";

  232.     case ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED:

  233.         return "ENGINE_CALLBACK_PARAMETER_VALUE_CHANGED";

  234.     case ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED:

  235.         return "ENGINE_CALLBACK_PARAMETER_DEFAULT_CHANGED";

  236. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  237.     case ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED:

  238.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_CONTROL_INDEX_CHANGED";

  239.     case ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED:

  240.         return "ENGINE_CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED";

  241.     case ENGINE_CALLBACK_OPTION_CHANGED:

  242.         return "ENGINE_CALLBACK_OPTION_CHANGED";

  243. #endif

  244.     case ENGINE_CALLBACK_PROGRAM_CHANGED:

  245.         return "ENGINE_CALLBACK_PROGRAM_CHANGED";

  246.     case ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED:

  247.         return "ENGINE_CALLBACK_MIDI_PROGRAM_CHANGED";

  248.     case ENGINE_CALLBACK_UI_STATE_CHANGED:

  249.         return "ENGINE_CALLBACK_UI_STATE_CHANGED";

  250.     case ENGINE_CALLBACK_NOTE_ON:

  251.         return "ENGINE_CALLBACK_NOTE_ON";

  252.     case ENGINE_CALLBACK_NOTE_OFF:

  253.         return "ENGINE_CALLBACK_NOTE_OFF";

  254.     case ENGINE_CALLBACK_UPDATE:

  255.         return "ENGINE_CALLBACK_UPDATE";

  256.     case ENGINE_CALLBACK_RELOAD_INFO:

  257.         return "ENGINE_CALLBACK_RELOAD_INFO";

  258.     case ENGINE_CALLBACK_RELOAD_PARAMETERS:

  259.         return "ENGINE_CALLBACK_RELOAD_PARAMETERS";

  260.     case ENGINE_CALLBACK_RELOAD_PROGRAMS:

  261.         return "ENGINE_CALLBACK_RELOAD_PROGRAMS";

  262.     case ENGINE_CALLBACK_RELOAD_ALL:

  263.         return "ENGINE_CALLBACK_RELOAD_ALL";

  264. #ifndef BUILD_BRIDGE_ALTERNATIVE_ARCH

  265.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED:

  266.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_ADDED";

  267.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED:

  268.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_REMOVED";

  269.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED:

  270.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_RENAMED";

  271.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED:

  272.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_DATA_CHANGED";

  273.     case ENGINE_CALLBACK_PATCHBAY_PORT_ADDED:

  274.         return "ENGINE_CALLBACK_PATCHBAY_PORT_ADDED";

  275.     case ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED:

  276.         return "ENGINE_CALLBACK_PATCHBAY_PORT_REMOVED";

  277.     case ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED:

  278.         return "ENGINE_CALLBACK_PATCHBAY_PORT_CHANGED";

  279.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED:

  280.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_ADDED";

  281.     case ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED:

  282.         return "ENGINE_CALLBACK_PATCHBAY_CONNECTION_REMOVED";

  283. #endif

  284.     case ENGINE_CALLBACK_ENGINE_STARTED:

  285.         return "ENGINE_CALLBACK_ENGINE_STARTED";

  286.     case ENGINE_CALLBACK_ENGINE_STOPPED:

  287.         return "ENGINE_CALLBACK_ENGINE_STOPPED";

  288.     case ENGINE_CALLBACK_PROCESS_MODE_CHANGED:

  289.         return "ENGINE_CALLBACK_PROCESS_MODE_CHANGED";

  290.     case ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED:

  291.         return "ENGINE_CALLBACK_TRANSPORT_MODE_CHANGED";

  292.     case ENGINE_CALLBACK_BUFFER_SIZE_CHANGED:

  293.         return "ENGINE_CALLBACK_BUFFER_SIZE_CHANGED";

  294.     case ENGINE_CALLBACK_SAMPLE_RATE_CHANGED:

  295.         return "ENGINE_CALLBACK_SAMPLE_RATE_CHANGED";

  296.     case ENGINE_CALLBACK_CANCELABLE_ACTION:

  297.         return "ENGINE_CALLBACK_CANCELABLE_ACTION";

  298.     case ENGINE_CALLBACK_PROJECT_LOAD_FINISHED:

  299.         return "ENGINE_CALLBACK_PROJECT_LOAD_FINISHED";

  300.     case ENGINE_CALLBACK_NSM:

  301.         return "ENGINE_CALLBACK_NSM";

  302.     case ENGINE_CALLBACK_IDLE:

  303.         return "ENGINE_CALLBACK_IDLE";

  304.     case ENGINE_CALLBACK_INFO:

  305.         return "ENGINE_CALLBACK_INFO";

  306.     case ENGINE_CALLBACK_ERROR:

  307.         return "ENGINE_CALLBACK_ERROR";

  308.     case ENGINE_CALLBACK_QUIT:

  309.         return "ENGINE_CALLBACK_QUIT";

  310.     case ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW:

  311.         return "ENGINE_CALLBACK_INLINE_DISPLAY_REDRAW";

  312.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED:

  313.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_ADDED";

  314.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED:

  315.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_REMOVED";

  316.     case ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED:

  317.         return "ENGINE_CALLBACK_PATCHBAY_PORT_GROUP_CHANGED";

  318.     case ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED:

  319.         return "ENGINE_CALLBACK_PARAMETER_MAPPED_RANGE_CHANGED";

  320.     case ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED:

  321.         return "ENGINE_CALLBACK_PATCHBAY_CLIENT_POSITION_CHANGED";

  322.     case ENGINE_CALLBACK_EMBED_UI_RESIZED:

  323.         return "ENGINE_CALLBACK_EMBED_UI_RESIZED";

  324.     }

  325. 

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

  327.     return "";

  328. }

  329. 

  330. static inline

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

  332. {

  333.     switch (option)

  334.     {

  335.     case ENGINE_OPTION_DEBUG:

  336.         return "ENGINE_OPTION_DEBUG";

  337.     case ENGINE_OPTION_PROCESS_MODE:

  338.         return "ENGINE_OPTION_PROCESS_MODE";

  339.     case ENGINE_OPTION_TRANSPORT_MODE:

  340.         return "ENGINE_OPTION_TRANSPORT_MODE";

  341.     case ENGINE_OPTION_FORCE_STEREO:

  342.         return "ENGINE_OPTION_FORCE_STEREO";

  343.     case ENGINE_OPTION_PREFER_PLUGIN_BRIDGES:

  344.         return "ENGINE_OPTION_PREFER_PLUGIN_BRIDGES";

  345.     case ENGINE_OPTION_PREFER_UI_BRIDGES:

  346.         return "ENGINE_OPTION_PREFER_UI_BRIDGES";

  347.     case ENGINE_OPTION_UIS_ALWAYS_ON_TOP:

  348.         return "ENGINE_OPTION_UIS_ALWAYS_ON_TOP";

  349.     case ENGINE_OPTION_MAX_PARAMETERS:

  350.         return "ENGINE_OPTION_MAX_PARAMETERS";

  351.     case ENGINE_OPTION_RESET_XRUNS:

  352.         return "ENGINE_OPTION_RESET_XRUNS";

  353.     case ENGINE_OPTION_UI_BRIDGES_TIMEOUT:

  354.         return "ENGINE_OPTION_UI_BRIDGES_TIMEOUT";

  355.     case ENGINE_OPTION_AUDIO_BUFFER_SIZE:

  356.         return "ENGINE_OPTION_AUDIO_BUFFER_SIZE";

  357.     case ENGINE_OPTION_AUDIO_SAMPLE_RATE:

  358.         return "ENGINE_OPTION_AUDIO_SAMPLE_RATE";

  359.     case ENGINE_OPTION_AUDIO_TRIPLE_BUFFER:

  360.         return "ENGINE_OPTION_AUDIO_TRIPLE_BUFFER";

  361.     case ENGINE_OPTION_AUDIO_DRIVER:

  362.         return "ENGINE_OPTION_AUDIO_DRIVER";

  363.     case ENGINE_OPTION_AUDIO_DEVICE:

  364.         return "ENGINE_OPTION_AUDIO_DEVICE";

  365. #ifndef BUILD_BRIDGE

  366.     case ENGINE_OPTION_OSC_ENABLED:

  367.         return "ENGINE_OPTION_OSC_ENABLED";

  368.     case ENGINE_OPTION_OSC_PORT_UDP:

  369.         return "ENGINE_OPTION_OSC_PORT_UDP";

  370.     case ENGINE_OPTION_OSC_PORT_TCP:

  371.         return "ENGINE_OPTION_OSC_PORT_TCP";

  372. #endif

  373.     case ENGINE_OPTION_FILE_PATH:

  374.         return "ENGINE_OPTION_FILE_PATH";

  375.     case ENGINE_OPTION_PLUGIN_PATH:

  376.         return "ENGINE_OPTION_PLUGIN_PATH";

  377.     case ENGINE_OPTION_PATH_BINARIES:

  378.         return "ENGINE_OPTION_PATH_BINARIES";

  379.     case ENGINE_OPTION_PATH_RESOURCES:

  380.         return "ENGINE_OPTION_PATH_RESOURCES";

  381.     case ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR:

  382.         return "ENGINE_OPTION_PREVENT_BAD_BEHAVIOUR";

  383.     case ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR:

  384.         return "ENGINE_OPTION_FRONTEND_BACKGROUND_COLOR";

  385.     case ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR:

  386.         return "ENGINE_OPTION_FRONTEND_FOREGROUND_COLOR";

  387.     case ENGINE_OPTION_FRONTEND_UI_SCALE:

  388.         return "ENGINE_OPTION_FRONTEND_UI_SCALE";

  389.     case ENGINE_OPTION_FRONTEND_WIN_ID:

  390.         return "ENGINE_OPTION_FRONTEND_WIN_ID";

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

  392.     case ENGINE_OPTION_WINE_EXECUTABLE:

  393.         return "ENGINE_OPTION_WINE_EXECUTABLE";

  394.     case ENGINE_OPTION_WINE_AUTO_PREFIX:

  395.         return "ENGINE_OPTION_WINE_AUTO_PREFIX";

  396.     case ENGINE_OPTION_WINE_FALLBACK_PREFIX:

  397.         return "ENGINE_OPTION_WINE_FALLBACK_PREFIX";

  398.     case ENGINE_OPTION_WINE_RT_PRIO_ENABLED:

  399.         return "ENGINE_OPTION_WINE_RT_PRIO_ENABLED";

  400.     case ENGINE_OPTION_WINE_BASE_RT_PRIO:

  401.         return "ENGINE_OPTION_WINE_BASE_RT_PRIO";

  402.     case ENGINE_OPTION_WINE_SERVER_RT_PRIO:

  403.         return "ENGINE_OPTION_WINE_SERVER_RT_PRIO";

  404. #endif

  405. #ifndef BUILD_BRIDGE

  406.     case ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT:

  407.         return "ENGINE_OPTION_DEBUG_CONSOLE_OUTPUT";

  408. #endif

  409.     case ENGINE_OPTION_CLIENT_NAME_PREFIX:

  410.         return "ENGINE_OPTION_CLIENT_NAME_PREFIX";

  411.     case ENGINE_OPTION_PLUGINS_ARE_STANDALONE:

  412.         return "ENGINE_OPTION_PLUGINS_ARE_STANDALONE";

  413.     }

  414. 

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

  416.     return "";

  417. }

  418. 

  419. static inline

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

  421. {

  422.     switch (mode)

  423.     {

  424.     case ENGINE_PROCESS_MODE_SINGLE_CLIENT:

  425.         return "ENGINE_PROCESS_MODE_SINGLE_CLIENT";

  426.     case ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS:

  427.         return "ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS";

  428.     case ENGINE_PROCESS_MODE_CONTINUOUS_RACK:

  429.         return "ENGINE_PROCESS_MODE_CONTINUOUS_RACK";

  430.     case ENGINE_PROCESS_MODE_PATCHBAY:

  431.         return "ENGINE_PROCESS_MODE_PATCHBAY";

  432.     case ENGINE_PROCESS_MODE_BRIDGE:

  433.         return "ENGINE_PROCESS_MODE_BRIDGE";

  434.     }

  435. 

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

  437.     return "";

  438. }

  439. 

  440. static inline

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

  442. {

  443.     switch (mode)

  444.     {

  445.     case ENGINE_TRANSPORT_MODE_DISABLED:

  446.         return "ENGINE_TRANSPORT_MODE_DISABLED";

  447.     case ENGINE_TRANSPORT_MODE_INTERNAL:

  448.         return "ENGINE_TRANSPORT_MODE_INTERNAL";

  449.     case ENGINE_TRANSPORT_MODE_JACK:

  450.         return "ENGINE_TRANSPORT_MODE_JACK";

  451.     case ENGINE_TRANSPORT_MODE_PLUGIN:

  452.         return "ENGINE_TRANSPORT_MODE_PLUGIN";

  453.     case ENGINE_TRANSPORT_MODE_BRIDGE:

  454.         return "ENGINE_TRANSPORT_MODE_BRIDGE";

  455.     }

  456. 

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

  458.     return "";

  459. }

  460. 

  461. static inline

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

  463. {

  464.     switch (opcode)

  465.     {

  466.     case FILE_CALLBACK_DEBUG:

  467.         return "FILE_CALLBACK_DEBUG";

  468.     case FILE_CALLBACK_OPEN:

  469.         return "FILE_CALLBACK_OPEN";

  470.     case FILE_CALLBACK_SAVE:

  471.         return "FILE_CALLBACK_SAVE";

  472.     }

  473. 

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

  475.     return "";

  476. }

  477. 

  478. static inline

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

  480. {

  481.     switch (icon)

  482.     {

  483.     case PATCHBAY_ICON_APPLICATION:

  484.         return "PATCHBAY_ICON_APPLICATION";

  485.     case PATCHBAY_ICON_PLUGIN:

  486.         return "PATCHBAY_ICON_PLUGIN";

  487.     case PATCHBAY_ICON_HARDWARE:

  488.         return "PATCHBAY_ICON_HARDWARE";

  489.     case PATCHBAY_ICON_CARLA:

  490.         return "PATCHBAY_ICON_CARLA";

  491.     case PATCHBAY_ICON_DISTRHO:

  492.         return "PATCHBAY_ICON_DISTRHO";

  493.     case PATCHBAY_ICON_FILE:

  494.         return "PATCHBAY_ICON_FILE";

  495.     }

  496. 

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

  498.     return "";

  499. }

  500. 

  501. // -----------------------------------------------------------------------

  502. 

  503. static inline

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

  505. {

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

  507. 

  508.     if (type == BINARY_NATIVE)

  509.         return "native";

  510. 

  511.     switch (type)

  512.     {

  513.     case BINARY_NONE:

  514.         return "none";

  515.     case BINARY_POSIX32:

  516.         return "posix32";

  517.     case BINARY_POSIX64:

  518.         return "posix64";

  519.     case BINARY_WIN32:

  520.         return "win32";

  521.     case BINARY_WIN64:

  522.         return "win64";

  523.     case BINARY_OTHER:

  524.         return "other";

  525.     }

  526. 

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

  528.     return "NONE";

  529. }

  530. 

  531. static inline

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

  533. {

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

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

  536. 

  537.     CarlaString stype(ctype);

  538. 

  539.     if (stype.isEmpty())

  540.         return BINARY_NONE;

  541. 

  542.     stype.toLower();

  543. 

  544.     if (stype == "none")

  545.         return BINARY_NONE;

  546.     if (stype == "native")

  547.         return BINARY_NATIVE;

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

  549.         return BINARY_POSIX32;

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

  551.         return BINARY_POSIX64;

  552.     if (stype == "win32")

  553.         return BINARY_WIN32;

  554.     if (stype == "win64")

  555.         return BINARY_WIN64;

  556.     if (stype == "other")

  557.         return BINARY_OTHER;

  558. 

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

  560.     return BINARY_NONE;

  561. }

  562. 

  563. // -----------------------------------------------------------------------

  564. 

  565. static inline

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

  567. {

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

  569. 

  570.     switch (category)

  571.     {

  572.     case PLUGIN_CATEGORY_NONE:

  573.         return "none";

  574.     case PLUGIN_CATEGORY_SYNTH:

  575.         return "synth";

  576.     case PLUGIN_CATEGORY_DELAY:

  577.         return "delay";

  578.     case PLUGIN_CATEGORY_EQ:

  579.         return "eq";

  580.     case PLUGIN_CATEGORY_FILTER:

  581.         return "filter";

  582.     case PLUGIN_CATEGORY_DISTORTION:

  583.         return "distortion";

  584.     case PLUGIN_CATEGORY_DYNAMICS:

  585.         return "dynamics";

  586.     case PLUGIN_CATEGORY_MODULATOR:

  587.         return "modulator";

  588.     case PLUGIN_CATEGORY_UTILITY:

  589.         return "utility";

  590.     case PLUGIN_CATEGORY_OTHER:

  591.         return "other";

  592.     }

  593. 

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

  595.     return "NONE";

  596. }

  597. 

  598. static inline

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

  600. {

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

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

  603. 

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

  605.         return PLUGIN_CATEGORY_NONE;

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

  607.         return PLUGIN_CATEGORY_SYNTH;

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

  609.         return PLUGIN_CATEGORY_DELAY;

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

  611.         return PLUGIN_CATEGORY_EQ;

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

  613.         return PLUGIN_CATEGORY_FILTER;

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

  615.         return PLUGIN_CATEGORY_DISTORTION;

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

  617.         return PLUGIN_CATEGORY_DYNAMICS;

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

  619.         return PLUGIN_CATEGORY_MODULATOR;

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

  621.         return PLUGIN_CATEGORY_UTILITY;

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

  623.         return PLUGIN_CATEGORY_OTHER;

  624. 

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

  626.     return PLUGIN_CATEGORY_NONE;

  627. }

  628. 

  629. // -----------------------------------------------------------------------

  630. 

  631. static inline

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

  633. {

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

  635. 

  636.     switch (type)

  637.     {

  638.     case PLUGIN_NONE:

  639.         return "NONE";

  640.     case PLUGIN_INTERNAL:

  641.         return "INTERNAL";

  642.     case PLUGIN_LADSPA:

  643.         return "LADSPA";

  644.     case PLUGIN_DSSI:

  645.         return "DSSI";

  646.     case PLUGIN_LV2:

  647.         return "LV2";

  648.     case PLUGIN_VST2:

  649.         return "VST2";

  650.     case PLUGIN_VST3:

  651.         return "VST3";

  652.     case PLUGIN_AU:

  653.         return "AU";

  654.     case PLUGIN_DLS:

  655.         return "DLS";

  656.     case PLUGIN_GIG:

  657.         return "GIG";

  658.     case PLUGIN_SF2:

  659.         return "SF2";

  660.     case PLUGIN_SFZ:

  661.         return "SFZ";

  662.     case PLUGIN_JACK:

  663.         return "JACK";

  664.     case PLUGIN_JSFX:

  665.         return "JSFX";

  666.     }

  667. 

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

  669.     return "NONE";

  670. }

  671. 

  672. static inline

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

  674. {

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

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

  677. 

  678.     CarlaString stype(ctype);

  679. 

  680.     if (stype.isEmpty())

  681.         return PLUGIN_NONE;

  682. 

  683.     stype.toLower();

  684. 

  685.     if (stype == "none")

  686.         return PLUGIN_NONE;

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

  688.         return PLUGIN_INTERNAL;

  689.     if (stype == "ladspa")

  690.         return PLUGIN_LADSPA;

  691.     if (stype == "dssi")

  692.         return PLUGIN_DSSI;

  693.     if (stype == "lv2")

  694.         return PLUGIN_LV2;

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

  696.         return PLUGIN_VST2;

  697.     if (stype == "vst3")

  698.         return PLUGIN_VST3;

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

  700.         return PLUGIN_AU;

  701.     if (stype == "dls")

  702.         return PLUGIN_DLS;

  703.     if (stype == "gig")

  704.         return PLUGIN_GIG;

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

  706.         return PLUGIN_SF2;

  707.     if (stype == "sfz")

  708.         return PLUGIN_SFZ;

  709.     if (stype == "jack")

  710.         return PLUGIN_JACK;

  711.     if (stype == "jsfx")

  712.         return PLUGIN_JSFX;

  713. 

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

  715.     return PLUGIN_NONE;

  716. }

  717. 

  718. // -----------------------------------------------------------------------

  719. 

  720. static inline

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

  722. {

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

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

  725. 

  726.     CarlaString sname(name);

  727. 

  728.     if (sname.isEmpty())

  729.         return PLUGIN_CATEGORY_NONE;

  730. 

  731.     sname.toLower();

  732. 

  733.     // generic tags first

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

  735.         return PLUGIN_CATEGORY_DELAY;

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

  737.         return PLUGIN_CATEGORY_DELAY;

  738. 

  739.     // filter

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

  741.         return PLUGIN_CATEGORY_FILTER;

  742. 

  743.     // distortion

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

  745.         return PLUGIN_CATEGORY_DISTORTION;

  746. 

  747.     // dynamics

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

  749.         return PLUGIN_CATEGORY_DYNAMICS;

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

  751.         return PLUGIN_CATEGORY_DYNAMICS;

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

  753.         return PLUGIN_CATEGORY_DYNAMICS;

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

  755.         return PLUGIN_CATEGORY_DYNAMICS;

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

  757.         return PLUGIN_CATEGORY_DYNAMICS;

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

  759.         return PLUGIN_CATEGORY_DYNAMICS;

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

  761.         return PLUGIN_CATEGORY_DYNAMICS;

  762. 

  763.     // modulator

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

  765.         return PLUGIN_CATEGORY_MODULATOR;

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

  767.         return PLUGIN_CATEGORY_MODULATOR;

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

  769.         return PLUGIN_CATEGORY_MODULATOR;

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

  771.         return PLUGIN_CATEGORY_MODULATOR;

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

  773.         return PLUGIN_CATEGORY_MODULATOR;

  774. 

  775.     // utility

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

  777.         return PLUGIN_CATEGORY_UTILITY;

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

  779.         return PLUGIN_CATEGORY_UTILITY;

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

  781.         return PLUGIN_CATEGORY_UTILITY;

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

  783.         return PLUGIN_CATEGORY_UTILITY;

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

  785.         return PLUGIN_CATEGORY_UTILITY;

  786. 

  787.     // common tags

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

  789.         return PLUGIN_CATEGORY_DELAY;

  790. 

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

  792.         return PLUGIN_CATEGORY_EQ;

  793. 

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

  795.         return PLUGIN_CATEGORY_UTILITY;

  796. 

  797.     // synth

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

  799.         return PLUGIN_CATEGORY_SYNTH;

  800. 

  801.     // other

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

  803.         return PLUGIN_CATEGORY_OTHER;

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

  805.         return PLUGIN_CATEGORY_OTHER;

  806. 

  807.     return PLUGIN_CATEGORY_NONE;

  808. }

  809. 

  810. // -----------------------------------------------------------------------

  811. 

  812. static inline

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

  814. {

  815.     if (options == PLUGIN_OPTIONS_NULL)

  816.         return true;

  817.     if (options & option)

  818.         return true;

  819.     return false;

  820. }

  821. 

  822. static inline

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

  824. {

  825.     if (options == PLUGIN_OPTIONS_NULL)

  826.         return false;

  827.     if (options & option)

  828.         return true;

  829.     return false;

  830. }

  831. 

  832. // -----------------------------------------------------------------------

  833. 

  834. CARLA_BACKEND_END_NAMESPACE

  835. 

  836. #endif // CARLA_BACKEND_UTILS_HPP_INCLUDED