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

914 lines
32KB
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_RESOURCES          = 14

  205. OPTION_PATH_BRIDGE_NATIVE      = 15

  206. OPTION_PATH_BRIDGE_POSIX32     = 16

  207. OPTION_PATH_BRIDGE_POSIX64     = 17

  208. OPTION_PATH_BRIDGE_WIN32       = 18

  209. OPTION_PATH_BRIDGE_WIN64       = 19

  210. OPTION_PATH_BRIDGE_LV2_GTK2    = 20

  211. OPTION_PATH_BRIDGE_LV2_GTK3    = 21

  212. OPTION_PATH_BRIDGE_LV2_QT4     = 22

  213. OPTION_PATH_BRIDGE_LV2_QT5     = 23

  214. OPTION_PATH_BRIDGE_LV2_COCOA   = 24

  215. OPTION_PATH_BRIDGE_LV2_WINDOWS = 25

  216. OPTION_PATH_BRIDGE_LV2_X11     = 26

  217. OPTION_PATH_BRIDGE_VST_COCOA   = 27

  218. OPTION_PATH_BRIDGE_VST_HWND    = 28

  219. OPTION_PATH_BRIDGE_VST_X11     = 29

  220. 

  221. # Callback Type

  222. CALLBACK_DEBUG          = 0

  223. CALLBACK_PLUGIN_ADDED   = 1

  224. CALLBACK_PLUGIN_REMOVED = 2

  225. CALLBACK_PLUGIN_RENAMED = 3

  226. CALLBACK_PARAMETER_VALUE_CHANGED        = 4

  227. CALLBACK_PARAMETER_DEFAULT_CHANGED      = 5

  228. CALLBACK_PARAMETER_MIDI_CHANNEL_CHANGED = 6

  229. CALLBACK_PARAMETER_MIDI_CC_CHANGED      = 7

  230. CALLBACK_PROGRAM_CHANGED         = 8

  231. CALLBACK_MIDI_PROGRAM_CHANGED    = 9

  232. CALLBACK_NOTE_ON                 = 10

  233. CALLBACK_NOTE_OFF                = 11

  234. CALLBACK_SHOW_GUI                = 12

  235. CALLBACK_UPDATE                  = 13

  236. CALLBACK_RELOAD_INFO             = 14

  237. CALLBACK_RELOAD_PARAMETERS       = 15

  238. CALLBACK_RELOAD_PROGRAMS         = 16

  239. CALLBACK_RELOAD_ALL              = 17

  240. CALLBACK_PATCHBAY_CLIENT_ADDED   = 18

  241. CALLBACK_PATCHBAY_CLIENT_REMOVED = 19

  242. CALLBACK_PATCHBAY_CLIENT_RENAMED = 20

  243. CALLBACK_PATCHBAY_PORT_ADDED         = 21

  244. CALLBACK_PATCHBAY_PORT_REMOVED       = 22

  245. CALLBACK_PATCHBAY_PORT_RENAMED       = 23

  246. CALLBACK_PATCHBAY_CONNECTION_ADDED   = 24

  247. CALLBACK_PATCHBAY_CONNECTION_REMOVED = 25

  248. CALLBACK_BUFFER_SIZE_CHANGED  = 26

  249. CALLBACK_SAMPLE_RATE_CHANGED  = 27

  250. CALLBACK_PROCESS_MODE_CHANGED = 28

  251. CALLBACK_NSM_ANNOUNCE = 29

  252. CALLBACK_NSM_OPEN     = 30

  253. CALLBACK_NSM_SAVE     = 31

  254. CALLBACK_ERROR        = 32

  255. CALLBACK_QUIT         = 33

  256. 

  257. # Process Mode

  258. PROCESS_MODE_SINGLE_CLIENT    = 0

  259. PROCESS_MODE_MULTIPLE_CLIENTS = 1

  260. PROCESS_MODE_CONTINUOUS_RACK  = 2

  261. PROCESS_MODE_PATCHBAY         = 3

  262. PROCESS_MODE_BRIDGE           = 4

  263. 

  264. # Transport Mode

  265. TRANSPORT_MODE_INTERNAL = 0

  266. TRANSPORT_MODE_JACK     = 1

  267. TRANSPORT_MODE_PLUGIN   = 2

  268. TRANSPORT_MODE_BRIDGE   = 3

  269. 

  270. # Set BINARY_NATIVE

  271. if HAIKU or LINUX or MACOS:

  272.     BINARY_NATIVE = BINARY_POSIX64 if kIs64bit else BINARY_POSIX32

  273. elif WINDOWS:

  274.     BINARY_NATIVE = BINARY_WIN64 if kIs64bit else BINARY_WIN32

  275. else:

  276.     BINARY_NATIVE = BINARY_OTHER

  277. 

  278. # ------------------------------------------------------------------------------------------------------------

  279. # Backend C++ -> Python variables

  280. 

  281. c_enum = c_int

  282. c_nullptr = None

  283. 

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

  285. 

  286. class ParameterData(Structure):

  287.     _fields_ = [

  288.         ("type", c_enum),

  289.         ("index", c_int32),

  290.         ("rindex", c_int32),

  291.         ("hints", c_uint32),

  292.         ("midiChannel", c_uint8),

  293.         ("midiCC", c_int16)

  294.     ]

  295. 

  296. class ParameterRanges(Structure):

  297.     _fields_ = [

  298.         ("def", c_float),

  299.         ("min", c_float),

  300.         ("max", c_float),

  301.         ("step", c_float),

  302.         ("stepSmall", c_float),

  303.         ("stepLarge", c_float)

  304.     ]

  305. 

  306. class MidiProgramData(Structure):

  307.     _fields_ = [

  308.         ("bank", c_uint32),

  309.         ("program", c_uint32),

  310.         ("name", c_char_p)

  311.     ]

  312. 

  313. class CustomData(Structure):

  314.     _fields_ = [

  315.         ("type", c_char_p),

  316.         ("key", c_char_p),

  317.         ("value", c_char_p)

  318.     ]

  319. 

  320. # ------------------------------------------------------------------------------------------------------------

  321. # Standalone C++ -> Python variables

  322. 

  323. class CarlaPluginInfo(Structure):

  324.     _fields_ = [

  325.         ("type", c_enum),

  326.         ("category", c_enum),

  327.         ("hints", c_uint),

  328.         ("optionsAvailable", c_uint),

  329.         ("optionsEnabled", c_uint),

  330.         ("binary", c_char_p),

  331.         ("name", c_char_p),

  332.         ("label", c_char_p),

  333.         ("maker", c_char_p),

  334.         ("copyright", c_char_p),

  335.         ("uniqueId", c_long),

  336.         ("latency", c_uint32)

  337.     ]

  338. 

  339. class CarlaNativePluginInfo(Structure):

  340.     _fields_ = [

  341.         ("category", c_enum),

  342.         ("hints", c_uint),

  343.         ("audioIns", c_uint32),

  344.         ("audioOuts", c_uint32),

  345.         ("midiIns", c_uint32),

  346.         ("midiOuts", c_uint32),

  347.         ("parameterIns", c_uint32),

  348.         ("parameterOuts", c_uint32),

  349.         ("name", c_char_p),

  350.         ("label", c_char_p),

  351.         ("maker", c_char_p),

  352.         ("copyright", c_char_p)

  353.     ]

  354. 

  355. class CarlaPortCountInfo(Structure):

  356.     _fields_ = [

  357.         ("ins", c_uint32),

  358.         ("outs", c_uint32),

  359.         ("total", c_uint32)

  360.     ]

  361. 

  362. class CarlaParameterInfo(Structure):

  363.     _fields_ = [

  364.         ("name", c_char_p),

  365.         ("symbol", c_char_p),

  366.         ("unit", c_char_p),

  367.         ("scalePointCount", c_uint32)

  368.     ]

  369. 

  370. class CarlaScalePointInfo(Structure):

  371.     _fields_ = [

  372.         ("value", c_float),

  373.         ("label", c_char_p)

  374.     ]

  375. 

  376. class CarlaTransportInfo(Structure):

  377.     _fields_ = [

  378.         ("playing", c_bool),

  379.         ("frame", c_uint32),

  380.         ("bar", c_int32),

  381.         ("beat", c_int32),

  382.         ("tick", c_int32),

  383.         ("bpm", c_double)

  384.     ]

  385. 

  386. # ------------------------------------------------------------------------------------------------------------

  387. # Standalone Python object

  388. 

  389. class Host(object):

  390.     def __init__(self, libName):

  391.         object.__init__(self)

  392. 

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

  394. 

  395.         self.lib.carla_get_extended_license_text.argtypes = None

  396.         self.lib.carla_get_extended_license_text.restype = c_char_p

  397. 

  398.         self.lib.carla_get_supported_file_types.argtypes = None

  399.         self.lib.carla_get_supported_file_types.restype = c_char_p

  400. 

  401.         self.lib.carla_get_engine_driver_count.argtypes = None

  402.         self.lib.carla_get_engine_driver_count.restype = c_uint

  403. 

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

  405.         self.lib.carla_get_engine_driver_name.restype = c_char_p

  406. 

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

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

  409. 

  410.         self.lib.carla_get_internal_plugin_count.argtypes = None

  411.         self.lib.carla_get_internal_plugin_count.restype = c_uint

  412. 

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

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

  415. 

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

  417.         self.lib.carla_engine_init.restype = c_bool

  418. 

  419.         self.lib.carla_engine_close.argtypes = None

  420.         self.lib.carla_engine_close.restype = c_bool

  421. 

  422.         self.lib.carla_engine_idle.argtypes = None

  423.         self.lib.carla_engine_idle.restype = None

  424. 

  425.         self.lib.carla_is_engine_running.argtypes = None

  426.         self.lib.carla_is_engine_running.restype = c_bool

  427. 

  428.         self.lib.carla_set_engine_about_to_close.argtypes = None

  429.         self.lib.carla_set_engine_about_to_close.restype = None

  430. 

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

  432.         self.lib.carla_set_engine_callback.restype = None

  433. 

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

  435.         self.lib.carla_set_engine_option.restype = None

  436. 

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

  438.         self.lib.carla_load_filename.restype = c_bool

  439. 

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

  441.         self.lib.carla_load_project.restype = c_bool

  442. 

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

  444.         self.lib.carla_save_project.restype = c_bool

  445. 

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

  447.         self.lib.carla_patchbay_connect.restype = c_bool

  448. 

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

  450.         self.lib.carla_patchbay_disconnect.restype = c_bool

  451. 

  452.         self.lib.carla_patchbay_refresh.argtypes = None

  453.         self.lib.carla_patchbay_refresh.restype = None

  454. 

  455.         self.lib.carla_transport_play.argtypes = None

  456.         self.lib.carla_transport_play.restype = None

  457. 

  458.         self.lib.carla_transport_pause.argtypes = None

  459.         self.lib.carla_transport_pause.restype = None

  460. 

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

  462.         self.lib.carla_transport_relocate.restype = None

  463. 

  464.         self.lib.carla_get_current_transport_frame.argtypes = None

  465.         self.lib.carla_get_current_transport_frame.restype = c_uint32

  466. 

  467.         self.lib.carla_get_transport_info.argtypes = None

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

  469. 

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

  471.         self.lib.carla_add_plugin.restype = c_bool

  472. 

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

  474.         self.lib.carla_remove_plugin.restype = c_bool

  475. 

  476.         self.lib.carla_remove_all_plugins.argtypes = None

  477.         self.lib.carla_remove_all_plugins.restype = None

  478. 

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

  480.         self.lib.carla_rename_plugin.restype = c_char_p

  481. 

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

  483.         self.lib.carla_clone_plugin.restype = c_bool

  484. 

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

  486.         self.lib.carla_replace_plugin.restype = c_bool

  487. 

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

  489.         self.lib.carla_switch_plugins.restype = c_bool

  490. 

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

  492.         self.lib.carla_load_plugin_state.restype = c_bool

  493. 

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

  495.         self.lib.carla_save_plugin_state.restype = c_bool

  496. 

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

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

  499. 

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

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

  502. 

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

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

  505. 

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

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

  508. 

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

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

  511. 

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

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

  514. 

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

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

  517. 

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

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

  520. 

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

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

  523. 

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

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

  526. 

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

  528.         self.lib.carla_get_chunk_data.restype = c_char_p

  529. 

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

  531.         self.lib.carla_get_parameter_count.restype = c_uint32

  532. 

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

  534.         self.lib.carla_get_program_count.restype = c_uint32

  535. 

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

  537.         self.lib.carla_get_midi_program_count.restype = c_uint32

  538. 

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

  540.         self.lib.carla_get_custom_data_count.restype = c_uint32

  541. 

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

  543.         self.lib.carla_get_parameter_text.restype = c_char_p

  544. 

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

  546.         self.lib.carla_get_program_name.restype = c_char_p

  547. 

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

  549.         self.lib.carla_get_midi_program_name.restype = c_char_p

  550. 

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

  552.         self.lib.carla_get_real_plugin_name.restype = c_char_p

  553. 

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

  555.         self.lib.carla_get_current_program_index.restype = c_int32

  556. 

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

  558.         self.lib.carla_get_current_midi_program_index.restype = c_int32

  559. 

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

  561.         self.lib.carla_get_default_parameter_value.restype = c_float

  562. 

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

  564.         self.lib.carla_get_current_parameter_value.restype = c_float

  565. 

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

  567.         self.lib.carla_get_input_peak_value.restype = c_float

  568. 

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

  570.         self.lib.carla_get_output_peak_value.restype = c_float

  571. 

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

  573.         self.lib.carla_set_option.restype = None

  574. 

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

  576.         self.lib.carla_set_active.restype = None

  577. 

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

  579.         self.lib.carla_set_drywet.restype = None

  580. 

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

  582.         self.lib.carla_set_volume.restype = None

  583. 

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

  585.         self.lib.carla_set_balance_left.restype = None

  586. 

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

  588.         self.lib.carla_set_balance_right.restype = None

  589. 

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

  591.         self.lib.carla_set_panning.restype = None

  592. 

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

  594.         self.lib.carla_set_ctrl_channel.restype = None

  595. 

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

  597.         self.lib.carla_set_parameter_value.restype = None

  598. 

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

  600.         self.lib.carla_set_parameter_midi_cc.restype = None

  601. 

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

  603.         self.lib.carla_set_parameter_midi_channel.restype = None

  604. 

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

  606.         self.lib.carla_set_program.restype = None

  607. 

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

  609.         self.lib.carla_set_midi_program.restype = None

  610. 

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

  612.         self.lib.carla_set_custom_data.restype = None

  613. 

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

  615.         self.lib.carla_set_chunk_data.restype = None

  616. 

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

  618.         self.lib.carla_prepare_for_save.restype = None

  619. 

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

  621.         self.lib.carla_send_midi_note.restype = None

  622. 

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

  624.         self.lib.carla_show_gui.restype = None

  625. 

  626.         self.lib.carla_get_buffer_size.argtypes = None

  627.         self.lib.carla_get_buffer_size.restype = c_uint32

  628. 

  629.         self.lib.carla_get_sample_rate.argtypes = None

  630.         self.lib.carla_get_sample_rate.restype = c_double

  631. 

  632.         self.lib.carla_get_last_error.argtypes = None

  633.         self.lib.carla_get_last_error.restype = c_char_p

  634. 

  635.         self.lib.carla_get_host_osc_url_tcp.argtypes = None

  636.         self.lib.carla_get_host_osc_url_tcp.restype = c_char_p

  637. 

  638.         self.lib.carla_get_host_osc_url_udp.argtypes = None

  639.         self.lib.carla_get_host_osc_url_udp.restype = c_char_p

  640. 

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

  642.         self.lib.carla_nsm_announce.restype = None

  643. 

  644.         self.lib.carla_nsm_ready.argtypes = None

  645.         self.lib.carla_nsm_ready.restype = None

  646. 

  647.         self.lib.carla_nsm_reply_open.argtypes = None

  648.         self.lib.carla_nsm_reply_open.restype = None

  649. 

  650.         self.lib.carla_nsm_reply_save.argtypes = None

  651.         self.lib.carla_nsm_reply_save.restype = None

  652. 

  653.     def get_extended_license_text(self):

  654.         return self.lib.carla_get_extended_license_text()

  655. 

  656.     def get_supported_file_types(self):

  657.         return self.lib.carla_get_supported_file_types()

  658. 

  659.     def get_engine_driver_count(self):

  660.         return self.lib.carla_get_engine_driver_count()

  661. 

  662.     def get_engine_driver_name(self, index):

  663.         return self.lib.carla_get_engine_driver_name(index)

  664. 

  665.     def get_engine_driver_device_names(self, index):

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

  667. 

  668.     def get_internal_plugin_count(self):

  669.         return self.lib.carla_get_internal_plugin_count()

  670. 

  671.     def get_internal_plugin_info(self, internalPluginId):

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

  673. 

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

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

  676. 

  677.     def engine_close(self):

  678.         return self.lib.carla_engine_close()

  679. 

  680.     def engine_idle(self):

  681.         self.lib.carla_engine_idle()

  682. 

  683.     def is_engine_running(self):

  684.         return self.lib.carla_is_engine_running()

  685. 

  686.     def set_engine_about_to_close(self):

  687.         self.lib.carla_set_engine_about_to_close()

  688. 

  689.     def set_engine_callback(self, func):

  690.         self._callback = CallbackFunc(func)

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

  692. 

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

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

  695. 

  696.     def load_filename(self, filename):

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

  698. 

  699.     def load_project(self, filename):

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

  701. 

  702.     def save_project(self, filename):

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

  704. 

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

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

  707. 

  708.     def patchbay_disconnect(self, connectionId):

  709.         return self.lib.carla_patchbay_disconnect(connectionId)

  710. 

  711.     def patchbay_refresh(self):

  712.         self.lib.carla_patchbay_refresh()

  713. 

  714.     def transport_play(self):

  715.         self.lib.carla_transport_play()

  716. 

  717.     def transport_pause(self):

  718.         self.lib.carla_transport_pause()

  719. 

  720.     def transport_relocate(self, frames):

  721.         self.lib.carla_transport_relocate(frames)

  722. 

  723.     def get_current_transport_frame(self):

  724.         return self.lib.carla_get_current_transport_frame()

  725. 

  726.     def get_transport_info(self):

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

  728. 

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

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

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

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

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

  734. 

  735.     def remove_plugin(self, pluginId):

  736.         return self.lib.carla_remove_plugin(pluginId)

  737. 

  738.     def remove_all_plugins(self):

  739.         self.lib.carla_remove_all_plugins()

  740. 

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

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

  743. 

  744.     def clone_plugin(self, pluginId):

  745.         return self.lib.carla_clone_plugin(pluginId)

  746. 

  747.     def replace_plugin(self, pluginId):

  748.         return self.lib.carla_replace_plugin(pluginId)

  749. 

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

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

  752. 

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

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

  755. 

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

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

  758. 

  759.     def get_plugin_info(self, pluginId):

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

  761. 

  762.     def get_audio_port_count_info(self, pluginId):

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

  764. 

  765.     def get_midi_port_count_info(self, pluginId):

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

  767. 

  768.     def get_parameter_count_info(self, pluginId):

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

  770. 

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

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

  773. 

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

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

  776. 

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

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

  779. 

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

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

  782. 

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

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

  785. 

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

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

  788. 

  789.     def get_chunk_data(self, pluginId):

  790.         return self.lib.carla_get_chunk_data(pluginId)

  791. 

  792.     def get_parameter_count(self, pluginId):

  793.         return self.lib.carla_get_parameter_count(pluginId)

  794. 

  795.     def get_program_count(self, pluginId):

  796.         return self.lib.carla_get_program_count(pluginId)

  797. 

  798.     def get_midi_program_count(self, pluginId):

  799.         return self.lib.carla_get_midi_program_count(pluginId)

  800. 

  801.     def get_custom_data_count(self, pluginId):

  802.         return self.lib.carla_get_custom_data_count(pluginId)

  803. 

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

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

  806. 

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

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

  809. 

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

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

  812. 

  813.     def get_real_plugin_name(self, pluginId):

  814.         return self.lib.carla_get_real_plugin_name(pluginId)

  815. 

  816.     def get_current_program_index(self, pluginId):

  817.         return self.lib.carla_get_current_program_index(pluginId)

  818. 

  819.     def get_current_midi_program_index(self, pluginId):

  820.         return self.lib.carla_get_current_midi_program_index(pluginId)

  821. 

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

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

  824. 

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

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

  827. 

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

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

  830. 

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

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

  833. 

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

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

  836. 

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

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

  839. 

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

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

  842. 

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

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

  845. 

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

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

  848. 

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

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

  851. 

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

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

  854. 

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

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

  857. 

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

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

  860. 

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

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

  863. 

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

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

  866. 

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

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

  869. 

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

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

  872. 

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

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

  875. 

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

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

  878. 

  879.     def prepare_for_save(self, pluginId):

  880.         self.lib.carla_prepare_for_save(pluginId)

  881. 

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

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

  884. 

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

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

  887. 

  888.     def get_last_error(self):

  889.         return self.lib.carla_get_last_error()

  890. 

  891.     def get_host_osc_url_tcp(self):

  892.         return self.lib.carla_get_host_osc_url_tcp()

  893. 

  894.     def get_host_osc_url_udp(self):

  895.         return self.lib.carla_get_host_osc_url_udp()

  896. 

  897.     def get_buffer_size(self):

  898.         return self.lib.carla_get_buffer_size()

  899. 

  900.     def get_sample_rate(self):

  901.         return self.lib.carla_get_sample_rate()

  902. 

  903.     def nsm_announce(self, url, appName_, pid):

  904.         self.lib.carla_nsm_announce(url.encode("utf-8"), appName_.encode("utf-8"), pid)

  905. 

  906.     def nsm_ready(self):

  907.         self.lib.carla_nsm_ready()

  908. 

  909.     def nsm_reply_open(self):

  910.         self.lib.carla_nsm_reply_open()

  911. 

  912.     def nsm_reply_save(self):

  913.         self.lib.carla_nsm_reply_save()