midiparse
Interpret raw MIDI data
Description
Separates raw MIDI bytes into standard numerical messages. This object works particularly well parsing the output of the midiin object.
Inlets
midiin [number]
Numbers received in the inlet are treated as bytes of a MIDI message (usually from a midiin object). The status byte determines the outlet which will be used to output the data bytes.
Outlets
noteonoroff [list]
Out leftmost outlet: A note-on or note-off message. The first number is a pitch value and the second number is a velocity value. The message is a note-off message when the second number is 0.
polypressure [list]
Out 2nd outlet: A polyphonic key pressure message. The first number is a key (note) number and the second number is an aftertouch (pressure) value.
controlchange [list]
Out 3rd outlet: A control message. The first number is a controller number and the second number is a control value.
programchange [number]
Out 4th outlet: The number is a program change.
aftertouch [number]
Out 5th outlet: The number is an aftertouch (channel pressure) value.
pitchbend [number]
Out 6th outlet: The number is a pitch bend value, with a range dependent on the @bendmode attribute.
channel [number]
Out 7th outlet: The number is the MIDI channel number.
Fixed Attributes
These attributes must be set in the object box and determine the behavior of the object at runtime.
bendmode [enum] (default: float)
The hires attribute is used to support high-resolution pitch bend scaling. When the attribute is set to 0 (default), midiparse will accept and output pitch bend integer values in the standard MIDI range of 0 to 127. When the attribute is set to 1, it accepts high resolution MIDI data and outputs float values in the range of -1 to 1. When the attribute is set to 2, it accepts high resolution MIDI data and outputs integer values in the range of -8192 to 8191 (standard 14-bit MIDI high resolution pitch bend range). 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 )
Possible values:0 = 'lores'
1 = 'float'
2 = 'hires'
Dynamic Attributes
These attributes can be modified in the code during execution using the set object
midiin [number]
Numbers received in the inlet are treated as bytes of a MIDI message (usually from a midiin object). The status byte determines the outlet which will be used to output the data bytes.
See Also
Name | Description |
---|---|
midiparse | |
midiin | MIDI input stream |
midiformat | Prepare data in the form of a MIDI message |
noteout | transmit MIDI note messages |