This specification defines a data type for a MIDI message, MidiEvent,
which is normalised for fast and convenient real-time processing. MIDI is the
Musical Instrument Digital Interface
, a ubiquitous binary standard for
controlling digital music devices.
For plugins that process MIDI (or other situations where MIDI is sent via a generic transport) the main type defined here, MidiEvent, can be mapped to an integer and used as the type of an LV2 Atom or Event.
This specification also defines a complete vocabulary for the MIDI standard, except for standard controller numbers. These descriptions are detailed enough to express any MIDI message as properties.
Index
Classes
Aftertouch
Class| Label | Aftertouch | ||||
|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||
| chunk |
| ||||
| chunk |
| ||||
| statusMask | a0 |
MIDI aftertouch message.
Bender
Class| Label | Bender | ||||||
|---|---|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||||
| chunk |
| ||||||
| statusMask | e0 |
MIDI bender message.
ChannelPressure
Class| Label | Channel Pressure | ||||
|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||
| chunk |
| ||||
| statusMask | d0 |
MIDI channel pressure message.
Chunk
Class| Label | Chunk |
|---|---|
| In domain of | byteNumber |
| property | |
| In range of | chunk |
A sequence of contiguous bytes in a MIDI message.
Controller
Class| Label | Controller | ||||
|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||
| chunk |
| ||||
| chunk |
| ||||
| statusMask | b0 |
MIDI controller change message.
HexByte
Class| Label | Hex Byte |
|---|---|
| In range of | status |
| statusMask | |
| velocity | |
| owl:onDatatype | xsd:hexBinary |
A hexadecimal byte, which has a value <= FF.
MidiEvent
Class| Label | MIDI Message |
|---|---|
| Subclass of | atom:Atom |
| ev:Event | |
| Superclass of | SystemMessage |
| VoiceMessage | |
| In range of | binding |
| owl:onDatatype | xsd:hexBinary |
A single raw MIDI message.
A single raw MIDI message (a sequence of bytes).
This is equivalent to a standard MIDI messages, except with the following restrictions to simplify handling:
-
Running status is not allowed, every message must have its own status byte.
-
Note On messages with velocity 0 are not allowed. These messages are equivalent to Note Off in standard MIDI streams, but here only proper Note Off messages are allowed.
-
"Realtime messages" (status bytes 0xF8 to 0xFF) are allowed, but may not occur inside other messages like they can in standard MIDI streams.
-
All messages are complete valid MIDI messages. This means, for example, that only the first byte in each event (the status byte) may have the eighth bit set, that Note On and Note Off events are always 3 bytes long, etc.
Where messages are communicated, the writer is responsible for writing valid messages, and the reader may assume that all events are valid.
If a MidiEvent is serialised to a string, the format should be xsd:hexBinary, for example:
[] eg:someEvent "901A01"^^midi:MidiEvent .
NoteOff
Class| Label | Note Off | ||||
|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||
| chunk |
| ||||
| chunk |
| ||||
| statusMask | 80 |
MIDI note off message.
NoteOn
Class| Label | Note On | ||||
|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||
| chunk |
| ||||
| chunk |
| ||||
| statusMask | 90 |
MIDI note on message.
ProgramChange
Class| Label | Program Change | ||||
|---|---|---|---|---|---|
| Subclass of | VoiceMessage | ||||
| chunk |
| ||||
| statusMask | c0 |
MIDI program change message.
SongPosition
Class| Label | Song Position | ||||||
|---|---|---|---|---|---|---|---|
| Subclass of | SystemCommon | ||||||
| chunk |
| ||||||
| status | f2 |
MIDI song position pointer message.
SystemCommon
Class| Label | System Common |
|---|---|
| Subclass of | SystemMessage |
| Superclass of | QuarterFrame |
| SongPosition | |
| SongSelect | |
| TuneRequest |
MIDI system common message.
SystemExclusive
Class| Label | System Exclusive |
|---|---|
| Subclass of | SystemMessage |
| status | f0 |
MIDI system exclusive message.
SystemMessage
Class| Label | System Message |
|---|---|
| Subclass of | MidiEvent |
| Superclass of | SystemCommon |
| SystemExclusive | |
| SystemRealtime | |
| statusMask | f0 |
MIDI system message.
SystemRealtime
Class| Label | System Realtime |
|---|---|
| Subclass of | SystemMessage |
| Superclass of | ActiveSense |
| Clock | |
| Continue | |
| Reset | |
| Start | |
| Stop |
MIDI system realtime message.
VoiceMessage
Class| Label | Voice Message |
|---|---|
| Subclass of | MidiEvent |
| Superclass of | Aftertouch |
| Bender | |
| ChannelPressure | |
| Controller | |
| NoteOff | |
| NoteOn | |
| ProgramChange | |
| statusMask | f0 |
MIDI voice message.
Properties
benderValue
Property| Label | bender value |
|---|---|
| Range | xsd:short |
| Type | Datatype Property |
MIDI pitch bender message (-8192 to 8192).
binding
Property| Label | binding |
|---|---|
| Range | MidiEvent |
| Type | Object Property |
The MIDI event to bind a parameter to.
byteNumber
Property| Label | byte number |
|---|---|
| Domain | Chunk |
| Range | xsd:unsignedByte |
| Type | Datatype Property |
The 0-based index of a byte which is part of this chunk.
channel
Property| Label | MIDI channel |
|---|---|
| Range | xsd:unsignedByte |
| Type | Datatype Property |
The channel number of a MIDI message.
controllerNumber
Property| Label | MIDI controller number |
|---|---|
| Range | xsd:byte |
| Type | Datatype Property |
The numeric ID of a controller (0 to 127).
controllerValue
Property| Label | MIDI controller value |
|---|---|
| Range | xsd:byte |
| Type | Datatype Property |
The value of a controller (0 to 127).
noteNumber
Property| Label | note number |
|---|---|
| Range | xsd:byte |
| Type | Datatype Property |
The numeric ID of a note (0 to 127).
programNumber
Property| Label | program number |
|---|---|
| Range | xsd:byte |
| Type | Datatype Property |
The numeric ID of a program (0 to 127).
property
Property| Label | property |
|---|---|
| Domain | Chunk |
| Range | rdf:Property |
| Type | Object Property |
The property this chunk represents.
songNumber
Property| Label | song number |
|---|---|
| Range | xsd:byte |
| Type | Datatype Property |
The numeric ID of a song (0 to 127).
songPosition
Propertystatus
Property| Label | status byte |
|---|---|
| Range | HexByte |
| Type | Datatype Property |
The exact status byte for a message of this type.
statusMask
Property| Label | status mask |
|---|---|
| Range | HexByte |
| Type | Datatype Property |
The status byte for a message of this type on channel 1.
This is a status byte with the lower nibble set to zero.
MIDI active sense message.