Struct helgoboss_midi::ParameterNumberMessage

pub struct ParameterNumberMessage { /* fields omitted */ }

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,
};

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();
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, 38, 24)),
        Some(control_change(0, 6, 117)),
    ]
);

Implementations

impl ParameterNumberMessage

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

Creates an NRPN message with a 7-bit value.

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

Creates an NRPN message with a 14-bit value.

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

Creates an RPN message with a 7-bit value.

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

Creates an RPN message with a 14-bit 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 to_short_messages<T: ShortMessageFactory>(&self) -> [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 messages are Some. If it has a 7-bit value only, the last one is None.

Trait Implementations

impl Clone for ParameterNumberMessage

pub fn clone(&self) -> ParameterNumberMessage

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for ParameterNumberMessage

impl Debug for ParameterNumberMessage

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

Formats the value using the given formatter.

impl Eq for ParameterNumberMessage

impl<T: ShortMessageFactory> From<ParameterNumberMessage> for [Option<T>; 4]

pub fn from(msg: ParameterNumberMessage) -> Self

Performs the conversion.

impl Hash for ParameterNumberMessage

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl PartialEq<ParameterNumberMessage> for ParameterNumberMessage

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for ParameterNumberMessage

impl StructuralPartialEq for ParameterNumberMessage