jdxi_editor.ui.sequencer.button.manager

Sequencer Button Manager Module

Manages sequencer button state, styling, and synchronization with pattern measures. Handles button clicks, note assignment, and UI updates.

Classes

NoteButtonAttrs	Button attribute names.
ButtonState	Represents the state of a sequencer button.
SequencerButtonManager	Manages sequencer button state and synchronization.

Module Contents

class jdxi_editor.ui.sequencer.button.manager.NoteButtonAttrs

Button attribute names.

NOTE = 'note'

NOTE_DURATION = 'note_duration'

NOTE_VELOCITY = 'note_velocity'

COPYABLE

class jdxi_editor.ui.sequencer.button.manager.ButtonState(is_checked: bool = False, note: int | None = None, velocity: int = 100, duration_ms: float = 120.0, *, note_spec: picomidi.ui.widget.button.note.NoteButtonEvent | None = None)

Represents the state of a sequencer button.

is_checked = False

note_spec

property note: int | None

property velocity: int

property duration_ms: float

is_active() → bool

Check if button has an active note (checked and has note).

class jdxi_editor.ui.sequencer.button.manager.SequencerButtonManager(midi_converter: jdxi_editor.midi.conversion.note.MidiNoteConverter | None = None, scope: str = 'SequencerButtonManager')

Manages sequencer button state and synchronization.

Handles: - Button click events and state updates - Note assignment from combo box selectors - Button styling and highlighting - Synchronization with measure data - Tooltip updates

midi_converter = None

scope = 'SequencerButtonManager'

buttons: List[List]

channel_map: Dict[int, PySide6.QtWidgets.QComboBox]

current_measure_index = 0

current_step = 0

total_steps = 16

style_generator: Callable | None = None

on_button_changed: Callable[[int, int, ButtonState], None] | None = None

on_measure_synced: Callable[[int], None] | None = None

default_velocity = 100

default_duration_ms = 120.0

get_current_duration: Callable[[], float] | None = None

get_current_velocity: Callable[[], int] | None = None

set_buttons(buttons: List[List]) → None

Set the button grid.

Parameters:

buttons – 2D list of buttons (4 rows x 16+ columns)

set_channel_map(channel_map: Dict[int, PySide6.QtWidgets.QComboBox]) → None

Set the row-to-selector mapping.

Parameters:

channel_map – Dictionary mapping row (0-3) to QComboBox

set_style_generator(generator: Callable[[bool, bool, bool], str]) → None

Set the style generator callback.

Called with (is_checked, is_current, is_selected_bar) returns stylesheet.

Parameters:

generator – Callback function

handle_button_click(button, checked: bool, measures: List | None = None) → None

Handle a button click event.

Updates button state, measure data, and UI.

Parameters:

• button – SequencerButton that was clicked

• checked – New checked state

• measures – List of PatternMeasure objects (optional)

sync_sequencer_with_measure(bar_index: int, measures: List) → None

Synchronize sequencer buttons with a measure’s data.

Copies note data from the measure to the main sequencer buttons.

Parameters:

• bar_index – Index of the bar to sync from

• measures – List of PatternMeasure objects

highlight_current_step(step: int) → None

Highlight the current playback step.

Updates button styles to show which step is currently playing.

Parameters:

step – Current step in bar (0-15)

highlight_bar(bar_index: int) → None

Highlight all buttons in the current bar display.

Parameters:

bar_index – Index of bar being displayed

reset_button(button) → None

Reset a button to its default state.

Clears note data and unchecks the button.

Parameters:

button – SequencerButton to reset

reset_all_buttons() → None

Reset all sequencer buttons.

clear_row(row: int) → None

Clear all buttons in a specific row.

Parameters:

row – Row index (0-3)

get_button_state(row: int, col: int) → ButtonState | None

Get the current state of a button.

Parameters:

• row – Row index

• col – Column index

Returns:

ButtonState or None if button doesn’t exist

get_row_state(row: int) → List[ButtonState | None]

Get the state of all buttons in a row.

Parameters:

row – Row index (0-3)

Returns:

List of ButtonState objects

set_button_note(row: int, col: int, note: int, velocity: int = 100, duration_ms: float = 120.0) → bool

Set a button’s note data programmatically.

Parameters:

• row – Row index

• col – Column index

• note – MIDI note number

• velocity – Note velocity

• duration_ms – Note duration

Returns:

True if successful

set_button_checked(row: int, col: int, checked: bool) → bool

Set a button’s checked state programmatically.

Parameters:

• row – Row index

• col – Column index

• checked – New checked state

Returns:

True if successful

_store_note_in_measures(button, checked: bool, measures: List) → None

Store button state in the corresponding measure.

Parameters:

• button – SequencerButton

• checked – Whether button is checked

• measures – List of PatternMeasure objects

_update_button_style(button, is_current: bool | None = None, is_selected_bar: bool = True) → None

Update button visual style.

Parameters:

• button – Button to style

• is_current – Whether button is current step (optional)

• is_selected_bar – Whether button is in selected bar

_update_button_tooltip(button) → None

Update button tooltip to show note name.

Parameters:

button – SequencerButton

_update_button_state_silent(button, checked: bool) → None

Update button checked state without signals.

Parameters:

• button – Button to update

• checked – New checked state

_get_button_state(button) → ButtonState

Extract button state.

Parameters:

button – SequencerButton

Returns:

ButtonState object

_sync_button_note_spec(button) → None

Sync the button’s note_spec from attributes.

Parameters:

button – SequencerButton

_create_note_spec(note, duration_ms, velocity)

Create a note specification object.

Parameters:

• note – MIDI note number

• duration_ms – Duration in milliseconds

• velocity – Velocity (0-127)

Returns:

NoteButtonSpec

_create_empty_note_spec()

Create an empty note spec.

_reset_button_internal(button) → None

Internal button reset (without logging).

_note_name_to_midi(note_name: str) → int | None

Convert note name to MIDI number.

Parameters:

note_name – Note name (e.g., ‘C4’)

Returns:

MIDI note number or None

_midi_to_note_name(midi_note: int, drums: bool = False) → str

Convert MIDI number to note name.

Parameters:

• midi_note – MIDI note number

• drums – Whether to use drum names

Returns:

Note name (e.g., ‘C4’)

_basic_note_name_to_midi(note_name: str) → int | None

Basic note name to MIDI conversion (fallback).

Parameters:

note_name – Note name

Returns:

MIDI note or None

_get_duration() → float

Get current default duration.

_get_velocity() → int

Get current default velocity.

set_midi_converter(converter: jdxi_editor.midi.conversion.note.MidiNoteConverter) → None

Set the MIDI converter.

Parameters:

converter – MidiNoteConverter instance

set_defaults(velocity: int = 100, duration_ms: float = 120.0) → None

Set default velocity and duration.

Parameters:

• velocity – Default velocity

• duration_ms – Default duration

highlight_measure(measure_index: int) → None

Highlight the current measure/bar in the sequencer display.

Updates button styles to show the selected measure and the current step. Equivalent to highlight_bar; “measure” and “bar” are interchangeable.

Parameters:

measure_index – Index of the measure being displayed