Enum ControlEvent 

pub enum ControlEvent {
    Button {
        id: u32,
        pressed: bool,
    },
    Knob {
        id: u32,
        value: f32,
        normalized: f32,
    },
    Fader {
        id: u32,
        value: f32,
        normalized: f32,
    },
    MidiControl {
        channel: u8,
        controller: u8,
        value: u8,
        normalized: f32,
    },
    MidiNote {
        channel: u8,
        note: u8,
        velocity: u8,
        on: bool,
    },
    Osc {
        address: String,
        args: Vec<f32>,
    },
    MidiClock,
    MidiTransport {
        kind: MidiTransportKind,
    },
}

Hardware control event from a physical interface (knob, button, fader, etc.).

Produced by sensors (MIDI, OSC, CV/Gate) and dispatched to servos for mapping to graph parameters.

Variants

Button

A physical button press or release.

Fields

id: u32

Hardware control identifier.

pressed: bool

true if the button is currently held down.

Knob

A physical knob (rotary encoder or potentiometer) event.

Fields

id: u32

Hardware control identifier.

value: f32

Raw value in hardware-native units.

normalized: f32

Value mapped to the [0.0, 1.0] range.

Fader

A physical fader (linear slider) event.

Fields

id: u32

Hardware control identifier.

value: f32

Raw value in hardware-native units.

normalized: f32

Value mapped to the [0.0, 1.0] range.

MidiControl

A MIDI control change message.

Fields

channel: u8

MIDI channel (0-indexed).

controller: u8

MIDI controller number.

value: u8

Raw 7-bit MIDI value.

normalized: f32

Value normalized to [0.0, 1.0].

MidiNote

A MIDI note-on or note-off message.

Fields

channel: u8

MIDI channel (0-indexed).

note: u8

MIDI note number.

velocity: u8

MIDI velocity value (0-127).

on: bool

true for note-on, false for note-off.

Osc

An OSC message event.

Fields

address: String

OSC address path.

args: Vec<f32>

OSC argument list as float values.

MidiClock

A MIDI clock tick event.

MidiTransport

A MIDI transport state change.

Fields

kind: MidiTransportKind

The type of transport event (start, stop, or continue).

Implementations

impl ControlEvent

pub fn normalized_value(&self) -> Option<f32>

Returns the normalized value (0.0–1.0) of this event, if it carries one.

pub fn id(&self) -> Option<u32>

Returns the hardware control ID attached to this event, if any.

Trait Implementations

impl Clone for ControlEvent

fn clone(&self) -> ControlEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ControlEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ControlEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ControlEvent

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ControlEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ControlEvent