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.
512 Commits
16 Branches
14GB
Tree: 591530b1e4
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '591530b1e4'
${ noResults }
Carla/source/carla_backend.py

901 lines
31KB
Raw Blame History 

  1. #!/usr/bin/env python3

  2. # -*- coding: utf-8 -*-

  3. 

  4. # Carla Backend code

  5. # Copyright (C) 2011-2013 Filipe Coelho <falktx@falktx.com>

  6. #

  7. # This program is free software; you can redistribute it and/or

  8. # modify it under the terms of the GNU General Public License as

  9. # published by the Free Software Foundation; either version 2 of

  10. # the License, or any later version.

  11. #

  12. # This program is distributed in the hope that it will be useful,

  13. # but WITHOUT ANY WARRANTY; without even the implied warranty of

  14. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

  15. # GNU General Public License for more details.

  16. #

  17. # For a full copy of the GNU General Public License see the GPL.txt file

  18. 

  19. # ------------------------------------------------------------------------------------------------------------

  20. # Imports (Global)

  21. 

  22. from ctypes import *

  23. from platform import architecture

  24. from sys import platform, maxsize

  25. 

  26. # ------------------------------------------------------------------------------------------------------------

  27. # 64bit check

  28. 

  29. kIs64bit = bool(architecture()[0] == "64bit" and maxsize > 2**32)

  30. 

  31. # ------------------------------------------------------------------------------------------------------------

  32. # Set Platform

  33. 

  34. if platform == "darwin":

  35.     HAIKU   = False

  36.     LINUX   = False

  37.     MACOS   = True

  38.     WINDOWS = False

  39. elif "haiku" in platform:

  40.     HAIKU   = True

  41.     LINUX   = False

  42.     MACOS   = False

  43.     WINDOWS = False

  44. elif "linux" in platform:

  45.     HAIKU   = False

  46.     LINUX   = True

  47.     MACOS   = False

  48.     WINDOWS = False

  49. elif platform in ("win32", "win64", "cygwin"):

  50.     HAIKU   = False

  51.     LINUX   = False

  52.     MACOS   = False

  53.     WINDOWS = True

  54. else:

  55.     HAIKU   = False

  56.     LINUX   = False

  57.     MACOS   = False

  58.     WINDOWS = False

  59. 

  60. # ------------------------------------------------------------------------------------------------------------

  61. # Convert a ctypes char** into a python string list

  62. 

  63. def charStringList(charPtr):

  64.     i = 0

  65.     retList = []

  66. 

  67.     if not charPtr:

  68.         return retList

  69. 

  70.     while True:

  71.         char_p = charPtr[i]

  72. 

  73.         if not char_p:

  74.             break

  75. 

  76.         retList.append(char_p.decode("utf-8", errors="ignore"))

  77.         i += 1

  78. 

  79.     return retList

  80. 

  81. # ------------------------------------------------------------------------------------------------------------

  82. # Convert a ctypes struct into a python dict

  83. 

  84. def structToDict(struct):

  85.     return dict((attr, getattr(struct, attr)) for attr, value in struct._fields_)

  86. 

  87. # ------------------------------------------------------------------------------------------------

  88. # Backend defines

  89. 

  90. MAX_DEFAULT_PLUGINS    = 99

  91. MAX_RACK_PLUGINS       = 16

  92. MAX_PATCHBAY_PLUGINS   = 999

  93. MAX_DEFAULT_PARAMETERS = 200

  94. 

  95. # Plugin Hints

  96. PLUGIN_IS_BRIDGE         = 0x001

  97. PLUGIN_IS_RTSAFE         = 0x002

  98. PLUGIN_IS_SYNTH          = 0x004

  99. PLUGIN_HAS_GUI           = 0x010

  100. PLUGIN_HAS_SINGLE_THREAD = 0x020

  101. PLUGIN_CAN_DRYWET        = 0x100

  102. PLUGIN_CAN_VOLUME        = 0x200

  103. PLUGIN_CAN_BALANCE       = 0x400

  104. PLUGIN_CAN_PANNING       = 0x800

  105. 

  106. # Plugin Options

  107. PLUGIN_OPTION_FIXED_BUFFER          = 0x001

  108. PLUGIN_OPTION_FORCE_STEREO          = 0x002

  109. PLUGIN_OPTION_MAP_PROGRAM_CHANGES   = 0x004

  110. PLUGIN_OPTION_USE_CHUNKS            = 0x008

  111. PLUGIN_OPTION_SEND_CONTROL_CHANGES  = 0x010

  112. PLUGIN_OPTION_SEND_CHANNEL_PRESSURE = 0x020

  113. PLUGIN_OPTION_SEND_NOTE_AFTERTOUCH  = 0x040

  114. PLUGIN_OPTION_SEND_PITCHBEND        = 0x080

  115. PLUGIN_OPTION_SEND_ALL_SOUND_OFF    = 0x100

  116. 

  117. # Parameter Hints

  118. PARAMETER_IS_BOOLEAN       = 0x01

  119. PARAMETER_IS_INTEGER       = 0x02

  120. PARAMETER_IS_LOGARITHMIC   = 0x04

  121. PARAMETER_IS_ENABLED       = 0x08

  122. PARAMETER_IS_AUTOMABLE     = 0x10

  123. PARAMETER_USES_SAMPLERATE  = 0x20

  124. PARAMETER_USES_SCALEPOINTS = 0x40

  125. PARAMETER_USES_CUSTOM_TEXT = 0x80

  126. 

  127. # Patchbay Port Hints

  128. PATCHBAY_PORT_IS_INPUT  = 0x1

  129. PATCHBAY_PORT_IS_OUTPUT = 0x2

  130. PATCHBAY_PORT_IS_AUDIO  = 0x4

  131. PATCHBAY_PORT_IS_MIDI   = 0x8

  132. 

  133. # Custom Data types

  134. CUSTOM_DATA_INVALID = None

  135. CUSTOM_DATA_CHUNK   = "http://kxstudio.sf.net/ns/carla/chunk"

  136. CUSTOM_DATA_STRING  = "http://kxstudio.sf.net/ns/carla/string"

  137. 

  138. # Binary Type

  139. BINARY_NONE    = 0

  140. BINARY_POSIX32 = 1

  141. BINARY_POSIX64 = 2

  142. BINARY_WIN32   = 3

  143. BINARY_WIN64   = 4

  144. BINARY_OTHER   = 5

  145. 

  146. # Plugin Type

  147. PLUGIN_NONE     = 0

  148. PLUGIN_INTERNAL = 1

  149. PLUGIN_LADSPA   = 2

  150. PLUGIN_DSSI     = 3

  151. PLUGIN_LV2      = 4

  152. PLUGIN_VST      = 5

  153. PLUGIN_VST3     = 6

  154. PLUGIN_GIG      = 7

  155. PLUGIN_SF2      = 8

  156. PLUGIN_SFZ      = 9

  157. 

  158. # Plugin Category

  159. PLUGIN_CATEGORY_NONE      = 0

  160. PLUGIN_CATEGORY_SYNTH     = 1

  161. PLUGIN_CATEGORY_DELAY     = 2 # also Reverb

  162. PLUGIN_CATEGORY_EQ        = 3

  163. PLUGIN_CATEGORY_FILTER    = 4

  164. PLUGIN_CATEGORY_DYNAMICS  = 5 # Amplifier, Compressor, Gate

  165. PLUGIN_CATEGORY_MODULATOR = 6 # Chorus, Flanger, Phaser

  166. PLUGIN_CATEGORY_UTILITY   = 7 # Analyzer, Converter, Mixer

  167. PLUGIN_CATEGORY_OTHER     = 8 # used to check if a plugin has a category

  168. 

  169. # Parameter Type

  170. PARAMETER_UNKNOWN       = 0

  171. PARAMETER_INPUT         = 1

  172. PARAMETER_OUTPUT        = 2

  173. PARAMETER_LATENCY       = 3

  174. PARAMETER_SAMPLE_RATE   = 4

  175. PARAMETER_LV2_FREEWHEEL = 5

  176. PARAMETER_LV2_TIME      = 6

  177. 

  178. # Internal Parameters Index

  179. PARAMETER_NULL          = -1

  180. PARAMETER_ACTIVE        = -2

  181. PARAMETER_DRYWET        = -3

  182. PARAMETER_VOLUME        = -4

  183. PARAMETER_BALANCE_LEFT  = -5

  184. PARAMETER_BALANCE_RIGHT = -6

  185. PARAMETER_PANNING       = -7

  186. PARAMETER_CTRL_CHANNEL  = -8

  187. PARAMETER_MAX           = -9

  188. 

  189. # Options Type

  190. OPTION_PROCESS_NAME            = 0

  191. OPTION_PROCESS_MODE            = 1

  192. OPTION_TRANSPORT_MODE          = 2

  193. OPTION_FORCE_STEREO            = 3

  194. OPTION_PREFER_PLUGIN_BRIDGES   = 4

  195. OPTION_PREFER_UI_BRIDGES       = 5

  196. OPTION_USE_DSSI_VST_CHUNKS     = 6

  197. OPTION_MAX_PARAMETERS          = 7

  198. OPTION_OSC_UI_TIMEOUT          = 8

  199. OPTION_JACK_AUTOCONNECT        = 9

  200. OPTION_JACK_TIMEMASTER         = 10

  201. OPTION_RTAUDIO_BUFFER_SIZE     = 11

  202. OPTION_RTAUDIO_SAMPLE_RATE     = 12

  203. OPTION_RTAUDIO_DEVICE          = 13

  204. OPTION_PATH_BRIDGE_NATIVE      = 14

  205. OPTION_PATH_BRIDGE_POSIX32     = 15

  206. OPTION_PATH_BRIDGE_POSIX64     = 16

  207. OPTION_PATH_BRIDGE_WIN32       = 17

  208. OPTION_PATH_BRIDGE_WIN64       = 18

  209. OPTION_PATH_BRIDGE_LV2_GTK2    = 19

  210. OPTION_PATH_BRIDGE_LV2_GTK3    = 20

  211. OPTION_PATH_BRIDGE_LV2_QT4     = 21

  212. OPTION_PATH_BRIDGE_LV2_QT5     = 22

  213. OPTION_PATH_BRIDGE_LV2_COCOA   = 23

  214. OPTION_PATH_BRIDGE_LV2_WINDOWS = 24

  215. OPTION_PATH_BRIDGE_LV2_X11     = 25

  216. OPTION_PATH_BRIDGE_VST_COCOA   = 26

  217. OPTION_PATH_BRIDGE_VST_HWND    = 27

  218. OPTION_PATH_BRIDGE_VST_X11     = 28

  219. 

  220. # Callback Type

  221. CALLBACK_DEBUG          = 0

  222. CALLBACK_PLUGIN_ADDED   = 1

  223. CALLBACK_PLUGIN_REMOVED = 2

  224. CALLBACK_PLUGIN_RENAMED = 3

  225. CALLBACK_PARAMETER_VALUE_CHANGED        = 4

  226. CALLBACK_PARAMETER_DEFAULT_CHANGED      = 5

  227. CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED = 6

  228. CALLBACK_PARAMETER_MIDI_CC_CHANGED      = 7

  229. CALLBACK_PROGRAM_CHANGED         = 8

  230. CALLBACK_MIDI_PROGRAM_CHANGED    = 9

  231. CALLBACK_NOTE_ON                 = 10

  232. CALLBACK_NOTE_OFF                = 11

  233. CALLBACK_SHOW_GUI                = 12

  234. CALLBACK_UPDATE                  = 13

  235. CALLBACK_RELOAD_INFO             = 14

  236. CALLBACK_RELOAD_PARAMETERS       = 15

  237. CALLBACK_RELOAD_PROGRAMS         = 16

  238. CALLBACK_RELOAD_ALL              = 17

  239. CALLBACK_PATCHBAY_CLIENT_ADDED   = 18

  240. CALLBACK_PATCHBAY_CLIENT_REMOVED = 19

  241. CALLBACK_PATCHBAY_CLIENT_RENAMED = 20

  242. CALLBACK_PATCHBAY_PORT_ADDED         = 21

  243. CALLBACK_PATCHBAY_PORT_REMOVED       = 22

  244. CALLBACK_PATCHBAY_PORT_RENAMED       = 23

  245. CALLBACK_PATCHBAY_CONNECTION_ADDED   = 24

  246. CALLBACK_PATCHBAY_CONNECTION_REMOVED = 25

  247. CALLBACK_BUFFER_SIZE_CHANGED = 26

  248. CALLBACK_SAMPLE_RATE_CHANGED = 27

  249. CALLBACK_NSM_ANNOUNCE = 28

  250. CALLBACK_NSM_OPEN     = 29

  251. CALLBACK_NSM_SAVE     = 30

  252. CALLBACK_ERROR        = 31

  253. CALLBACK_QUIT         = 32

  254. 

  255. # Process Mode

  256. PROCESS_MODE_SINGLE_CLIENT    = 0

  257. PROCESS_MODE_MULTIPLE_CLIENTS = 1

  258. PROCESS_MODE_CONTINUOUS_RACK  = 2

  259. PROCESS_MODE_PATCHBAY         = 3

  260. PROCESS_MODE_BRIDGE           = 4

  261. 

  262. # Transport Mode

  263. TRANSPORT_MODE_INTERNAL = 0

  264. TRANSPORT_MODE_JACK     = 1

  265. TRANSPORT_MODE_BRIDGE   = 2

  266. 

  267. # Set BINARY_NATIVE

  268. if HAIKU or LINUX or MACOS:

  269.     BINARY_NATIVE = BINARY_POSIX64 if kIs64bit else BINARY_POSIX32

  270. elif WINDOWS:

  271.     BINARY_NATIVE = BINARY_WIN64 if kIs64bit else BINARY_WIN32

  272. else:

  273.     BINARY_NATIVE = BINARY_OTHER

  274. 

  275. # ------------------------------------------------------------------------------------------------------------

  276. # Backend C++ -> Python variables

  277. 

  278. c_enum = c_int

  279. c_nullptr = None

  280. 

  281. CallbackFunc = CFUNCTYPE(None, c_void_p, c_enum, c_uint, c_int, c_int, c_float, c_char_p)

  282. 

  283. class ParameterData(Structure):

  284.     _fields_ = [

  285.         ("type", c_enum),

  286.         ("index", c_int32),

  287.         ("rindex", c_int32),

  288.         ("hints", c_uint32),

  289.         ("midiChannel", c_uint8),

  290.         ("midiCC", c_int16)

  291.     ]

  292. 

  293. class ParameterRanges(Structure):

  294.     _fields_ = [

  295.         ("def", c_float),

  296.         ("min", c_float),

  297.         ("max", c_float),

  298.         ("step", c_float),

  299.         ("stepSmall", c_float),

  300.         ("stepLarge", c_float)

  301.     ]

  302. 

  303. class MidiProgramData(Structure):

  304.     _fields_ = [

  305.         ("bank", c_uint32),

  306.         ("program", c_uint32),

  307.         ("name", c_char_p)

  308.     ]

  309. 

  310. class CustomData(Structure):

  311.     _fields_ = [

  312.         ("type", c_char_p),

  313.         ("key", c_char_p),

  314.         ("value", c_char_p)

  315.     ]

  316. 

  317. # ------------------------------------------------------------------------------------------------------------

  318. # Standalone C++ -> Python variables

  319. 

  320. class CarlaPluginInfo(Structure):

  321.     _fields_ = [

  322.         ("type", c_enum),

  323.         ("category", c_enum),

  324.         ("hints", c_uint),

  325.         ("optionsAvailable", c_uint),

  326.         ("optionsEnabled", c_uint),

  327.         ("binary", c_char_p),

  328.         ("name", c_char_p),

  329.         ("label", c_char_p),

  330.         ("maker", c_char_p),

  331.         ("copyright", c_char_p),

  332.         ("uniqueId", c_long),

  333.         ("latency", c_uint32)

  334.     ]

  335. 

  336. class CarlaNativePluginInfo(Structure):

  337.     _fields_ = [

  338.         ("category", c_enum),

  339.         ("hints", c_uint),

  340.         ("audioIns", c_uint32),

  341.         ("audioOuts", c_uint32),

  342.         ("midiIns", c_uint32),

  343.         ("midiOuts", c_uint32),

  344.         ("parameterIns", c_uint32),

  345.         ("parameterOuts", c_uint32),

  346.         ("name", c_char_p),

  347.         ("label", c_char_p),

  348.         ("maker", c_char_p),

  349.         ("copyright", c_char_p)

  350.     ]

  351. 

  352. class CarlaPortCountInfo(Structure):

  353.     _fields_ = [

  354.         ("ins", c_uint32),

  355.         ("outs", c_uint32),

  356.         ("total", c_uint32)

  357.     ]

  358. 

  359. class CarlaParameterInfo(Structure):

  360.     _fields_ = [

  361.         ("name", c_char_p),

  362.         ("symbol", c_char_p),

  363.         ("unit", c_char_p),

  364.         ("scalePointCount", c_uint32)

  365.     ]

  366. 

  367. class CarlaScalePointInfo(Structure):

  368.     _fields_ = [

  369.         ("value", c_float),

  370.         ("label", c_char_p)

  371.     ]

  372. 

  373. class CarlaTransportInfo(Structure):

  374.     _fields_ = [

  375.         ("playing", c_bool),

  376.         ("frame", c_uint32),

  377.         ("bar", c_int32),

  378.         ("beat", c_int32),

  379.         ("tick", c_int32),

  380.         ("bpm", c_double)

  381.     ]

  382. 

  383. # ------------------------------------------------------------------------------------------------------------

  384. # Standalone Python object

  385. 

  386. class Host(object):

  387.     def __init__(self, libName):

  388.         object.__init__(self)

  389. 

  390.         self.lib = cdll.LoadLibrary(libName)

  391. 

  392.         self.lib.carla_get_extended_license_text.argtypes = None

  393.         self.lib.carla_get_extended_license_text.restype = c_char_p

  394. 

  395.         self.lib.carla_get_supported_file_types.argtypes = None

  396.         self.lib.carla_get_supported_file_types.restype = c_char_p

  397. 

  398.         self.lib.carla_get_engine_driver_count.argtypes = None

  399.         self.lib.carla_get_engine_driver_count.restype = c_uint

  400. 

  401.         self.lib.carla_get_engine_driver_name.argtypes = [c_uint]

  402.         self.lib.carla_get_engine_driver_name.restype = c_char_p

  403. 

  404.         self.lib.carla_get_engine_driver_device_names.argtypes = [c_uint]

  405.         self.lib.carla_get_engine_driver_device_names.restype = POINTER(c_char_p)

  406. 

  407.         self.lib.carla_get_internal_plugin_count.argtypes = None

  408.         self.lib.carla_get_internal_plugin_count.restype = c_uint

  409. 

  410.         self.lib.carla_get_internal_plugin_info.argtypes = [c_uint]

  411.         self.lib.carla_get_internal_plugin_info.restype = POINTER(CarlaNativePluginInfo)

  412. 

  413.         self.lib.carla_engine_init.argtypes = [c_char_p, c_char_p]

  414.         self.lib.carla_engine_init.restype = c_bool

  415. 

  416.         self.lib.carla_engine_close.argtypes = None

  417.         self.lib.carla_engine_close.restype = c_bool

  418. 

  419.         self.lib.carla_engine_idle.argtypes = None

  420.         self.lib.carla_engine_idle.restype = None

  421. 

  422.         self.lib.carla_is_engine_running.argtypes = None

  423.         self.lib.carla_is_engine_running.restype = c_bool

  424. 

  425.         self.lib.carla_set_engine_about_to_close.argtypes = None

  426.         self.lib.carla_set_engine_about_to_close.restype = None

  427. 

  428.         self.lib.carla_set_engine_callback.argtypes = [CallbackFunc, c_void_p]

  429.         self.lib.carla_set_engine_callback.restype = None

  430. 

  431.         self.lib.carla_set_engine_option.argtypes = [c_enum, c_int, c_char_p]

  432.         self.lib.carla_set_engine_option.restype = None

  433. 

  434.         self.lib.carla_load_filename.argtypes = [c_char_p]

  435.         self.lib.carla_load_filename.restype = c_bool

  436. 

  437.         self.lib.carla_load_project.argtypes = [c_char_p]

  438.         self.lib.carla_load_project.restype = c_bool

  439. 

  440.         self.lib.carla_save_project.argtypes = [c_char_p]

  441.         self.lib.carla_save_project.restype = c_bool

  442. 

  443.         self.lib.carla_patchbay_connect.argtypes = [c_int, c_int]

  444.         self.lib.carla_patchbay_connect.restype = c_bool

  445. 

  446.         self.lib.carla_patchbay_disconnect.argtypes = [c_int]

  447.         self.lib.carla_patchbay_disconnect.restype = c_bool

  448. 

  449.         self.lib.carla_patchbay_refresh.argtypes = None

  450.         self.lib.carla_patchbay_refresh.restype = None

  451. 

  452.         self.lib.carla_transport_play.argtypes = None

  453.         self.lib.carla_transport_play.restype = None

  454. 

  455.         self.lib.carla_transport_pause.argtypes = None

  456.         self.lib.carla_transport_pause.restype = None

  457. 

  458.         self.lib.carla_transport_relocate.argtypes = [c_uint32]

  459.         self.lib.carla_transport_relocate.restype = None

  460. 

  461.         self.lib.carla_get_current_transport_frame.argtypes = None

  462.         self.lib.carla_get_current_transport_frame.restype = c_uint32

  463. 

  464.         self.lib.carla_get_transport_info.argtypes = None

  465.         self.lib.carla_get_transport_info.restype = POINTER(CarlaTransportInfo)

  466. 

  467.         self.lib.carla_add_plugin.argtypes = [c_enum, c_enum, c_char_p, c_char_p, c_char_p, c_void_p]

  468.         self.lib.carla_add_plugin.restype = c_bool

  469. 

  470.         self.lib.carla_remove_plugin.argtypes = [c_uint]

  471.         self.lib.carla_remove_plugin.restype = c_bool

  472. 

  473.         self.lib.carla_remove_all_plugins.argtypes = None

  474.         self.lib.carla_remove_all_plugins.restype = None

  475. 

  476.         self.lib.carla_rename_plugin.argtypes = [c_uint, c_char_p]

  477.         self.lib.carla_rename_plugin.restype = c_char_p

  478. 

  479.         self.lib.carla_clone_plugin.argtypes = [c_uint]

  480.         self.lib.carla_clone_plugin.restype = c_bool

  481. 

  482.         self.lib.carla_replace_plugin.argtypes = [c_uint]

  483.         self.lib.carla_replace_plugin.restype = c_bool

  484. 

  485.         self.lib.carla_switch_plugins.argtypes = [c_uint, c_uint]

  486.         self.lib.carla_switch_plugins.restype = c_bool

  487. 

  488.         self.lib.carla_load_plugin_state.argtypes = [c_uint, c_char_p]

  489.         self.lib.carla_load_plugin_state.restype = c_bool

  490. 

  491.         self.lib.carla_save_plugin_state.argtypes = [c_uint, c_char_p]

  492.         self.lib.carla_save_plugin_state.restype = c_bool

  493. 

  494.         self.lib.carla_get_plugin_info.argtypes = [c_uint]

  495.         self.lib.carla_get_plugin_info.restype = POINTER(CarlaPluginInfo)

  496. 

  497.         self.lib.carla_get_audio_port_count_info.argtypes = [c_uint]

  498.         self.lib.carla_get_audio_port_count_info.restype = POINTER(CarlaPortCountInfo)

  499. 

  500.         self.lib.carla_get_midi_port_count_info.argtypes = [c_uint]

  501.         self.lib.carla_get_midi_port_count_info.restype = POINTER(CarlaPortCountInfo)

  502. 

  503.         self.lib.carla_get_parameter_count_info.argtypes = [c_uint]

  504.         self.lib.carla_get_parameter_count_info.restype = POINTER(CarlaPortCountInfo)

  505. 

  506.         self.lib.carla_get_parameter_info.argtypes = [c_uint, c_uint32]

  507.         self.lib.carla_get_parameter_info.restype = POINTER(CarlaParameterInfo)

  508. 

  509.         self.lib.carla_get_parameter_scalepoint_info.argtypes = [c_uint, c_uint32, c_uint32]

  510.         self.lib.carla_get_parameter_scalepoint_info.restype = POINTER(CarlaScalePointInfo)

  511. 

  512.         self.lib.carla_get_parameter_data.argtypes = [c_uint, c_uint32]

  513.         self.lib.carla_get_parameter_data.restype = POINTER(ParameterData)

  514. 

  515.         self.lib.carla_get_parameter_ranges.argtypes = [c_uint, c_uint32]

  516.         self.lib.carla_get_parameter_ranges.restype = POINTER(ParameterRanges)

  517. 

  518.         self.lib.carla_get_midi_program_data.argtypes = [c_uint, c_uint32]

  519.         self.lib.carla_get_midi_program_data.restype = POINTER(MidiProgramData)

  520. 

  521.         self.lib.carla_get_custom_data.argtypes = [c_uint, c_uint32]

  522.         self.lib.carla_get_custom_data.restype = POINTER(CustomData)

  523. 

  524.         self.lib.carla_get_chunk_data.argtypes = [c_uint]

  525.         self.lib.carla_get_chunk_data.restype = c_char_p

  526. 

  527.         self.lib.carla_get_parameter_count.argtypes = [c_uint]

  528.         self.lib.carla_get_parameter_count.restype = c_uint32

  529. 

  530.         self.lib.carla_get_program_count.argtypes = [c_uint]

  531.         self.lib.carla_get_program_count.restype = c_uint32

  532. 

  533.         self.lib.carla_get_midi_program_count.argtypes = [c_uint]

  534.         self.lib.carla_get_midi_program_count.restype = c_uint32

  535. 

  536.         self.lib.carla_get_custom_data_count.argtypes = [c_uint]

  537.         self.lib.carla_get_custom_data_count.restype = c_uint32

  538. 

  539.         self.lib.carla_get_parameter_text.argtypes = [c_uint, c_uint32]

  540.         self.lib.carla_get_parameter_text.restype = c_char_p

  541. 

  542.         self.lib.carla_get_program_name.argtypes = [c_uint, c_uint32]

  543.         self.lib.carla_get_program_name.restype = c_char_p

  544. 

  545.         self.lib.carla_get_midi_program_name.argtypes = [c_uint, c_uint32]

  546.         self.lib.carla_get_midi_program_name.restype = c_char_p

  547. 

  548.         self.lib.carla_get_real_plugin_name.argtypes = [c_uint]

  549.         self.lib.carla_get_real_plugin_name.restype = c_char_p

  550. 

  551.         self.lib.carla_get_current_program_index.argtypes = [c_uint]

  552.         self.lib.carla_get_current_program_index.restype = c_int32

  553. 

  554.         self.lib.carla_get_current_midi_program_index.argtypes = [c_uint]

  555.         self.lib.carla_get_current_midi_program_index.restype = c_int32

  556. 

  557.         # TODO - consider removal

  558.         self.lib.carla_get_default_parameter_value.argtypes = [c_uint, c_uint32]

  559.         self.lib.carla_get_default_parameter_value.restype = c_float

  560. 

  561.         # TODO - consider removal

  562.         self.lib.carla_get_current_parameter_value.argtypes = [c_uint, c_uint32]

  563.         self.lib.carla_get_current_parameter_value.restype = c_float

  564. 

  565.         self.lib.carla_get_input_peak_value.argtypes = [c_uint, c_ushort]

  566.         self.lib.carla_get_input_peak_value.restype = c_float

  567. 

  568.         self.lib.carla_get_output_peak_value.argtypes = [c_uint, c_ushort]

  569.         self.lib.carla_get_output_peak_value.restype = c_float

  570. 

  571.         self.lib.carla_set_option.argtypes = [c_uint, c_uint, c_bool]

  572.         self.lib.carla_set_option.restype = None

  573. 

  574.         self.lib.carla_set_active.argtypes = [c_uint, c_bool]

  575.         self.lib.carla_set_active.restype = None

  576. 

  577.         self.lib.carla_set_drywet.argtypes = [c_uint, c_float]

  578.         self.lib.carla_set_drywet.restype = None

  579. 

  580.         self.lib.carla_set_volume.argtypes = [c_uint, c_float]

  581.         self.lib.carla_set_volume.restype = None

  582. 

  583.         self.lib.carla_set_balance_left.argtypes = [c_uint, c_float]

  584.         self.lib.carla_set_balance_left.restype = None

  585. 

  586.         self.lib.carla_set_balance_right.argtypes = [c_uint, c_float]

  587.         self.lib.carla_set_balance_right.restype = None

  588. 

  589.         self.lib.carla_set_panning.argtypes = [c_uint, c_float]

  590.         self.lib.carla_set_panning.restype = None

  591. 

  592.         self.lib.carla_set_ctrl_channel.argtypes = [c_uint, c_int8]

  593.         self.lib.carla_set_ctrl_channel.restype = None

  594. 

  595.         self.lib.carla_set_parameter_value.argtypes = [c_uint, c_uint32, c_float]

  596.         self.lib.carla_set_parameter_value.restype = None

  597. 

  598.         self.lib.carla_set_parameter_midi_cc.argtypes = [c_uint, c_uint32, c_int16]

  599.         self.lib.carla_set_parameter_midi_cc.restype = None

  600. 

  601.         self.lib.carla_set_parameter_midi_channel.argtypes = [c_uint, c_uint32, c_uint8]

  602.         self.lib.carla_set_parameter_midi_channel.restype = None

  603. 

  604.         self.lib.carla_set_program.argtypes = [c_uint, c_uint32]

  605.         self.lib.carla_set_program.restype = None

  606. 

  607.         self.lib.carla_set_midi_program.argtypes = [c_uint, c_uint32]

  608.         self.lib.carla_set_midi_program.restype = None

  609. 

  610.         self.lib.carla_set_custom_data.argtypes = [c_uint, c_char_p, c_char_p, c_char_p]

  611.         self.lib.carla_set_custom_data.restype = None

  612. 

  613.         self.lib.carla_set_chunk_data.argtypes = [c_uint, c_char_p]

  614.         self.lib.carla_set_chunk_data.restype = None

  615. 

  616.         self.lib.carla_prepare_for_save.argtypes = [c_uint]

  617.         self.lib.carla_prepare_for_save.restype = None

  618. 

  619.         self.lib.carla_send_midi_note.argtypes = [c_uint, c_uint8, c_uint8, c_uint8]

  620.         self.lib.carla_send_midi_note.restype = None

  621. 

  622.         self.lib.carla_show_gui.argtypes = [c_uint, c_bool]

  623.         self.lib.carla_show_gui.restype = None

  624. 

  625.         self.lib.carla_get_buffer_size.argtypes = None

  626.         self.lib.carla_get_buffer_size.restype = c_uint32

  627. 

  628.         self.lib.carla_get_sample_rate.argtypes = None

  629.         self.lib.carla_get_sample_rate.restype = c_double

  630. 

  631.         self.lib.carla_get_last_error.argtypes = None

  632.         self.lib.carla_get_last_error.restype = c_char_p

  633. 

  634.         self.lib.carla_get_host_osc_url.argtypes = None

  635.         self.lib.carla_get_host_osc_url.restype = c_char_p

  636. 

  637.         self.lib.carla_nsm_announce.argtypes = [c_char_p, c_char_p, c_int]

  638.         self.lib.carla_nsm_announce.restype = None

  639. 

  640.         self.lib.carla_nsm_reply_open.argtypes = None

  641.         self.lib.carla_nsm_reply_open.restype = None

  642. 

  643.         self.lib.carla_nsm_reply_save.argtypes = None

  644.         self.lib.carla_nsm_reply_save.restype = None

  645. 

  646.     def get_extended_license_text(self):

  647.         return self.lib.carla_get_extended_license_text()

  648. 

  649.     def get_supported_file_types(self):

  650.         return self.lib.carla_get_supported_file_types()

  651. 

  652.     def get_engine_driver_count(self):

  653.         return self.lib.carla_get_engine_driver_count()

  654. 

  655.     def get_engine_driver_name(self, index):

  656.         return self.lib.carla_get_engine_driver_name(index)

  657. 

  658.     def get_engine_driver_device_names(self, index):

  659.         return charStringList(self.lib.carla_get_engine_driver_device_names(index))

  660. 

  661.     def get_internal_plugin_count(self):

  662.         return self.lib.carla_get_internal_plugin_count()

  663. 

  664.     def get_internal_plugin_info(self, internalPluginId):

  665.         return structToDict(self.lib.carla_get_internal_plugin_info(internalPluginId).contents)

  666. 

  667.     def engine_init(self, driverName, clientName):

  668.         return self.lib.carla_engine_init(driverName.encode("utf-8"), clientName.encode("utf-8"))

  669. 

  670.     def engine_close(self):

  671.         return self.lib.carla_engine_close()

  672. 

  673.     def engine_idle(self):

  674.         self.lib.carla_engine_idle()

  675. 

  676.     def is_engine_running(self):

  677.         return self.lib.carla_is_engine_running()

  678. 

  679.     def set_engine_about_to_close(self):

  680.         self.lib.carla_set_engine_about_to_close()

  681. 

  682.     def set_engine_callback(self, func):

  683.         self._callback = CallbackFunc(func)

  684.         self.lib.carla_set_engine_callback(self._callback, c_nullptr)

  685. 

  686.     def set_engine_option(self, option, value, valueStr):

  687.         self.lib.carla_set_engine_option(option, value, valueStr.encode("utf-8"))

  688. 

  689.     def load_filename(self, filename):

  690.         return self.lib.carla_load_filename(filename.encode("utf-8"))

  691. 

  692.     def load_project(self, filename):

  693.         return self.lib.carla_load_project(filename.encode("utf-8"))

  694. 

  695.     def save_project(self, filename):

  696.         return self.lib.carla_save_project(filename.encode("utf-8"))

  697. 

  698.     def patchbay_connect(self, portIdA, portIdB):

  699.         return self.lib.carla_patchbay_connect(portIdA, portIdB)

  700. 

  701.     def patchbay_disconnect(self, connectionId):

  702.         return self.lib.carla_patchbay_disconnect(connectionId)

  703. 

  704.     def patchbay_refresh(self):

  705.         self.lib.carla_patchbay_refresh()

  706. 

  707.     def transport_play(self):

  708.         self.lib.carla_transport_play()

  709. 

  710.     def transport_pause(self):

  711.         self.lib.carla_transport_pause()

  712. 

  713.     def transport_relocate(self, frames):

  714.         self.lib.carla_transport_relocate(frames)

  715. 

  716.     def get_current_transport_frame(self):

  717.         return self.lib.carla_get_current_transport_frame()

  718. 

  719.     def get_transport_info(self):

  720.         return structToDict(self.lib.carla_get_transport_info().contents)

  721. 

  722.     def add_plugin(self, btype, ptype, filename, name, label, extraStuff):

  723.         cfilename = filename.encode("utf-8") if filename else c_nullptr

  724.         cname     = name.encode("utf-8") if name else c_nullptr

  725.         clabel    = label.encode("utf-8") if label else c_nullptr

  726.         return self.lib.carla_add_plugin(btype, ptype, cfilename, cname, clabel, cast(extraStuff, c_void_p))

  727. 

  728.     def remove_plugin(self, pluginId):

  729.         return self.lib.carla_remove_plugin(pluginId)

  730. 

  731.     def remove_all_plugins(self):

  732.         self.lib.carla_remove_all_plugins()

  733. 

  734.     def rename_plugin(self, pluginId, newName):

  735.         return self.lib.carla_rename_plugin(pluginId, newName.encode("utf-8"))

  736. 

  737.     def clone_plugin(self, pluginId):

  738.         return self.lib.carla_clone_plugin(pluginId)

  739. 

  740.     def replace_plugin(self, pluginId):

  741.         return self.lib.carla_replace_plugin(pluginId)

  742. 

  743.     def switch_plugins(self, pluginIdA, pluginIdB):

  744.         return self.lib.carla_switch_plugins(pluginIdA, pluginIdB)

  745. 

  746.     def load_plugin_state(self, pluginId, filename):

  747.         return self.lib.carla_load_plugin_state(pluginId, filename.encode("utf-8"))

  748. 

  749.     def save_plugin_state(self, pluginId, filename):

  750.         return self.lib.carla_save_plugin_state(pluginId, filename.encode("utf-8"))

  751. 

  752.     def get_plugin_info(self, pluginId):

  753.         return structToDict(self.lib.carla_get_plugin_info(pluginId).contents)

  754. 

  755.     def get_audio_port_count_info(self, pluginId):

  756.         return structToDict(self.lib.carla_get_audio_port_count_info(pluginId).contents)

  757. 

  758.     def get_midi_port_count_info(self, pluginId):

  759.         return structToDict(self.lib.carla_get_midi_port_count_info(pluginId).contents)

  760. 

  761.     def get_parameter_count_info(self, pluginId):

  762.         return structToDict(self.lib.carla_get_parameter_count_info(pluginId).contents)

  763. 

  764.     def get_parameter_info(self, pluginId, parameterId):

  765.         return structToDict(self.lib.carla_get_parameter_info(pluginId, parameterId).contents)

  766. 

  767.     def get_parameter_scalepoint_info(self, pluginId, parameterId, scalePointId):

  768.         return structToDict(self.lib.carla_get_parameter_scalepoint_info(pluginId, parameterId, scalePointId).contents)

  769. 

  770.     def get_parameter_data(self, pluginId, parameterId):

  771.         return structToDict(self.lib.carla_get_parameter_data(pluginId, parameterId).contents)

  772. 

  773.     def get_parameter_ranges(self, pluginId, parameterId):

  774.         return structToDict(self.lib.carla_get_parameter_ranges(pluginId, parameterId).contents)

  775. 

  776.     def get_midi_program_data(self, pluginId, midiProgramId):

  777.         return structToDict(self.lib.carla_get_midi_program_data(pluginId, midiProgramId).contents)

  778. 

  779.     def get_custom_data(self, pluginId, customDataId):

  780.         return structToDict(self.lib.carla_get_custom_data(pluginId, customDataId).contents)

  781. 

  782.     def get_chunk_data(self, pluginId):

  783.         return self.lib.carla_get_chunk_data(pluginId)

  784. 

  785.     def get_parameter_count(self, pluginId):

  786.         return self.lib.carla_get_parameter_count(pluginId)

  787. 

  788.     def get_program_count(self, pluginId):

  789.         return self.lib.carla_get_program_count(pluginId)

  790. 

  791.     def get_midi_program_count(self, pluginId):

  792.         return self.lib.carla_get_midi_program_count(pluginId)

  793. 

  794.     def get_custom_data_count(self, pluginId):

  795.         return self.lib.carla_get_custom_data_count(pluginId)

  796. 

  797.     def get_parameter_text(self, pluginId, parameterId):

  798.         return self.lib.carla_get_parameter_text(pluginId, parameterId)

  799. 

  800.     def get_program_name(self, pluginId, programId):

  801.         return self.lib.carla_get_program_name(pluginId, programId)

  802. 

  803.     def get_midi_program_name(self, pluginId, midiProgramId):

  804.         return self.lib.carla_get_midi_program_name(pluginId, midiProgramId)

  805. 

  806.     def get_real_plugin_name(self, pluginId):

  807.         return self.lib.carla_get_real_plugin_name(pluginId)

  808. 

  809.     def get_current_program_index(self, pluginId):

  810.         return self.lib.carla_get_current_program_index(pluginId)

  811. 

  812.     def get_current_midi_program_index(self, pluginId):

  813.         return self.lib.carla_get_current_midi_program_index(pluginId)

  814. 

  815.     def get_default_parameter_value(self, pluginId, parameterId):

  816.         return self.lib.carla_get_default_parameter_value(pluginId, parameterId)

  817. 

  818.     def get_current_parameter_value(self, pluginId, parameterId):

  819.         return self.lib.carla_get_current_parameter_value(pluginId, parameterId)

  820. 

  821.     def get_input_peak_value(self, pluginId, portId):

  822.         return self.lib.carla_get_input_peak_value(pluginId, portId)

  823. 

  824.     def get_output_peak_value(self, pluginId, portId):

  825.         return self.lib.carla_get_output_peak_value(pluginId, portId)

  826. 

  827.     def set_option(self, pluginId, option, yesNo):

  828.         self.lib.carla_set_option(pluginId, option, yesNo)

  829. 

  830.     def set_active(self, pluginId, onOff):

  831.         self.lib.carla_set_active(pluginId, onOff)

  832. 

  833.     def set_drywet(self, pluginId, value):

  834.         self.lib.carla_set_drywet(pluginId, value)

  835. 

  836.     def set_volume(self, pluginId, value):

  837.         self.lib.carla_set_volume(pluginId, value)

  838. 

  839.     def set_balance_left(self, pluginId, value):

  840.         self.lib.carla_set_balance_left(pluginId, value)

  841. 

  842.     def set_balance_right(self, pluginId, value):

  843.         self.lib.carla_set_balance_right(pluginId, value)

  844. 

  845.     def set_panning(self, pluginId, value):

  846.         self.lib.carla_set_panning(pluginId, value)

  847. 

  848.     def set_ctrl_channel(self, pluginId, channel):

  849.         self.lib.carla_set_ctrl_channel(pluginId, channel)

  850. 

  851.     def set_parameter_value(self, pluginId, parameterId, value):

  852.         self.lib.carla_set_parameter_value(pluginId, parameterId, value)

  853. 

  854.     def set_parameter_midi_cc(self, pluginId, parameterId, cc):

  855.         self.lib.carla_set_parameter_midi_cc(pluginId, parameterId, cc)

  856. 

  857.     def set_parameter_midi_channel(self, pluginId, parameterId, channel):

  858.         self.lib.carla_set_parameter_midi_channel(pluginId, parameterId, channel)

  859. 

  860.     def set_program(self, pluginId, programId):

  861.         self.lib.carla_set_program(pluginId, programId)

  862. 

  863.     def set_midi_program(self, pluginId, midiProgramId):

  864.         self.lib.carla_set_midi_program(pluginId, midiProgramId)

  865. 

  866.     def set_custom_data(self, pluginId, type_, key, value):

  867.         self.lib.carla_set_custom_data(pluginId, type_.encode("utf-8"), key.encode("utf-8"), value.encode("utf-8"))

  868. 

  869.     def set_chunk_data(self, pluginId, chunkData):

  870.         self.lib.carla_set_chunk_data(pluginId, chunkData.encode("utf-8"))

  871. 

  872.     def prepare_for_save(self, pluginId):

  873.         self.lib.carla_prepare_for_save(pluginId)

  874. 

  875.     def send_midi_note(self, pluginId, channel, note, velocity):

  876.         self.lib.carla_send_midi_note(pluginId, channel, note, velocity)

  877. 

  878.     def show_gui(self, pluginId, yesNo):

  879.         self.lib.carla_show_gui(pluginId, yesNo)

  880. 

  881.     def get_last_error(self):

  882.         return self.lib.carla_get_last_error()

  883. 

  884.     def get_host_osc_url(self):

  885.         return self.lib.carla_get_host_osc_url()

  886. 

  887.     def get_buffer_size(self):

  888.         return self.lib.carla_get_buffer_size()

  889. 

  890.     def get_sample_rate(self):

  891.         return self.lib.carla_get_sample_rate()

  892. 

  893.     def nsm_announce(self, url, appName, pid):

  894.         self.lib.carla_nsm_announce(url.encode("utf-8"), appName.encode("utf-8"), pid)

  895. 

  896.     def nsm_reply_open(self):

  897.         self.lib.carla_nsm_reply_open()

  898. 

  899.     def nsm_reply_save(self):

  900.         self.lib.carla_nsm_reply_save()