Struct ParameterNumberMessage

pub struct ParameterNumberMessage { /* private fields */ }

A MIDI Parameter Number message, either registered (RPN) or non-registered (NRPN).

MIDI systems emit those by sending up to 4 short Control Change messages in a row. The ParameterNumberMessageScanner can be used to extract such messages from a stream of ShortMessages.

Example

use helgoboss_midi::{
    controller_numbers, Channel, ParameterNumberMessage, RawShortMessage, U14,
    DataEntryByteOrder::MsbFirst
};

let msg =
    ParameterNumberMessage::registered_14_bit(Channel::new(0), U14::new(420), U14::new(15000));
assert_eq!(msg.channel().get(), 0);
assert_eq!(msg.number().get(), 420);
assert_eq!(msg.value().get(), 15000);
assert!(msg.is_registered());
assert!(msg.is_14_bit());
let short_messages: [Option<RawShortMessage>; 4] = msg.to_short_messages(MsbFirst);
use helgoboss_midi::test_util::control_change;
assert_eq!(
    short_messages,
    [
        Some(control_change(0, 101, 3)),
        Some(control_change(0, 100, 36)),
        Some(control_change(0, 6, 117)),
        Some(control_change(0, 38, 24)),
    ]
);

Implementations

impl ParameterNumberMessage

pub fn non_registered_7_bit( channel: Channel, number: U14, value: U7, ) -> ParameterNumberMessage

Creates an NRPN message with a 7-bit data-entry value.

pub fn non_registered_14_bit( channel: Channel, number: U14, value: U14, ) -> ParameterNumberMessage

Creates an NRPN message with a 14-bit data-entry value.

pub fn non_registered_decrement( channel: Channel, number: U14, value: U7, ) -> ParameterNumberMessage

Creates an NRPN message with a data decrement value.

pub fn non_registered_increment( channel: Channel, number: U14, value: U7, ) -> ParameterNumberMessage

Creates an NRPN message with a data increment value.

pub fn registered_7_bit( channel: Channel, number: U14, value: U7, ) -> ParameterNumberMessage

Creates an RPN message with a 7-bit data-entry value.

pub fn registered_14_bit( channel: Channel, number: U14, value: U14, ) -> ParameterNumberMessage

Creates an RPN message with a 14-bit data-entry value.

pub fn registered_decrement( channel: Channel, number: U14, value: U7, ) -> ParameterNumberMessage

Creates an RPN message with a data decrement value.

pub fn registered_increment( channel: Channel, number: U14, value: U7, ) -> ParameterNumberMessage

Creates an RPN message with a data increment value.

pub fn channel(&self) -> Channel

Returns the channel of this message.

pub fn number(&self) -> U14

Returns the parameter number of this message.

pub fn value(&self) -> U14

Returns the value of this message.

If it’s just a 7-bit message, the value is <= 127.

pub fn is_14_bit(&self) -> bool

Returns true if this message has a 14-bit value and false if only a 7-bit value.

pub fn is_registered(&self) -> bool

Returns whether this message uses a registered parameter number.

pub fn data_type(&self) -> DataType

Returns the data type of the value in this message.

pub fn to_short_messages<T: ShortMessageFactory>( &self, data_entry_byte_order: DataEntryByteOrder, ) -> [Option<T>; 4]

Translates this message into up to 4 short Control Change messages, which need to be sent in a row in order to encode this (N)RPN message.

If this message has a 14-bit value, all returned short messages are Some and the given data entry byte order is respected. If it has a 7-bit value only, the last short message is None.

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<T: ShortMessageFactory> From<ParameterNumberMessage> for [Option<T>; 4]

fn from(msg: ParameterNumberMessage) -> Self

Converts to this type from the input type.

impl Hash for ParameterNumberMessage

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

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 Eq for ParameterNumberMessage

impl StructuralPartialEq for ParameterNumberMessage