InputChannel

The InputChannel class represents a single MIDI input channel (1-16) from a single input device. This object is derived from the host's MIDI subsystem and should not be instantiated directly.

All 16 InputChannel objects can be found inside the input's channels property.

Since: 3.0.0

Extends: EventEmitter

Fires: allnotesoff, allsoundoff, channelaftertouch, controlchange, controlchange-controllerxxx, keyaftertouch, localcontrol, midimessage, monomode, noteoff, noteon, nrpn, nrpn-databuttondecrement, nrpn-databuttonincrement, nrpn-dataentrycoarse, nrpn-dataentryfine, omnimode, pitchbend, programchange, resetallcontrollers, rpn, rpn-databuttondecrement, rpn-databuttonincrement, rpn-dataentrycoarse, rpn-dataentryfine, unknownmessage

Constructor

Creates an InputChannel object.

Parameters

new InputChannel(input, number)

Parameter	Type	Default	Description
input	Input		The Input object this channel belongs to.
number	number		The channel's MIDI number (1-16).

---

Properties

.eventCount

Type: number
Attributes: read-only

The number of unique events that have registered listeners.

Note: this excludes global events registered with EventEmitter.ANY_EVENT because they are not tied to a specific event.

.eventMap

Type: Object
Attributes: read-only

An object containing a property for each event with at least one registered listener. Each event property contains an array of all the Listener objects registered for the event.

.eventNames

Type: Array.<string>
Attributes: read-only

An array of all the unique event names for which the emitter has at least one registered listener.

Note: this excludes global events registered with EventEmitter.ANY_EVENT because they are not tied to a specific event.

.eventsSuspended

Type: boolean

Whether or not the execution of callbacks is currently suspended for this emitter.

.input

Since: 3.0
Type: Input

The Input this channel belongs to.

.notesState

Type: Array.<boolean>

Contains the current playing state of all MIDI notes of this channel (0-127). The state is true for a currently playing note and false otherwise.

.number

Since: 3.0
Type: number

This channel's MIDI number (1-16).

.octaveOffset

Since: 3.0
Type: number

An integer to offset the reported octave of incoming note-specific messages (noteon, noteoff and keyaftertouch). By default, middle C (MIDI note number 60) is placed on the 4th octave (C4).

If, for example, octaveOffset is set to 2, MIDI note number 60 will be reported as C6. If octaveOffset is set to -1, MIDI note number 60 will be reported as C3.

Note that this value is combined with the global offset value defined by WebMidi.octaveOffset object and with the value defined on the parent input object with Input.octaveOffset.

.parameterNumberEventsEnabled

Type: boolean

Indicates whether events for Registered Parameter Number and Non-Registered Parameter Number should be dispatched. RPNs and NRPNs are composed of a sequence of specific control change messages. When a valid sequence of such control change messages is received, an rpn or nrpn event will fire.

If an invalid or out-of-order control change message is received, it will fall through the collector logic and all buffered control change messages will be discarded as incomplete.

---

Methods

.addListener(...)

Adds a listener for the specified event. It returns the Listener object that was created and attached to the event.

To attach a global listener that will be triggered for any events, use EventEmitter.ANY_EVENT as the first parameter. Note that a global listener will also be triggered by non-registered events.

Parameters

Signature: addListener(event, callback, [options])

Parameter	Type(s)	Default	Description
event	string Symbol		The event to listen to.
callback	EventEmitter~callback		The callback function to execute when the event occurs.
[options]	Object	{}
[options.context]	Object	this	The value of this in the callback function.
[options.prepend]	boolean	false	Whether the listener should be added at the beginning of the listeners array and thus executed first.
[options.duration]	number	Infinity	The number of milliseconds before the listener automatically expires.
[options.remaining]	number	Infinity	The number of times after which the callback should automatically be removed.
[options.arguments]	array		An array of arguments which will be passed separately to the callback function. This array is stored in the arguments property of the Listener object and can be retrieved or modified as desired.

Return Value

Returns: Listener

The newly created Listener object.

Throws:

• TypeError : The event parameter must be a string or EventEmitter.ANY_EVENT.
• TypeError : The callback parameter must be a function.

.addOneTimeListener(...)

Adds a one-time listener for the specified event. The listener will be executed once and then destroyed. It returns the Listener object that was created and attached to the event.

To attach a global listener that will be triggered for any events, use EventEmitter.ANY_EVENT as the first parameter. Note that a global listener will also be triggered by non-registered events.

Parameters

Signature: addOneTimeListener(event, callback, [options])

