Struct ParameterNumberMessageScanner

pub struct ParameterNumberMessageScanner { /* private fields */ }

Scanner for detecting (N)RPN messages in a stream of short messages without polling.

Supports the following message sequences (x and y represent the bytes that make up the parameter number, MSB represents either a data entry MSB or an increment/decrement value):

• [x, y, MSB]: Interpreted as 7-bit data entry or increment/decrement message.
• [x, y, LSB, MSB]: Interpreted as 14-bit data entry message.
• [x, y, MSB, MSB, ...]: Interpreted as 7-bit data entry or increment/decrement messages.
• [x, y, LSB, MSB, LSB, MSB, ...]: Interpreted as 14-bit data entry messages.

Example

use helgoboss_midi::test_util::{control_change, channel, u14};
use helgoboss_midi::{ParameterNumberMessage, ParameterNumberMessageScanner};

let mut scanner = ParameterNumberMessageScanner::new();
let result_1 = scanner.feed(&control_change(0, 101, 3));
let result_2 = scanner.feed(&control_change(0, 100, 36));
let result_3 = scanner.feed(&control_change(0, 38, 24));
let result_4 = scanner.feed(&control_change(0, 6, 117));
assert_eq!(result_1, None);
assert_eq!(result_2, None);
assert_eq!(result_3, None);
assert_eq!(
    result_4,
    Some(ParameterNumberMessage::registered_14_bit(
        channel(0),
        u14(420),
        u14(15000)
    ))
);

Implementations

impl ParameterNumberMessageScanner

pub fn new() -> ParameterNumberMessageScanner

Creates a new scanner.

pub fn feed( &mut self, msg: &impl ShortMessage, ) -> Option<ParameterNumberMessage>

Feeds the scanner a single short message.

Returns the (N)RPN message if one has been detected.

pub fn reset(&mut self)

Resets the scanner discarding all intermediate scanning progress.

Trait Implementations

impl Clone for ParameterNumberMessageScanner

fn clone(&self) -> ParameterNumberMessageScanner

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParameterNumberMessageScanner

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

Formats the value using the given formatter.

impl Default for ParameterNumberMessageScanner

fn default() -> ParameterNumberMessageScanner

Returns the “default value” for a type.

impl PartialEq for ParameterNumberMessageScanner

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

impl Eq for ParameterNumberMessageScanner

impl StructuralPartialEq for ParameterNumberMessageScanner