Struct ParameterNumberMessage 

pub struct ParameterNumberMessage {
    pub channel: MidiChannel,
    pub kind: ParameterNumberKind,
    pub parameter: u16,
    pub value: f32,
    pub is_increment: bool,
    pub is_decrement: bool,
}

A complete RPN or NRPN message with its 14-bit value.

This represents a fully-decoded RPN/NRPN sequence after the RpnTracker has assembled all the CC messages.

Example

use beamer_core::{RpnTracker, ControlChange, cc, rpn};

let mut tracker = RpnTracker::new();

// Simulate receiving CC sequence for Pitch Bend Sensitivity = 12 semitones
tracker.process_cc(&ControlChange { channel: 0, controller: cc::RPN_MSB, value: 0.0 });
tracker.process_cc(&ControlChange { channel: 0, controller: cc::RPN_LSB, value: 0.0 });
let msg = tracker.process_cc(&ControlChange { channel: 0, controller: cc::DATA_ENTRY_MSB, value: 12.0/127.0 });

if let Some(msg) = msg {
    assert!(msg.is_pitch_bend_sensitivity());
    let (semitones, cents) = msg.pitch_bend_sensitivity();
    assert_eq!(semitones, 12);
}

Fields

channel: MidiChannel

MIDI channel (0-15).

kind: ParameterNumberKind

RPN or NRPN.

parameter: u16

14-bit parameter number (MSB << 7 | LSB).

value: f32

14-bit data value, normalized to 0.0-1.0.

is_increment: bool

Whether this was a data increment (+1 to current value).

is_decrement: bool

Whether this was a data decrement (-1 from current value).

Implementations

impl ParameterNumberMessage

pub const fn rpn(channel: MidiChannel, parameter: u16, value: f32) -> Self

Create a new RPN message.

pub const fn nrpn(channel: MidiChannel, parameter: u16, value: f32) -> Self

Create a new NRPN message.

pub const fn is_rpn(&self) -> bool

Check if this is an RPN.

pub const fn is_nrpn(&self) -> bool

Check if this is an NRPN.

pub fn is_pitch_bend_sensitivity(&self) -> bool

Check if this is the Pitch Bend Sensitivity RPN.

pub fn is_null(&self) -> bool

Check if this is the RPN Null message.

pub fn raw_value(&self) -> u16

Get the raw 14-bit value (0-16383).

pub fn pitch_bend_sensitivity(&self) -> (u8, u8)

For Pitch Bend Sensitivity: get semitones and cents.

Returns (semitones, cents) where MSB = semitones (0-127) and LSB = cents (0-127).

Trait Implementations

impl Clone for ParameterNumberMessage

fn clone(&self) -> ParameterNumberMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParameterNumberMessage

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

Formats the value using the given formatter.

impl PartialEq for ParameterNumberMessage

fn eq(&self, other: &ParameterNumberMessage) -> 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 Copy for ParameterNumberMessage

impl StructuralPartialEq for ParameterNumberMessage