Struct VoiceState

pub struct VoiceState {
    pub active_note: Option<u8>,
    pub velocity: f32,
    pub gate: bool,
    pub frequency: f32,
    /* private fields */
}

Monophonic voice state for MIDI-controlled synthesis.

Tracks the currently active note, velocity, gate state, and frequency. Supports legato playing with last-note priority: when multiple notes are held, releasing a note will return to the previous held note without retriggering the envelope.

Fields

active_note: Option<u8>

The currently active MIDI note number, if any.

velocity: f32

Velocity of the active note (0.0 to 1.0).

gate: bool

Gate state: true while a note is held.

frequency: f32

Frequency in Hz for the current note.

Implementations

impl VoiceState

pub fn new() -> VoiceState

Create a new voice state.

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

Process a note-on event.

Updates the active note, velocity, gate state, and frequency. The note is also pushed onto the note stack for legato handling. If the note stack is full (16 notes), the note is silently dropped from the stack but still becomes the active note.

pub fn note_off(&mut self, note: u8) -> bool

Process a note-off event.

Returns true if the voice should enter release stage (no more notes held), or false if switching to a previous legato note.

pub fn reset(&mut self)

Reset the voice state.

Clears all state and the note stack.

pub fn is_active(&self) -> bool

Returns true if a note is currently active.

pub fn held_note_count(&self) -> usize

Returns the number of notes currently held.

Trait Implementations

impl Clone for VoiceState

fn clone(&self) -> VoiceState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VoiceState

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for VoiceState

fn default() -> VoiceState

Returns the “default value” for a type.