jdxi_editor.midi.data.parameter.digital.common
Module: AddressParameterDigitalCommon
This module defines the AddressParameterDigitalCommon class, which represents common parameters for Digital/SuperNATURAL synth tones. These parameters are shared across all partials and define various synthesizer settings, such as tone name, tone level, performance parameters, partial switches, and additional effects.
The class provides methods to:
Retrieve a human-readable digital name for each parameter.
Identify if a parameter is a switch (binary or enum).
Get appropriate digital text for switch values.
Validate and convert parameter values within their defined range.
Retrieve the partial number (1-3) for partial-specific parameters.
Get a parameter by its name.
Parameters include: - Tone name parameters (12 ASCII characters) - Tone level - Performance parameters (e.g., Portamento switch, Mono switch) - Partial switches (e.g., Partial 1 switch, Partial 2 switch) - Additional effect parameters (e.g., Ring Mod, Unison, Analog Feel)
- Usage example:
# Initialize a parameter object param = AddressParameterDigitalCommon(address=0x00, min_val=0, max_val=127)
# Get the digital name for the parameter print(param.display_name)
# Validate and convert a value for the parameter valid_value = param.validate_value(64)
# Get the switch text for a given value switch_text = param.get_switch_text(1)
Classes
Common parameters for Digital/SuperNATURAL synth tones. |
Module Contents
- class jdxi_editor.midi.data.parameter.digital.common.DigitalCommonParam(address: int, min_val: int, max_val: int, display_min: int | None = None, display_max: int | None = None, description: str | None = None, display_name: str | None = None, options: list | None = None, values: list | None = None)[source]
Bases:
picomidi.sysex.parameter.address.AddressParameterCommon parameters for Digital/SuperNATURAL synth tones. These parameters are shared across all partials.
- get_tooltip() str[source]
Return tooltip string for UI. Base may return options list; we always return self.tooltip.
- property display_name: str[source]
Get digital name for the parameter (from ParameterSpec or fallback).