jdxi_editor.ui.editors.base.editor

This module defines the AnalogSynthEditor class, which provides a PySide6-based user interface for editing analog synthesizer parameters in the Roland JD-Xi synthesizer. It extends the SynthEditor base class and integrates MIDI communication for real-time parameter adjustments and preset management.

Key Features:

• Provides a graphical editor for modifying analog synth parameters, including oscillator, filter, amp, LFO, and envelope settings.

• Supports MIDI communication to send and receive real-time parameter changes.

• Allows selection of different analog synth presets from a dropdown menu.

• Displays an instrument image that updates based on the selected preset.

• Includes a scrollable layout for managing a variety of parameter controls.

• Implements bipolar parameter handling for proper UI representation.

• Supports waveform selection with custom buttons and icons.

• Provides a “Send Read Request to Synth” button to retrieve current synth settings.

• Enables MIDI-triggered updates via incoming program changes and parameter adjustments.

Dependencies:

• PySide6 (for UI components and event handling)

• MIDIHelper (for handling MIDI communication)

• PresetHandler (for managing synth presets)

• Various custom enums and helper classes (Analog.Parameter, AnalogCommonParameter, etc.)

Usage:

The AnalogSynthEditor class can be instantiated as part of a larger PySide6 application. It requires a MIDIHelper instance for proper communication with the synthesizer.

Example:

midi_helper = MIDIHelper() preset_helper = PresetHandler() editor = AnalogSynthEditor(midi_helper, preset_helper) editor.show()

Classes

ControlBinding
BaseSynthEditor	Base Synth Editor UI.

Module Contents

class jdxi_editor.ui.editors.base.editor.ControlBinding

getter: Callable[[], object]

setter: Callable[[object, int], None]

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

Bases: jdxi_editor.ui.editors.synth.editor.SynthEditor

Base Synth Editor UI.

SUB_OSC_TYPE_MAP

SYNTH_SPEC

pitch_env_mapping

osc_waveform_map = None

instrument_image_group: PySide6.QtWidgets.QGroupBox | None = None

scroll: PySide6.QtWidgets.QScrollArea | None = None

instrument_preset_group: PySide6.QtWidgets.QGroupBox | None = None

instrument_preset: PySide6.QtWidgets.QWidget | None = None

instrument_preset_widget: PySide6.QtWidgets.QWidget | None = None

amp_section: jdxi_editor.ui.editors.analog.amp.section.AnalogAmpSection | None = None

oscillator_section: jdxi_editor.ui.editors.analog.oscillator.section.AnalogOscillatorSection | None = None

filter_section: jdxi_editor.ui.editors.analog.filter.section.AnalogFilterSection | None = None

tab_widget = None

lfo_section = None

preset_helper = None

wave_buttons

lfo_shape_buttons

updating_from_spinbox = False

previous_json_data = None

main_window = None

analog = True

group_handlers

param_handlers

adsr_mapping

pwm_mapping

refresh_shortcut

_set_value(widget, value) → None

setup_ui()

Set up the Analog Synth Editor UI.

set_style()

Set style

set_dimensions()

set dimensions

build_widgets()

Create widgets

_configure_sliders()

Configure sliders

add_tabs()

Add tabs to tab widget. Only adds a tab when the section exists.

_init_parameter_mappings()

Initialize MIDI parameter mappings.

update_filter_controls_state(mode: int)

Update filter controls enabled state (delegate to section, same mechanism as Digital).

_on_filter_mode_changed(mode: int)

Handle filter mode changes (callback from filter section when mode button clicked).

update_filter_state(value: int)

Update the filter state

Parameters:

value – int value

Returns:

None

_update_filter_mode_buttons(partial_number: int, value: int)

Update the filter mode buttons based on the FILTER_MODE_SWITCH value with visual feedback.

Uses Filter.Mode (not Filter.FilterType) so the lookup key matches the section’s button_widgets keys, which are keyed by the spec.param from generate_wave_shapes (Mode). :param value: int filter mode value (0 = BYPASS, 1 = LPF for Analog) :return: None

_on_waveform_selected(waveform: jdxi_editor.midi.data.analog.oscillator.AnalogWaveOsc)

Handle waveform button selection

Parameters:

waveform – AnalogOscWave value

Returns:

None

get_controls_as_dict()

Get the current values of self.controls as a dictionary. Override to handle waveform buttons and filter mode buttons specially.

Returns:

dict A dictionary of control parameter names and their values.

