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.

748 lines
21KB

  1. /*
  2. * Carla Backend API
  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 GPL.txt file
  16. */
  17. #ifndef __CARLA_BACKEND_HPP__
  18. #define __CARLA_BACKEND_HPP__
  19. #include "CarlaDefines.hpp"
  20. #include <cstdint>
  21. #define CARLA_BACKEND_START_NAMESPACE namespace CarlaBackend {
  22. #define CARLA_BACKEND_END_NAMESPACE }
  23. #define CARLA_BACKEND_USE_NAMESPACE using namespace CarlaBackend;
  24. #define STR_MAX 0xFF
  25. CARLA_BACKEND_START_NAMESPACE
  26. /*!
  27. * @defgroup CarlaBackendAPI Carla Backend API
  28. *
  29. * The Carla Backend API.\n
  30. * This is the base definitions for everything in the Carla code.
  31. *
  32. * @{
  33. */
  34. const unsigned int MAX_DEFAULT_PLUGINS = 99; //!< Maximum default number of loadable plugins
  35. const unsigned int MAX_RACK_PLUGINS = 16; //!< Maximum number of loadable plugins in rack mode
  36. const unsigned int MAX_PATCHBAY_PLUGINS = 255; //!< Maximum number of loadable plugins in patchbay mode
  37. const unsigned int MAX_DEFAULT_PARAMETERS = 200; //!< Maximum default number of parameters allowed.\see OPTION_MAX_PARAMETERS
  38. /*!
  39. * @defgroup PluginHints Plugin Hints
  40. *
  41. * Various plugin hints.
  42. * \see CarlaPlugin::hints()
  43. * @{
  44. */
  45. const unsigned int PLUGIN_IS_BRIDGE = 0x001; //!< Plugin is a bridge (ie, BridgePlugin). This hint is required because "bridge" itself is not a plugin type.
  46. const unsigned int PLUGIN_IS_RTSAFE = 0x002; //!< Plugin is hard real-time safe.
  47. const unsigned int PLUGIN_IS_SYNTH = 0x004; //!< Plugin is a synthesizer (produces sound).
  48. const unsigned int PLUGIN_HAS_GUI = 0x010; //!< Plugin has its own custom GUI.
  49. const unsigned int PLUGIN_HAS_SINGLE_THREAD = 0x020; //!< Plugin needs a single thread for both DSP and UI events.
  50. const unsigned int PLUGIN_CAN_DRYWET = 0x100; //!< Plugin can make use of Dry/Wet controls.
  51. const unsigned int PLUGIN_CAN_VOLUME = 0x200; //!< Plugin can make use of Volume controls.
  52. const unsigned int PLUGIN_CAN_BALANCE = 0x400; //!< Plugin can make use of Left & Right Balance controls.
  53. const unsigned int PLUGIN_CAN_PANNING = 0x800; //!< Plugin can make use of Panning controls.
  54. /**@}*/
  55. /*!
  56. * @defgroup PluginOptions Plugin Options
  57. *
  58. * Various plugin options.
  59. * \see CarlaPlugin::availableOptions() and CarlaPlugin::options()
  60. * @{
  61. */
  62. const unsigned int PLUGIN_OPTION_FIXED_BUFFER = 0x001; //!< Use a constant, fixed-size audio buffer
  63. const unsigned int PLUGIN_OPTION_FORCE_STEREO = 0x002; //!< Force mono plugin as stereo
  64. const unsigned int PLUGIN_OPTION_MAP_PROGRAM_CHANGES = 0x004; //!< Map MIDI-Programs to plugin programs
  65. const unsigned int PLUGIN_OPTION_USE_CHUNKS = 0x008; //!< Use chunks to save data
  66. const unsigned int PLUGIN_OPTION_SEND_CONTROL_CHANGES = 0x010; //!< Send MIDI CC events
  67. const unsigned int PLUGIN_OPTION_SEND_CHANNEL_PRESSURE = 0x020; //!< Send MIDI channel pressure events
  68. const unsigned int PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH = 0x040; //!< Send MIDI note aftertouch events
  69. const unsigned int PLUGIN_OPTION_SEND_PITCHBEND = 0x080; //!< Send MIDI pitchbend events
  70. const unsigned int PLUGIN_OPTION_SEND_ALL_SOUND_OFF = 0x100; //!< Send MIDI all sounds/notes off events, single-note offs otherwise
  71. /**@}*/
  72. /*!
  73. * @defgroup ParameterHints Parameter Hints
  74. *
  75. * Various parameter hints.
  76. * \see CarlaPlugin::parameterData()
  77. * @{
  78. */
  79. const unsigned int PARAMETER_IS_BOOLEAN = 0x01; //!< Parameter value is a boolean (always at minimum or maximum values).
  80. const unsigned int PARAMETER_IS_INTEGER = 0x02; //!< Parameter value is an integer.
  81. const unsigned int PARAMETER_IS_LOGARITHMIC = 0x04; //!< Parameter is logarithmic.
  82. const unsigned int PARAMETER_IS_ENABLED = 0x08; //!< Parameter is enabled and will be shown in the host built-in editor.
  83. const unsigned int PARAMETER_IS_AUTOMABLE = 0x10; //!< Parameter is automable (realtime safe)
  84. const unsigned int PARAMETER_USES_SAMPLERATE = 0x20; //!< Parameter needs sample rate to work (value and ranges are multiplied by SR, and must be divided by SR on save).
  85. const unsigned int PARAMETER_USES_SCALEPOINTS = 0x40; //!< Parameter uses scalepoints to define internal values in a meaningful way.
  86. const unsigned int PARAMETER_USES_CUSTOM_TEXT = 0x80; //!< Parameter uses custom text for displaying its value.\see CarlaPlugin::getParameterText()
  87. /**@}*/
  88. /*!
  89. * @defgroup PatchbayPortHints Patchbay Port Hints
  90. *
  91. * Various patchbay port hints.
  92. * @{
  93. */
  94. const unsigned int PATCHBAY_PORT_IS_INPUT = 0x1; //!< Patchbay port is input.
  95. const unsigned int PATCHBAY_PORT_IS_OUTPUT = 0x2; //!< Patchbay port is output.
  96. const unsigned int PATCHBAY_PORT_IS_AUDIO = 0x4; //!< Patchbay port is of Audio type.
  97. const unsigned int PATCHBAY_PORT_IS_MIDI = 0x8; //!< Patchbay port is of MIDI type.
  98. /**@}*/
  99. /*!
  100. * @defgroup CustomDataTypes Custom Data types
  101. *
  102. * The type defines how the \param value in CustomData is stored.
  103. *
  104. * Types are valid URIs.\n
  105. * Any non-string, non-simple type (not integral) is saved in a base64 encoded format.
  106. */
  107. const char* const CUSTOM_DATA_INVALID = nullptr; //!< Null or Invalid data.
  108. const char* const CUSTOM_DATA_CHUNK = "http://kxstudio.sf.net/ns/carla/chunk"; //!< Carla Chunk URI
  109. const char* const CUSTOM_DATA_STRING = "http://kxstudio.sf.net/ns/carla/string"; //!< Carla String URI
  110. /**@}*/
  111. /*!
  112. * The binary type of a plugin.
  113. */
  114. enum BinaryType {
  115. BINARY_NONE = 0, //!< Null binary type.
  116. BINARY_POSIX32 = 1, //!< POSIX 32bit.
  117. BINARY_POSIX64 = 2, //!< POSIX 64bit.
  118. BINARY_WIN32 = 3, //!< Windows 32bit.
  119. BINARY_WIN64 = 4, //!< Windows 64bit.
  120. BINARY_OTHER = 5 //!< Other.
  121. };
  122. /*!
  123. * All the available plugin types, as provided by subclasses of CarlaPlugin.\n
  124. * Some plugin classes might provide more than 1 plugin type.
  125. */
  126. enum PluginType {
  127. PLUGIN_NONE = 0, //!< Null plugin type.
  128. PLUGIN_INTERNAL = 1, //!< Internal plugin.
  129. PLUGIN_LADSPA = 2, //!< LADSPA plugin.
  130. PLUGIN_DSSI = 3, //!< DSSI plugin.
  131. PLUGIN_LV2 = 4, //!< LV2 plugin.
  132. PLUGIN_VST = 5, //!< VST1/2 plugin.
  133. PLUGIN_VST3 = 6, //!< VST3 plugin.
  134. PLUGIN_GIG = 7, //!< GIG sound kit, implemented via LinuxSampler.
  135. PLUGIN_SF2 = 8, //!< SF2 sound kit (aka SoundFont), implemented via FluidSynth.
  136. PLUGIN_SFZ = 9 //!< SFZ sound kit, implemented via LinuxSampler.
  137. };
  138. /*!
  139. * Plugin category, describing the funtionality of a plugin.\n
  140. * When a plugin fails to tell his own category, one is atributted to it based on its name.
  141. */
  142. enum PluginCategory {
  143. PLUGIN_CATEGORY_NONE = 0, //!< Null plugin category.
  144. PLUGIN_CATEGORY_SYNTH = 1, //!< A synthesizer or generator.
  145. PLUGIN_CATEGORY_DELAY = 2, //!< A delay or reverberator.
  146. PLUGIN_CATEGORY_EQ = 3, //!< An equalizer.
  147. PLUGIN_CATEGORY_FILTER = 4, //!< A filter.
  148. PLUGIN_CATEGORY_DYNAMICS = 5, //!< A 'dynamic' plugin (amplifier, compressor, gate, etc).
  149. PLUGIN_CATEGORY_MODULATOR = 6, //!< A 'modulator' plugin (chorus, flanger, phaser, etc).
  150. PLUGIN_CATEGORY_UTILITY = 7, //!< An 'utility' plugin (analyzer, converter, mixer, etc).
  151. PLUGIN_CATEGORY_OTHER = 8 //!< Misc plugin (used to check if the plugin has a category).
  152. };
  153. /*!
  154. * Plugin parameter type.
  155. */
  156. enum ParameterType {
  157. PARAMETER_UNKNOWN = 0, //!< Null parameter type.
  158. PARAMETER_INPUT = 1, //!< Input parameter.
  159. PARAMETER_OUTPUT = 2, //!< Ouput parameter.
  160. PARAMETER_LATENCY = 3, //!< Special latency parameter, used in LADSPA, DSSI and LV2 plugins.
  161. PARAMETER_SAMPLE_RATE = 4, //!< Special sample-rate parameter, used in LADSPA, DSSI and LV2 plugins.
  162. #ifdef WANT_LV2
  163. PARAMETER_LV2_FREEWHEEL = 5, //!< Special LV2 Plugin parameter used to report freewheel (offline) mode.
  164. PARAMETER_LV2_TIME = 6 //!< Special LV2 Plugin parameter used to report time information.
  165. #endif
  166. };
  167. /*!
  168. * Internal parameter indexes.\n
  169. * These are special parameters used internally, plugins do not know about their existence.
  170. */
  171. enum InternalParametersIndex {
  172. PARAMETER_NULL = -1, //!< Null parameter.
  173. PARAMETER_ACTIVE = -2, //!< Active parameter, can only be 'true' or 'false'; default is 'false'.
  174. PARAMETER_DRYWET = -3, //!< Dry/Wet parameter, range 0.0...1.0; default is 1.0.
  175. PARAMETER_VOLUME = -4, //!< Volume parameter, range 0.0...1.27; default is 1.0.
  176. PARAMETER_BALANCE_LEFT = -5, //!< Stereo Balance-Left parameter, range -1.0...1.0; default is -1.0.
  177. PARAMETER_BALANCE_RIGHT = -6, //!< Stereo Balance-Right parameter, range -1.0...1.0; default is 1.0.
  178. PARAMETER_PANNING = -7, //!< Mono Panning parameter, range -1.0...1.0; default is 0.0.
  179. PARAMETER_CTRL_CHANNEL = -8, //!< MIDI Control channel
  180. PARAMETER_MAX = -9 //!< Max value, defined for convenience
  181. };
  182. /*!
  183. * Options used in the CarlaEngine::setOption() and set_option() calls.\n
  184. * All options except paths must be set before initiliazing or after closing the engine.
  185. */
  186. enum OptionsType {
  187. /*!
  188. * Try to set the current process name.
  189. * \note Not available on all platforms.
  190. */
  191. OPTION_PROCESS_NAME = 0,
  192. /*!
  193. * Set the engine processing mode.\n
  194. * Default is PROCESS_MODE_CONTINUOUS_RACK.
  195. * \see ProcessMode
  196. */
  197. OPTION_PROCESS_MODE = 1,
  198. /*!
  199. * Set the engine transport mode.\n
  200. * Default is TRANSPORT_MODE_INTERNAL.
  201. * \see TransportMode
  202. */
  203. OPTION_TRANSPORT_MODE = 2,
  204. /*!
  205. * Force mono plugins as stereo, by running 2 instances at the same time.
  206. * \note Not supported by all plugins.
  207. */
  208. OPTION_FORCE_STEREO = 3,
  209. /*!
  210. * Use plugin bridges whenever possible.\n
  211. * Default is no, EXPERIMENTAL.
  212. */
  213. OPTION_PREFER_PLUGIN_BRIDGES = 4,
  214. /*!
  215. * Use OSC-UI bridges whenever possible, otherwise UIs will be handled in the main thread.\n
  216. * Default is yes.
  217. */
  218. OPTION_PREFER_UI_BRIDGES = 5,
  219. #ifdef WANT_DSSI
  220. /*!
  221. * Use (unofficial) dssi-vst chunks feature.\n
  222. * Default is no.
  223. */
  224. OPTION_USE_DSSI_VST_CHUNKS = 6,
  225. #endif
  226. /*!
  227. * Maximum number of parameters allowed.\n
  228. * Default is MAX_DEFAULT_PARAMETERS.
  229. */
  230. OPTION_MAX_PARAMETERS = 7,
  231. /*!
  232. * Timeout value in ms for how much to wait for OSC-Bridges to respond.\n
  233. * Default is 4000 (4 secs).
  234. */
  235. OPTION_OSC_UI_TIMEOUT = 8,
  236. /*!
  237. * Prefered buffer size.
  238. */
  239. OPTION_PREFERRED_BUFFER_SIZE = 9,
  240. /*!
  241. * Prefered sample rate.
  242. */
  243. OPTION_PREFERRED_SAMPLE_RATE = 10,
  244. #ifndef BUILD_BRIDGE
  245. /*!
  246. * Set path to the native plugin bridge executable.\n
  247. * Default unset.
  248. */
  249. OPTION_PATH_BRIDGE_NATIVE = 11,
  250. /*!
  251. * Set path to the POSIX 32bit plugin bridge executable.\n
  252. * Default unset.
  253. */
  254. OPTION_PATH_BRIDGE_POSIX32 = 12,
  255. /*!
  256. * Set path to the POSIX 64bit plugin bridge executable.\n
  257. * Default unset.
  258. */
  259. OPTION_PATH_BRIDGE_POSIX64 = 13,
  260. /*!
  261. * Set path to the Windows 32bit plugin bridge executable.\n
  262. * Default unset.
  263. */
  264. OPTION_PATH_BRIDGE_WIN32 = 14,
  265. /*!
  266. * Set path to the Windows 64bit plugin bridge executable.\n
  267. * Default unset.
  268. */
  269. OPTION_PATH_BRIDGE_WIN64 = 15,
  270. #endif
  271. #ifdef WANT_LV2
  272. /*!
  273. * Set path to the LV2 Gtk2 UI bridge executable.\n
  274. * Default unset.
  275. */
  276. OPTION_PATH_BRIDGE_LV2_GTK2 = 16,
  277. /*!
  278. * Set path to the LV2 Gtk3 UI bridge executable.\n
  279. * Default unset.
  280. */
  281. OPTION_PATH_BRIDGE_LV2_GTK3 = 17,
  282. /*!
  283. * Set path to the LV2 Qt4 UI bridge executable.\n
  284. * Default unset.
  285. */
  286. OPTION_PATH_BRIDGE_LV2_QT4 = 18,
  287. /*!
  288. * Set path to the LV2 Qt5 UI bridge executable.\n
  289. * Default unset.
  290. */
  291. OPTION_PATH_BRIDGE_LV2_QT5 = 19,
  292. /*!
  293. * Set path to the LV2 Cocoa UI bridge executable.\n
  294. * Default unset.
  295. */
  296. OPTION_PATH_BRIDGE_LV2_COCOA = 20,
  297. /*!
  298. * Set path to the LV2 Windows UI bridge executable.\n
  299. * Default unset.
  300. */
  301. OPTION_PATH_BRIDGE_LV2_WINDOWS = 21,
  302. /*!
  303. * Set path to the LV2 X11 UI bridge executable.\n
  304. * Default unset.
  305. */
  306. OPTION_PATH_BRIDGE_LV2_X11 = 22,
  307. #endif
  308. #ifdef WANT_VST
  309. /*!
  310. * Set path to the VST Cocoa UI bridge executable.\n
  311. * Default unset.
  312. */
  313. OPTION_PATH_BRIDGE_VST_COCOA = 23,
  314. /*!
  315. * Set path to the VST HWND UI bridge executable.\n
  316. * Default unset.
  317. */
  318. OPTION_PATH_BRIDGE_VST_HWND = 24,
  319. /*!
  320. * Set path to the VST X11 UI bridge executable.\n
  321. * Default unset.
  322. */
  323. OPTION_PATH_BRIDGE_VST_X11 = 25
  324. #endif
  325. };
  326. /*!
  327. * Opcodes sent from the engine callback to the GUI, as defined by CallbackFunc.
  328. *
  329. * \see CarlaEngine::setCallback() and set_callback_function()
  330. */
  331. enum CallbackType {
  332. /*!
  333. * Debug.\n
  334. * This opcode is undefined and used only for testing purposes.
  335. */
  336. CALLBACK_DEBUG = 0,
  337. /*!
  338. * A plugin has been added.
  339. * \param valueStr Plugin name
  340. */
  341. CALLBACK_PLUGIN_ADDED = 1,
  342. /*!
  343. * A plugin has been removed.
  344. */
  345. CALLBACK_PLUGIN_REMOVED = 2,
  346. /*!
  347. * A plugin has been renamed.
  348. * \param valueStr New name
  349. */
  350. CALLBACK_PLUGIN_RENAMED = 3,
  351. /*!
  352. * A parameter value has been changed.
  353. *
  354. * \param value1 Parameter index
  355. * \param value3 Value
  356. */
  357. CALLBACK_PARAMETER_VALUE_CHANGED = 4,
  358. /*!
  359. * A parameter default has changed.
  360. *
  361. * \param value1 Parameter index
  362. * \param value3 New default value
  363. */
  364. CALLBACK_PARAMETER_DEFAULT_CHANGED = 5,
  365. /*!
  366. * A parameter's MIDI channel has been changed.
  367. *
  368. * \param value1 Parameter index
  369. * \param value2 MIDI channel
  370. */
  371. CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED = 6,
  372. /*!
  373. * A parameter's MIDI CC has been changed.
  374. *
  375. * \param value1 Parameter index
  376. * \param value2 MIDI CC
  377. */
  378. CALLBACK_PARAMETER_MIDI_CC_CHANGED = 7,
  379. /*!
  380. * The current program has has been changed.
  381. *
  382. * \param value1 Program index
  383. */
  384. CALLBACK_PROGRAM_CHANGED = 8,
  385. /*!
  386. * The current MIDI program has been changed.
  387. *
  388. * \param value1 MIDI bank
  389. * \param value2 MIDI program
  390. */
  391. CALLBACK_MIDI_PROGRAM_CHANGED = 9,
  392. /*!
  393. * A note has been pressed.
  394. *
  395. * \param value1 Channel
  396. * \param value2 Note
  397. * \param value3 Velocity
  398. */
  399. CALLBACK_NOTE_ON = 10,
  400. /*!
  401. * A note has been released.
  402. *
  403. * \param value1 Channel
  404. * \param value2 Note
  405. */
  406. CALLBACK_NOTE_OFF = 11,
  407. /*!
  408. * The plugin's custom GUI state has changed.
  409. *
  410. * \param value1 State, as follows:.\n
  411. * 0: GUI has been closed or hidden\n
  412. * 1: GUI has been shown\n
  413. * -1: GUI has crashed and should not be shown again
  414. */
  415. CALLBACK_SHOW_GUI = 12,
  416. /*!
  417. * The plugin needs update.
  418. */
  419. CALLBACK_UPDATE = 13,
  420. /*!
  421. * The plugin's data/information has changed.
  422. */
  423. CALLBACK_RELOAD_INFO = 14,
  424. /*!
  425. * The plugin's parameters have changed.
  426. */
  427. CALLBACK_RELOAD_PARAMETERS = 15,
  428. /*!
  429. * The plugin's programs have changed.
  430. */
  431. CALLBACK_RELOAD_PROGRAMS = 16,
  432. /*!
  433. * The plugin's state has changed.
  434. */
  435. CALLBACK_RELOAD_ALL = 17,
  436. /*!
  437. * Canvas client added
  438. *
  439. * \param value1 Client Id
  440. * \param valueStr Client name
  441. */
  442. CALLBACK_PATCHBAY_CLIENT_ADDED = 18,
  443. /*!
  444. * Canvas client removed
  445. *
  446. * \param value1 Client Id
  447. */
  448. CALLBACK_PATCHBAY_CLIENT_REMOVED = 19,
  449. /*!
  450. * Canvas client renamed
  451. *
  452. * \param value1 Client Id
  453. * \param valueStr New client name
  454. */
  455. CALLBACK_PATCHBAY_CLIENT_RENAMED = 20,
  456. /*!
  457. * Canvas port added
  458. *
  459. * \param value1 Client Id
  460. * \param value2 Port Id
  461. * \param value3 Port flags
  462. * \param valueStr Port name
  463. */
  464. CALLBACK_PATCHBAY_PORT_ADDED = 21,
  465. /*!
  466. * Canvas port remvoed
  467. *
  468. * \param value1 Port Id
  469. */
  470. CALLBACK_PATCHBAY_PORT_REMOVED = 22,
  471. /*!
  472. * Canvas port renamed
  473. *
  474. * \param value1 Port Id
  475. * \param valueStr New port name
  476. */
  477. CALLBACK_PATCHBAY_PORT_RENAMED = 23,
  478. /*!
  479. * Canvas port connection added
  480. *
  481. * \param value1 Output port Id
  482. * \param value2 Input port Id
  483. */
  484. CALLBACK_PATCHBAY_CONNECTION_ADDED = 24,
  485. /*!
  486. * Canvas port connection removed
  487. *
  488. * \param value1 Output port Id
  489. * \param value2 Input port Id
  490. */
  491. CALLBACK_PATCHBAY_CONNECTION_REMOVED = 25,
  492. /*!
  493. * Non-Session-Manager Announce message.
  494. */
  495. CALLBACK_BUFFER_SIZE_CHANGED = 26,
  496. /*!
  497. * Non-Session-Manager Announce message.
  498. */
  499. CALLBACK_SAMPLE_RATE_CHANGED = 27,
  500. /*!
  501. * Non-Session-Manager Announce message.
  502. */
  503. CALLBACK_NSM_ANNOUNCE = 28,
  504. /*!
  505. * Non-Session-Manager Open message.
  506. */
  507. CALLBACK_NSM_OPEN = 29,
  508. /*!
  509. * Non-Session-Manager Save message.
  510. */
  511. CALLBACK_NSM_SAVE = 30,
  512. /*!
  513. * An error occurred, show \a valueStr as an error to user.
  514. */
  515. CALLBACK_ERROR = 31,
  516. /*!
  517. * The engine has crashed or malfunctioned and will no longer work.
  518. */
  519. CALLBACK_QUIT = 32
  520. };
  521. /*!
  522. * Engine process mode.
  523. *
  524. * \see OPTION_PROCESS_MODE
  525. */
  526. enum ProcessMode {
  527. PROCESS_MODE_SINGLE_CLIENT = 0, //!< Single client mode (dynamic input/outputs as needed by plugins)
  528. PROCESS_MODE_MULTIPLE_CLIENTS = 1, //!< Multiple client mode (1 master client + 1 client per plugin)
  529. PROCESS_MODE_CONTINUOUS_RACK = 2, //!< Single client, 'rack' mode. Processes plugins in order of Id, with forced stereo.
  530. PROCESS_MODE_PATCHBAY = 3, //!< Single client, 'patchbay' mode.
  531. PROCESS_MODE_BRIDGE = 4 //!< Special mode, used in plugin-bridges only.
  532. };
  533. /*!
  534. * All the available transport modes
  535. */
  536. enum TransportMode {
  537. TRANSPORT_MODE_INTERNAL = 0, //!< Internal transport mode.
  538. TRANSPORT_MODE_JACK = 1, //!< JACK transport, only available if driver name is "JACK"
  539. TRANSPORT_MODE_BRIDGE = 2 //!< Special mode, used in plugin-bridges only.
  540. };
  541. /*!
  542. * Callback function the engine will call when something interesting happens.
  543. *
  544. * \see CallbackType and set_callback_function()
  545. */
  546. typedef void (*CallbackFunc)(void* ptr, CallbackType action, unsigned int pluginId, int value1, int value2, float value3, const char* valueStr);
  547. /*!
  548. * Parameter data
  549. */
  550. struct ParameterData {
  551. ParameterType type;
  552. int32_t index;
  553. int32_t rindex;
  554. uint32_t hints;
  555. uint8_t midiChannel;
  556. int16_t midiCC;
  557. #ifndef DOXYGEN
  558. ParameterData()
  559. : type(PARAMETER_UNKNOWN),
  560. index(PARAMETER_NULL),
  561. rindex(-1),
  562. hints(0x0),
  563. midiChannel(0),
  564. midiCC(-1) {}
  565. #endif
  566. };
  567. /*!
  568. * Parameter ranges
  569. */
  570. struct ParameterRanges {
  571. float def;
  572. float min;
  573. float max;
  574. float step;
  575. float stepSmall;
  576. float stepLarge;
  577. #ifndef DOXYGEN
  578. ParameterRanges()
  579. : def(0.0f),
  580. min(0.0f),
  581. max(1.0f),
  582. step(0.01f),
  583. stepSmall(0.0001f),
  584. stepLarge(0.1f) {}
  585. #endif
  586. void fixDefault()
  587. {
  588. fixValue(def);
  589. }
  590. void fixValue(float& value) const
  591. {
  592. if (value < min)
  593. value = min;
  594. else if (value > max)
  595. value = max;
  596. }
  597. float fixValue(const float& value) const
  598. {
  599. if (value < min)
  600. return min;
  601. else if (value > max)
  602. return max;
  603. return value;
  604. }
  605. float normalizeValue(const float& value) const
  606. {
  607. return (value - min) / (max - min);
  608. }
  609. float unnormalizeValue(const float& value) const
  610. {
  611. return value * (max - min) + min;
  612. }
  613. };
  614. /*!
  615. * MIDI Program data
  616. */
  617. struct MidiProgramData {
  618. uint32_t bank;
  619. uint32_t program;
  620. const char* name;
  621. #ifndef DOXYGEN
  622. MidiProgramData()
  623. : bank(0),
  624. program(0),
  625. name(nullptr) {}
  626. #endif
  627. };
  628. /*!
  629. * Custom data, saving key:value 'dictionaries'.\n
  630. * \a type is an URI which defines the \a value type.
  631. *
  632. * \see CustomDataTypes
  633. */
  634. struct CustomData {
  635. const char* type;
  636. const char* key;
  637. const char* value;
  638. #ifndef DOXYGEN
  639. CustomData()
  640. : type(nullptr),
  641. key(nullptr),
  642. value(nullptr) {}
  643. #endif
  644. };
  645. /**@}*/
  646. // forward declarations of commonly used Carla classes
  647. class CarlaEngine;
  648. class CarlaPlugin;
  649. CARLA_BACKEND_END_NAMESPACE
  650. #endif // __CARLA_BACKEND_HPP__