RNBO Objects & Operators midiparse
Open Help

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