Skip to content

ableton.v3.control_surface.components.session_navigation (runtime)

Live 12 — Live Object Model & framework reference (descriptions and signatures).

Functions

clamp(val, minv, maxv)

depends(**dependencies)

listens(event_path, *a, **k)

Classes

class Component(ControlManager)

Properties

  • application
  • is_root
  • layer
  • parent
  • song

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)
_tasks(self, parent_task_group=None)
_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.
  • any_clipboard_has_content = False - bool(x) -> bool
  • canonical_parent = None
  • num_layers = 0 - int([x]) -> integer

class EventObject(CompoundDisconnectable)

Methods

__init__(self, *a, **k)

Initialize self. See help(type(self)) for accurate signature.

disconnect(self)
disconnect_disconnectable(self, slot)
find_disconnectable(self, predicate)
has_disconnectable(self, slot)
register_disconnectable(self, slot)
register_disconnectables(self, disconnectables)
register_slot(self, *a, **k)
unregister_disconnectable(self, slot)

class ScrollComponent(Component, Scrollable)

Properties

  • application
  • is_root
  • layer
  • parent
  • scrollable
  • song

Methods

__init__(self, scrollable=None, scroll_skin_name=None, *a, **k)

Initialize self. See help(type(self)) for accurate signature.

_add_child(self, component)
_do_scroll_down(self)
_do_scroll_up(self)
_ensure_scroll_one_direction(self)
_get_layer_iterable(self)
_grab_all_layers(self)
_internal_on_enabled_changed(self)
_make_scroll_task(self, scroll_step)
_on_scroll_pressed(self, button, scroll_step, scroll_task)
_on_scroll_released(self, scroll_task)
_release_all_layers(self)
_set_enabled_recursive(self, enable)
_tasks(self, parent_task_group=None)
_update_is_enabled(self)
_update_scroll_controls(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)
can_scroll_down(self)
can_scroll_up(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)
scroll_down(self)
scroll_up(self)
set_enabled(self, enable)
set_scroll_down_button(self, button)
set_scroll_encoder(self, encoder)
set_scroll_up_button(self, button)
unregister_disconnectable(self, slot)
update(self)

Attributes

  • _clipboard_component_instances = [] - Built-in mutable sequence.
  • any_clipboard_has_content = False - bool(x) -> bool
  • canonical_parent = None
  • num_layers = 0 - int([x]) -> integer
  • scroll_down_button = <ableton.v3.control_surface.controls.button.ButtonControl object at 0x13c7b05d0>
  • scroll_encoder = <ableton.v3.control_surface.controls.encoder.StepEncoderControl object at 0x13c7b0490>
  • scroll_up_button = <ableton.v3.control_surface.controls.button.ButtonControl object at 0x13c7b0590>
  • scrolling_delay = 0.3 - Convert a string or number to a floating point number, if possible.
  • scrolling_step_delay = 0.1 - Convert a string or number to a floating point number, if possible.

class Scrollable

Methods

__init__(self, /, *args, **kwargs)

Initialize self. See help(type(self)) for accurate signature.

can_scroll_down()
can_scroll_up()

Attributes

  • scroll_down = NotImplemented
  • scroll_up = NotImplemented

class SessionNavigationComponent(Component)

Properties

  • application
  • is_root
  • layer
  • parent
  • song

Methods

__init__(self, name='Session_Navigation', session_ring=None, respect_borders=False, snap_track_offset=False, *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)
_tasks(self, parent_task_group=None)
_update_horizontal(self)
_update_is_enabled(self)
_update_vertical(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_down_button(self, button)
set_enabled(self, enable)
set_horizontal_encoder(self, control)
set_left_button(self, button)
set_page_down_button(self, button)
set_page_left_button(self, button)
set_page_right_button(self, button)
set_page_up_button(self, button)
set_right_button(self, button)
set_up_button(self, button)
set_vertical_encoder(self, control)
unregister_disconnectable(self, slot)
update(self)

Attributes

  • _SessionNavigationComponent__on_offset_changed = None
  • _clipboard_component_instances = [] - Built-in mutable sequence.
  • any_clipboard_has_content = False - bool(x) -> bool
  • canonical_parent = None
  • num_layers = 0 - int([x]) -> integer

class SessionRingScroller(Scrollable, EventObject)

Methods

__init__(self, session_ring, respect_borders, snap_track_offset=False, scroll_scenes=False, page_size=1, *a, **k)

Initialize self. See help(type(self)) for accurate signature.

_can_scroll_scenes(self, delta)
_can_scroll_tracks(self, delta)
_max_scene_offset(self)
_max_track_offset(self)
_scroll_scenes(self, delta)
_scroll_tracks(self, delta)
add_scrolled_listener(self, slot, identify_sender=False, *a, **k)
can_scroll_down()
can_scroll_up()
disconnect(self)
disconnect_disconnectable(self, slot)
find_disconnectable(self, predicate)
has_disconnectable(self, slot)
notify_scrolled(self, *a, **k)
register_disconnectable(self, slot)
register_disconnectables(self, disconnectables)
register_slot(self, *a, **k)
remove_scrolled_listener(self, slot)
scroll_down(self)
scroll_up(self)
scrolled_has_listener(self, slot)
scrolled_listener_count(self)
unregister_disconnectable(self, slot)

class partial

partial(func, args, *keywords) - new function with partial application of the given arguments and keywords.

Methods

__call__(self, /, *args, **kwargs)

Call self as a function.

__init__(self, /, *args, **kwargs)

Initialize self. See help(type(self)) for accurate signature.

Attributes

  • args = <member 'args' of 'functools.partial' objects> - tuple of arguments to future partial calls
  • func = <member 'func' of 'functools.partial' objects> - function object to use in future partial calls
  • keywords = <member 'keywords' of 'functools.partial' objects> - dictionary of keyword arguments to future partial calls