simple-carla 1.5.1__tar.gz → 2.1.0__tar.gz

{simple_carla-1.5.1 → simple_carla-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: simple_carla
-Version: 1.5.1
+Version: 2.1.0
 Summary: An easy-to-use, object-oriented interface to the carla plugin host.
 Author-email: Leon Dionne <ldionne@dridesign.sh.cn>
 Description-Content-Type: text/markdown

{simple_carla-1.5.1 → simple_carla-2.1.0}/pyproject.toml

@@ -18,7 +18,7 @@ build-backend = "flit_core.buildapi"
 sc-plugin-def = "simple_carla.scripts.sc_plugin_def:main"
 
 [bumpver]
-current_version = "1.5.1"
+current_version = "2.1.0"
 version_pattern = "MAJOR.MINOR.PATCH"
 commit_message = "Bump version {old_version} -> {new_version}"
 commit = true

{simple_carla-1.5.1 → simple_carla-2.1.0}/simple_carla/__init__.py

@@ -22,7 +22,7 @@ An easy-to-use, object-oriented interface to the carla plugin host.
 """
 import os, sys, threading, time, logging, traceback
 from ctypes import byref, cast, c_char_p, c_void_p, POINTER
-from functools import wraps
+from functools import wraps, cached_property
 from struct import pack
 from numpy import zeros as np_zeros
 from log_soso import StreamToLogger
@@ -234,7 +234,7 @@ from carla_backend import (
 )
 
 
-__version__ = "1.5.1"
+__version__ = "2.1.0"
 
 
 # -------------------------------------------------------------------
@@ -1280,14 +1280,15 @@ class _SimpleCarla(CarlaHostDLL):
 		the "_plugins" dict.
 		"""
 		if plugin_id in self._plugins:
-			logging.warning('cb_plugin_added: Cannot add plugin %s', plugin_id)
-			logging.warning('"%s" - plugin %s already in _plugins"', carla_plugin_name, self._plugins[plugin_id])
+			logging.error('cb_plugin_added: Cannot add plugin %s', plugin_id)
+			logging.error('"%s" - plugin %s already in _plugins"', carla_plugin_name, self._plugins[plugin_id])
 			return
 		if carla_plugin_name in self._plugin_by_uuid:
 			self._plugins[plugin_id] = self._plugin_by_uuid[carla_plugin_name]
 			self._plugins[plugin_id].post_embed_init(plugin_id) 		# Set up parameters, etc.
 		else:
-			logging.warning('cb_plugin_added: Plugin "%s" not found in _plugin_by_uuid when added', carla_plugin_name)
+			logging.error('cb_plugin_added: Plugin "%s" not found in _plugin_by_uuid when added',
+				carla_plugin_name)
 
 	def cb_plugin_removed(self, plugin_id):
 		if plugin_id in self._plugins:
@@ -1295,7 +1296,8 @@ class _SimpleCarla(CarlaHostDLL):
 			if plugin.uuid in self._plugin_by_uuid:
 				del self._plugin_by_uuid[plugin.uuid]
 			else:
-				logging.warning('cb_plugin_removed: "%s" uuid %s not in self._plugin_by_uuid', plugin, plugin.uuid)
+				logging.error('cb_plugin_removed: "%s" uuid %s not in self._plugin_by_uuid',
+					plugin, plugin.uuid)
 			self._alert_plugin_removed(plugin)
 			# Renumber plugins per Carla plugin_id conventions:
 			for i in range(plugin_id, len(self._plugins) - 1):
@@ -1306,7 +1308,7 @@ class _SimpleCarla(CarlaHostDLL):
 			if self.is_clear():
 				self._alert_last_plugin_removed()
 		else:
-			logging.warning('cb_plugin_removed: Plugin removed (%d) not in _plugins', plugin_id)
+			logging.error('cb_plugin_removed: Plugin removed (%d) not in _plugins', plugin_id)
 
 	def cb_plugin_renamed(self, plugin_id, new_name):
 		self._plugins[plugin_id].plugin_renamed(new_name)
@@ -1316,34 +1318,10 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def cb_parameter_value_changed(self, plugin_id, index, value):
 		if plugin_id in self._plugins:
-			plugin = self._plugins[plugin_id]
-			if index == PARAMETER_NULL:
-				return
-			elif index == PARAMETER_ACTIVE:
-				plugin.active = value != 0
-			elif index == PARAMETER_DRYWET:
-				plugin.dry_wet = value
-			elif index == PARAMETER_VOLUME:
-				plugin.volume = value
-			elif index == PARAMETER_BALANCE_LEFT:
-				plugin.balance_left = value
-			elif index == PARAMETER_BALANCE_RIGHT:
-				plugin.balance_right = value
-			elif index == PARAMETER_PANNING:
-				plugin.panning = value
-			elif index == PARAMETER_CTRL_CHANNEL:
-				plugin.ctrl_channel = value
-			elif index == PARAMETER_MAX:
-				return
-			else:
-				if index in plugin.parameters:
-					parameter = plugin.parameters[index]
-					parameter.internal_value_changed(value)
-					plugin.parameter_internal_value_changed(parameter, value)
-				else:
-					logging.error('Parameter index not in plugin.parameters')
+			self._plugins[plugin_id].internal_value_changed(index, value)
 		else:
-			logging.debug('cb_parameter_value_changed: plugin_id %s not in self._plugins', plugin_id)
+			logging.error('cb_parameter_value_changed: plugin_id %s not in self._plugins',
+				plugin_id)
 
 	def cb_parameter_default_changed(self, plugin_id, index, value):
 		self._plugins[plugin_id].parameter_default_changed(index, value)
@@ -1412,7 +1390,7 @@ class _SimpleCarla(CarlaHostDLL):
 		use "on_client_added".
 		"""
 		if client_id in self._clients:
-			return logging.warning('cb_patchbay_client_added: "%s" already in _clients as "%s"',
+			return logging.error('cb_patchbay_client_added: "%s" already in _clients as "%s"',
 				self._clients[client_id], client_name)
 		plugin_uuid = client_name.rsplit("/")[-1]
 		if plugin_uuid in self._plugin_by_uuid:
@@ -1443,7 +1421,8 @@ class _SimpleCarla(CarlaHostDLL):
 				del self._sys_clients[client.client_name]
 			del self._clients[client_id]
 		else:
-			logging.warning('cb_patchbay_client_removed: Client removed (%s) not in _clients', client_id)
+			logging.error('cb_patchbay_client_removed: Client removed (%s) not in _clients',
+				client_id)
 
 	def cb_patchbay_client_renamed(self, client_id, new_client_name):
 		logging.debug('cb_patchbay_client_renamed: "%s" new name: "%s"',
@@ -1465,14 +1444,14 @@ class _SimpleCarla(CarlaHostDLL):
 			self._clients[client_id].port_added(port_id, port_flags, group_id, port_name)
 			self._alert_port_added(self._clients[client_id].ports[port_id])
 		else:
-			logging.warning('cb_patchbay_port_added: client %s not in _clients', client_id)
+			logging.error('cb_patchbay_port_added: client %s not in _clients', client_id)
 
 	def cb_patchbay_port_removed(self, client_id, port_id):
 		if client_id in self._clients:
 			self._alert_port_removed(self._clients[client_id].ports[port_id])
 			self._clients[client_id].port_removed(port_id)
 		else:
-			logging.warning('cb_patchbay_port_removed: client %s not in _clients', client_id)
+			logging.error('cb_patchbay_port_removed: client %s not in _clients', client_id)
 
 	def cb_patchbay_port_changed(self, client_id, port_id, port_flags, group_id, new_port_name):
 		logging.debug('cb_patchbay_port_changed: client_id %s port_id %s group_id %s new_port_name %s',
@@ -1519,7 +1498,7 @@ class _SimpleCarla(CarlaHostDLL):
 			self._alert_connection_removed(connection)
 			del self._connections[connection_id]
 		else:
-			logging.warning('cb_patchbay_connection_removed: Connection %s not in ._connections',
+			logging.error('cb_patchbay_connection_removed: Connection %s not in ._connections',
 				connection_id)
 
 	# ================================================================================
@@ -1561,6 +1540,8 @@ class _SimpleCarla(CarlaHostDLL):
 		"""
 		Returns Plugin.
 		"plugin_id" is the integer plugin_id assigned by Carla.
+
+		Raises IndexError
 		"""
 		if plugin_id in self._plugins:
 			return  self._plugins[plugin_id]
@@ -1577,12 +1558,19 @@ class _SimpleCarla(CarlaHostDLL):
 		"""
 		Returns PatchbayClient, either a SystemPatchbayClient or Plugin.
 		"client_id" is the integer client_id assigned by Carla.
+
+		Raises IndexError
 		"""
 		if client_id in self._clients:
 			return  self._clients[client_id]
 		raise IndexError()
 
 	def named_client(self, client_name):
+		"""
+		Returns the PatchbayClient (system or Plugin) with the given "client_name"
+
+		Raises IndexError
+		"""
 		for client in self._clients.values():
 			if client.client_name == client_name:
 				return client
@@ -1599,10 +1587,12 @@ class _SimpleCarla(CarlaHostDLL):
 		"""
 		Returns the PatchbayClient with the given client_name.
 		"client_name" is the same value that JACK audio connection kit uses.
+
+		Raises IndexError
 		"""
 		if client_name in self._sys_clients:
 			return self._sys_clients[client_name]
-		return None
+		raise IndexError
 
 	def is_clear(self):
 		"""
@@ -1615,14 +1605,15 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_clients(self):
 		"""
-		Generator which yields SystemPatchbayClient
+		Generator which yields SystemPatchbayClient - all system clients.
 		"""
 		for client in self._sys_clients.values():
 			return client
 
 	def system_audio_in_clients(self):
 		"""
-		Generator which yields SystemPatchbayClient
+		Generator which yields SystemPatchbayClient - system clients with at least one
+		audio in port.
 		"""
 		for client in self._sys_clients.values():
 			if client.audio_in_count > 0:
@@ -1630,7 +1621,8 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_audio_out_clients(self):
 		"""
-		Generator which yields SystemPatchbayClient
+		Generator which yields SystemPatchbayClient - system clients with at least one
+		audio out port.
 		"""
 		for client in self._sys_clients.values():
 			if client.audio_out_count > 0:
@@ -1638,7 +1630,7 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_audio_in_ports(self):
 		"""
-		Generator which yields PatchbayPort
+		Generator which yields PatchbayPort - all audio in ports of all system clients.
 		"""
 		for client in self._sys_clients.values():
 			for port in client.audio_ins():
@@ -1646,7 +1638,7 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_audio_out_ports(self):
 		"""
-		Generator which yields PatchbayPort
+		Generator which yields PatchbayPort - all audio out ports of all system clients.
 		"""
 		for client in self._sys_clients.values():
 			for port in client.audio_outs():
@@ -1654,7 +1646,8 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_midi_in_clients(self):
 		"""
-		Generator which yields SystemPatchbayClient
+		Generator which yields SystemPatchbayClient - system clients with at least one
+		MIDI in port.
 		"""
 		for client in self._sys_clients.values():
 			if client.midi_in_count > 0:
@@ -1662,7 +1655,8 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_midi_out_clients(self):
 		"""
-		Generator which yields SystemPatchbayClient
+		Generator which yields SystemPatchbayClient - system clients with at least one
+		MIDI out port.
 		"""
 		for client in self._sys_clients.values():
 			if client.midi_out_count > 0:
@@ -1670,7 +1664,7 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_midi_in_ports(self):
 		"""
-		Generator which yields PatchbayPort
+		Generator which yields PatchbayPort - all MIDI in ports of all system clients.
 		"""
 		for client in self._sys_clients.values():
 			for port in client.midi_ins():
@@ -1678,7 +1672,7 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def system_midi_out_ports(self):
 		"""
-		Generator which yields PatchbayPort
+		Generator which yields PatchbayPort - all MIDI out ports of all system clients.
 		"""
 		for client in self._sys_clients.values():
 			for port in client.midi_outs():
@@ -1703,7 +1697,8 @@ class _SimpleCarla(CarlaHostDLL):
 		port1 must be an PatchbayPort which is an output.
 		port2 must be an PatchbayPort which is an intput.
 		"""
-		if not self.patchbay_connect(True, port1.client_id, port1.port_id, port2.client_id, port2.port_id):
+		if not self.patchbay_connect(True, port1.client_id, port1.port_id,
+			port2.client_id, port2.port_id):
 			logging.error('Patchbay connect FAILED! %s -> %s', port1, port2)
 
 	# -------------------------------------------------------------------
@@ -1711,11 +1706,17 @@ class _SimpleCarla(CarlaHostDLL):
 
 	def autoload(self, plugin, filename, callback = None):
 		"""
-		liquidsfz does not have an input file parameter, but instead, requests the host to display an open file dialog from which the user may select an SFZ file to load. This function triggers the plugin's host gui display which will call __file_callback(). When there is a plugin to autoload on deck, __file_callback() will return the "autoload_filename" property of the plugin, instead of showing the file open dialog and returning the result.
+		Tell Carla to load the given filename for the given plugin.
 
+		Some plugins, (such as liquidsfz) do not have an input file parameter, but
+		instead, requests the host to display an open file dialog from which the user
+		may select an SFZ file to load. This function triggers the plugin's host gui
+		display which will call Carla.file_callback(). When there is a plugin to autoload
+		on deck, Carla.file_callback() will return the "autoload_filename" property of
+		the plugin, instead of showing the file open dialog and returning the result.
 		"""
 		if self._autoload_plugin is not None:
-			raise Exception("Cannot set autoload plugin as it is already used by " + self._autoload_plugin)
+			raise Exception(f'Autoload already used by "{self._autoload_plugin}"')
 		self._autoload_plugin = plugin
 		self._autoload_filename = filename
 		#logging.debug('Autoloading "%s"', filename)
@@ -1769,11 +1770,11 @@ class _SimpleCarla(CarlaHostDLL):
 			filter = charPtrToString(filter)
 			if action == FILE_CALLBACK_OPEN:
 				if self._open_file_callback is None:
-					raise RuntimeError('Carla wants to open a file, but no callback function is defined')
+					raise RuntimeError('No callback function defined')
 				str_filename = self._open_file_callback(caption, filter)
 			elif action == FILE_CALLBACK_SAVE:
 				if self._save_file_callback is None:
-					raise RuntimeError('Carla wants to open a file, but no callback function is defined')
+					raise RuntimeError('No callback function defined')
 				str_filename = self._save_file_callback(caption, filter)
 			else:
 				return None
@@ -2357,21 +2358,13 @@ class PatchbayClient:
 	# -------------------------------------------------------------------
 	# Other port access funcs:
 
-	def midi_input_port(self):
-		"""
-		Returns PatchbayPort;
-		the first midi input port owned by this client.
-		"""
-		for port in self.ports.values():
-			if port.is_midi and port.is_input:
-				return port
-		return None
-
 	def named_port(self, port_name):
 		"""
 		Returns PatchbayPort;
 		the port owned by this client whose "port_name" matches exactly.
 		Note that the name does NOT include the client_name portion.
+
+		Raises IndexError
 		"""
 		for port in self.ports.values():
 			if port.port_name == port_name:
@@ -2562,26 +2555,25 @@ class PatchbayPort:
 		for conn in self._connections.values():
 			conn.disconnect()
 
+	@cached_property
 	def client(self):
 		"""
 		Returns PatchbayClient.
 		(May return class extending PatchbayClient, i.e. SystemPatchbayClient / Plugin)
 		"""
-		# TODO: Make this a cached property
 		return Carla.instance.client(self.client_id)
 
 	def client_name(self):
 		"""
 		Returns (str) the JACK client name of the PatchbayClient which "owns" this PatchbayPort.
 		"""
-		# TODO: Make this a property
-		return self.client().client_name
+		return self.client.client_name
 
 	def jack_name(self):
 		"""
 		Returns (str) fully qualified name in the format that JACK uses.
 		"""
-		return "{0}:{1}".format(self.client().client_name, self.port_name)
+		return "{0}:{1}".format(self.client.client_name, self.port_name)
 
 	def connections(self):
 		"""
@@ -2627,25 +2619,13 @@ class PatchbayPort:
 		Returns list of PatchbayClient
 		(May return class extending PatchbayClient, i.e. SystemPatchbayClient / Plugin)
 		"""
-		return [ port.client() for port in self.connected_ports() ]
-
-	def encode_saved_state(self):
-		"""
-		Returns a dict which is encoded to JSON when saving a project.
-		"""
-		client = self.client()
-		return {
-			"system"	: isinstance(client, SystemPatchbayClient),
-			"moniker"	: f"{client.moniker}:{self.port_name}",
-			"client"	: client.client_name if isinstance(client, SystemPatchbayClient) else client.uuid,
-			"port"		: self.port_name
-		}
+		return [ port.client for port in self.connected_ports() ]
 
 	def __str__(self):
 		return '<{0} {1} "{2}:{3}">'.format(
 			("Audio" if self.is_audio else "MIDI" if self.is_midi else "CV"),
 			("input" if self.is_input else "output"),
-			self.client().moniker, self.port_name
+			self.client.moniker, self.port_name
 		)
 
 
@@ -2681,11 +2661,9 @@ class PatchbayConnection:
 		return f'<PatchbayConnection {self.connection_id} {self.out_port} to {self.in_port}>'
 
 
-
 # -------------------------------------------------------------------
 # Plugins:
 
-
 class Plugin(PatchbayClient):
 	"""
 	An abstraction of a carla plugin.
@@ -2724,6 +2702,8 @@ class Plugin(PatchbayClient):
 		super().__init__()
 		self.saved_state			= saved_state
 		self.original_plugin_name	= self.plugin_def['name']
+		self.client_id				= None	# Assigned by carla
+		self.client_name			= None	# Assigned by carla
 		self.plugin_id				= None
 		self.moniker				= None
 		self.ports_ready			= False
@@ -2880,7 +2860,6 @@ class Plugin(PatchbayClient):
 		Called after post_embed_init() and all ports ready.
 		You can check the state of this plugin using the "Plugin.is_ready" property.
 		"""
-		logging.debug('%s ready', self)
 		if self._cb_ready is not None:
 			self._cb_ready()
 
@@ -3009,16 +2988,6 @@ class Plugin(PatchbayClient):
 		return '<{0} "{1}" (uuid {2}, client_id {3})>'.format(
 			type(self).__name__, self.moniker, self.uuid, self.client_id)
 
-	def idle_fast(self):
-		"""
-		Function which is called at a regular interval by client applications
-		Although this function is not used anywhere in this package, it is included for
-		your convenience.
-		Use it like so:
-			for plugin in Carla.instance.plugins():
-				plugin.idle_fast()
-		"""
-
 	# -------------------------------------------------------------------
 	# Functions called from Carla engine callbacks:
 
@@ -3051,6 +3020,34 @@ class Plugin(PatchbayClient):
 		if self._cb_removed is not None:
 			self._cb_removed()
 
+	def internal_value_changed(self, index, value):
+		if index == PARAMETER_NULL:
+			return
+		elif index == PARAMETER_ACTIVE:
+			self.active_changed(bool(value))
+		elif index == PARAMETER_DRYWET:
+			self.dry_wet_changed(value)
+		elif index == PARAMETER_VOLUME:
+			self.volume_changed(value)
+		elif index == PARAMETER_BALANCE_LEFT:
+			self.balance_left_changed(value)
+		elif index == PARAMETER_BALANCE_RIGHT:
+			self.balance_right_changed(value)
+		elif index == PARAMETER_PANNING:
+			self.panning_changed(value)
+		elif index == PARAMETER_CTRL_CHANNEL:
+			self.ctrl_channel_changed(value)
+		elif index == PARAMETER_MAX:
+			return
+		else:
+			if index in self.parameters:
+				parameter = self.parameters[index]
+				parameter.internal_value_changed(value)
+				self.parameter_internal_value_changed(parameter, value)
+			else:
+				logging.error('Parameter "%d" not in "%s" parameters',
+					index, self)
+
 	def parameter_internal_value_changed(self, parameter, value):
 		"""
 		Called by the Carla host engine when the internal value of a parameter has changed.
@@ -3139,8 +3136,31 @@ class Plugin(PatchbayClient):
 		pass
 
 	# -------------------------------------------------------------------
-	# Propery access functions which may trigger GUI changes
-	# or require setting a parameter in the engine:
+	# Property changes triggered by internal value changes from carla
+
+	def active_changed(self, value):
+		self._active = value
+
+	def dry_wet_changed(self, value):
+		self._dry_wet = value
+
+	def volume_changed(self, value):
+		self._volume = value
+
+	def balance_left_changed(self, value):
+		self._balance_left = value
+
+	def balance_right_changed(self, value):
+		self._balance_right = value
+
+	def panning_changed(self, value):
+		self._panning = value
+
+	def ctrl_channel_changed(self, value):
+		self._ctrl_channel = value
+
+	# -------------------------------------------------------------------
+	# Properties accessed only from outside, not by carla
 
 	@property
 	def active(self):
@@ -3154,6 +3174,9 @@ class Plugin(PatchbayClient):
 		"""
 		Set the "active" state of this Plugin.
 		"""
+		self.set_active(value)
+
+	def set_active(self, value):
 		if self.is_ready:
 			self._active = value
 			Carla.instance.set_active(self.plugin_id, bool(value))
@@ -3172,6 +3195,9 @@ class Plugin(PatchbayClient):
 		Sets the dry/wet mix.
 		"value" must be a float value in the range 0.0 to 1.0.
 		"""
+		self.set_dry_wet(value)
+
+	def set_dry_wet(self, value):
 		if isinstance(value, float):
 			if value < 0.0 or value > 1.0:
 				raise ValueError()
@@ -3192,6 +3218,9 @@ class Plugin(PatchbayClient):
 		Sets the volume.
 		"value" must be a float value in the range 0.0 to 1.0.
 		"""
+		self.set_volume(value)
+
+	def set_volume(self, value):
 		if isinstance(value, float):
 			if value < 0.0 or value > 1.0:
 				raise ValueError()
@@ -3212,6 +3241,9 @@ class Plugin(PatchbayClient):
 		Sets the balance of the left channel (if applicable).
 		"value" must be a float value in the range 0.0 to 1.0.
 		"""
+		self.set_balance_left(value)
+
+	def set_balance_left(self, value):
 		if isinstance(value, float):
 			if value < -1.0 or value > 1.0:
 				raise ValueError()
@@ -3232,6 +3264,9 @@ class Plugin(PatchbayClient):
 		Sets the balance of the right channel (if applicable).
 		"value" must be a float value in the range 0.0 to 1.0.
 		"""
+		self.set_balance_right(value)
+
+	def set_balance_right(self, value):
 		if isinstance(value, float):
 			if value < -1.0 or value > 1.0:
 				raise ValueError()
@@ -3262,6 +3297,9 @@ class Plugin(PatchbayClient):
 		Sets the pan value (if applicable).
 		"value" must be a float value in the range 0.0 to 1.0.
 		"""
+		self.set_panning(value)
+
+	def set_panning(self, value):
 		if isinstance(value, float):
 			if value < -1.0 or value > 1.0:
 				raise ValueError()
@@ -3280,7 +3318,9 @@ class Plugin(PatchbayClient):
 		"""
 		Not sure what this does.
 		"""
-		# logging.debug('set ctrl_channel %s', value)
+		self.set_ctrl_channel(value)
+
+	def set_ctrl_channel(self, value):
 		Carla.instance.set_ctrl_channel(self.plugin_id, value)
 		self._ctrl_channel = value
 
@@ -3405,6 +3445,7 @@ class Parameter:
 		self.__value = Carla.instance.get_current_parameter_value(self.plugin_id, self.parameter_id)
 		return self.__value
 
+	@cached_property
 	def plugin(self):
 		"""
 		Returns the Plugin which "owns" this Parameter.

{simple_carla-1.5.1 → simple_carla-2.1.0}/simple_carla/qt.py

@@ -314,7 +314,6 @@ class CarlaQt(_SimpleCarla, QObject):
 		self.sig_last_plugin_removed.emit()
 
 
-
 class AbstractQtPlugin(Plugin):
 	"""
 	This is an abstract class for use by classes which you wish to inherit from a
@@ -329,10 +328,17 @@ class AbstractQtPlugin(Plugin):
 	class MyVisualPlugin(QFrame, AbstractQtPlugin):
 
 		# You must define these signals!
-		sig_ready				= pyqtSignal(Plugin)
-		sig_removed 			= pyqtSignal(Plugin)
-		sig_connection_change	= pyqtSignal(PatchbayPort, PatchbayPort, bool)
-		sig_parameter_changed	= pyqtSignal(Plugin, Parameter, float)
+		sig_ready						= pyqtSignal(Plugin)
+		sig_removed 					= pyqtSignal(Plugin)
+		sig_connection_change			= pyqtSignal(PatchbayPort, PatchbayPort, bool)
+		sig_parameter_changed			= pyqtSignal(Plugin, Parameter, float)
+		sig_active_changed				= pyqtSignal(Plugin, bool)
+		sig_dry_wet_changed				= pyqtSignal(Plugin, float)
+		sig_volume_changed				= pyqtSignal(Plugin, float)
+		sig_balance_left_changed		= pyqtSignal(Plugin, float)
+		sig_balance_right_changed		= pyqtSignal(Plugin, float)
+		sig_panning_changed				= pyqtSignal(Plugin, float)
+		sig_ctrl_channel_changed		= pyqtSignal(Plugin, float)
 
 		plugin_def = {...}
 
@@ -364,6 +370,37 @@ class AbstractQtPlugin(Plugin):
 		if not self.removing_from_carla:
 			self.sig_connection_change.emit(connection.out_port, connection.in_port, state)
 
+	# -------------------------------------------------------------------
+	# Property changes triggered by internal value changes from carla
+
+	def active_changed(self, value):
+		self._active = value
+		self.sig_active_changed.emit(self, value)
+
+	def dry_wet_changed(self, value):
+		self._dry_wet = value
+		self.sig_dry_wet_changed.emit(self, value)
+
+	def volume_changed(self, value):
+		self._volume = value
+		self.sig_volume_changed.emit(self, value)
+
+	def balance_left_changed(self, value):
+		self._balance_left = value
+		self.sig_balance_left_changed.emit(self, value)
+
+	def balance_right_changed(self, value):
+		self._balance_right = value
+		self.sig_balance_right_changed.emit(self, value)
+
+	def panning_changed(self, value):
+		self._panning = value
+		self.sig_panning_changed.emit(self, value)
+
+	def ctrl_channel_changed(self, value):
+		self._ctrl_channel = value
+		self.sig_ctrl_channel_changed.emit(self, value)
+
 	def parameter_internal_value_changed(self, parameter, value):
 		"""
 		Called by the Carla host engine when the internal value of a parameter has changed.
@@ -375,7 +412,6 @@ class AbstractQtPlugin(Plugin):
 		self.sig_parameter_changed.emit(self, parameter, value)
 
 
-
 class QtPlugin(AbstractQtPlugin, QObject):
 	"""
 	A class which inherits from both Plugin and QObject. It can be used by plugins
@@ -389,15 +425,22 @@ class QtPlugin(AbstractQtPlugin, QObject):
 
 	"""
 
-	sig_ready				= pyqtSignal(Plugin)
-	sig_removed 			= pyqtSignal(Plugin)
-	sig_connection_change	= pyqtSignal(PatchbayPort, PatchbayPort, bool)
-	sig_parameter_changed	= pyqtSignal(Plugin, Parameter, float)
+	sig_ready						= pyqtSignal(Plugin)
+	sig_removed 					= pyqtSignal(Plugin)
+	sig_connection_change			= pyqtSignal(PatchbayPort, PatchbayPort, bool)
+	sig_parameter_changed			= pyqtSignal(Plugin, Parameter, float)
+	sig_active_changed				= pyqtSignal(Plugin, bool)
+	sig_dry_wet_changed				= pyqtSignal(Plugin, float)
+	sig_volume_changed				= pyqtSignal(Plugin, float)
+	sig_balance_left_changed		= pyqtSignal(Plugin, float)
+	sig_balance_right_changed		= pyqtSignal(Plugin, float)
+	sig_panning_changed				= pyqtSignal(Plugin, float)
+	sig_ctrl_channel_changed		= pyqtSignal(Plugin, float)
+
 
 	def __init__(self, plugin_def=None, saved_state=None):
 		QObject.__init__(self)
 		Plugin.__init__(self, plugin_def, saved_state)
 
 
-
 #  end simple_carla/qt.py