jdxi_editor.ui.editors.io.program

ProgramEditor Module

This module defines the ProgramEditor class, a PySide6-based GUI for managing and selecting MIDI programs.

It allows users to browse, filter, and load programs based on bank, genre, and program number.

The class also facilitates MIDI integration by sending Program Change (PC) and Bank Select (CC#0, CC#32) messages.

Key Features: - Graphical UI for selecting and managing MIDI programs. - Filtering options based on bank and genre. - MIDI integration for program selection and loading. - Image display for program categories. - Program list population based on predefined program data.

Classes:

ProgramEditor(QMainWindow)

A main window class for handling MIDI program selection and management.

Signals:

program_changed (int, str, int)

Emitted when a program selection changes. Parameters: - MIDI channel (int) - Preset name (str) - Program number (int)

Dependencies: - PySide6.QtWidgets - PySide6.QtCore - MIDIHelper for MIDI message handling - PresetHandler for managing program presets - JDXiProgramList.PROGRAM_LIST for predefined program data

Classes

MidiFileDelegate	Delegate for MIDI file selection with file dialog.
PlayButtonDelegate	Delegate for Play button in table.
ProgramEditor	Program Editor Window

Module Contents

class jdxi_editor.ui.editors.io.program.MidiFileDelegate(table_widget=None, parent=None)

Bases: PySide6.QtWidgets.QStyledItemDelegate

Delegate for MIDI file selection with file dialog.

_dialog_open = False

table_widget = None

paint(painter, option, index)

Paint the cell with a button-like appearance.

editorEvent(event, model, option, index)

Handle mouse clicks to open file dialog.

sizeHint(option, index)

Return appropriate size for the button.

class jdxi_editor.ui.editors.io.program.PlayButtonDelegate(parent=None, play_callback=None)

Bases: PySide6.QtWidgets.QStyledItemDelegate

Delegate for Play button in table.

play_callback = None

paint(painter, option, index)

Draw a play button.

editorEvent(event, model, option, index)

Handle button click.

sizeHint(option, index)

Return button size.

class jdxi_editor.ui.editors.io.program.ProgramEditor(midi_helper: jdxi_editor.midi.io.helper.MidiIOHelper | None = None, parent: PySide6.QtWidgets.QWidget | None = None, preset_helper: jdxi_editor.jdxi.preset.helper.JDXiPresetHelper = None)

Bases: jdxi_editor.ui.editors.synth.simple.BasicEditor

Program Editor Window

program_changed

title_right_vlayout = None

program_list = None

file_label = None

Initialize the ProgramEditor

Parameters:

• midi_helper – Optional[MidiIOHelper]

• parent – Optional[QWidget]

• preset_helper – JDXIPresetHelper

midi_helper = None

preset_helper = None

channel

midi_requests

default_image = 'programs.png'

instrument_icon_folder = 'programs'

instrument_title_label

layout = None

midi_channel = 0

genre_label = None

program_number_combo_box = None

program_name = ''

bank_combo_box = None

load_button = None

save_button = None

image_label = None

title_label = None

bank_label = None

program_label = None

genre_combo_box = None

preset_type = None

programs

_current_playlist_row = None

_playlist_midi_editor = None

controls: Dict[picomidi.sysex.parameter.address.AddressParameter, PySide6.QtWidgets.QWidget]

setup_ui()

set up ui elements

_create_preset_selection_widget() → PySide6.QtWidgets.QWidget

create_preset_selection_widget

Returns:

QWidget

load_preset_by_program_change(preset_index: int) → None

Load a preset by program change.

Parameters:

preset_index – int

on_category_changed(_: int) → None

Handle category selection change.

_create_transport_group() → PySide6.QtWidgets.QGroupBox

_create_transport_group

Returns:

QGroupBox

Transport controls area

_create_program_selection_box() → PySide6.QtWidgets.QGroupBox

create_program_selection_box

Returns:

QGroupBox

edit_program_name()

edit_tone_name

Returns:

None

on_preset_type_changed(index: int) → None

on_preset_type_changed

Parameters:

index – int

Handle preset type selection change

set_channel_and_preset_lists(preset_type: str) → None

set_channel_and_preset_lists

Parameters:

preset_type

Returns:

None

update_category_combo_box_categories() → None

update_category_combo_box_categories

Returns:

None

Update the category combo box.

_populate_programs(search_text: str = '') → None

Populate the program list with available presets.

Parameters:

search_text – str

Returns:

None

_populate_presets(search_text: str = '') → None

Populate the program list with available presets.

Parameters:

search_text – str

Returns:

None

_init_synth_data(synth_type: jdxi_editor.jdxi.synth.type.JDXiSynth = JDXiSynth.DIGITAL_SYNTH_1, partial_number: int | None = 0) → None

Parameters:

• synth_type – JDXiSynth

• partial_number – int

Returns:

None

Initialize synth-specific data

_create_mixer_section() → PySide6.QtWidgets.QWidget

_create_mixer_section

Returns:

QWidget

Create general vocal effect controls section with scrolling

update_tone_name_for_synth(tone_name: str, synth_type: str) → None

Update the tone name.

Parameters:

• tone_name – str

• synth_type – str

set_current_program_name(program_name: str, synth_type: str = None) → None

Set the current program name in the file label

Parameters:

• program_name – str

• synth_type – str (optional), discarded for now

Returns:

None

start_playback()

Start playback of the MIDI file.

stop_playback()

Stop playback of the MIDI file.

populate_programs(search_text: str = '')

Populate the program list with available presets. Uses SQLite database to ensure all user bank programs are loaded correctly.

add_user_banks(filtered_list: list, bank: str, search_text: str = None) → None

Add user banks to the program list. Only adds generic entries for programs that don’t exist in the database. Uses SQLite database for reliable lookups. :param search_text: :param filtered_list: list of programs already loaded from database :param bank: str

_create_user_programs_tab() → PySide6.QtWidgets.QWidget

Create the User Programs tab with a sortable, searchable table.

Returns:

QWidget containing the user programs table

_get_table_style() → str

Get custom styling for tables with rounded corners and charcoal embossed cells.

Returns:

str CSS style string

_populate_user_programs_table(search_text: str = '') → None

Populate the user programs table from SQLite database.

Parameters:

search_text – Optional search text to filter programs

_save_user_programs_changes() → None

Save changes made to the user programs table (e.g., genre edits) to the database.

_create_playlist_tab() → PySide6.QtWidgets.QWidget

Create the Playlist tab with a table showing all playlists.

Returns:

QWidget containing the playlist table

_populate_playlist_table() → None

Populate the playlist table from SQLite database.

_create_new_playlist() → None

Create a new playlist.

_refresh_playlists() → None

populate programs

_delete_selected_playlist() → None

Delete the selected playlist.

_on_playlist_item_changed(item: PySide6.QtWidgets.QTableWidgetItem) → None

Handle changes to playlist name or description.

Parameters:

item – The table item that was changed

_on_playlist_selected(item: PySide6.QtWidgets.QTableWidgetItem) → None

Handle double-click on a playlist. Could open playlist editor or show playlist programs.

Parameters:

item – The table item that was double-clicked

_create_playlist_editor_tab() → PySide6.QtWidgets.QWidget

Create the Playlist Editor tab for editing playlist contents.

Returns:

QWidget containing the playlist editor

_populate_playlist_editor_combo() → None

Populate the playlist selection combo box.

_on_playlist_programs_selection_changed() → None

Handle selection change in playlist programs table.

_on_playlist_editor_playlist_changed(index: int) → None

Handle playlist selection change in the editor.

_populate_playlist_programs_table(playlist_id: int) → None

Populate the playlist programs table with programs from the selected playlist.

Parameters:

playlist_id – Playlist ID

_on_cheat_preset_changed(row: int, cheat_preset_id: str | None) → None

Handle cheat preset selection change.

Parameters:

• row – Table row index

• cheat_preset_id – Selected cheat preset ID or None

_on_playlist_program_item_changed(item: PySide6.QtWidgets.QTableWidgetItem) → None

Handle changes to playlist program items (e.g., MIDI file path).

Parameters:

item – The table item that was changed

_add_program_to_playlist() → None

Add a program to the selected playlist.

_delete_program_from_playlist() → None

Delete selected program(s) from the playlist.

_play_playlist_program(index) → None

Play the MIDI file associated with a playlist program.

Parameters:

index – QModelIndex of the play button

_on_playlist_playback_finished()

Called when MIDI playback finishes. Advances to the next playlist item.

_on_playlist_program_double_clicked(item: PySide6.QtWidgets.QTableWidgetItem) → None

Handle double-click on a playlist program item. If the Program Name column (column 2) is clicked, show the Program Editor.

Parameters:

item – The table item that was double-clicked

_load_program_from_table_for_playlist(row: int) → None

Load a program from the playlist programs table and send MIDI Program Change.

Parameters:

row – Row index in the table

_load_cheat_preset(preset_id: str) → None

Load a cheat preset (Digital Synth preset) on the Analog Synth channel (Ch3).

Parameters:

preset_id – Preset ID (e.g., “113”)

_on_user_program_selected(item: PySide6.QtWidgets.QTableWidgetItem) → None

Handle double-click on a program in the user programs table. Loads the program via MIDI Program Change.

Parameters:

item – The table item that was double-clicked

_on_user_program_selection_changed() → None

Handle selection change in the user programs table. Loads the program via MIDI Program Change when a row is selected.

_play_user_program(index) → None

Callback for Play button delegate - loads and plays the program.

Parameters:

index – QModelIndex from the delegate

_load_program_from_table(row: int) → None

Load a program from the table and send MIDI Program Change.

Parameters:

row – Row index in the table

on_bank_changed(_: int) → None

Handle bank selection change.

on_program_number_changed(index: int) → None

Handle program number selection change. :param index: int

load_program()

Load the selected program based on bank and number.

update_current_synths(program_details: jdxi_editor.jdxi.program.program.JDXiProgram) → None

Update the current synth label. :param program_details: dict :return: None

load_preset(program_number: int) → None

load_preset

Parameters:

program_number – int

Returns:

None

Load preset data and update UI

_update_program_list() → None

Update the program list with available presets.

on_genre_changed(_: int) → None

Handle genre selection change.

Parameters:

_ – int

_dispatch_sysex_to_area(json_sysex_data: str) → None

Dispatch SysEx data to the appropriate area for processing.

Parameters:

json_sysex_data

Returns:

None

_update_common_controls(partial_number: int, sysex_data: Dict, successes: list = None, failures: list = None) → None

Update the UI components for tone common and modify parameters.

Parameters:

• partial_number – int partial number

• sysex_data – Dictionary containing SysEx data

• successes – List of successful parameters

• failures – List of failed parameters

Returns:

None

_update_slider(param: picomidi.sysex.parameter.address.AddressParameter, midi_value: int, successes: list = None, failures: list = None, slider: PySide6.QtWidgets.QWidget = None) → None

Update slider based on parameter and value.

Parameters:

• param – AddressParameter

• midi_value – int value

• successes – list

• failures – list

Returns:

None