Parameter	Type(s)	Default	Description
event	string Symbol		The event to listen to
callback	EventEmitter~callback		The callback function to execute when the event occurs
[options]	Object	{}
[options.context]	Object	this	The context to invoke the callback function in.
[options.prepend]	boolean	false	Whether the listener should be added at the beginning of the listeners array and thus executed first.
[options.duration]	number	Infinity	The number of milliseconds before the listener automatically expires.
[options.arguments]	array		An array of arguments which will be passed separately to the callback function. This array is stored in the arguments property of the Listener object and can be retrieved or modified as desired.

Return Value

Returns: Listener

The newly created Listener object.

Throws:

• TypeError : The event parameter must be a string or EventEmitter.ANY_EVENT.
• TypeError : The callback parameter must be a function.

.destroy()

Destroys the InputChannel by removing all listeners and severing the link with the MIDI subsystem's input.

.emit(...)

Executes the callback function of all the Listener objects registered for a given event. The callback functions are passed the additional arguments passed to emit() (if any) followed by the arguments present in the arguments property of the Listener object (if any).

If the eventsSuspended property is true or the Listener.suspended property is true, the callback functions will not be executed.

This function returns an array containing the return values of each of the callbacks.

It should be noted that the regular listeners are triggered first followed by the global listeners (those added with EventEmitter.ANY_EVENT).

Parameters

Signature: emit(event, ...args)

Parameter	Type(s)	Default	Description
event	string		The event
args	*		Arbitrary number of arguments to pass along to the callback functions

Return Value

Returns: Array

An array containing the return value of each of the executed listener functions.

Throws:

• TypeError : The event parameter must be a string.

.getListenerCount(...)

Returns the number of listeners registered for a specific event.

Please note that global events (those added with EventEmitter.ANY_EVENT) do not count towards the remaining number for a "regular" event. To get the number of global listeners, specifically use EventEmitter.ANY_EVENT as the parameter.

Parameters

Signature: getListenerCount(event)

Parameter	Type(s)	Default	Description
event	string Symbol		The event which is usually a string but can also be the special EventEmitter.ANY_EVENT symbol.

Return Value

Returns: number

An integer representing the number of listeners registered for the specified event.

.getListeners(...)

Returns an array of all the Listener objects that have been registered for a specific event.

Please note that global events (those added with EventEmitter.ANY_EVENT) are not returned for "regular" events. To get the list of global listeners, specifically use EventEmitter.ANY_EVENT as the parameter.

Parameters

Signature: getListeners(event)

Parameter	Type(s)	Default	Description
event	string Symbol		The event to get listeners for.

Return Value

Returns: Array.<Listener>

An array of Listener objects.

.getNoteState(...)

Since: version 3.0.0

Returns the playing status of the specified note (true if the note is currently playing, false if it is not). The note parameter can be an unsigned integer (0-127), a note identifier ("C4", "G#5", etc.) or a Note object.

IF the note is specified using an integer (0-127), no octave offset will be applied.

Parameters

Signature: getNoteState(note)

Parameter	Type(s)	Default	Description
note	number string Note		The note to get the state for. The octaveOffset (channel, input and global) will be factored in for note identifiers and Note objects.

Return Value

Returns: boolean

.hasListener(...)

Returns true if the specified event has at least one registered listener. If no event is specified, the method returns true if any event has at least one listener registered (this includes global listeners registered to EventEmitter.ANY_EVENT).

Note: to specifically check for global listeners added with EventEmitter.ANY_EVENT, use EventEmitter.ANY_EVENT as the parameter.

Parameters

Signature: hasListener([event], [callback])

Parameter	Type(s)	Default	Description
[event]	string Symbol	(any event)	The event to check
[callback]	function Listener	(any callback)	The actual function that was added to the event or the Listener object returned by addListener().

Return Value

Returns: boolean

.removeListener(...)

Removes all the listeners that match the specified criterias. If no parameters are passed, all listeners will be removed. If only the event parameter is passed, all listeners for that event will be removed. You can remove global listeners by using EventEmitter.ANY_EVENT as the first parameter.

To use more granular options, you must at least define the event. Then, you can specify the callback to match or one or more of the additional options.

Parameters

Signature: removeListener([event], [callback], [options])

Parameter	Type(s)	Default	Description
[event]	string		The event name.
[callback]	EventEmitter~callback		Only remove the listeners that match this exact callback function.
[options]	Object
[options.context]	*		Only remove the listeners that have this exact context.
[options.remaining]	number		Only remove the listener if it has exactly that many remaining times to be executed.

.suspendEvent(...)

