Source code for jdxi_editor.midi.wave.form

"""
MIDI Waveform Types
==================

This module defines the `Waveform` enum, which represents the different waveform types available on the JD-Xi.

Constants:
    - OSC_WAVE_SAW: Sawtooth waveform
    - OSC_WAVE_SQUARE: Square waveform
    - OSC_WAVE_TRIANGLE: Triangle waveform
    - OSC_WAVE_SINE: Sine waveform
    - OSC_WAVE_NOISE: Noise waveform
    - OSC_WAVE_SUPER_SAW: Super saw waveform
    - OSC_WAVE_PCM: PCM waveform

Usage Example:
    >>> waveform = Waveform.SAW
    >>> waveform.midi_value
    0x00
    >>> Waveform.from_midi_value(0x00)
    Waveform.SAW

"""

from enum import Enum, auto


[docs]
OSC_WAVE_SAW = 0x00  # Sawtooth


[docs]
OSC_WAVE_SQUARE = 0x01  # Square


[docs]
OSC_WAVE_TRIANGLE = 0x02  # Triangle


[docs]
OSC_WAVE_SINE = 0x03  # Sine


[docs]
OSC_WAVE_NOISE = 0x04  # Noise


[docs]
OSC_WAVE_SUPER_SAW = 0x05  # Super saw


[docs]
OSC_WAVE_PCM = 0x06  # PCM waveform




[docs]
class Waveform(Enum):
    """Waveform types available on the JD-Xi"""


[docs]
    SAW = 1  # Sawtooth wave


[docs]
    SQUARE = 2  # Square wave


[docs]
    TRIANGLE = 3  # Triangle wave


[docs]
    SINE = 4  # Sine wave


[docs]
    NOISE = 5  # Noise


[docs]
    SUPER_SAW = 6  # Super saw


[docs]
    PCM = 7  # PCM waveform


    @property

[docs]
    def display_name(self) -> str:
        """Get display name for waveform"""
        return self.name.replace("_", " ").title()


    @property

[docs]
    def midi_value(self) -> int:
        """Get MIDI value for waveform"""
        return {
            Waveform.SAW: OSC_WAVE_SAW,
            Waveform.SQUARE: OSC_WAVE_SQUARE,
            Waveform.TRIANGLE: OSC_WAVE_TRIANGLE,
            Waveform.SINE: OSC_WAVE_SINE,
            Waveform.NOISE: OSC_WAVE_NOISE,
            Waveform.SUPER_SAW: OSC_WAVE_SUPER_SAW,
            Waveform.PCM: OSC_WAVE_PCM,
        }[self]


    @classmethod

[docs]
    def from_midi_value(cls, value: int) -> "Waveform":
        """Create Waveform from MIDI value"""
        for waveform in cls:
            if waveform.midi_value == value:
                return waveform
        raise ValueError(f"Invalid waveform value: {value}")