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

474 lines
14KB
Raw Blame History 

  1. /*

  2.  * Carla VST utils

  3.  * Copyright (C) 2011-2013 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. // Define __cdecl if needed

  27. #ifndef CARLA_OS_WIN

  28. # ifndef __cdecl

  29. #  define __cdecl

  30. # endif

  31. #endif

  32. 

  33. // Disable deprecated VST features (NOT)

  34. #define VST_2_4_EXTENSIONS 1

  35. #define VST_FORCE_DEPRECATED 0

  36. 

  37. #ifdef VESTIGE_HEADER

  38. #include "vestige/aeffectx.h"

  39. #define audioMasterGetOutputSpeakerArrangement audioMasterGetSpeakerArrangement

  40. #define effFlagsProgramChunks (1 << 5)

  41. #define effSetProgramName 4

  42. #define effGetParamLabel 6

  43. #define effGetParamDisplay 7

  44. #define effGetVu 9

  45. #define effEditDraw 16

  46. #define effEditMouse 17

  47. #define effEditKey 18

  48. #define effEditSleep 21

  49. #define effIdentify 22

  50. #define effGetChunk 23

  51. #define effSetChunk 24

  52. #define effCanBeAutomated 26

  53. #define effString2Parameter 27

  54. #define effGetNumProgramCategories 28

  55. #define effGetProgramNameIndexed 29

  56. #define effCopyProgram 30

  57. #define effConnectInput 31

  58. #define effConnectOutput 32

  59. #define effGetInputProperties 33

  60. #define effGetOutputProperties 34

  61. #define effGetPlugCategory 35

  62. #define effGetCurrentPosition 36

  63. #define effGetDestinationBuffer 37

  64. #define effOfflineNotify 38

  65. #define effOfflinePrepare 39

  66. #define effOfflineRun 40

  67. #define effProcessVarIo 41

  68. #define effSetSpeakerArrangement 42

  69. #define effSetBlockSizeAndSampleRate 43

  70. #define effSetBypass 44

  71. #define effGetErrorText 46

  72. #define effVendorSpecific 50

  73. #define effGetTailSize 52

  74. #define effIdle 53

  75. #define effGetIcon 54

  76. #define effSetViewPosition 55

  77. #define effKeysRequired 57

  78. #define effEditKeyDown 59

  79. #define effEditKeyUp 60

  80. #define effSetEditKnobMode 61

  81. #define effGetMidiProgramName 62

  82. #define effGetCurrentMidiProgram 63

  83. #define effGetMidiProgramCategory 64

  84. #define effHasMidiProgramsChanged 65

  85. #define effGetMidiKeyName 66

  86. #define effBeginSetProgram 67

  87. #define effEndSetProgram 68

  88. #define effGetSpeakerArrangement 69

  89. #define effShellGetNextPlugin 70

  90. #define effStartProcess 71

  91. #define effStopProcess 72

  92. #define effSetTotalSampleToProcess 73

  93. #define effSetPanLaw 74

  94. #define effBeginLoadBank 75

  95. #define effBeginLoadProgram 76

  96. #define effSetProcessPrecision 77

  97. #define effGetNumMidiInputChannels 78

  98. #define effGetNumMidiOutputChannels 79

  99. #define kPlugCategSynth 2

  100. #define kPlugCategAnalysis 3

  101. #define kPlugCategMastering 4

  102. #define kPlugCategRoomFx 6

  103. #define kPlugCategRestoration 8

  104. #define kPlugCategShell 10

  105. #define kPlugCategGenerator 11

  106. #define kVstAutomationOff 1

  107. #define kVstAutomationReadWrite 4

  108. #define kVstProcessLevelUnknown 0

  109. #define kVstProcessLevelUser 1

  110. #define kVstProcessLevelRealtime 2

  111. #define kVstProcessLevelOffline 4

  112. #define kVstProcessPrecision32 0

  113. #define kVstTransportChanged 1

  114. #define kVstVersion 2400

  115. #define DECLARE_VST_DEPRECATED(idx) idx

  116. #define VSTCALLBACK __cdecl

  117. struct ERect {

  118.     int16_t top, left, bottom, right;

  119. };

  120. struct VstTimeInfo_R {

  121.     double samplePos, sampleRate, nanoSeconds, ppqPos, tempo, barStartPos, cycleStartPos, cycleEndPos;

  122.     int32_t timeSigNumerator, timeSigDenominator, smpteOffset, smpteFrameRate, samplesToNextClock, flags;

  123. };

  124. #else

  125. #ifndef CARLA_OS_MAC

  126. # undef TARGET_API_MAC_CARBON

  127. # define TARGET_API_MAC_CARBON 0

  128. #endif

  129. #undef VST_64BIT_PLATFORM

  130. #define VST_64BIT_PLATFORM (defined(_WIN64) || defined(__LP64__) || defined (_LP64))

  131. #include "vst/pluginterfaces/vst2.x/aeffectx.h"

  132. typedef VstTimeInfo VstTimeInfo_R;

  133. #endif

  134. 

  135. // -----------------------------------------------------------------------

  136. // Plugin callback

  137. 

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

  139. 

  140. // -----------------------------------------------------------------------

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

  142. 

  143. static inline

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

  145. {

  146.     try {

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

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

  149. }

  150. 

  151. // -----------------------------------------------------------------------

  152. // Convert Effect opcode to string

  153. 

  154. static inline

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

  156. {

  157.     switch (opcode)

  158.     {

  159.     case effOpen:

  160.         return "effOpen";

  161.     case effClose:

  162.         return "effClose";

  163.     case effSetProgram:

  164.         return "effSetProgram";

  165.     case effGetProgram:

  166.         return "effGetProgram";

  167.     case effSetProgramName:

  168.         return "effSetProgramName";

  169.     case effGetProgramName:

  170.         return "effGetProgramName";

  171.     case effGetParamLabel:

  172.         return "effGetParamLabel";

  173.     case effGetParamDisplay:

  174.         return "effGetParamDisplay";

  175.     case effGetParamName:

  176.         return "effGetParamName";

  177. #if ! VST_FORCE_DEPRECATED

  178.     case effGetVu:

  179.         return "effGetVu";

  180. #endif

  181.     case effSetSampleRate:

  182.         return "effSetSampleRate";

  183.     case effSetBlockSize:

  184.         return "effSetBlockSize";

  185.     case effMainsChanged:

  186.         return "effMainsChanged";

  187.     case effEditGetRect:

  188.         return "effEditGetRect";

  189.     case effEditOpen:

  190.         return "effEditOpen";

  191.     case effEditClose:

  192.         return "effEditClose";

  193. #if ! VST_FORCE_DEPRECATED

  194.     case effEditDraw:

  195.         return "effEditDraw";

  196.     case effEditMouse:

  197.         return "effEditMouse";

  198.     case effEditKey:

  199.         return "effEditKey";

  200. #endif

  201.     case effEditIdle:

  202.         return "effEditIdle";

  203. #if ! VST_FORCE_DEPRECATED

  204.     case effEditTop:

  205.         return "effEditTop";

  206.     case effEditSleep:

  207.         return "effEditSleep";

  208.     case effIdentify:

  209.         return "effIdentify";

  210. #endif

  211.     case effGetChunk:

  212.         return "effGetChunk";

  213.     case effSetChunk:

  214.         return "effSetChunk";

  215.     case effProcessEvents:

  216.         return "effProcessEvents";

  217.     case effCanBeAutomated:

  218.         return "effCanBeAutomated";

  219.     case effString2Parameter:

  220.         return "effString2Parameter";

  221. #if ! VST_FORCE_DEPRECATED

  222.     case effGetNumProgramCategories:

  223.         return "effGetNumProgramCategories";

  224. #endif

  225.     case effGetProgramNameIndexed:

  226.         return "effGetProgramNameIndexed";

  227. #if ! VST_FORCE_DEPRECATED

  228.     case effCopyProgram:

  229.         return "effCopyProgram";

  230.     case effConnectInput:

  231.         return "effConnectInput";

  232.     case effConnectOutput:

  233.         return "effConnectOutput";

  234. #endif

  235.     case effGetInputProperties:

  236.         return "effGetInputProperties";

  237.     case effGetOutputProperties:

  238.         return "effGetOutputProperties";

  239.     case effGetPlugCategory:

  240.         return "effGetPlugCategory";

  241. #if ! VST_FORCE_DEPRECATED

  242.     case effGetCurrentPosition:

  243.         return "effGetCurrentPosition";

  244.     case effGetDestinationBuffer:

  245.         return "effGetDestinationBuffer";

  246. #endif

  247.     case effOfflineNotify:

  248.         return "effOfflineNotify";

  249.     case effOfflinePrepare:

  250.         return "effOfflinePrepare";

  251.     case effOfflineRun:

  252.         return "effOfflineRun";

  253.     case effProcessVarIo:

  254.         return "effProcessVarIo";

  255.     case effSetSpeakerArrangement:

  256.         return "effSetSpeakerArrangement";

  257. #if ! VST_FORCE_DEPRECATED

  258.     case effSetBlockSizeAndSampleRate:

  259.         return "effSetBlockSizeAndSampleRate";

  260. #endif

  261.     case effSetBypass:

  262.         return "effSetBypass";

  263.     case effGetEffectName:

  264.         return "effGetEffectName";

  265. #if ! VST_FORCE_DEPRECATED

  266.     case effGetErrorText:

  267.         return "effGetErrorText";

  268. #endif

  269.     case effGetVendorString:

  270.         return "effGetVendorString";

  271.     case effGetProductString:

  272.         return "effGetProductString";

  273.     case effGetVendorVersion:

  274.         return "effGetVendorVersion";

  275.     case effVendorSpecific:

  276.         return "effVendorSpecific";

  277.     case effCanDo:

  278.         return "effCanDo";

  279.     case effGetTailSize:

  280.         return "effGetTailSize";

  281. #if ! VST_FORCE_DEPRECATED

  282.     case effIdle:

  283.         return "effIdle";

  284.     case effGetIcon:

  285.         return "effGetIcon";

  286.     case effSetViewPosition:

  287.         return "effSetViewPosition";

  288. #endif

  289.     case effGetParameterProperties:

  290.         return "effGetParameterProperties";

  291. #if ! VST_FORCE_DEPRECATED

  292.     case effKeysRequired:

  293.         return "effKeysRequired";

  294. #endif

  295.     case effGetVstVersion:

  296.         return "effGetVstVersion";

  297.     case effEditKeyDown:

  298.         return "effEditKeyDown";

  299.     case effEditKeyUp:

  300.         return "effEditKeyUp";

  301.     case effSetEditKnobMode:

  302.         return "effSetEditKnobMode";

  303.     case effGetMidiProgramName:

  304.         return "effGetMidiProgramName";

  305.     case effGetCurrentMidiProgram:

  306.         return "effGetCurrentMidiProgram";

  307.     case effGetMidiProgramCategory:

  308.         return "effGetMidiProgramCategory";

  309.     case effHasMidiProgramsChanged:

  310.         return "effHasMidiProgramsChanged";

  311.     case effGetMidiKeyName:

  312.         return "effGetMidiKeyName";

  313.     case effBeginSetProgram:

  314.         return "effBeginSetProgram";

  315.     case effEndSetProgram:

  316.         return "effEndSetProgram";

  317.     case effGetSpeakerArrangement:

  318.         return "effGetSpeakerArrangement";

  319.     case effShellGetNextPlugin:

  320.         return "effShellGetNextPlugin";

  321.     case effStartProcess:

  322.         return "effStartProcess";

  323.     case effStopProcess:

  324.         return "effStopProcess";

  325.     case effSetTotalSampleToProcess:

  326.         return "effSetTotalSampleToProcess";

  327.     case effSetPanLaw:

  328.         return "effSetPanLaw";

  329.     case effBeginLoadBank:

  330.         return "effBeginLoadBank";

  331.     case effBeginLoadProgram:

  332.         return "effBeginLoadProgram";

  333.     case effSetProcessPrecision:

  334.         return "effSetProcessPrecision";

  335.     case effGetNumMidiInputChannels:

  336.         return "effGetNumMidiInputChannels";

  337.     case effGetNumMidiOutputChannels:

  338.         return "effGetNumMidiOutputChannels";

  339.     default:

  340.         return "unknown";

  341.     }

  342. }

  343. 

  344. // -----------------------------------------------------------------------

  345. // Convert Host/Master opcode to string

  346. 

  347. static inline

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

  349. {

  350.     switch (opcode)

  351.     {

  352.     case audioMasterAutomate:

  353.         return "audioMasterAutomate";

  354.     case audioMasterVersion:

  355.         return "audioMasterVersion";

  356.     case audioMasterCurrentId:

  357.         return "audioMasterCurrentId";

  358.     case audioMasterIdle:

  359.         return "audioMasterIdle";

  360. #if ! VST_FORCE_DEPRECATED

  361.     case audioMasterPinConnected:

  362.         return "audioMasterPinConnected";

  363.     case audioMasterWantMidi:

  364.         return "audioMasterWantMidi";

  365. #endif

  366.     case audioMasterGetTime:

  367.         return "audioMasterGetTime";

  368.     case audioMasterProcessEvents:

  369.         return "audioMasterProcessEvents";

  370. #if ! VST_FORCE_DEPRECATED

  371.     case audioMasterSetTime:

  372.         return "audioMasterSetTime";

  373.     case audioMasterTempoAt:

  374.         return "audioMasterTempoAt";

  375.     case audioMasterGetNumAutomatableParameters:

  376.         return "audioMasterGetNumAutomatableParameters";

  377.     case audioMasterGetParameterQuantization:

  378.         return "audioMasterGetParameterQuantization";

  379. #endif

  380.     case audioMasterIOChanged:

  381.         return "audioMasterIOChanged";

  382. #if ! VST_FORCE_DEPRECATED

  383.     case audioMasterNeedIdle:

  384.         return "audioMasterNeedIdle";

  385. #endif

  386.     case audioMasterSizeWindow:

  387.         return "audioMasterSizeWindow";

  388.     case audioMasterGetSampleRate:

  389.         return "audioMasterGetSampleRate";

  390.     case audioMasterGetBlockSize:

  391.         return "audioMasterGetBlockSize";

  392.     case audioMasterGetInputLatency:

  393.         return "audioMasterGetInputLatency";

  394.     case audioMasterGetOutputLatency:

  395.         return "audioMasterGetOutputLatency";

  396. #if ! VST_FORCE_DEPRECATED

  397.     case audioMasterGetPreviousPlug:

  398.         return "audioMasterGetPreviousPlug";

  399.     case audioMasterGetNextPlug:

  400.         return "audioMasterGetNextPlug";

  401.     case audioMasterWillReplaceOrAccumulate:

  402.         return "audioMasterWillReplaceOrAccumulate";

  403. #endif

  404.     case audioMasterGetCurrentProcessLevel:

  405.         return "audioMasterGetCurrentProcessLevel";

  406.     case audioMasterGetAutomationState:

  407.         return "audioMasterGetAutomationState";

  408.     case audioMasterOfflineStart:

  409.         return "audioMasterOfflineStart";

  410.     case audioMasterOfflineRead:

  411.         return "audioMasterOfflineRead";

  412.     case audioMasterOfflineWrite:

  413.         return "audioMasterOfflineWrite";

  414.     case audioMasterOfflineGetCurrentPass:

  415.         return "audioMasterOfflineGetCurrentPass";

  416.     case audioMasterOfflineGetCurrentMetaPass:

  417.         return "audioMasterOfflineGetCurrentMetaPass";

  418. #if ! VST_FORCE_DEPRECATED

  419.     case audioMasterSetOutputSampleRate:

  420.         return "audioMasterSetOutputSampleRate";

  421.     case audioMasterGetOutputSpeakerArrangement:

  422.         return "audioMasterGetOutputSpeakerArrangement";

  423. #endif

  424.     case audioMasterGetVendorString:

  425.         return "audioMasterGetVendorString";

  426.     case audioMasterGetProductString:

  427.         return "audioMasterGetProductString";

  428.     case audioMasterGetVendorVersion:

  429.         return "audioMasterGetVendorVersion";

  430.     case audioMasterVendorSpecific:

  431.         return "audioMasterVendorSpecific";

  432. #if ! VST_FORCE_DEPRECATED

  433.     case audioMasterSetIcon:

  434.         return "audioMasterSetIcon";

  435. #endif

  436.     case audioMasterCanDo:

  437.         return "audioMasterCanDo";

  438.     case audioMasterGetLanguage:

  439.         return "audioMasterGetLanguage";

  440. #if ! VST_FORCE_DEPRECATED

  441.     case audioMasterOpenWindow:

  442.         return "audioMasterOpenWindow";

  443.     case audioMasterCloseWindow:

  444.         return "audioMasterCloseWindow";

  445. #endif

  446.     case audioMasterGetDirectory:

  447.         return "audioMasterGetDirectory";

  448.     case audioMasterUpdateDisplay:

  449.         return "audioMasterUpdateDisplay";

  450.     case audioMasterBeginEdit:

  451.         return "audioMasterBeginEdit";

  452.     case audioMasterEndEdit:

  453.         return "audioMasterEndEdit";

  454.     case audioMasterOpenFileSelector:

  455.         return "audioMasterOpenFileSelector";

  456.     case audioMasterCloseFileSelector:

  457.         return "audioMasterCloseFileSelector";

  458. #if ! VST_FORCE_DEPRECATED

  459.     case audioMasterEditFile:

  460.         return "audioMasterEditFile";

  461.     case audioMasterGetChunkFile:

  462.         return "audioMasterGetChunkFile";

  463.     case audioMasterGetInputSpeakerArrangement:

  464.         return "audioMasterGetInputSpeakerArrangement";

  465. #endif

  466.     default:

  467.         return "unknown";

  468.     }

  469. }

  470. 

  471. // -----------------------------------------------------------------------

  472. 

  473. #endif // CARLA_VST_UTILS_HPP_INCLUDED