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

314 lines
14KB
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. // Server sends these to client during RT

  26. enum PluginBridgeRtClientOpcode {

  27.     kPluginBridgeRtClientNull = 0,

  28.     kPluginBridgeRtClientSetAudioPool,            // ulong/ptr

  29.     kPluginBridgeRtClientSetCVPool,               // ulong/ptr

  30.     kPluginBridgeRtClientControlEventParameter,   // uint/frame, byte/chan, ushort, float

  31.     kPluginBridgeRtClientControlEventMidiBank,    // uint/frame, byte/chan, ushort

  32.     kPluginBridgeRtClientControlEventMidiProgram, // uint/frame, byte/chan, ushort

  33.     kPluginBridgeRtClientControlEventAllSoundOff, // uint/frame, byte/chan

  34.     kPluginBridgeRtClientControlEventAllNotesOff, // uint/frame, byte/chan

  35.     kPluginBridgeRtClientMidiEvent,               // uint/frame, byte/port, byte/size, byte[]/data

  36.     kPluginBridgeRtClientProcess,

  37.     kPluginBridgeRtClientQuit

  38. };

  39. 

  40. // Server sends these to client during non-RT

  41. enum PluginBridgeNonRtClientOpcode {

  42.     kPluginBridgeNonRtClientNull = 0,

  43.     kPluginBridgeNonRtClientPing,

  44.     kPluginBridgeNonRtClientActivate,

  45.     kPluginBridgeNonRtClientDeactivate,

  46.     kPluginBridgeNonRtClientSetBufferSize,           // uint

  47.     kPluginBridgeNonRtClientSetSampleRate,           // double

  48.     kPluginBridgeNonRtClientSetOffline,

  49.     kPluginBridgeNonRtClientSetOnline,

  50.     kPluginBridgeNonRtClientSetParameterValue,       // uint, float

  51.     kPluginBridgeNonRtClientSetParameterMidiChannel, // uint, byte

  52.     kPluginBridgeNonRtClientSetParameterMidiCC,      // uint, short

  53.     kPluginBridgeNonRtClientSetProgram,              // int

  54.     kPluginBridgeNonRtClientSetMidiProgram,          // int

  55.     kPluginBridgeNonRtClientSetCustomData,           // uint/size, str[], uint/size, str[], uint/size, str[] (compressed)

  56.     kPluginBridgeNonRtClientSetChunkDataFile,        // uint/size, str[] (filename)

  57.     kPluginBridgeNonRtClientSetCtrlChannel,          // short

  58.     kPluginBridgeNonRtClientSetOption,               // uint/option, bool

  59.     kPluginBridgeNonRtClientPrepareForSave,

  60.     kPluginBridgeNonRtClientShowUI,

  61.     kPluginBridgeNonRtClientHideUI,

  62.     kPluginBridgeNonRtClientUiParameterChange,       // uint, float

  63.     kPluginBridgeNonRtClientUiProgramChange,         // uint

  64.     kPluginBridgeNonRtClientUiMidiProgramChange,     // uint

  65.     kPluginBridgeNonRtClientUiNoteOn,                // byte, byte, byte

  66.     kPluginBridgeNonRtClientUiNoteOff,               // byte, byte

  67.     kPluginBridgeNonRtClientQuit

  68. };

  69. 

  70. // Client sends these to server during non-RT

  71. enum PluginBridgeNonRtServerOpcode {

  72.     kPluginBridgeNonRtServerNull = 0,

  73.     kPluginBridgeNonRtServerPong,

  74.     kPluginBridgeNonRtServerPluginInfo1,          // uint/category, uint/hints, uint/optionsAvailable, uint/optionsEnabled, long/uniqueId

  75.     kPluginBridgeNonRtServerPluginInfo2,          // uint/size, str[] (realName), uint/size, str[] (label), uint/size, str[] (maker), uint/size, str[] (copyright)

  76.     kPluginBridgeNonRtServerAudioCount,           // uint/ins, uint/outs

  77.     kPluginBridgeNonRtServerMidiCount,            // uint/ins, uint/outs

  78.     kPluginBridgeNonRtServerParameterCount,       // uint/ins, uint/outs

  79.     kPluginBridgeNonRtServerProgramCount,         // uint/count

  80.     kPluginBridgeNonRtServerMidiProgramCount,     // uint/count

  81.     kPluginBridgeNonRtServerParameterData1,       // uint/index, int/rindex, uint/type, uint/hints, int/cc

  82.     kPluginBridgeNonRtServerParameterData2,       // uint/index, uint/size, str[] (name), uint/size, str[] (unit)

  83.     kPluginBridgeNonRtServerParameterRanges1,     // uint/index, float/def, float/min, float/max

  84.     kPluginBridgeNonRtServerParameterRanges2,     // uint/index float/step, float/stepSmall, float/stepLarge

  85.     kPluginBridgeNonRtServerParameterValue,       // uint/index float/value

  86.     kPluginBridgeNonRtServerDefaultValue,         // uint/index float/value

  87.     kPluginBridgeNonRtServerCurrentProgram,       // int/index

  88.     kPluginBridgeNonRtServerCurrentMidiProgram,   // int/index

  89.     kPluginBridgeNonRtServerProgramName,          // uint/index, uint/size, str[] (name)

  90.     kPluginBridgeNonRtServerMidiProgramData,      // uint/index, uint/bank, uint/program, uint/size, str[] (name)

  91.     kPluginBridgeNonRtServerConfigure,            // uint/size, str[], uint/size, str[]

  92.     kPluginBridgeNonRtServerSetCustomData,        // uint/size, str[], uint/size, str[], uint/size, str[] (compressed)

  93.     kPluginBridgeNonRtServerSetChunkDataFile,     // uint/size, str[] (filename)

  94.     kPluginBridgeNonRtServerSetLatency,           // uint

  95.     kPluginBridgeNonRtServerReady,

  96.     kPluginBridgeNonRtServerSaved,

  97.     kPluginBridgeNonRtServerUiClosed,

  98.     kPluginBridgeNonRtServerError

  99. };

  100. 

  101. // -----------------------------------------------------------------------

  102. 

  103. struct BridgeSemaphore {

  104.     union {

  105.         void* server;

  106.         char _padServer[64];

  107.     };

  108.     union {

  109.         void* client;

  110.         char _padClient[64];

  111.     };

  112. };

  113. 

  114. // needs to be 64bit aligned

  115. struct BridgeTimeInfo {

  116.     uint64_t playing;

  117.     uint64_t frame;

  118.     uint64_t usecs;

  119.     uint32_t valid;

  120.     // bbt

  121.     int32_t bar, beat, tick;

  122.     float beatsPerBar, beatType;

  123.     double barStartTick, ticksPerBeat, beatsPerMinute;

  124. };

  125. 

  126. // -----------------------------------------------------------------------

  127. 

  128. static const std::size_t kBridgeRtClientDataMidiOutSize = 512*4;

  129. 

  130. // Server => Client RT

  131. struct BridgeRtClientData {

  132.     BridgeSemaphore sem;

  133.     BridgeTimeInfo timeInfo;

  134.     SmallStackBuffer ringBuffer;

  135.     uint8_t midiOut[kBridgeRtClientDataMidiOutSize];

  136. };

  137. 

  138. // Server => Client Non-RT

  139. struct BridgeNonRtClientData {

  140.     BigStackBuffer ringBuffer;

  141. };

  142. 

  143. // Client => Server Non-RT

  144. struct BridgeNonRtServerData {

  145.     HugeStackBuffer ringBuffer;

  146. };

  147. 

  148. // -----------------------------------------------------------------------

  149. 

  150. static inline

  151. const char* PluginBridgeRtClientOpcode2str(const PluginBridgeRtClientOpcode opcode) noexcept

  152. {

  153.     switch (opcode)

  154.     {

  155.     case kPluginBridgeRtClientNull:

  156.         return "kPluginBridgeRtClientNull";

  157.     case kPluginBridgeRtClientSetAudioPool:

  158.         return "kPluginBridgeRtClientSetAudioPool";

  159.     case kPluginBridgeRtClientSetCVPool:

  160.         return "kPluginBridgeRtClientSetCVPool";

  161.     case kPluginBridgeRtClientControlEventParameter:

  162.         return "kPluginBridgeRtClientControlEventParameter";

  163.     case kPluginBridgeRtClientControlEventMidiBank:

  164.         return "kPluginBridgeRtClientControlEventMidiBank";

  165.     case kPluginBridgeRtClientControlEventMidiProgram:

  166.         return "kPluginBridgeRtClientControlEventMidiProgram";

  167.     case kPluginBridgeRtClientControlEventAllSoundOff:

  168.         return "kPluginBridgeRtClientControlEventAllSoundOff";

  169.     case kPluginBridgeRtClientControlEventAllNotesOff:

  170.         return "kPluginBridgeRtClientControlEventAllNotesOff";

  171.     case kPluginBridgeRtClientMidiEvent:

  172.         return "kPluginBridgeRtClientMidiEvent";

  173.     case kPluginBridgeRtClientProcess:

  174.         return "kPluginBridgeRtClientProcess";

  175.     case kPluginBridgeRtClientQuit:

  176.         return "kPluginBridgeRtClientQuit";

  177.     }

  178. 

  179.     carla_stderr("CarlaBackend::PluginBridgeRtClientOpcode2str(%i) - invalid opcode", opcode);

  180.     return nullptr;

  181. }

  182. 

  183. static inline

  184. const char* PluginBridgeNonRtClientOpcode2str(const PluginBridgeNonRtClientOpcode opcode) noexcept

  185. {

  186.     switch (opcode)

  187.     {

  188.     case kPluginBridgeNonRtClientNull:

  189.         return "kPluginBridgeNonRtClientNull";

  190.     case kPluginBridgeNonRtClientPing:

  191.         return "kPluginBridgeNonRtClientPing";

  192.     case kPluginBridgeNonRtClientActivate:

  193.         return "kPluginBridgeNonRtClientActivate";

  194.     case kPluginBridgeNonRtClientDeactivate:

  195.         return "kPluginBridgeNonRtClientDeactivate";

  196.     case kPluginBridgeNonRtClientSetBufferSize:

  197.         return "kPluginBridgeNonRtClientSetBufferSize";

  198.     case kPluginBridgeNonRtClientSetSampleRate:

  199.         return "kPluginBridgeNonRtClientSetSampleRate";

  200.     case kPluginBridgeNonRtClientSetOffline:

  201.         return "kPluginBridgeNonRtClientSetOffline";

  202.     case kPluginBridgeNonRtClientSetOnline:

  203.         return "kPluginBridgeNonRtClientSetOnline";

  204.     case kPluginBridgeNonRtClientSetParameterValue:

  205.         return "kPluginBridgeNonRtClientSetParameterValue";

  206.     case kPluginBridgeNonRtClientSetParameterMidiChannel:

  207.         return "kPluginBridgeNonRtClientSetParameterMidiChannel";

  208.     case kPluginBridgeNonRtClientSetParameterMidiCC:

  209.         return "kPluginBridgeNonRtClientSetParameterMidiCC";

  210.     case kPluginBridgeNonRtClientSetProgram:

  211.         return "kPluginBridgeNonRtClientSetProgram";

  212.     case kPluginBridgeNonRtClientSetMidiProgram:

  213.         return "kPluginBridgeNonRtClientSetMidiProgram";

  214.     case kPluginBridgeNonRtClientSetCustomData:

  215.         return "kPluginBridgeNonRtClientSetCustomData";

  216.     case kPluginBridgeNonRtClientSetChunkDataFile:

  217.         return "kPluginBridgeNonRtClientSetChunkDataFile";

  218.     case kPluginBridgeNonRtClientSetCtrlChannel:

  219.         return "kPluginBridgeNonRtClientSetCtrlChannel";

  220.     case kPluginBridgeNonRtClientSetOption:

  221.         return "kPluginBridgeNonRtClientSetOption";

  222.     case kPluginBridgeNonRtClientPrepareForSave:

  223.         return "kPluginBridgeNonRtClientPrepareForSave";

  224.     case kPluginBridgeNonRtClientShowUI:

  225.         return "kPluginBridgeNonRtClientShowUI";

  226.     case kPluginBridgeNonRtClientHideUI:

  227.         return "kPluginBridgeNonRtClientHideUI";

  228.     case kPluginBridgeNonRtClientUiParameterChange:

  229.         return "kPluginBridgeNonRtClientUiParameterChange";

  230.     case kPluginBridgeNonRtClientUiProgramChange:

  231.         return "kPluginBridgeNonRtClientUiProgramChange";

  232.     case kPluginBridgeNonRtClientUiMidiProgramChange:

  233.         return "kPluginBridgeNonRtClientUiMidiProgramChange";

  234.     case kPluginBridgeNonRtClientUiNoteOn:

  235.         return "kPluginBridgeNonRtClientUiNoteOn";

  236.     case kPluginBridgeNonRtClientUiNoteOff:

  237.         return "kPluginBridgeNonRtClientUiNoteOff";

  238.     case kPluginBridgeNonRtClientQuit:

  239.         return "kPluginBridgeNonRtClientQuit";

  240.     }

  241. 

  242.     carla_stderr("CarlaBackend::PluginBridgeNonRtClientOpcode2str(%i) - invalid opcode", opcode);

  243.     return nullptr;

  244. }

  245. 

  246. static inline

  247. const char* PluginBridgeNonRtServerOpcode2str(const PluginBridgeNonRtServerOpcode opcode) noexcept

  248. {

  249.     switch (opcode)

  250.     {

  251.     case kPluginBridgeNonRtServerNull:

  252.         return "kPluginBridgeNonRtServerNull";

  253.     case kPluginBridgeNonRtServerPong:

  254.         return "kPluginBridgeNonRtServerPong";

  255.     case kPluginBridgeNonRtServerPluginInfo1:

  256.         return "kPluginBridgeNonRtServerPluginInfo1";

  257.     case kPluginBridgeNonRtServerPluginInfo2:

  258.         return "kPluginBridgeNonRtServerPluginInfo2";

  259.     case kPluginBridgeNonRtServerAudioCount:

  260.         return "kPluginBridgeNonRtServerAudioCount";

  261.     case kPluginBridgeNonRtServerMidiCount:

  262.         return "kPluginBridgeNonRtServerMidiCount";

  263.     case kPluginBridgeNonRtServerParameterCount:

  264.         return "kPluginBridgeNonRtServerParameterCount";

  265.     case kPluginBridgeNonRtServerProgramCount:

  266.         return "kPluginBridgeNonRtServerProgramCount";

  267.     case kPluginBridgeNonRtServerMidiProgramCount:

  268.         return "kPluginBridgeNonRtServerMidiProgramCount";

  269.     case kPluginBridgeNonRtServerParameterData1:

  270.         return "kPluginBridgeNonRtServerParameterData1";

  271.     case kPluginBridgeNonRtServerParameterData2:

  272.         return "kPluginBridgeNonRtServerParameterData2";

  273.     case kPluginBridgeNonRtServerParameterRanges1:

  274.         return "kPluginBridgeNonRtServerParameterRanges1";

  275.     case kPluginBridgeNonRtServerParameterRanges2:

  276.         return "kPluginBridgeNonRtServerParameterRanges2";

  277.     case kPluginBridgeNonRtServerParameterValue:

  278.         return "kPluginBridgeNonRtServerParameterValue";

  279.     case kPluginBridgeNonRtServerDefaultValue:

  280.         return "kPluginBridgeNonRtServerDefaultValue";

  281.     case kPluginBridgeNonRtServerCurrentProgram:

  282.         return "kPluginBridgeNonRtServerCurrentProgram";

  283.     case kPluginBridgeNonRtServerCurrentMidiProgram:

  284.         return "kPluginBridgeNonRtServerCurrentMidiProgram";

  285.     case kPluginBridgeNonRtServerProgramName:

  286.         return "kPluginBridgeNonRtServerProgramName";

  287.     case kPluginBridgeNonRtServerMidiProgramData:

  288.         return "kPluginBridgeNonRtServerMidiProgramData";

  289.     case kPluginBridgeNonRtServerConfigure:

  290.         return "kPluginBridgeNonRtServerConfigure";

  291.     case kPluginBridgeNonRtServerSetCustomData:

  292.         return "kPluginBridgeNonRtServerSetCustomData";

  293.     case kPluginBridgeNonRtServerSetChunkDataFile:

  294.         return "kPluginBridgeNonRtServerSetChunkDataFile";

  295.     case kPluginBridgeNonRtServerSetLatency:

  296.         return "kPluginBridgeNonRtServerSetLatency";

  297.     case kPluginBridgeNonRtServerReady:

  298.         return "kPluginBridgeNonRtServerReady";

  299.     case kPluginBridgeNonRtServerSaved:

  300.         return "kPluginBridgeNonRtServerSaved";

  301.     case kPluginBridgeNonRtServerUiClosed:

  302.         return "kPluginBridgeNonRtServerUiClosed";

  303.     case kPluginBridgeNonRtServerError:

  304.         return "kPluginBridgeNonRtServerError";

  305.     }

  306. 

  307.     carla_stderr("CarlaBackend::PluginBridgeNonRtServerOpcode2str%i) - invalid opcode", opcode);

  308.     return nullptr;

  309. }

  310. 

  311. // -----------------------------------------------------------------------

  312. 

  313. #endif // CARLA_BRIDGE_UTILS_HPP_INCLUDED