jdxi_editor.midi.utils.conversions

MIDI CC Conversion Utilities

This module provides utility functions for converting between MIDI values and various numerical representations such as milliseconds and fractional values.

These functions are useful for mapping MIDI messages to meaningful time or intensity values in a synthesizer or effect unit. from picomidi.constant import MidiConstant

Functions

`midi_value_to_ms`(→ float)	Converts a MIDI value (0–127) to a time value in milliseconds.
`ms_to_midi_value`(→ int)	Converts address time value in milliseconds to address MIDI byte range value (0-127)
`fraction_to_midi_value`(→ int)	Converts address fractional value (0.0-1.0) to address MIDI CC value (0-127).
`midi_value_to_fraction`(→ float)	Converts address MIDI value (0-127) to address fractional value (0.0-1.0).

Module Contents

jdxi_editor.midi.utils.conversions.midi_value_to_ms(midi_value: int, min_time: int = 10, max_time: int = 1000) → float[source]

Converts a MIDI value (0–127) to a time value in milliseconds.

Parameters:

midi_value – int MIDI CC value (0–127).
min_time – int, optional: Minimum time in milliseconds. Default is 10 ms.
max_time – int, optional: Maximum time in milliseconds. Default is 1000 ms.

Returns:

int Corresponding time value in milliseconds.

jdxi_editor.midi.utils.conversions.ms_to_midi_value(ms_time: float, min_time: int = 10, max_time: int = 1000) → int[source]

Converts address time value in milliseconds to address MIDI byte range value (0-127)

Parameters:

ms_time – float: Time value in milliseconds.
min_time – int, optional: Minimum time in milliseconds. Default is 10 ms.
max_time – int, optional: Maximum time in milliseconds. Default is 1000 ms.

Returns:

int Corresponding MIDI value (1-127)

jdxi_editor.midi.utils.conversions.fraction_to_midi_value(fractional_value: float, minimum: float = 0.0, maximum: float = 1.0) → int[source]

Converts address fractional value (0.0-1.0) to address MIDI CC value (0-127).

Parameters:

fractional_value – float Fractional value between min and max.
minimum – float optional Minimum possible fractional value. Default is 0.
maximum – float optional Maximum possible fractional value. Default is 1.

Returns:

int: Corresponding MIDI value.

jdxi_editor.midi.utils.conversions.midi_value_to_fraction(midi_value: int, minimum: float = 0.0, maximum: float = 1.0) → float[source]

Converts address MIDI value (0-127) to address fractional value (0.0-1.0).

Parameters:

midi_value – int: MIDI CC value (0-127).
minimum – float, optional Minimum possible fractional value. Default is 0.
maximum – float, optional Maximum possible fractional value. Default is 1.

Returns:

float Corresponding fractional value.