mpeparse Reference

Interpret raw MPE MIDI data

mpeparse

Description

Separates raw Multidimensional Polyphonic Expression (MPE) MIDI bytes into standard message types.

Examples

Arguments

None.

Attributes

hires [int] (default: 0)

An integer in the range 0 - 2 sets the range used for pitch bend messages by the mpeparse object.

Possible values:

0 = 'Off (0-127)' ( Standard 8-bit MIDI pitch bend range (default) )
1 = 'Float (-1 to 1)' ( Uses pitch bend messages in the audio signal range )
2 = '14-bit Fixed (-8192 to 8191)' ( Standard 14-bit MIDI high resolution pitch bend range )

index [int] (default: 0)

Set mpeparse to output only on the specified voice number (from 1 to 15).

strict [int] (default: 0)

Enforce MPE Scope

Common Box Attributes

Messages

bang

Clears the mpeparse object's memory of any partial MPE MIDI message received up to that point.

int

Arguments

byte [int]
Numbers received in the inlet are treated as bytes of a MIDI message (usually from a midiin or polymidiin object). The status byte determines the outlet which will be used to output the data bytes.

float

Arguments

byte [float]
Converted to int.

mpeevent

Arguments

MPE-messages [list]
The word 'mpeevent' followed by 6 integers, which specify the Zone First Channel, Zone Index, Voice Number, Channel Number, MIDI Message Number, and Data.

Output

int

Out 4th outlet: The number is a program change.

Out 5th outlet: The number is an aftertouch (channel pressure) value.

Out 6th outlet: The number is a pitch bend value.

Out 7th outlet: The number is the voice number (-1 if global).

Out 8th outlet: The number is the Zone First Channel.

Out 9th outlet: The number is the Zone Index (-1 if global).

list

Out leftmost outlet: A note-on/note-off message. The first number is a pitch value and the second number is a velocity value.

Out 2nd outlet: A polyphonic key pressure message. The first number is an aftertouch (pressure) value and the second number is a pitch value (key number).

Out 3rd outlet: A control message. The first number is a control value and the second number is a controller number.

list

Out rightmost outlet: The MPE Event Message. The MPE event message is a list composed of the symbol mpeevent, followed by 6 integers which specify the Zone First Channel, Zone Index, Voice Number, Channel Number, MIDI Message Number, and Data. This message can be sent to a patch encapsulated in a poly~ object using the polymidiin object.

See Also

Name Description
midiin
midiformat
midiparse
mpeconfig
mpeformat
polymidiin