_on_lfo_shape_changed(value: int)

Handle LFO shape change

Parameters:

value – int value

Returns:

None

_handle_sliders(param: picomidi.sysex.parameter.address.AddressParameter, value: int, successes: list, failures: list)

Handle sliders

update_slider(param: picomidi.sysex.parameter.address.AddressParameter, midi_value: int, successes: list = None, failures: list = None) → None

Helper function to update sliders safely.

Parameters:

• param – AddressParameterAnalog value

• failures – list of failed parameters

• successes – list of successful parameters

• midi_value – int value

Returns:

None

update_adsr_widget(param: jdxi_editor.midi.data.parameter.analog.address.AnalogParam, midi_value: int, successes: list = None, failures: list = None) → None

Helper function to update ADSR widgets.

Parameters:

• param – AddressParameterAnalog value

• midi_value – int value

• failures – list of failed parameters

• successes – list of successful parameters

Returns:

None

update_pitch_env_widget(parameter: jdxi_editor.midi.data.parameter.analog.address.AnalogParam, value: int, successes: list = None, failures: list = None) → None

Helper function to update ADSR widgets.

Parameters:

• parameter – AddressParameterAnalog value

• value – int value

• failures – list of failed parameters

• successes – list of successful parameters

Returns:

None

update_pwm_widget(parameter: jdxi_editor.midi.data.parameter.analog.address.AnalogParam, value: int, successes: list = None, failures: list = None) → None

Helper function to update PWM widgets.

Parameters:

• parameter – AddressParameterAnalog value

• value – int value

• failures – list of failed parameters

• successes – list of successful parameters

Returns:

None

_update_controls(partial_no: int, sysex_data: dict, successes: list, failures: list) → None

Update sliders and combo boxes based on parsed SysEx data.

Parameters:

• sysex_data – dict SysEx data

• successes – list SysEx data

• failures – list SysEx data

Returns:

None

_build_param_handlers()

Build param handlers

_process_param_update(param_value, param_name, failures: list, successes: list)

Process updates for a single parameter.

Parameters:

• param_name – The name of the parameter

• param_value – The value of the parameter

• successes – The list of successes to append to

• failures – The list of failures to append to

_update_suboscillator(param_value)

Update the sub oscillator type switch control.

_log_and_store_sysex_data(sysex_data: dict) → None

Compare new and old SysEx data, log differences, and store the current data.

_get_adsr_params() → list

Retrieve the list of ADSR-related parameters.

Returns:

A list of ADSR parameters

_update_waveform_buttons(value: int)

Update the waveform buttons based on the OSC_WAVE value with visual feedback.

Parameters:

value – int value

Returns:

None

_update_lfo_shape_buttons(value: int)

Update the LFO shape buttons with visual feedback.

Parameters:

value – int value

Returns:

None

_update_pw_controls_state(waveform: jdxi_editor.midi.data.analog.oscillator.AnalogWaveOsc)

Enable/disable PW controls based on waveform

Parameters:

waveform – AnalogOscWave value

Returns:

None

_handle_adsr(param: picomidi.sysex.parameter.address.AddressParameter, param_value: int, successes: list, failures: list) → bool

Dispatch ADSR parameter updates to the ADSR widget.

_handle_pitch_env(param, param_value, successes: list, failures: list) → bool

Dispatch pitch envelope parameter updates to the pitch env widget.

_handle_waveform(param, param_value, successes, failures)

Handle waveform; signature matches param_handlers (param, param_value, successes, failures).

_handle_lfo_shape(param, param_value, successes, failures)

Handler for LFO shape; signature matches param_handlers (param, param_value, successes, failures).

_handle_filter_mode_switch(param: picomidi.sysex.parameter.address.AddressParameter, param_value: int, successes: list, failures: list)

handle filter mode switch

_handle_lfo_tempo_sync_switch(param_name: Literal['LFO_TEMPO_SYNC_SWITCH'], param_value, successes: list, failures: list)

Handle LFO Tempo Sync Switch

_handle_suboscillator(param_name: str, param_value, successes: list, failures: list)

Handle SubOscillator

_handle_lfo_tempo_sync_note(param_name: Literal['LFO_TEMPO_SYNC_NOTE'], param_value, successes: list, failures: list)

Handle LFO Tempo Sync Note

_handle_sub_osc_type(param, value, *_)

_handle_direct_control(param, value, successes, failures)

_handle_filter_mode(param, value, successes, failures)