Suspends execution of all callbacks functions registered for the specified event type.

You can suspend execution of callbacks registered with EventEmitter.ANY_EVENT by passing EventEmitter.ANY_EVENT to suspendEvent(). Beware that this will not suspend all callbacks but only those registered with EventEmitter.ANY_EVENT. While this may seem counter-intuitive at first glance, it allows the selective suspension of global listeners while leaving other listeners alone. If you truly want to suspends all callbacks for a specific EventEmitter, simply set its eventsSuspended property to true.

Parameters

Signature: suspendEvent(event)

Parameter	Type(s)	Default	Description
event	string Symbol		The event name (or EventEmitter.ANY_EVENT) for which to suspend execution of all callback functions.

.unsuspendEvent(...)

Resumes execution of all suspended callback functions registered for the specified event type.

You can resume execution of callbacks registered with EventEmitter.ANY_EVENT by passing EventEmitter.ANY_EVENT to unsuspendEvent(). Beware that this will not resume all callbacks but only those registered with EventEmitter.ANY_EVENT. While this may seem counter-intuitive, it allows the selective unsuspension of global listeners while leaving other callbacks alone.

Parameters

Signature: unsuspendEvent(event)

Parameter	Type(s)	Default	Description
event	string Symbol		The event name (or EventEmitter.ANY_EVENT) for which to resume execution of all callback functions.

.waitFor(...)

Attributes: async

The waitFor() method is an async function which returns a promise. The promise is fulfilled when the specified event occurs. The event can be a regular event or EventEmitter.ANY_EVENT (if you want to resolve as soon as any event is emitted).

If the duration option is set, the promise will only be fulfilled if the event is emitted within the specified duration. If the event has not been fulfilled after the specified duration, the promise is rejected. This makes it super easy to wait for an event and timeout after a certain time if the event is not triggered.

Parameters

Signature: waitFor(event, [options])

Parameter	Type(s)	Default	Description
event	string Symbol		The event to wait for
[options]	Object	{}
[options.duration]	number	Infinity	The number of milliseconds to wait before the promise is automatically rejected.

---

Events

allnotesoff

Event emitted when an "all notes off" channel-mode MIDI message has been received.

Event Properties

Property	Type	Description
type	string	allnotesoff
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).

allsoundoff

Event emitted when an "all sound off" channel-mode MIDI message has been received.

Event Properties

Property	Type	Description
type	string	allsoundoff
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).

channelaftertouch

Event emitted when a control change MIDI message has been received.

Event Properties

Property	Type	Description
type	string	channelaftertouch
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
value	number	The value expressed as a float between 0 and 1.
rawValue	number	The raw MIDI value expressed as an integer between 0 and 127.

controlchange

Event emitted when a control change MIDI message has been received.

Event Properties

Property	Type	Description
type	string	controlchange
subtype	string	The type of control change message that was received.
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
controller	object
controller.number	object	The number of the controller.
controller.name	object	The usual name or function of the controller.
value	number	The value expressed as a float between 0 and 1.
rawValue	number	The value expressed as an integer (between 0 and 127).

controlchange-controllerxxx

Event emitted when a control change MIDI message has been received and that message is targeting the controller numbered "xxx". Of course, "xxx" should be replaced by a valid controller number (0-127).

Event Properties

Property	Type	Description
type	string	controlchange-controllerxxx
subtype	string	The type of control change message that was received.
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
controller	object
controller.number	object	The number of the controller.
controller.name	object	The usual name or function of the controller.
value	number	The value expressed as a float between 0 and 1.
rawValue	number	The value expressed as an integer (between 0 and 127).

keyaftertouch

Event emitted when a key-specific aftertouch MIDI message has been received.

Event Properties

Property	Type	Description
type	string	"keyaftertouch"
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
note	object	A Note object containing information such as note name and number.
value	number	The aftertouch amount expressed as a float between 0 and 1.
rawValue	number	The aftertouch amount expressed as an integer (between 0 and 127).

localcontrol

Event emitted when a "local control" channel-mode MIDI message has been received. The value property of the event is set to either true (local control on) of false (local control off).

Event Properties

Property	Type	Description
type	string	localcontrol
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
value	boolean	For local control on, the value is true. For local control off, the value is false.
rawValue	boolean	For local control on, the value is 127. For local control off, the value is 0.

midimessage

Event emitted when a MIDI message of any kind is received by an InputChannel

Event Properties

Property	Type	Description
type	string	midimessage
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).

monomode

Event emitted when a "mono/poly mode" MIDI message has been received. The value property of the event is set to either true (mono mode on / poly mode off) or false (mono mode off / poly mode on).

