ableton.v3.control_surface.identification (runtime)¶
Live 11 — Live Object Model & framework reference (descriptions and signatures).
Module constants¶
MIDI_CC_TYPE = 1MIDI_NOTE_TYPE = 0MIDI_PB_TYPE = 2NON_REALTIME_HEADER = (240, 126)PRODUCT_ID_BYTES_START_INDEX = 3STANDARD_RESPONSE_BYTES = (6, 2)logger = <Logger ableton.v3.control_surface.identification (INFO)>
Functions¶
abstractmethod(funcobj)¶
create_responder(identity_response_id_bytes, custom_identity_response)¶
depends(**dependencies)¶
nop(*a, **k)¶
status_byte_to_msg_type(status_byte)¶
Classes¶
class ABC¶
Methods¶
__init__(self, /, *args, **kwargs)¶
Initialize self. See help(type(self)) for accurate signature.
Attributes¶
_abc_impl=<_abc_data object at 0x118694cc0>
class Component(ControlManager)¶
Properties¶
applicationis_rootlayerparentsong
Methods¶
__init__(self, name='', parent=None, register_component=None, song=None, layer=None, is_enabled=True, is_private=True, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_add_child(self, component)¶
_get_layer_iterable(self)¶
_grab_all_layers(self)¶
_internal_on_enabled_changed(self)¶
_release_all_layers(self)¶
_set_enabled_recursive(self, enable)¶
_update_is_enabled(self)¶
add_any_clipboard_has_content_listener(self, slot, identify_sender=False, *a, **k)¶
add_children(self, *children)¶
add_control(self, name, control)¶
add_enabled_listener(self, slot, identify_sender=False, *a, **k)¶
any_clipboard_has_content_has_listener(self, slot)¶
any_clipboard_has_content_listener_count(self)¶
control_notifications_enabled(self)¶
disconnect(self)¶
disconnect_disconnectable(self, slot)¶
enabled_has_listener(self, slot)¶
enabled_listener_count(self)¶
find_disconnectable(self, predicate)¶
has_disconnectable(self, slot)¶
is_enabled(self, explicit=False)¶
notify_any_clipboard_has_content(self, *a, **k)¶
notify_enabled(self, *a, **k)¶
on_enabled_changed(self)¶
register_clipboard(self)¶
register_disconnectable(self, slot)¶
register_disconnectables(self, disconnectables)¶
register_slot(self, *a, **k)¶
remove_any_clipboard_has_content_listener(self, slot)¶
remove_enabled_listener(self, slot)¶
set_enabled(self, enable)¶
unregister_disconnectable(self, slot)¶
update(self)¶
Attributes¶
_clipboard_component_instances=[]- Built-in mutable sequence._tasks=<ableton.v2.base.util.lazy_attribute object at 0x163a2a898>any_clipboard_has_content=False- bool(x) -> boolcanonical_parent=Nonenum_layers=0- int([x]) -> integer
class CustomSysexResponder(Responder)¶
Methods¶
__init__(self, response_bytes, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
create_response_element(self)¶
is_valid_response(self, _)¶
Attributes¶
_abc_impl=<_abc_data object at 0x163bf7420>
class IdentificationComponent(Component, Renderable)¶
Properties¶
applicationis_rootlayerparentsong
Methods¶
__init__(self, name='Identification', identity_request=(240, 126, 127, 6, 1, 247), identity_request_delay=0.0, identity_response_id_bytes=None, custom_identity_response=None, send_midi=None, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_add_child(self, component)¶
_create_event_handler(self, property_name)¶
_get_layer_iterable(self)¶
_grab_all_layers(self)¶
_init_state_from_controls(self, renderable_state)¶
_init_state_from_listenable_properties(self, renderable_state)¶
_internal_on_enabled_changed(self)¶
_release_all_layers(self)¶
_send_identity_request(self)¶
_set_enabled_recursive(self, enable)¶
_update_is_enabled(self)¶
add_any_clipboard_has_content_listener(self, slot, identify_sender=False, *a, **k)¶
add_children(self, *children)¶
add_control(self, name, control)¶
add_enabled_listener(self, slot, identify_sender=False, *a, **k)¶
add_is_identified_listener(self, slot, identify_sender=False, *a, **k)¶
add_received_response_bytes_listener(self, slot, identify_sender=False, *a, **k)¶
any_clipboard_has_content_has_listener(self, slot)¶
any_clipboard_has_content_listener_count(self)¶
control_base_type(extra_args=None, extra_kws=None, *a, **k)¶
control_notifications_enabled(self)¶
disconnect(self)¶
disconnect_disconnectable(self, slot)¶
dispatch_event(self, name: 'str', value)¶
enabled_has_listener(self, slot)¶
enabled_listener_count(self)¶
find_disconnectable(self, predicate)¶
has_disconnectable(self, slot)¶
is_enabled(self, explicit=False)¶
is_identified_has_listener(self, slot)¶
is_identified_listener_count(self)¶
notify(self, notification: 'Notification[Callable[[Unpack[NotificationParams]], Optional[str]]]', *a: 'Unpack[NotificationParams]')¶
notify_any_clipboard_has_content(self, *a, **k)¶
notify_enabled(self, *a, **k)¶
notify_is_identified(self, *a, **k)¶
notify_received_response_bytes(self, *a, **k)¶
on_enabled_changed(self)¶
received_response_bytes_has_listener(self, slot)¶
received_response_bytes_listener_count(self)¶
register_clipboard(self)¶
register_disconnectable(self, slot)¶
register_disconnectables(self, disconnectables)¶
register_slot(self, *a, **k)¶
remove_any_clipboard_has_content_listener(self, slot)¶
remove_enabled_listener(self, slot)¶
remove_is_identified_listener(self, slot)¶
remove_received_response_bytes_listener(self, slot)¶
request_identity(self)¶
set_enabled(self, enable)¶
suppress_notifications(self)¶
unregister_disconnectable(self, slot)¶
update(self)¶
Attributes¶
_clipboard_component_instances=[]- Built-in mutable sequence._tasks=<ableton.v2.base.util.lazy_attribute object at 0x163a2a898>any_clipboard_has_content=False- bool(x) -> boolcanonical_parent=Noneidentity_response_control=<ableton.v2.control_surface.control.control.InputControl object at 0x163bfa940>include_in_top_level_state=True- bool(x) -> boolis_identified=False- bool(x) -> boolnum_layers=0- int([x]) -> integerreceived_response_bytes=Nonerenderable_state=<ableton.v2.base.util.lazy_attribute object at 0x1639d72e8>
class IdentityResponseError(Exception)¶
Common base class for all non-exit exceptions.
Methods¶
__init__(self, expected_bytes=None, actual_bytes=None)¶
Initialize self. See help(type(self)) for accurate signature.
with_traceback(...)¶
Exception.with_traceback(tb) -- set self.traceback to tb and return self.
Attributes¶
args=<attribute 'args' of 'BaseException' objects>
class InputControl(Control)¶
Properties¶
value
Methods¶
State(control=None, channel=None, identifier=None, *a, **k)¶
__init__(self, extra_args=None, extra_kws=None, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_clear_state(self, manager)¶
_get_state(self, manager, state_factory=None)¶
_make_control_state(self, manager)¶
Attributes¶
_extra_args=[]- Built-in mutable sequence._extra_kws={}- dict() -> new empty dictionary
class InputControlElement(NotifyingControlElement)¶
Properties¶
_last_sent_valueis_feedback_enabledmapping_sensitivityresourcescript_forwardingsend_depends_on_forwardingsuppress_script_forwarding
Methods¶
ProxiedInterface(outer=None, *a, **k)¶
__init__(self, msg_type=None, channel=None, identifier=None, sysex_identifier=None, request_rebuild_midi_map=None, send_should_depend_on_forwarding=True, is_feedback_enabled=True, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_do_send_value(self, value, channel=None)¶
_mapping_feedback_values(self)¶
_on_resource_lost(self, client)¶
_on_resource_received(self, client, *a, **k)¶
_report_value(self, value, is_input)¶
_resource_type(on_received_callback=None, on_lost_callback=None, *a, **k)¶
_send_delayed_messages(self)¶
_status_byte(self, channel)¶
_verify_value(self, value)¶
add_value_listener(self, slot, identify_sender=False, *a, **k)¶
begin_gesture(self)¶
clear_send_cache(self)¶
connect_to(self, parameter)¶
disconnect(self)¶
disconnect_disconnectable(self, slot)¶
end_gesture(self)¶
find_disconnectable(self, predicate)¶
force_next_send(self)¶
has_disconnectable(self, slot)¶
identifier_bytes(self)¶
install_connections(self, install_translation, install_mapping, install_forwarding)¶
mapped_parameter(self)¶
max_value(self)¶
message_channel(self)¶
message_identifier(self)¶
message_map_mode(self)¶
message_sysex_identifier(self)¶
message_type(self)¶
needs_takeover(self)¶
notify_ownership_change(self, client, grabbed, element_ownership_handler=None)¶
notify_value(self, *a, **k)¶
original_channel(self)¶
original_identifier(self)¶
receive_chunk(self, chunk)¶
receive_value(self, value)¶
register_disconnectable(self, slot)¶
register_disconnectables(self, disconnectables)¶
register_slot(self, *a, **k)¶
release_parameter(self)¶
remove_value_listener(self, slot)¶
reset(self)¶
reset_state(self)¶
script_wants_forwarding(self)¶
send_midi(self, message)¶
send_value(self, value, force=False, channel=None)¶
set_channel(self, channel)¶
set_feedback_delay(self, delay)¶
set_identifier(self, identifier)¶
set_needs_takeover(self, needs_takeover)¶
set_report_values(self, report_input, report_output)¶
unregister_disconnectable(self, slot)¶
use_default_message(self)¶
value_has_listener(self, slot)¶
value_listener_count(self)¶
Attributes¶
_has_resource=False- bool(x) -> bool_has_task_group=False- bool(x) -> bool_input_signal_listener_count=0- int([x]) -> integer_resource=<ableton.v2.base.util.lazy_attribute object at 0x11b312780>_tasks=<ableton.v2.base.util.lazy_attribute object at 0x1630c8898>allow_receiving_chunks=False- bool(x) -> boolcanonical_parent=Nonename=''- str(object='') -> strnum_delayed_messages=1- int([x]) -> integeroptimized_send_midi=True- bool(x) -> boolproxied_interface=<ableton.v2.base.util.lazy_attribute object at 0x11df40710>
class PlainMidiResponder(Responder)¶
Methods¶
__init__(self, response_bytes, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
create_response_element(self)¶
is_valid_response(self, response_bytes)¶
Attributes¶
_abc_impl=<_abc_data object at 0x163bf7480>
class Renderable(CompoundDisconnectable)¶
Methods¶
__init__(self, react=None, notifications: 'Optional[Type[Notifications]]' = None, suppress_notifications: 'Optional[Callable]' = None, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_create_event_handler(self, property_name)¶
_init_state_from_controls(self, renderable_state)¶
_init_state_from_listenable_properties(self, renderable_state)¶
control_base_type(extra_args=None, extra_kws=None, *a, **k)¶
disconnect(self)¶
disconnect_disconnectable(self, slot)¶
dispatch_event(self, name: 'str', value)¶
find_disconnectable(self, predicate)¶
has_disconnectable(self, slot)¶
notify(self, notification: 'Notification[Callable[[Unpack[NotificationParams]], Optional[str]]]', *a: 'Unpack[NotificationParams]')¶
register_disconnectable(self, slot)¶
register_disconnectables(self, disconnectables)¶
suppress_notifications(self)¶
unregister_disconnectable(self, slot)¶
Attributes¶
include_in_top_level_state=True- bool(x) -> boolrenderable_state=<ableton.v2.base.util.lazy_attribute object at 0x1639d72e8>
class Responder(ABC)¶
Methods¶
__init__(self, response_bytes, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
create_response_element(self)¶
is_valid_response(self, response_bytes)¶
Attributes¶
_abc_impl=<_abc_data object at 0x163bf73f0>
class StandardResponder(Responder)¶
Methods¶
__init__(self, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_extract_product_id_bytes(self, midi_bytes)¶
create_response_element(self)¶
is_valid_response(self, response_bytes)¶
Attributes¶
_abc_impl=<_abc_data object at 0x163bf74e0>
class SysexElement(InputControlElement)¶
Properties¶
_last_sent_valueis_feedback_enabledmapping_sensitivityresourcescript_forwardingsend_depends_on_forwardingsuppress_script_forwarding
Methods¶
ProxiedInterface(outer=None, *a, **k)¶
__init__(self, send_message_generator=None, enquire_message=None, default_value=None, optimized=False, use_first_byte_as_value=False, *a, **k)¶
Initialize self. See help(type(self)) for accurate signature.
_do_send_value(self, message)¶
_mapping_feedback_values(self)¶
_on_resource_lost(self, client)¶
_on_resource_received(self, client, *a, **k)¶
_report_value(self, value, is_input)¶
_resource_type(on_received_callback=None, on_lost_callback=None, *a, **k)¶
_send_delayed_messages(self)¶
_status_byte(self, channel)¶
_verify_value(self, value)¶
add_value_listener(self, slot, identify_sender=False, *a, **k)¶
begin_gesture(self)¶
clear_send_cache(self)¶
connect_to(self, parameter)¶
deferring_send(self)¶
disconnect(self)¶
disconnect_disconnectable(self, slot)¶
end_gesture(self)¶
enquire_value(self)¶
find_disconnectable(self, predicate)¶
force_next_send(self)¶
has_disconnectable(self, slot)¶
identifier_bytes(self)¶
install_connections(self, install_translation, install_mapping, install_forwarding)¶
mapped_parameter(self)¶
max_value(self)¶
message_channel(self)¶
message_identifier(self)¶
message_map_mode(self)¶
message_sysex_identifier(self)¶
message_type(self)¶
needs_takeover(self)¶
notify_ownership_change(self, client, grabbed, element_ownership_handler=None)¶
notify_value(self, *a, **k)¶
original_channel(self)¶
original_identifier(self)¶
receive_chunk(self, chunk)¶
receive_value(self, value)¶
register_disconnectable(self, slot)¶
register_disconnectables(self, disconnectables)¶
register_slot(self, *a, **k)¶
release_parameter(self)¶
remove_value_listener(self, slot)¶
reset(self)¶
reset_state(self)¶
script_wants_forwarding(self)¶
send_midi(self, message)¶
send_value(self, *a, **k)¶
set_channel(self, channel)¶
set_feedback_delay(self, delay)¶
set_identifier(self, identifier)¶
set_needs_takeover(self, needs_takeover)¶
set_report_values(self, report_input, report_output)¶
unregister_disconnectable(self, slot)¶
use_default_message(self)¶
value_has_listener(self, slot)¶
value_listener_count(self)¶
Attributes¶
_has_resource=False- bool(x) -> bool_has_task_group=False- bool(x) -> bool_input_signal_listener_count=0- int([x]) -> integer_resource=<ableton.v2.base.util.lazy_attribute object at 0x11b312780>_tasks=<ableton.v2.base.util.lazy_attribute object at 0x1630c8898>allow_receiving_chunks=False- bool(x) -> boolcanonical_parent=Nonename=''- str(object='') -> strnum_delayed_messages=1- int([x]) -> integeroptimized_send_midi=True- bool(x) -> boolproxied_interface=<ableton.v2.base.util.lazy_attribute object at 0x11df40710>
class listenable_property(listenable_property_base, property)¶
Property attribute.
fget function to be used for getting an attribute value fset function to be used for setting an attribute value fdel function to be used for del'ing an attribute doc docstring
Typical use is to define a managed attribute x:
class C(object): def getx(self): return self._x def setx(self, value): self._x = value def delx(self): del self._x x = property(getx, setx, delx, "I'm the 'x' property.")
Decorators make defining new properties or modifying existing ones easy:
class C(object): @property def x(self): "I am the 'x' property." return self._x @x.setter def x(self, value): self._x = value @x.deleter def x(self): del self._x
Methods¶
__init__(self, /, *args, **kwargs)¶
Initialize self. See help(type(self)) for accurate signature.
deleter(...)¶
Descriptor to change the deleter on a property.
getter(...)¶
Descriptor to change the getter on a property.
managed(default_value)¶
set_property_name(self, name)¶
setter(...)¶
Descriptor to change the setter on a property.
Attributes¶
fdel=<member 'fdel' of 'property' objects>fget=<member 'fget' of 'property' objects>fset=<member 'fset' of 'property' objects>