jdxi_editor.midi.conversion.note

MIDI Note Conversion Utilities

Provides utilities for converting between MIDI note numbers, note names (e.g., ‘C4’), and combo box indices for different instrument types.

Attributes

_JDXI_DRUM_NAMES
converter

Classes

MidiNoteConverter

Convert between MIDI note numbers, note names, and combo box indices.

Functions

_jdxi_drum_index(→ Optional[int])

Return drum index for JD-Xi drum name, or None if not found.

Module Contents

jdxi_editor.midi.conversion.note._JDXI_DRUM_NAMES = ['BD1', 'RIM', 'BD2', 'CLAP', 'BD3', 'SD1', 'CHH', 'SD2', 'PHH', 'SD3', 'OHH', 'SD4', 'TOM1',...

jdxi_editor.midi.conversion.note._jdxi_drum_index(note_name: str) → int | None

Return drum index for JD-Xi drum name, or None if not found.

class jdxi_editor.midi.conversion.note.MidiNoteConverter(drum_options: List[str] | None = None)

Convert between MIDI note numbers, note names, and combo box indices.

NOTE_TO_SEMITONE: Dict[str, int]

SEMITONE_TO_NOTE: List[str] = ['C', 'C#', 'D', 'D#', 'E', 'F', 'F#', 'G', 'G#', 'A', 'A#', 'B']

NOTE_RANGES: Dict[int, range]

drum_options = []

note_name_to_midi(note_name: str) → int

Convert note name (e.g., ‘C4’) or drum name (e.g., ‘CLAP’) to MIDI note number.

Examples

‘C4’ -> 60 (Middle C) ‘A4’ -> 69 ‘C#4’ -> 61 ‘CLAP’ -> 39 (if CLAP is at index 3 in drum_options; drums map to 36-59)

Parameters:

note_name – Note name in format “NOTE[OCTAVE]” or drum name from drum_options

Returns:

MIDI note number (0-127)

Raises:

ValueError – If note name is invalid

midi_to_note_name(midi_note: int, drums: bool = False) → str

Convert MIDI note number to note name or drum name.

Examples

60 -> ‘C4’ (without drums=True) 69 -> ‘A4’ 36 -> ‘Kick’ (with drums=True, if drum_options set)

Parameters:

• midi_note – MIDI note number (0-127)

• drums – If True, return drum name from drum_options (if available)

Returns:

Note name (e.g., ‘C4’) or drum name (e.g., ‘Kick’) or fallback string

_midi_to_drum_name(midi_note: int) → str

Convert MIDI note number to drum kit name.

Drum notes are typically in range 36-60 (C2-C3). Maps to indices 0-24 in the drum_options list.

Parameters:

midi_note – MIDI note number

Returns:

Drum name or fallback string

midi_note_to_combo_index(row: int, midi_note: int, row_options: List[str] | None = None) → int | None

Convert a MIDI note number to the corresponding combo box index for a specific row.

This is useful for determining which item in a combo box corresponds to a MIDI note.

Examples

Row 0 (Digital Synth 1), MIDI note 60 (C4) -> index 0 (first item in options) Row 3 (Drums), MIDI note 36 (C2) -> index 0 (first drum in options)

Parameters:

• row – Sequencer row index (0-3)

• midi_note – MIDI note number to convert

• row_options – List of note/drum options for the row (e.g., [‘C4’, ‘C#4’, …])

Returns:

Index in row_options, or None if not found or invalid

get_note_range_for_row(row: int) → range

Get the valid MIDI note range for a specific sequencer row.

Parameters:

row – Sequencer row index (0-3)

Returns:

Range object with valid MIDI notes for this row

is_note_in_row_range(row: int, midi_note: int) → bool

Check if a MIDI note is in the valid range for a specific row.

Parameters:

• row – Sequencer row index (0-3)

• midi_note – MIDI note number to check

Returns:

True if note is in valid range for this row

get_all_notes_for_row(row: int) → List[str]

Get all valid note names for a specific row.

Useful for populating combo boxes.

Parameters:

row – Sequencer row index (0-3)

Returns:

List of note names (e.g., [‘C4’, ‘C#4’, ‘D4’, …])

update_drum_options(drum_options: List[str]) → None

Update the drum kit options.

Call this when the drum kit selection changes.

Parameters:

drum_options – List of drum kit note names

jdxi_editor.midi.conversion.note.converter