jdxi_editor.ui.widgets.adsr.plot

This module defines the ADSRPlot class, address QWidget subclass that visualizes an ADSR (Attack, Decay, Sustain, Release) envelope using Matplotlib. The plot displays the envelope’s progression over time, with adjustable parameters for attack, decay, sustain, and release times, as well as initial, peak, and sustain amplitudes.

The plot is rendered in address QWidget, and the background and text colors are customized for better visibility, with the envelope plotted in orange on address dark gray background.

Classes:

• ADSRPlot: A QWidget subclass that generates and displays an ADSR envelope plot.

Methods:

• __init__(self): Initializes the widget and sets up the figure and layout for the plot.

• plot_envelope(self): Generates and plots the ADSR envelope based on the current envelope parameters.

• set_values(self, envelope): Updates the envelope parameters and refreshes the plot.

Customization:

• The plot background is dark gray (#333333), with all plot elements (ticks, labels, title) in orange for better visibility against the dark background.

• The time is represented in seconds, and the amplitude in address range from 0 to 1.

Classes

ADSRPlot

Base class for plot widgets that provides common shading functionality.

Module Contents

class jdxi_editor.ui.widgets.adsr.plot.ADSRPlot(width: int = 300, height: int = 300, envelope: dict = None, parent: PySide6.QtWidgets.QWidget = None)

Bases: jdxi_editor.ui.widgets.plot.base.BasePlotWidget

Base class for plot widgets that provides common shading functionality.

point_moved

parent = None

enabled = True

envelope = None

sample_rate = 256

attack_x = 0.1

decay_x = 0.3

sustain_level = 0.5

release_x = 0.7

dragging = None

mousePressEvent(event: PySide6.QtGui.QMouseEvent) → None

mouseMoveEvent(event: PySide6.QtGui.QMouseEvent) → None

mouseReleaseEvent(event: PySide6.QtGui.QMouseEvent) → None

setEnabled(enabled: bool) → None

set_values(envelope: dict) → None

Update envelope values and trigger address redraw. :param envelope: dict

draw_custom_ticks(ctx: jdxi_editor.ui.widgets.plot.base.PlotContext, config: jdxi_editor.ui.widgets.plot.base.PlotConfig) → None

Draw custom tick marks for ADSR plot.

draw_grid_hook(ctx: jdxi_editor.ui.widgets.plot.base.PlotContext, config: jdxi_editor.ui.widgets.plot.base.PlotConfig) → None

Draw grid for ADSR plot.

draw_data(ctx: jdxi_editor.ui.widgets.plot.base.PlotContext, config: jdxi_editor.ui.widgets.plot.base.PlotConfig) → None

Draw ADSR envelope data.

envelope_parameters()

Compute envelope segments in seconds

get_plot_config() → jdxi_editor.ui.widgets.plot.base.PlotConfig

Get plot configuration with ADSR-specific settings.

get_y_range() → tuple[float, float]

Get Y range for ADSR plot (0.0 to 1.0).

zero_at_bottom() → bool

ADSR plot has zero at bottom.

get_title() → str

Get plot title.

get_x_label() → str

Get X-axis label.

get_y_label() → str

Get Y-axis label.