Event Properties

Property	Type	Description
type	string	monomode
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
value	boolean	The value is true for omni mode on and false for omni mode off.
rawValue	boolean	The raw MIDI value

noteoff

Event emitted when a note off MIDI message has been received on the channel.

Event Properties

Property	Type	Description
type	string	noteoff
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
note	object	A Note object containing information such as note name, octave and release velocity.
value	number	The release velocity amount expressed as a float between 0 and 1.
rawValue	number	The release velocity amount expressed as an integer (between 0 and 127).

noteon

Event emitted when a note on MIDI message has been received.

Event Properties

Property	Type	Description
type	string	noteon
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
note	object	A Note object containing information such as note name, octave and release velocity.
value	number	The attack velocity amount expressed as a float between 0 and 1.
rawValue	number	The attack velocity amount expressed as an integer (between 0 and 127).

nrpn

Event emitted when any NRPN message is received on the input. There are four subtypes of NRPN messages:

• nrpn-dataentrycoarse
• nrpn-dataentryfine
• nrpn-databuttonincrement
• nrpn-databuttondecrement

The parameter to which the message applies can be found in the event's parameter property.

Event Properties

Property	Type	Description
type	string	nrpn
subtype	string	The precise type of NRPN message that was received.
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	number	The non-registered parameter number (0-16383)
parameterMsb	number	The MSB portion of the non-registered parameter number (0-127)
parameterLsb:	number	The LSB portion of the non-registered parameter number (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

nrpn-databuttondecrement

Event emitted when an NRPN data button decrement message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	nrpn-databuttondecrement
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

nrpn-databuttonincrement

Event emitted when an NRPN data button increment message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	nrpn-databuttonincrement
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

nrpn-dataentrycoarse

Event emitted when an NRPN data entry coarse message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	nrpn-dataentrycoarse
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

nrpn-dataentryfine

Event emitted when an NRPN data entry fine message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	nrpn-dataentryfine
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

omnimode

Event emitted when an "omni mode" channel-mode MIDI message has been received. The value property of the event is set to either true (omni mode on) of false (omni mode off).

Event Properties

Property	Type	Description
type	string	"omnimode"
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
value	boolean	The value is true for omni mode on and false for omni mode off.
rawValue	boolean	The raw MIDI value

pitchbend

Event emitted when a pitch bend MIDI message has been received.

Event Properties

Property	Type	Description
type	string	pitchbend
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
value	number	The value expressed as a float between 0 and 1.
rawValue	number	The raw MIDI value expressed as an integer (between 0 and 16383).

programchange

Event emitted when a program change MIDI message has been received.

Event Properties

Property	Type	Description
type	string	programchange
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
value	number	The value expressed as an integer between 0 and 127.
rawValue	number	The raw MIDI value expressed as an integer between 0 and 127.

resetallcontrollers

Event emitted when a "reset all controllers" channel-mode MIDI message has been received.

Event Properties

Property	Type	Description
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
message	Message	A Message object containing information about the incoming MIDI message.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).

rpn

Event emitted when any RPN message is received on the input. There are four subtypes of RPN messages:

• rpn-dataentrycoarse
• rpn-dataentryfine
• rpn-databuttonincrement
• rpn-databuttondecrement

The parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	rpn
subtype	string	The precise type of RPN message that was received.
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

rpn-databuttondecrement

Event emitted when an RPN data button decrement message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	rpn-databuttondecrement
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

rpn-databuttonincrement

Event emitted when an RPN data button increment message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	rpn-databuttonincrement
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

rpn-dataentrycoarse

Event emitted when an RPN data entry coarse message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	rpn-dataentrycoarse
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)

rpn-dataentryfine

Event emitted when an RPN data entry fine message is received on the input. The specific parameter to which the message applies can be found in the event's parameter property. It is one of the ones defined in Enumerations.MIDI_REGISTERED_PARAMETERS.

Event Properties

Property	Type	Description
type	string	rpn-dataentryfine
target	InputChannel	The object that dispatched the event.
port	Input	The Input that triggered the event.
timestamp	number	The moment (DOMHighResTimeStamp) when the event occurred (in milliseconds since the navigation start of the document).
message	Message	A Message object containing information about the incoming MIDI message.
parameter	string	The registered parameter's name
parameterMsb	number	The MSB portion of the registered parameter (0-127)
parameterLsb:	number	The LSB portion of the registered parameter (0-127)
value	number	The received value as a normalized number between 0 and 1.
rawValue	number	The value as received (0-127)