Enum PerformanceIntent 

pub enum PerformanceIntent {
    NoteOn {
        pitch: Pitch,
        velocity: u8,
        channel: Channel,
    },
    NoteOff {
        pitch: Pitch,
        velocity: u8,
        channel: Channel,
    },
    Aftertouch {
        pitch: Pitch,
        pressure: u8,
        channel: Channel,
    },
    PitchBend {
        value: u16,
        channel: Channel,
    },
    Sustain {
        down: bool,
        channel: Channel,
    },
    Sostenuto {
        down: bool,
        channel: Channel,
    },
    AllNotesOff {
        channel: Channel,
    },
    AllSoundOff {
        channel: Channel,
    },
    ResetControllers {
        channel: Channel,
    },
    Parameter {
        target: Symbol,
        value: i64,
    },
    Panic,
}

A single live-performance gesture.

Enumerates the MIDI-style intents a PerformanceSource can emit: note triggers, expression controls, the sustain pedal, parameter changes, and an all-notes-off panic.

Variants

NoteOn

Starts a note at the given pitch and velocity on a channel.

Fields

pitch: Pitch

Pitch of the note.

velocity: u8

Attack velocity (0..=127).

channel: Channel

Channel the note plays on.

NoteOff

Releases a previously started note.

Fields

pitch: Pitch

Pitch of the note being released.

velocity: u8

Release velocity (0..=127).

channel: Channel

Channel the note plays on.

Aftertouch

Applies polyphonic key pressure to a sounding note.

Fields

pitch: Pitch

Pitch the pressure applies to.

pressure: u8

Pressure amount (0..=127).

channel: Channel

Channel the note plays on.

PitchBend

Bends pitch on a channel by a 14-bit amount.

Fields

value: u16

Raw 14-bit bend value (0..=16383).

channel: Channel

Channel the bend applies to.

Sustain

Sets the sustain pedal state on a channel.

Fields

down: bool

Whether the pedal is depressed.

channel: Channel

Channel the pedal applies to.

Sostenuto

Sets the sostenuto pedal state on a channel.

Fields

down: bool

Whether the pedal is depressed.

channel: Channel

Channel the pedal applies to.

AllNotesOff

Releases every key-down note on one channel, subject to hold pedals.

Fields

channel: Channel

Channel whose notes are released.

AllSoundOff

Silences every sounding note on one channel immediately.

Fields

channel: Channel

Channel whose sound is stopped.

ResetControllers

Resets channel controllers and releases notes held only by pedals.

Fields

channel: Channel

Channel whose controller state is reset.

Parameter

Sets a named parameter to an integer value.

Fields

target: Symbol

Symbol naming the parameter target.

value: i64

New parameter value.

Panic

Requests an all-notes-off panic and pedal reset.

Implementations

impl PerformanceIntent

pub fn kind_symbol(&self) -> Symbol

Returns the qualified symbol identifying this intent’s kind.

pub fn kind_label(&self) -> &'static str

Returns the short kebab-case label for this intent’s kind.

pub fn to_expr(&self) -> Expr

Encodes this intent as an Expr map keyed by kind and its fields.

pub fn from_expr(expr: &Expr) -> Result<Self>

Decodes an intent from an Expr map produced by to_expr.

Accepts both bare and music/performance-intent-qualified kind labels, and returns an error for non-map exprs or unknown kinds.

Trait Implementations

impl Clone for PerformanceIntent

fn clone(&self) -> PerformanceIntent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PerformanceIntent

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

Formats the value using the given formatter.

impl Eq for PerformanceIntent

impl PartialEq for PerformanceIntent

fn eq(&self, other: &PerformanceIntent) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PerformanceIntent