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.
2054 Commits
16 Branches
275MB
Tree: 4310ff30d7
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '4310ff30d7'
${ noResults }
Carla/source/utils/CarlaBridgeUtils.hpp

288 lines
11KB
Raw Blame History 

  1. /*

  2.  * Carla Bridge utils

  3.  * Copyright (C) 2013-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_BRIDGE_UTILS_HPP_INCLUDED

  19. #define CARLA_BRIDGE_UTILS_HPP_INCLUDED

  20. 

  21. #include "CarlaRingBuffer.hpp"

  22. 

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

  24. 

  25. // carla-plugin receives these via osc

  26. enum PluginBridgeOscInfoType {

  27.     kPluginBridgeOscNull = 0,

  28.     kPluginBridgeOscPong,

  29.     kPluginBridgeOscPluginInfo1,          // uuuuh => category, hints, optionsAvailable, optionsEnabled, uniqueId

  30.     kPluginBridgeOscPluginInfo2,          // ssss  => realName, label, maker, copyright

  31.     kPluginBridgeOscAudioCount,           // uu    => ins, outs

  32.     kPluginBridgeOscMidiCount,            // uu    => ins, outs

  33.     kPluginBridgeOscParameterCount,       // uu    => ins, outs

  34.     kPluginBridgeOscProgramCount,         // u     => count

  35.     kPluginBridgeOscMidiProgramCount,     // u     => count

  36.     kPluginBridgeOscParameterData1,       // uiuui => index, rindex, type, hints, cc

  37.     kPluginBridgeOscParameterData2,       // uss   => index, name, unit

  38.     kPluginBridgeOscParameterRanges1,     // ufff  => index, def, min, max

  39.     kPluginBridgeOscParameterRanges2,     // ufff  => index, step, stepSmall, stepLarge

  40.     kPluginBridgeOscParameterValue,       // uf    => index, value

  41.     kPluginBridgeOscDefaultValue,         // uf    => index, value

  42.     kPluginBridgeOscCurrentProgram,       // i     => index

  43.     kPluginBridgeOscCurrentMidiProgram,   // i     => index

  44.     kPluginBridgeOscProgramName,          // us    => index, name

  45.     kPluginBridgeOscMidiProgramData,      // uuus  => index, bank, program, name

  46.     kPluginBridgeOscConfigure,            // ss    => key, value

  47.     kPluginBridgeOscSetCustomData,        // sss   => type, key, value

  48.     kPluginBridgeOscSetChunkDataFile,     // s     => chunkFile

  49.     kPluginBridgeOscLatency,              // u     => value

  50.     kPluginBridgeOscReady,

  51.     kPluginBridgeOscError

  52. };

  53. 

  54. // carla-plugin sends these during RT

  55. enum PluginBridgeRtOpcode {

  56.     kPluginBridgeRtNull = 0,

  57.     kPluginBridgeRtSetAudioPool,   // ulong/ptr

  58.     kPluginBridgeRtSetParameter,   // uint, float

  59.     kPluginBridgeRtMidiData,       // uint/frame, uint/size, char[]

  60.     kPluginBridgeRtMidiBank,       // uint/frame, byte/chan, ushort

  61.     kPluginBridgeRtMidiProgram,    // uint/frame, byte/chan, ushort

  62.     kPluginBridgeRtAllSoundOff,    // uint/frame

  63.     kPluginBridgeRtAllNotesOff,    // uint/frame

  64.     kPluginBridgeRtProcess

  65. };

  66. 

  67. // carla-plugin sends these during non-RT

  68. enum PluginBridgeNonRtOpcode {

  69.     kPluginBridgeNonRtNull = 0,

  70.     kPluginBridgeNonRtPing,

  71.     kPluginBridgeNonRtActivate,

  72.     kPluginBridgeNonRtDeactivate,

  73.     kPluginBridgeNonRtSetBufferSize,           // uint

  74.     kPluginBridgeNonRtSetSampleRate,           // double

  75.     kPluginBridgeNonRtSetOffline,

  76.     kPluginBridgeNonRtSetOnline,

  77.     kPluginBridgeNonRtSetParameterValue,       // uint, float

  78.     kPluginBridgeNonRtSetProgram,              // int

  79.     kPluginBridgeNonRtSetMidiProgram,          // int

  80.     kPluginBridgeNonRtSetCustomData,           // uint/size, str, uint/size, str, uint/size, str

  81.     kPluginBridgeNonRtSetChunkDataFile,        // uint/size, str/file

  82.     kPluginBridgeNonRtSetCtrlChannel,          // short

  83.     kPluginBridgeNonRtSetOption,               // uint/option, bool

  84.     kPluginBridgeNonRtPrepareForSave,

  85.     kPluginBridgeNonRtShowUI,

  86.     kPluginBridgeNonRtHideUI,

  87.     kPluginBridgeNonRtUiParameterChange,       // uint, float

  88.     kPluginBridgeNonRtUiProgramChange,         // uint

  89.     kPluginBridgeNonRtUiMidiProgramChange,     // uint

  90.     kPluginBridgeNonRtUiNoteOn,                // byte, byte, byte

  91.     kPluginBridgeNonRtUiNoteOff,               // byte, byte

  92.     kPluginBridgeNonRtQuit

  93. };

  94. 

  95. // -----------------------------------------------------------------------

  96. 

  97. const char* const CARLA_BRIDGE_MSG_HIDE_GUI = "CarlaBridgeHideGUI"; //!< Plugin -> Host configure, tells host GUI is now hidden

  98. const char* const CARLA_BRIDGE_MSG_SAVED    = "CarlaBridgeSaved";   //!< Plugin -> Host configure, tells host state is saved

  99. 

  100. // -----------------------------------------------------------------------

  101. 

  102. struct BridgeSemaphore {

  103.     union {

  104.         void* server;

  105.         char _padServer[32];

  106.     };

  107.     union {

  108.         void* client;

  109.         char _padClient[32];

  110.     };

  111. };

  112. 

  113. struct BridgeTimeInfo {

  114.     bool playing;

  115.     uint64_t frame;

  116.     uint64_t usecs;

  117.     uint     valid;

  118.     // bbt

  119.     int32_t bar, beat, tick;

  120.     float beatsPerBar, beatType;

  121.     double barStartTick, ticksPerBeat, beatsPerMinute;

  122. };

  123. 

  124. struct BridgeRtData {

  125.     BridgeSemaphore sem;

  126.     BridgeTimeInfo timeInfo;

  127.     StackBuffer ringBuffer;

  128. };

  129. 

  130. struct BridgeNonRtData {

  131.     BigStackBuffer ringBuffer;

  132. };

  133. 

  134. // -----------------------------------------------------------------------

  135. 

  136. static inline

  137. const char* PluginBridgeOscInfoType2str(const PluginBridgeOscInfoType type) noexcept

  138. {

  139.     switch (type)

  140.     {

  141.     case kPluginBridgeOscNull:

  142.         return "kPluginBridgeOscNull";

  143.     case kPluginBridgeOscPong:

  144.         return "kPluginBridgeOscPong";

  145.     case kPluginBridgeOscPluginInfo1:

  146.         return "kPluginBridgeOscPluginInfo1";

  147.     case kPluginBridgeOscPluginInfo2:

  148.         return "kPluginBridgeOscPluginInfo2";

  149.     case kPluginBridgeOscAudioCount:

  150.         return "kPluginBridgeOscAudioCount";

  151.     case kPluginBridgeOscMidiCount:

  152.         return "kPluginBridgeOscMidiCount";

  153.     case kPluginBridgeOscParameterCount:

  154.         return "kPluginBridgeOscParameterCount";

  155.     case kPluginBridgeOscProgramCount:

  156.         return "kPluginBridgeOscProgramCount";

  157.     case kPluginBridgeOscMidiProgramCount:

  158.         return "kPluginBridgeOscMidiProgramCount";

  159.     case kPluginBridgeOscParameterData1:

  160.         return "kPluginBridgeOscParameterData1";

  161.     case kPluginBridgeOscParameterData2:

  162.         return "kPluginBridgeOscParameterData2";

  163.     case kPluginBridgeOscParameterRanges1:

  164.         return "kPluginBridgeOscParameterRanges1";

  165.     case kPluginBridgeOscParameterRanges2:

  166.         return "kPluginBridgeOscParameterRanges2";

  167.     case kPluginBridgeOscParameterValue:

  168.         return "kPluginBridgeOscParameterValue";

  169.     case kPluginBridgeOscDefaultValue:

  170.         return "kPluginBridgeOscDefaultValue";

  171.     case kPluginBridgeOscCurrentProgram:

  172.         return "kPluginBridgeOscCurrentProgram";

  173.     case kPluginBridgeOscCurrentMidiProgram:

  174.         return "kPluginBridgeOscCurrentMidiProgram";

  175.     case kPluginBridgeOscProgramName:

  176.         return "kPluginBridgeOscProgramName";

  177.     case kPluginBridgeOscMidiProgramData:

  178.         return "kPluginBridgeOscMidiProgramData";

  179.     case kPluginBridgeOscConfigure:

  180.         return "kPluginBridgeOscConfigure";

  181.     case kPluginBridgeOscSetCustomData:

  182.         return "kPluginBridgeOscSetCustomData";

  183.     case kPluginBridgeOscSetChunkDataFile:

  184.         return "kPluginBridgeOscSetChunkDataFile";

  185.     case kPluginBridgeOscLatency:

  186.         return "kPluginBridgeOscLatency";

  187.     case kPluginBridgeOscReady:

  188.         return "kPluginBridgeOscReady";

  189.     case kPluginBridgeOscError:

  190.         return "kPluginBridgeOscError";

  191.     }

  192. 

  193.     carla_stderr("CarlaBackend::PluginBridgeOscInfoType2str(%i) - invalid type", type);

  194.     return nullptr;

  195. }

  196. 

  197. static inline

  198. const char* PluginBridgeRtOpcode2str(const PluginBridgeRtOpcode opcode) noexcept

  199. {

  200.     switch (opcode)

  201.     {

  202.     case kPluginBridgeRtNull:

  203.         return "kPluginBridgeRtNull";

  204.     case kPluginBridgeRtSetAudioPool:

  205.         return "kPluginBridgeRtSetAudioPool";

  206.     case kPluginBridgeRtSetParameter:

  207.         return "kPluginBridgeRtSetParameter";

  208.     case kPluginBridgeRtMidiData:

  209.         return "kPluginBridgeRtMidiData";

  210.     case kPluginBridgeRtMidiBank:

  211.         return "kPluginBridgeRtMidiBank";

  212.     case kPluginBridgeRtMidiProgram:

  213.         return "kPluginBridgeRtMidiProgram";

  214.     case kPluginBridgeRtAllSoundOff:

  215.         return "kPluginBridgeRtAllSoundOff";

  216.     case kPluginBridgeRtAllNotesOff:

  217.         return "kPluginBridgeRtAllNotesOff";

  218.     case kPluginBridgeRtProcess:

  219.         return "kPluginBridgeRtProcess";

  220.     }

  221. 

  222.     carla_stderr("CarlaBackend::PluginBridgeRtOpcode2str(%i) - invalid opcode", opcode);

  223.     return nullptr;

  224. }

  225. 

  226. static inline

  227. const char* PluginBridgeNonRtOpcode2str(const PluginBridgeNonRtOpcode opcode) noexcept

  228. {

  229.     switch (opcode)

  230.     {

  231.     case kPluginBridgeNonRtNull:

  232.         return "kPluginBridgeNonRtNull";

  233.     case kPluginBridgeNonRtPing:

  234.         return "kPluginBridgeNonRtPing";

  235.     case kPluginBridgeNonRtActivate:

  236.         return "kPluginBridgeNonRtActivate";

  237.     case kPluginBridgeNonRtDeactivate:

  238.         return "kPluginBridgeNonRtDeactivate";

  239.     case kPluginBridgeNonRtSetBufferSize:

  240.         return "kPluginBridgeNonRtSetBufferSize";

  241.     case kPluginBridgeNonRtSetSampleRate:

  242.         return "kPluginBridgeNonRtSetSampleRate";

  243.     case kPluginBridgeNonRtSetOffline:

  244.         return "kPluginBridgeNonRtSetOffline";

  245.     case kPluginBridgeNonRtSetOnline:

  246.         return "kPluginBridgeNonRtSetOnline";

  247.     case kPluginBridgeNonRtSetParameterValue:

  248.         return "kPluginBridgeNonRtSetParameterValue";

  249.     case kPluginBridgeNonRtSetProgram:

  250.         return "kPluginBridgeNonRtSetProgram";

  251.     case kPluginBridgeNonRtSetMidiProgram:

  252.         return "kPluginBridgeNonRtSetMidiProgram";

  253.     case kPluginBridgeNonRtSetCustomData:

  254.         return "kPluginBridgeNonRtSetCustomData";

  255.     case kPluginBridgeNonRtSetChunkDataFile:

  256.         return "kPluginBridgeNonRtSetChunkDataFile";

  257.     case kPluginBridgeNonRtSetCtrlChannel:

  258.         return "kPluginBridgeNonRtSetCtrlChannel";

  259.     case kPluginBridgeNonRtSetOption:

  260.         return "kPluginBridgeNonRtSetOption";

  261.     case kPluginBridgeNonRtPrepareForSave:

  262.         return "kPluginBridgeNonRtPrepareForSave";

  263.     case kPluginBridgeNonRtShowUI:

  264.         return "kPluginBridgeNonRtShowUI";

  265.     case kPluginBridgeNonRtHideUI:

  266.         return "kPluginBridgeNonRtHideUI";

  267.     case kPluginBridgeNonRtUiParameterChange:

  268.         return "kPluginBridgeNonRtUiParameterChange";

  269.     case kPluginBridgeNonRtUiProgramChange:

  270.         return "kPluginBridgeNonRtUiProgramChange";

  271.     case kPluginBridgeNonRtUiMidiProgramChange:

  272.         return "kPluginBridgeNonRtUiMidiProgramChange";

  273.     case kPluginBridgeNonRtUiNoteOn:

  274.         return "kPluginBridgeNonRtUiNoteOn";

  275.     case kPluginBridgeNonRtUiNoteOff:

  276.         return "kPluginBridgeNonRtUiNoteOff";

  277.     case kPluginBridgeNonRtQuit:

  278.         return "kPluginBridgeNonRtQuit";

  279.     }

  280. 

  281.     carla_stderr("CarlaBackend::PluginBridgeNonRtOpcode2str(%i) - invalid opcode", opcode);

  282.     return nullptr;

  283. }

  284. 

  285. // -----------------------------------------------------------------------

  286. 

  287. #endif // CARLA_BRIDGE_UTILS_HPP_INCLUDED