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.
96 Commits
16 Branches
310MB
Tree: 353ad65fc8
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '353ad65fc8'
${ noResults }
Carla/source/backend/CarlaStandalone.hpp

243 lines
8.8KB
Raw Blame History 

  1. /*

  2.  * Carla Standalone 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. 

  18. #ifndef __CARLA_STANDALONE_HPP__

  19. #define __CARLA_STANDALONE_HPP__

  20. 

  21. #include "CarlaBackend.hpp"

  22. 

  23. /*!

  24.  * @defgroup CarlaBackendStandalone Carla Backend Standalone

  25.  *

  26.  * The Carla Backend Standalone API

  27.  *

  28.  * @{

  29.  */

  30. 

  31. typedef CarlaBackend::BinaryType CarlaBinaryType;

  32. typedef CarlaBackend::PluginType CarlaPluginType;

  33. typedef CarlaBackend::PluginCategory CarlaPluginCategory;

  34. typedef CarlaBackend::OptionsType CarlaOptionsType;

  35. typedef CarlaBackend::CallbackFunc CarlaCallbackFunc;

  36. 

  37. struct CarlaPluginInfo {

  38.     CarlaPluginType type;

  39.     CarlaPluginCategory category;

  40.     unsigned int hints;

  41.     const char* binary;

  42.     const char* name;

  43.     const char* label;

  44.     const char* maker;

  45.     const char* copyright;

  46.     long uniqueId;

  47.     uint32_t latency;

  48. 

  49.     CarlaPluginInfo()

  50.         : type(CarlaBackend::PLUGIN_NONE),

  51.           category(CarlaBackend::PLUGIN_CATEGORY_NONE),

  52.           hints(0x0),

  53.           binary(nullptr),

  54.           name(nullptr),

  55.           label(nullptr),

  56.           maker(nullptr),

  57.           copyright(nullptr),

  58.           uniqueId(0),

  59.           latency(0) {}

  60. 

  61.     ~CarlaPluginInfo()

  62.     {

  63.         if (label != nullptr)

  64.             delete[] label;

  65.         if (maker != nullptr)

  66.             delete[] maker;

  67.         if (copyright != nullptr)

  68.             delete[] copyright;

  69.     }

  70. };

  71. 

  72. struct CarlaNativePluginInfo {

  73.     CarlaPluginCategory category;

  74.     unsigned int hints;

  75.     uint32_t audioIns;

  76.     uint32_t audioOuts;

  77.     uint32_t midiIns;

  78.     uint32_t midiOuts;

  79.     uint32_t parameterIns;

  80.     uint32_t parameterOuts;

  81.     const char* name;

  82.     const char* label;

  83.     const char* maker;

  84.     const char* copyright;

  85. 

  86.     CarlaNativePluginInfo()

  87.         : category(CarlaBackend::PLUGIN_CATEGORY_NONE),

  88.           hints(0x0),

  89.           audioIns(0),

  90.           audioOuts(0),

  91.           midiIns(0),

  92.           midiOuts(0),

  93.           parameterIns(0),

  94.           parameterOuts(0),

  95.           name(nullptr),

  96.           label(nullptr),

  97.           maker(nullptr),

  98.           copyright(nullptr) {}

  99. };

  100. 

  101. struct CarlaPortCountInfo {

  102.     uint32_t ins;

  103.     uint32_t outs;

  104.     uint32_t total;

  105. 

  106.     CarlaPortCountInfo()

  107.         : ins(0),

  108.           outs(0),

  109.           total(0) {}

  110. };

  111. 

  112. struct CarlaParameterInfo {

  113.     const char* name;

  114.     const char* symbol;

  115.     const char* unit;

  116.     uint32_t scalePointCount;

  117. 

  118.     CarlaParameterInfo()

  119.         : name(nullptr),

  120.           symbol(nullptr),

  121.           unit(nullptr),

  122.           scalePointCount(0) {}

  123. 

  124.     ~CarlaParameterInfo()

  125.     {

  126.         if (name != nullptr)

  127.             delete[] name;

  128.         if (symbol != nullptr)

  129.             delete[] symbol;

  130.         if (unit != nullptr)

  131.             delete[] unit;

  132.     }

  133. };

  134. 

  135. struct CarlaScalePointInfo {

  136.     float value;

  137.     const char* label;

  138. 

  139.     CarlaScalePointInfo()

  140.         : value(0.0f),

  141.           label(nullptr) {}

  142. 

  143.     ~CarlaScalePointInfo()

  144.     {

  145.         if (label != nullptr)

  146.             delete[] label;

  147.     }

  148. };

  149. 

  150. CARLA_EXPORT const char* carla_get_extended_license_text();

  151. 

  152. CARLA_EXPORT unsigned int carla_get_engine_driver_count();

  153. CARLA_EXPORT const char* carla_get_engine_driver_name(unsigned int index);

  154. 

  155. CARLA_EXPORT unsigned int carla_get_internal_plugin_count();

  156. CARLA_EXPORT const CarlaNativePluginInfo* carla_get_internal_plugin_info(unsigned int internalPluginId);

  157. 

  158. CARLA_EXPORT bool carla_engine_init(const char* driverName, const char* clientName);

  159. CARLA_EXPORT bool carla_engine_close();

  160. CARLA_EXPORT void carla_engine_idle();

  161. CARLA_EXPORT bool carla_is_engine_running();

  162. 

  163. CARLA_EXPORT bool carla_load_project(const char* filename);

  164. CARLA_EXPORT bool carla_save_project(const char* filename);

  165. 

  166. CARLA_EXPORT bool carla_add_plugin(CarlaBinaryType btype, CarlaPluginType ptype, const char* filename, const char* name, const char* label, void* extraPtr);

  167. CARLA_EXPORT bool carla_remove_plugin(unsigned int pluginId);

  168. CARLA_EXPORT void carla_remove_all_plugins();

  169. 

  170. //CARLA_EXPORT bool carla_load_plugin_state(unsigned int pluginId, const char* filename);

  171. //CARLA_EXPORT bool carla_save_plugin_state(unsigned int pluginId, const char* filename);

  172. 

  173. CARLA_EXPORT const CarlaPluginInfo* carla_get_plugin_info(unsigned int pluginId);

  174. CARLA_EXPORT const CarlaPortCountInfo* carla_get_audio_port_count_info(unsigned int pluginId);

  175. CARLA_EXPORT const CarlaPortCountInfo* carla_get_midi_port_count_info(unsigned int pluginId);

  176. CARLA_EXPORT const CarlaPortCountInfo* carla_get_parameter_count_info(unsigned int pluginId);

  177. CARLA_EXPORT const CarlaParameterInfo* carla_get_parameter_info(unsigned int pluginId, uint32_t parameterId);

  178. CARLA_EXPORT const CarlaScalePointInfo* carla_get_parameter_scalepoint_info(unsigned int pluginId, uint32_t parameterId, uint32_t scalePointId);

  179. 

  180. CARLA_EXPORT const CarlaBackend::ParameterData* carla_get_parameter_data(unsigned int pluginId, uint32_t parameterId);

  181. CARLA_EXPORT const CarlaBackend::ParameterRanges* carla_get_parameter_ranges(unsigned int pluginId, uint32_t parameterId);

  182. CARLA_EXPORT const CarlaBackend::MidiProgramData* carla_get_midi_program_data(unsigned int pluginId, uint32_t midiProgramId);

  183. CARLA_EXPORT const CarlaBackend::CustomData* carla_get_custom_data(unsigned int pluginId, uint32_t customDataId);

  184. CARLA_EXPORT const char* carla_get_chunk_data(unsigned int pluginId);

  185. 

  186. CARLA_EXPORT uint32_t carla_get_parameter_count(unsigned int pluginId);

  187. CARLA_EXPORT uint32_t carla_get_program_count(unsigned int pluginId);

  188. CARLA_EXPORT uint32_t carla_get_midi_program_count(unsigned int pluginId);

  189. CARLA_EXPORT uint32_t carla_get_custom_data_count(unsigned int pluginId);

  190. 

  191. CARLA_EXPORT const char* carla_get_parameter_text(unsigned int pluginId, uint32_t parameterId);

  192. CARLA_EXPORT const char* carla_get_program_name(unsigned int pluginId, uint32_t programId);

  193. CARLA_EXPORT const char* carla_get_midi_program_name(unsigned int pluginId, uint32_t midiProgramId);

  194. CARLA_EXPORT const char* carla_get_real_plugin_name(unsigned int pluginId);

  195. 

  196. CARLA_EXPORT int32_t carla_get_current_program_index(unsigned int pluginId);

  197. CARLA_EXPORT int32_t carla_get_current_midi_program_index(unsigned int pluginId);

  198. 

  199. CARLA_EXPORT float carla_get_default_parameter_value(unsigned int pluginId, uint32_t parameterId);

  200. CARLA_EXPORT float carla_get_current_parameter_value(unsigned int pluginId, uint32_t parameterId);

  201. 

  202. CARLA_EXPORT float carla_get_input_peak_value(unsigned int pluginId, unsigned short portId);

  203. CARLA_EXPORT float carla_get_output_peak_value(unsigned int pluginId, unsigned short portId);

  204. 

  205. CARLA_EXPORT void carla_set_active(unsigned int pluginId, bool onOff);

  206. CARLA_EXPORT void carla_set_drywet(unsigned int pluginId, float value);

  207. CARLA_EXPORT void carla_set_volume(unsigned int pluginId, float value);

  208. CARLA_EXPORT void carla_set_balance_left(unsigned int pluginId, float value);

  209. CARLA_EXPORT void carla_set_balance_right(unsigned int pluginId, float value);

  210. CARLA_EXPORT void carla_set_panning(unsigned int pluginId, float value);

  211. 

  212. CARLA_EXPORT void carla_set_parameter_value(unsigned int pluginId, uint32_t parameterId, float value);

  213. CARLA_EXPORT void carla_set_parameter_midi_channel(unsigned int pluginId, uint32_t parameterId, uint8_t channel);

  214. CARLA_EXPORT void carla_set_parameter_midi_cc(unsigned int pluginId, uint32_t parameterId, int16_t cc);

  215. CARLA_EXPORT void carla_set_program(unsigned int pluginId, uint32_t programId);

  216. CARLA_EXPORT void carla_set_midi_program(unsigned int pluginId, uint32_t midiProgramId);

  217. 

  218. CARLA_EXPORT void carla_set_custom_data(unsigned int pluginId, const char* type, const char* key, const char* value);

  219. CARLA_EXPORT void carla_set_chunk_data(unsigned int pluginId, const char* chunkData);

  220. 

  221. CARLA_EXPORT void carla_prepare_for_save(unsigned int pluginId);

  222. CARLA_EXPORT void carla_send_midi_note(unsigned int pluginId, uint8_t channel, uint8_t note, uint8_t velocity);

  223. CARLA_EXPORT void carla_show_gui(unsigned int pluginId, bool yesNo);

  224. 

  225. CARLA_EXPORT uint32_t carla_get_buffer_size();

  226. CARLA_EXPORT double   carla_get_sample_rate();

  227. 

  228. CARLA_EXPORT const char* carla_get_last_error();

  229. CARLA_EXPORT const char* carla_get_host_osc_url();

  230. 

  231. CARLA_EXPORT void carla_set_callback_function(CarlaCallbackFunc func);

  232. CARLA_EXPORT void carla_set_option(CarlaOptionsType option, int value, const char* valueStr);

  233. 

  234. #if 0

  235. CARLA_EXPORT void carla_nsm_announce(const char* url, int pid);

  236. CARLA_EXPORT void carla_nsm_reply_open();

  237. CARLA_EXPORT void carla_nsm_reply_save();

  238. #endif

  239. 

  240. /**@}*/

  241. 

  242. #endif // __CARLA_STANDALONE_HPP__