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

416 lines
14KB
Raw Blame History 

  1. /*

  2.  * Carla VST utils

  3.  * Copyright (C) 2011-2014 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_VST_UTILS_HPP_INCLUDED

  19. #define CARLA_VST_UTILS_HPP_INCLUDED

  20. 

  21. #include "CarlaUtils.hpp"

  22. 

  23. // -----------------------------------------------------------------------

  24. // Include fixes

  25. 

  26. // Disable deprecated VST features (NOT)

  27. #define VST_2_4_EXTENSIONS 1

  28. #define VST_FORCE_DEPRECATED 0

  29. 

  30. #include "vestige/aeffectx.h"

  31. #define audioMasterGetOutputSpeakerArrangement audioMasterGetSpeakerArrangement

  32. #define effFlagsProgramChunks (1 << 5)

  33. #define effSetProgramName 4

  34. #define effGetParamLabel 6

  35. #define effGetParamDisplay 7

  36. #define effGetVu 9

  37. #define effEditDraw 16

  38. #define effEditMouse 17

  39. #define effEditKey 18

  40. #define effEditSleep 21

  41. #define effIdentify 22

  42. #define effGetChunk 23

  43. #define effSetChunk 24

  44. #define effCanBeAutomated 26

  45. #define effString2Parameter 27

  46. #define effGetNumProgramCategories 28

  47. #define effGetProgramNameIndexed 29

  48. #define effCopyProgram 30

  49. #define effConnectInput 31

  50. #define effConnectOutput 32

  51. #define effGetInputProperties 33

  52. #define effGetOutputProperties 34

  53. #define effGetCurrentPosition 36

  54. #define effGetDestinationBuffer 37

  55. #define effOfflineNotify 38

  56. #define effOfflinePrepare 39

  57. #define effOfflineRun 40

  58. #define effProcessVarIo 41

  59. #define effSetSpeakerArrangement 42

  60. #define effSetBlockSizeAndSampleRate 43

  61. #define effSetBypass 44

  62. #define effGetErrorText 46

  63. #define effVendorSpecific 50

  64. #define effGetTailSize 52

  65. #define effGetIcon 54

  66. #define effSetViewPosition 55

  67. #define effKeysRequired 57

  68. #define effEditKeyDown 59

  69. #define effEditKeyUp 60

  70. #define effSetEditKnobMode 61

  71. #define effGetMidiProgramName 62

  72. #define effGetCurrentMidiProgram 63

  73. #define effGetMidiProgramCategory 64

  74. #define effHasMidiProgramsChanged 65

  75. #define effGetMidiKeyName 66

  76. #define effGetSpeakerArrangement 69

  77. #define effSetTotalSampleToProcess 73

  78. #define effSetPanLaw 74

  79. #define effBeginLoadBank 75

  80. #define effBeginLoadProgram 76

  81. #define effSetProcessPrecision 77

  82. #define effGetNumMidiInputChannels 78

  83. #define effGetNumMidiOutputChannels 79

  84. #define kPlugCategSynth 2

  85. #define kPlugCategAnalysis 3

  86. #define kPlugCategMastering 4

  87. #define kPlugCategRoomFx 6

  88. #define kPlugCategRestoration 8

  89. #define kPlugCategShell 10

  90. #define kPlugCategGenerator 11

  91. #define kVstAutomationOff 1

  92. #define kVstAutomationReadWrite 4

  93. #define kVstProcessLevelUnknown 0

  94. #define kVstProcessLevelUser 1

  95. #define kVstProcessLevelRealtime 2

  96. #define kVstProcessLevelOffline 4

  97. #define kVstProcessPrecision32 0

  98. #define kVstTransportChanged 1

  99. #define kVstVersion 2400

  100. #define DECLARE_VST_DEPRECATED(idx) idx

  101. #if defined(CARLA_OS_WIN) && defined(__cdecl)

  102. # define VSTCALLBACK __cdecl

  103. #else

  104. # define VSTCALLBACK

  105. #endif

  106. struct ERect {

  107.     int16_t top, left, bottom, right;

  108. };

  109. 

  110. // -----------------------------------------------------------------------

  111. // Plugin callback

  112. 

  113. typedef AEffect* (*VST_Function)(audioMasterCallback);

  114. 

  115. // -----------------------------------------------------------------------

  116. // Check if feature is supported by the plugin

  117. 

  118. static inline

  119. bool vstPluginCanDo(AEffect* const effect, const char* const feature) noexcept

  120. {

  121.     CARLA_SAFE_ASSERT_RETURN(effect != nullptr, false);

  122.     CARLA_SAFE_ASSERT_RETURN(feature != nullptr && feature[0] != '\0', false);

  123. 

  124.     try {

  125.         return (effect->dispatcher(effect, effCanDo, 0, 0, const_cast<char*>(feature), 0.0f) == 1);

  126.     } CARLA_SAFE_EXCEPTION_RETURN("vstPluginCanDo", false);

  127. }

  128. 

  129. // -----------------------------------------------------------------------

  130. // Convert Effect opcode to string

  131. 

  132. static inline

  133. const char* vstEffectOpcode2str(const int32_t opcode) noexcept

  134. {

  135.     switch (opcode)

  136.     {

  137.     case effOpen:

  138.         return "effOpen";

  139.     case effClose:

  140.         return "effClose";

  141.     case effSetProgram:

  142.         return "effSetProgram";

  143.     case effGetProgram:

  144.         return "effGetProgram";

  145.     case effSetProgramName:

  146.         return "effSetProgramName";

  147.     case effGetProgramName:

  148.         return "effGetProgramName";

  149.     case effGetParamLabel:

  150.         return "effGetParamLabel";

  151.     case effGetParamDisplay:

  152.         return "effGetParamDisplay";

  153.     case effGetParamName:

  154.         return "effGetParamName";

  155.     case DECLARE_VST_DEPRECATED(effGetVu):

  156.         return "effGetVu";

  157.     case effSetSampleRate:

  158.         return "effSetSampleRate";

  159.     case effSetBlockSize:

  160.         return "effSetBlockSize";

  161.     case effMainsChanged:

  162.         return "effMainsChanged";

  163.     case effEditGetRect:

  164.         return "effEditGetRect";

  165.     case effEditOpen:

  166.         return "effEditOpen";

  167.     case effEditClose:

  168.         return "effEditClose";

  169.     case DECLARE_VST_DEPRECATED(effEditDraw):

  170.         return "effEditDraw";

  171.     case DECLARE_VST_DEPRECATED(effEditMouse):

  172.         return "effEditMouse";

  173.     case DECLARE_VST_DEPRECATED(effEditKey):

  174.         return "effEditKey";

  175.     case effEditIdle:

  176.         return "effEditIdle";

  177.     case DECLARE_VST_DEPRECATED(effEditTop):

  178.         return "effEditTop";

  179.     case DECLARE_VST_DEPRECATED(effEditSleep):

  180.         return "effEditSleep";

  181.     case DECLARE_VST_DEPRECATED(effIdentify):

  182.         return "effIdentify";

  183.     case effGetChunk:

  184.         return "effGetChunk";

  185.     case effSetChunk:

  186.         return "effSetChunk";

  187.     case effProcessEvents:

  188.         return "effProcessEvents";

  189.     case effCanBeAutomated:

  190.         return "effCanBeAutomated";

  191.     case effString2Parameter:

  192.         return "effString2Parameter";

  193.     case DECLARE_VST_DEPRECATED(effGetNumProgramCategories):

  194.         return "effGetNumProgramCategories";

  195.     case effGetProgramNameIndexed:

  196.         return "effGetProgramNameIndexed";

  197.     case DECLARE_VST_DEPRECATED(effCopyProgram):

  198.         return "effCopyProgram";

  199.     case DECLARE_VST_DEPRECATED(effConnectInput):

  200.         return "effConnectInput";

  201.     case DECLARE_VST_DEPRECATED(effConnectOutput):

  202.         return "effConnectOutput";

  203.     case effGetInputProperties:

  204.         return "effGetInputProperties";

  205.     case effGetOutputProperties:

  206.         return "effGetOutputProperties";

  207.     case effGetPlugCategory:

  208.         return "effGetPlugCategory";

  209.     case DECLARE_VST_DEPRECATED(effGetCurrentPosition):

  210.         return "effGetCurrentPosition";

  211.     case DECLARE_VST_DEPRECATED(effGetDestinationBuffer):

  212.         return "effGetDestinationBuffer";

  213.     case effOfflineNotify:

  214.         return "effOfflineNotify";

  215.     case effOfflinePrepare:

  216.         return "effOfflinePrepare";

  217.     case effOfflineRun:

  218.         return "effOfflineRun";

  219.     case effProcessVarIo:

  220.         return "effProcessVarIo";

  221.     case effSetSpeakerArrangement:

  222.         return "effSetSpeakerArrangement";

  223.     case DECLARE_VST_DEPRECATED(effSetBlockSizeAndSampleRate):

  224.         return "effSetBlockSizeAndSampleRate";

  225.     case effSetBypass:

  226.         return "effSetBypass";

  227.     case effGetEffectName:

  228.         return "effGetEffectName";

  229.     case DECLARE_VST_DEPRECATED(effGetErrorText):

  230.         return "effGetErrorText";

  231.     case effGetVendorString:

  232.         return "effGetVendorString";

  233.     case effGetProductString:

  234.         return "effGetProductString";

  235.     case effGetVendorVersion:

  236.         return "effGetVendorVersion";

  237.     case effVendorSpecific:

  238.         return "effVendorSpecific";

  239.     case effCanDo:

  240.         return "effCanDo";

  241.     case effGetTailSize:

  242.         return "effGetTailSize";

  243.     case DECLARE_VST_DEPRECATED(effIdle):

  244.         return "effIdle";

  245.     case DECLARE_VST_DEPRECATED(effGetIcon):

  246.         return "effGetIcon";

  247.     case DECLARE_VST_DEPRECATED(effSetViewPosition):

  248.         return "effSetViewPosition";

  249.     case effGetParameterProperties:

  250.         return "effGetParameterProperties";

  251.     case DECLARE_VST_DEPRECATED(effKeysRequired):

  252.         return "effKeysRequired";

  253.     case effGetVstVersion:

  254.         return "effGetVstVersion";

  255.     case effEditKeyDown:

  256.         return "effEditKeyDown";

  257.     case effEditKeyUp:

  258.         return "effEditKeyUp";

  259.     case effSetEditKnobMode:

  260.         return "effSetEditKnobMode";

  261.     case effGetMidiProgramName:

  262.         return "effGetMidiProgramName";

  263.     case effGetCurrentMidiProgram:

  264.         return "effGetCurrentMidiProgram";

  265.     case effGetMidiProgramCategory:

  266.         return "effGetMidiProgramCategory";

  267.     case effHasMidiProgramsChanged:

  268.         return "effHasMidiProgramsChanged";

  269.     case effGetMidiKeyName:

  270.         return "effGetMidiKeyName";

  271.     case effBeginSetProgram:

  272.         return "effBeginSetProgram";

  273.     case effEndSetProgram:

  274.         return "effEndSetProgram";

  275.     case effGetSpeakerArrangement:

  276.         return "effGetSpeakerArrangement";

  277.     case effShellGetNextPlugin:

  278.         return "effShellGetNextPlugin";

  279.     case effStartProcess:

  280.         return "effStartProcess";

  281.     case effStopProcess:

  282.         return "effStopProcess";

  283.     case effSetTotalSampleToProcess:

  284.         return "effSetTotalSampleToProcess";

  285.     case effSetPanLaw:

  286.         return "effSetPanLaw";

  287.     case effBeginLoadBank:

  288.         return "effBeginLoadBank";

  289.     case effBeginLoadProgram:

  290.         return "effBeginLoadProgram";

  291.     case effSetProcessPrecision:

  292.         return "effSetProcessPrecision";

  293.     case effGetNumMidiInputChannels:

  294.         return "effGetNumMidiInputChannels";

  295.     case effGetNumMidiOutputChannels:

  296.         return "effGetNumMidiOutputChannels";

  297.     default:

  298.         return "unknown";

  299.     }

  300. }

  301. 

  302. // -----------------------------------------------------------------------

  303. // Convert Host/Master opcode to string

  304. 

  305. static inline

  306. const char* vstMasterOpcode2str(const int32_t opcode) noexcept

  307. {

  308.     switch (opcode)

  309.     {

  310.     case audioMasterAutomate:

  311.         return "audioMasterAutomate";

  312.     case audioMasterVersion:

  313.         return "audioMasterVersion";

  314.     case audioMasterCurrentId:

  315.         return "audioMasterCurrentId";

  316.     case audioMasterIdle:

  317.         return "audioMasterIdle";

  318.     case DECLARE_VST_DEPRECATED(audioMasterPinConnected):

  319.         return "audioMasterPinConnected";

  320.     case DECLARE_VST_DEPRECATED(audioMasterWantMidi):

  321.         return "audioMasterWantMidi";

  322.     case audioMasterGetTime:

  323.         return "audioMasterGetTime";

  324.     case audioMasterProcessEvents:

  325.         return "audioMasterProcessEvents";

  326.     case DECLARE_VST_DEPRECATED(audioMasterSetTime):

  327.         return "audioMasterSetTime";

  328.     case DECLARE_VST_DEPRECATED(audioMasterTempoAt):

  329.         return "audioMasterTempoAt";

  330.     case DECLARE_VST_DEPRECATED(audioMasterGetNumAutomatableParameters):

  331.         return "audioMasterGetNumAutomatableParameters";

  332.     case DECLARE_VST_DEPRECATED(audioMasterGetParameterQuantization):

  333.         return "audioMasterGetParameterQuantization";

  334.     case audioMasterIOChanged:

  335.         return "audioMasterIOChanged";

  336.     case DECLARE_VST_DEPRECATED(audioMasterNeedIdle):

  337.         return "audioMasterNeedIdle";

  338.     case audioMasterSizeWindow:

  339.         return "audioMasterSizeWindow";

  340.     case audioMasterGetSampleRate:

  341.         return "audioMasterGetSampleRate";

  342.     case audioMasterGetBlockSize:

  343.         return "audioMasterGetBlockSize";

  344.     case audioMasterGetInputLatency:

  345.         return "audioMasterGetInputLatency";

  346.     case audioMasterGetOutputLatency:

  347.         return "audioMasterGetOutputLatency";

  348.     case DECLARE_VST_DEPRECATED(audioMasterGetPreviousPlug):

  349.         return "audioMasterGetPreviousPlug";

  350.     case DECLARE_VST_DEPRECATED(audioMasterGetNextPlug):

  351.         return "audioMasterGetNextPlug";

  352.     case DECLARE_VST_DEPRECATED(audioMasterWillReplaceOrAccumulate):

  353.         return "audioMasterWillReplaceOrAccumulate";

  354.     case audioMasterGetCurrentProcessLevel:

  355.         return "audioMasterGetCurrentProcessLevel";

  356.     case audioMasterGetAutomationState:

  357.         return "audioMasterGetAutomationState";

  358.     case audioMasterOfflineStart:

  359.         return "audioMasterOfflineStart";

  360.     case audioMasterOfflineRead:

  361.         return "audioMasterOfflineRead";

  362.     case audioMasterOfflineWrite:

  363.         return "audioMasterOfflineWrite";

  364.     case audioMasterOfflineGetCurrentPass:

  365.         return "audioMasterOfflineGetCurrentPass";

  366.     case audioMasterOfflineGetCurrentMetaPass:

  367.         return "audioMasterOfflineGetCurrentMetaPass";

  368.     case DECLARE_VST_DEPRECATED(audioMasterSetOutputSampleRate):

  369.         return "audioMasterSetOutputSampleRate";

  370.     case DECLARE_VST_DEPRECATED(audioMasterGetOutputSpeakerArrangement):

  371.         return "audioMasterGetOutputSpeakerArrangement";

  372.     case audioMasterGetVendorString:

  373.         return "audioMasterGetVendorString";

  374.     case audioMasterGetProductString:

  375.         return "audioMasterGetProductString";

  376.     case audioMasterGetVendorVersion:

  377.         return "audioMasterGetVendorVersion";

  378.     case audioMasterVendorSpecific:

  379.         return "audioMasterVendorSpecific";

  380.     case DECLARE_VST_DEPRECATED(audioMasterSetIcon):

  381.         return "audioMasterSetIcon";

  382.     case audioMasterCanDo:

  383.         return "audioMasterCanDo";

  384.     case audioMasterGetLanguage:

  385.         return "audioMasterGetLanguage";

  386.     case DECLARE_VST_DEPRECATED(audioMasterOpenWindow):

  387.         return "audioMasterOpenWindow";

  388.     case DECLARE_VST_DEPRECATED(audioMasterCloseWindow):

  389.         return "audioMasterCloseWindow";

  390.     case audioMasterGetDirectory:

  391.         return "audioMasterGetDirectory";

  392.     case audioMasterUpdateDisplay:

  393.         return "audioMasterUpdateDisplay";

  394.     case audioMasterBeginEdit:

  395.         return "audioMasterBeginEdit";

  396.     case audioMasterEndEdit:

  397.         return "audioMasterEndEdit";

  398.     case audioMasterOpenFileSelector:

  399.         return "audioMasterOpenFileSelector";

  400.     case audioMasterCloseFileSelector:

  401.         return "audioMasterCloseFileSelector";

  402.     case DECLARE_VST_DEPRECATED(audioMasterEditFile):

  403.         return "audioMasterEditFile";

  404.     case DECLARE_VST_DEPRECATED(audioMasterGetChunkFile):

  405.         return "audioMasterGetChunkFile";

  406.     case DECLARE_VST_DEPRECATED(audioMasterGetInputSpeakerArrangement):

  407.         return "audioMasterGetInputSpeakerArrangement";

  408.     default:

  409.         return "unknown";

  410.     }

  411. }

  412. 

  413. // -----------------------------------------------------------------------

  414. 

  415. #endif // CARLA_VST_UTILS_HPP_INCLUDED