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.
39 Commits
17 Branches
510MB
Tree: 0aeeaddd34
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0aeeaddd34'
${ noResults }
Carla/source/backend/carla_standalone.hpp

182 lines
6.6KB
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 "carla_backend.hpp"

  22. 

  23. // TODO - create struct for internal plugin info

  24. // TODO - dont strdup() on const-char* returns, use static char[STR_MAX]

  25. 

  26. CARLA_BACKEND_START_NAMESPACE

  27. 

  28. /*!

  29.  * @defgroup CarlaBackendStandalone Carla Backend Standalone

  30.  *

  31.  * The Carla Backend Standalone API

  32.  *

  33.  * @{

  34.  */

  35. 

  36. #if 0

  37. struct PluginInfo {

  38.     PluginType type;

  39.     PluginCategory 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. 

  48.     PluginInfo()

  49.         : type(PLUGIN_NONE),

  50.           category(PLUGIN_CATEGORY_NONE),

  51.           hints(0x0),

  52.           binary(nullptr),

  53.           name(nullptr),

  54.           label(nullptr),

  55.           maker(nullptr),

  56.           copyright(nullptr),

  57.           uniqueId(0) {}

  58. };

  59. 

  60. struct PortCountInfo {

  61.     uint32_t ins;

  62.     uint32_t outs;

  63.     uint32_t total;

  64. 

  65.     PortCountInfo()

  66.         : ins(0),

  67.           outs(0),

  68.           total(0) {}

  69. };

  70. 

  71. struct ParameterInfo {

  72.     const char* name;

  73.     const char* symbol;

  74.     const char* unit;

  75.     uint32_t scalePointCount;

  76. 

  77.     ParameterInfo()

  78.         : name(nullptr),

  79.           symbol(nullptr),

  80.           unit(nullptr),

  81.           scalePointCount(0) {}

  82. };

  83. 

  84. struct ScalePointInfo {

  85.     double value;

  86.     const char* label;

  87. 

  88.     ScalePointInfo()

  89.         : value(0.0),

  90.           label(nullptr) {}

  91. };

  92. #endif

  93. 

  94. CARLA_EXPORT const char* carla_get_extended_license_text();

  95. 

  96. CARLA_EXPORT unsigned int carla_get_engine_driver_count();

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

  98. 

  99. #if 0

  100. CARLA_EXPORT unsigned int get_internal_plugin_count();

  101. CARLA_EXPORT const PluginInfo* get_internal_plugin_info(unsigned int pluginId);

  102. 

  103. CARLA_EXPORT bool engine_init(const char* driverName, const char* clientName);

  104. CARLA_EXPORT bool engine_close();

  105. CARLA_EXPORT bool is_engine_running();

  106. 

  107. CARLA_EXPORT int  add_plugin(BinaryType btype, PluginType ptype, const char* filename, const char* name, const char* label, void* extraPtr);

  108. CARLA_EXPORT bool remove_plugin(unsigned int pluginId);

  109. 

  110. CARLA_EXPORT const PluginInfo* get_plugin_info(unsigned int pluginId);

  111. CARLA_EXPORT const PortCountInfo* get_audio_port_count_info(unsigned int pluginId);

  112. CARLA_EXPORT const PortCountInfo* get_midi_port_count_info(unsigned int pluginId);

  113. CARLA_EXPORT const PortCountInfo* get_parameter_count_info(unsigned int pluginId);

  114. CARLA_EXPORT const ParameterInfo* get_parameter_info(unsigned short plugin_id, uint32_t parameterId);

  115. CARLA_EXPORT const ScalePointInfo* get_parameter_scalepoint_info(unsigned int pluginId, uint32_t parameterId, uint32_t scalePointId);

  116. 

  117. CARLA_EXPORT const ParameterData* get_parameter_data(unsigned int pluginId, uint32_t parameterId);

  118. CARLA_EXPORT const ParameterRanges* get_parameter_ranges(unsigned int pluginId, uint32_t parameterId);

  119. CARLA_EXPORT const MidiProgramData* get_midi_program_data(unsigned int pluginId, uint32_t midiProgramId);

  120. CARLA_EXPORT const CustomData* get_custom_data(unsigned int pluginId, uint32_t customDataId);

  121. CARLA_EXPORT const char* get_chunk_data(unsigned int pluginId);

  122. 

  123. CARLA_EXPORT uint32_t get_parameter_count(unsigned int pluginId);

  124. CARLA_EXPORT uint32_t get_program_count(unsigned int pluginId);

  125. CARLA_EXPORT uint32_t get_midi_program_count(unsigned int pluginId);

  126. CARLA_EXPORT uint32_t get_custom_data_count(unsigned int pluginId);

  127. 

  128. CARLA_EXPORT const char* get_parameter_text(unsigned int pluginId, uint32_t parameterId);

  129. CARLA_EXPORT const char* get_program_name(unsigned int pluginId, uint32_t programId);

  130. CARLA_EXPORT const char* get_midi_program_name(unsigned int pluginId, uint32_t midiProgramId);

  131. CARLA_EXPORT const char* get_real_plugin_name(unsigned int pluginId);

  132. 

  133. CARLA_EXPORT int32_t get_current_program_index(unsigned int pluginId);

  134. CARLA_EXPORT int32_t get_current_midi_program_index(unsigned int pluginId);

  135. 

  136. CARLA_EXPORT double get_default_parameter_value(unsigned int pluginId, uint32_t parameterId);

  137. CARLA_EXPORT double get_current_parameter_value(unsigned int pluginId, uint32_t parameterId);

  138. 

  139. CARLA_EXPORT double get_input_peak_value(unsigned int pluginId, unsigned short portId);

  140. CARLA_EXPORT double get_output_peak_value(unsigned int pluginId, unsigned short portId);

  141. 

  142. CARLA_EXPORT void set_active(unsigned int pluginId, bool onOff);

  143. CARLA_EXPORT void set_drywet(unsigned int pluginId, double value);

  144. CARLA_EXPORT void set_volume(unsigned int pluginId, double value);

  145. CARLA_EXPORT void set_balance_left(unsigned int pluginId, double value);

  146. CARLA_EXPORT void set_balance_right(unsigned int pluginId, double value);

  147. 

  148. CARLA_EXPORT void set_parameter_value(unsigned int pluginId, uint32_t parameterId, double value);

  149. CARLA_EXPORT void set_parameter_midi_channel(unsigned int pluginId, uint32_t parameterId, uint8_t channel);

  150. CARLA_EXPORT void set_parameter_midi_cc(unsigned int pluginId, uint32_t parameterId, int16_t cc);

  151. CARLA_EXPORT void set_program(unsigned int pluginId, uint32_t programId);

  152. CARLA_EXPORT void set_midi_program(unsigned int pluginId, uint32_t midiProgramId);

  153. 

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

  155. CARLA_EXPORT void set_chunk_data(unsigned int pluginId, const char* chunkData);

  156. 

  157. CARLA_EXPORT void show_gui(unsigned int pluginId, bool yesNo);

  158. CARLA_EXPORT void idle_guis();

  159. 

  160. CARLA_EXPORT void send_midi_note(unsigned int pluginId, uint8_t channel, uint8_t note, uint8_t velocity);

  161. CARLA_EXPORT void prepare_for_save(unsigned int pluginId);

  162. 

  163. CARLA_EXPORT uint32_t get_buffer_size();

  164. CARLA_EXPORT double   get_sample_rate();

  165. 

  166. CARLA_EXPORT const char* get_last_error();

  167. CARLA_EXPORT const char* get_host_osc_url();

  168. 

  169. CARLA_EXPORT void set_callback_function(CallbackFunc func);

  170. CARLA_EXPORT void set_option(OptionsType option, int value, const char* valueStr);

  171. 

  172. CARLA_EXPORT void nsm_announce(const char* url, int pid);

  173. CARLA_EXPORT void nsm_reply_open();

  174. CARLA_EXPORT void nsm_reply_save();

  175. #endif

  176. 

  177. /**@}*/

  178. 

  179. CARLA_BACKEND_END_NAMESPACE

  180. 

  181. #endif // __CARLA_STANDALONE_HPP__