jdxi_editor.ui.widgets.combo_box.synchronizer

ComboBox Synchronizer Module

Manages synchronization between MIDI input/output and combo box selectors. Handles real-time note-to-selector mapping and drum kit selection updates.

Classes

ComboBoxUpdateConfig	Configuration for combo box synchronization.
ComboBoxState	Represents the state of a combo box selector.
ComboBoxSynchronizer	Synchronizes MIDI messages with combo box selectors.

Module Contents

class jdxi_editor.ui.widgets.combo_box.synchronizer.ComboBoxUpdateConfig(silence_logging: bool = False, min_note: int = 36, update_interval_ms: int = 100)

Configuration for combo box synchronization.

silence_logging = False

min_note = 36

update_interval_ms = 100

class jdxi_editor.ui.widgets.combo_box.synchronizer.ComboBoxState(row: int, current_index: int, current_text: str, note: int | None = None)

Represents the state of a combo box selector.

row

current_index

current_text

note = None

class jdxi_editor.ui.widgets.combo_box.synchronizer.ComboBoxSynchronizer(config: ComboBoxUpdateConfig | None = None, midi_converter: jdxi_editor.midi.conversion.note.MidiNoteConverter | None = None, scope: str = 'ComboBoxSynchronizer')

Synchronizes MIDI messages with combo box selectors.

Handles: - Incoming MIDI note-to-selector mapping - Outgoing MIDI message parsing - Drum kit selection updates - Selector state management - Channel-to-selector routing

CHANNEL_TO_ROW

ROW_TO_CHANNEL

config

midi_converter = None

scope = 'ComboBoxSynchronizer'

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

row_options: Dict[int, List[str]]

last_update_time: Dict[int, float]

on_selector_changed: Callable[[ComboBoxState], None] | None = None

on_drum_kit_changed: Callable[[str], None] | None = None

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

set_selector(row: int, combo_box: PySide6.QtWidgets.QComboBox) → None

Register a selector combo box for a row.

Parameters:

• row – Row index (0-3)

• combo_box – QComboBox widget

set_selector_options(row: int, options: List[str]) → None

Set the available options for a selector.

Parameters:

• row – Row index (0-3)

• options – List of option strings

set_all_selectors(digital1: PySide6.QtWidgets.QComboBox, digital2: PySide6.QtWidgets.QComboBox, analog: PySide6.QtWidgets.QComboBox, drums: PySide6.QtWidgets.QComboBox) → None

Set all selector combo boxes at once.

Parameters:

• digital1 – Digital Synth 1 selector

• digital2 – Digital Synth 2 selector

• analog – Analog Synth selector

• drums – Drum kit selector

process_incoming_midi(message) → None

Process an incoming MIDI message.

Updates selectors based on incoming notes.

Parameters:

message – Mido Message object

process_outgoing_midi(message) → None

Process an outgoing MIDI message.

Converts raw or partial messages to mido Message and updates selectors.

Parameters:

message – List[int], tuple, or mido.Message

set_selector_by_note(row: int, midi_note: int) → bool

Update a selector based on a MIDI note.

Parameters:

• row – Row index (0-3)

• midi_note – MIDI note number

Returns:

True if selector was updated

set_selector_by_text(row: int, text: str) → bool

Update a selector by text value.

Parameters:

• row – Row index (0-3)

• text – Item text to select

Returns:

True if selector was updated

set_drum_kit(kit_name: str) → bool

Change the drum kit selection.

Parameters:

kit_name – Name of the drum kit

Returns:

True if drum kit was changed

get_selector_state(row: int) → ComboBoxState | None

Get the current state of a selector.

Parameters:

row – Row index (0-3)

Returns:

ComboBoxState or None

get_all_selector_states() → Dict[int, ComboBoxState]

Get the state of all selectors.

Returns:

Dictionary mapping row to ComboBoxState

get_selected_note(row: int) → int | None

Get the MIDI note corresponding to the currently selected item in a selector.

Parameters:

row – Row index (0-3)

Returns:

MIDI note number or None

enable_selector(row: int, enabled: bool = True) → None

Enable or disable a selector.

Parameters:

• row – Row index (0-3)

• enabled – Whether to enable the selector

enable_all_selectors(enabled: bool = True) → None

Enable or disable all selectors.

Parameters:

enabled – Whether to enable selectors

reset_selectors() → None

Reset all selectors to their first item.

_handle_note_on(message: mido.Message) → None

Handle a NOTE_ON message.

Updates the appropriate selector based on channel and note.

Parameters:

message – Mido NOTE_ON message with velocity > 0

_note_to_combo_index(row: int, midi_note: int) → int | None

Convert a MIDI note to a combo box index.

Parameters:

• row – Row index (0-3)

• midi_note – MIDI note number

Returns:

Combo box index or None

_text_to_note(row: int, text: str) → int | None

Convert selector text to a MIDI note.

Parameters:

• row – Row index

• text – Text from selector

Returns:

MIDI note or None

_midi_to_note_name(midi_note: int) → str

Convert MIDI note to note name.

Parameters:

midi_note – MIDI note number

Returns:

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

_midi_to_drum_name(midi_note: int) → str

Convert MIDI note to drum name.

Parameters:

midi_note – MIDI note number

Returns:

Drum name or fallback

_basic_note_name_to_midi(note_name: str) → int | None

Basic fallback for note name to MIDI conversion.

Parameters:

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

Returns:

MIDI note or None

_set_selector_index_silent(combo_box: PySide6.QtWidgets.QComboBox, index: int) → None

Set combo box index without triggering signals.

Parameters:

• combo_box – QComboBox to update

• index – Index to set

set_config(config: ComboBoxUpdateConfig) → None

Update synchronizer configuration.

Parameters:

config – New ComboBoxUpdateConfig

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

Set the MIDI converter.

Parameters:

converter – MidiNoteConverter instance