ableton.v3.control_surface.components.note_editor

Module constants

• PROPERTY_RANGE_KEYS = ('pitch', 'start_time', 'duration', 'velocity')
• RELATIVE_OFFSET = 0.24
• DEFAULT_HEIGHT = 4
• DEFAULT_WIDTH = 4
• DEFAULT_VELOCITY = 100
• DEFAULT_START_NOTE = 36
• DEFAULT_STEP_TRANSLATION_CHANNEL = 1
• STEP_DELAY_TIME = 0.2

Classes

class PitchProvider(EventObject)

Bases: EventObject

Attributes

• pitches
• is_polyphonic

class TimeStep

__init__(self, start, length, *a, **k)

offset(self)

left_boundary(self)

right_boundary(self)

filter_notes(self, notes)

clamp(self, time)

includes_note(self, note)

includes_time(self, time)

connected_time_ranges(self)

class StepButtonControl(ButtonControl)

Bases: ButtonControl

class State(ButtonControl.State)

Bases: ButtonControl.State

Attributes

• x
• y
• is_active = False

class NoteEditorComponent(Component, Renderable)

Bases: Component, Renderable

Attributes

• _NoteEditorComponent__on_clip_notes_changed
• _NoteEditorComponent__on_sequencer_clip_changed
• _NoteEditorComponent__on_target_track_color_changed
• _NoteEditorComponent__on_provided_pitches_changed
• _NoteEditorComponent__on_provider_polyphony_changed
• _NoteEditorComponent__on_resolution_changed

__init__(self, name, translation_channel, full_velocity, target_track, sequencer_clip, grid_resolution, clipboard_component_type, *a, **k)

clipboard(self)

width(self)

height(self)

step_count(self)

step_length(self)

can_change_page(self)

page_time(self)

page_time(self, time)

page_length(self)

active_steps(self)

pitch_provider(self)

pitch_provider(self, provider)

set_clip(self, clip)

set_pitches(self, pitches)

set_pitch_offset(self, value)

set_duration_offset(self, value)

set_velocity_offset(self, value)

set_nudge_offset(self, value)

set_matrix(self, matrix)

set_copy_button(self, button)

is_pitch_active(self, pitch)

toggle_pitch_for_all_active_steps(self, pitch)

can_nudge_by_offset(self, offset)

get_note_property_ranges(self)

get_duration_range_string(self)

get_duration_fine_range_string(self)

get_velocity_range_string(self)

get_nudge_offset_range_string(self)

_get_property_range_string(self, property_name, value_range_fn, str_fmt)

_get_step_offset_range_string(self, property_name)

page_time_changed(self)

_time_step(self, time)

_can_edit(self)

_has_clip(self)

_can_press_or_release_step(self, step)

_get_step_start_time(self, step)

_get_step_time_range(self, step)

_get_notes_info_from_step(self, step)

_get_clip_notes_time_range(self)

matrix(self, pad)

matrix(self, pad)

_on_pad_pressed(self, pad)

matrix(self, pad)

matrix(self, pad)

matrix(self, pad)

_on_pad_released(self, pad, **k)

_on_release_step(self, step, can_add_or_remove)

_refresh_active_steps(self)

_release_active_steps(self)

_add_note_in_step(self, pitch, time)

_delete_notes_in_step(self, step)

_adjust_duration_of_last_held_step_notes(self, destination_step)

_modify_note_property(self, note_property, value)

_reset_modifications(self)

_modify_step_notes(self, steps)

_modify_note(self, time_step, duration_offset, nudge_offset, note)

_modify_duration(time_step, duration_offset, note)

_update_from_grid(self)

_update_clipboard(self, pad)

update(self)

_update_editor_matrix(self)

_get_color_for_step(self, index, visible_steps)

_get_alternate_color_for_step(self, index, visible_steps)

_visible_steps(self)

__on_clip_notes_changed(self)

__on_sequencer_clip_changed(self)

__on_target_track_color_changed(self)

__on_provided_pitches_changed(self, pitches)

__on_provider_polyphony_changed(self, _)

__on_resolution_changed(self, *_)

class NoteRegionClipboardComponent(BufferedClipboardComponent)

Bases: BufferedClipboardComponent

__init__(self, *a, **k)

set_clip(self, clip)

extend_buffer(self, obj)

_do_paste(self, obj)

_is_source_valid(self)

Functions

get_notes(clip, pitches, time, length, all_pitches)

remove_notes(clip, pitches, time, length, all_pitches)

property_ranges_for_notes(notes, start_time, property_ranges)

step_offset_percentage(step_length, value)