Skip to content

ableton.v2.control_surface.elements.encoder

Module constants

  • _map_modes
  • map_modes
  • ABSOLUTE_MAP_MODES
  • SIGNED_BIT_DEFAULT_DELTA = 20.0
  • SIGNED_BIT_VALUE_MAP = (1, 2, 3, 4, 5, 8, 10, 20, 50)
  • ENCODER_VALUE_NORMALIZER
  • MAX_14_BIT_CC = 95
  • ENCODER_VALUE_ACCUMULATOR

Classes

class EncoderElement(InputControlElement)

Bases: InputControlElement

Attributes

  • encoder_sensitivity = 1.0
  • allow_receiving_chunks = True

__init__(self, msg_type, channel, identifier, map_mode, encoder_sensitivity, *a, **k)

message_map_mode(self)

receive_value(self, value)

relative_value_to_delta(self, value)

normalize_value(self, value)

notify_value(self, value)

receive_chunk(self, chunk)

class ProxiedInterface(InputControlElement.ProxiedInterface)

Bases: InputControlElement.ProxiedInterface

Attributes
  • normalize_value

class TouchEncoderElementBase(EncoderElement)

Bases: EncoderElement

touch_element(self)

is_pressed(self)

class ProxiedInterface(EncoderElement.ProxiedInterface)

Bases: EncoderElement.ProxiedInterface

Attributes
  • is_pressed
  • touch_element

class TouchEncoderElement(CompoundElement, TouchEncoderElementBase)

Bases: CompoundElement, TouchEncoderElementBase

__init__(self, msg_type, channel, identifier, map_mode, touch_element, *a, **k)

on_nested_control_element_value(self, value, control)

touch_element(self)

is_pressed(self)

on_nested_control_element_received(self, control)

on_nested_control_element_lost(self, control)

class FineGrainWithModifierEncoderElement(WrapperElement)

Bases: WrapperElement

Attributes

  • _FineGrainWithModifierEncoderElement__on_normalized_value
  • _FineGrainWithModifierEncoderElement__on_modifier_value

__init__(self, encoder, modifier, modified_sensitivity, default_sensitivity, *a, **k)

add_normalized_value_listener(self, listener)

remove_normalized_value_listener(self, listener)

normalized_value_has_listener(self, listener)

__on_normalized_value(self, value)

__on_modifier_value(self, value)

on_nested_control_element_received(self, control)

on_nested_control_element_lost(self, control)

on_nested_control_element_value(self, value, control)

_enforce_control_invariant(self)

set_sensitivities(self, default, modified)

Functions

_not_implemented(value)

signed_bit_delta(value)

normalize_two_compliment(value)

accumulate_relative_two_compliment_chunk(chunk)