Struct MpeEngine 

pub struct MpeEngine { /* private fields */ }

MPE engine for managing per-note expression.

Implementations

impl MpeEngine

pub fn new() -> Self

Creates a new MPE engine with default configuration.

pub fn with_config(config: MpeConfig) -> Self

Creates a new MPE engine with custom configuration.

pub fn config(&self) -> &MpeConfig

Gets the current MPE configuration.

pub fn set_config(&mut self, config: MpeConfig)

Sets the MPE configuration.

pub fn note_on(&mut self, note: u8, velocity: u8) -> NoteExpression

Handles a note-on event.

Assigns the note to an available channel and creates a NoteExpression.

Arguments

• note - MIDI note number (0-127)
• velocity - Note velocity (0-127)

Returns

The NoteExpression for this note.

pub fn note_off(&mut self, note: u8) -> Option<NoteExpression>

Handles a note-off event.

Arguments

• note - MIDI note number (0-127)

Returns

The NoteExpression that was removed, or None if note wasn’t active.

pub fn pitch_bend(&mut self, channel: u8, value: u16)

Handles a pitch bend event for a specific channel.

Arguments

• channel - MIDI channel (1-16)
• value - Pitch bend value (0-16383, 8192 = center)

pub fn channel_pressure(&mut self, channel: u8, value: u8)

Handles a channel pressure (aftertouch) event.

Arguments

• channel - MIDI channel (1-16)
• value - Pressure value (0-127)

pub fn timbre(&mut self, channel: u8, value: u8)

Handles a CC74 (timbre/brightness) event.

Arguments

• channel - MIDI channel (1-16)
• value - CC74 value (0-127)

pub fn get_note_expression(&self, note: u8) -> Option<&NoteExpression>

Gets the expression data for a specific note.

Arguments

• note - MIDI note number (0-127)

Returns

The NoteExpression for this note, or None if not active.

pub fn active_notes(&self) -> impl Iterator<Item = &NoteExpression>

Gets all active note expressions.

pub fn active_note_count(&self) -> usize

Gets the number of active notes.

pub fn clear_all_notes(&mut self)

Clears all active notes (panic button / all notes off).

Trait Implementations

impl Default for MpeEngine

fn default() -> Self

Returns the “default value” for a type.