From f143549d7958495320c107e5682f54b021a482df Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sat, 5 Nov 2011 00:34:05 +0000 Subject: Update wording of MIDI extension to be more correct and generic (Event, Atom, etc.) --- ext/atom.lv2/atom.ttl | 22 ------------- ext/midi.lv2/midi.ttl | 86 ++++++++++++++++++++++++++------------------------- 2 files changed, 44 insertions(+), 64 deletions(-) diff --git a/ext/atom.lv2/atom.ttl b/ext/atom.lv2/atom.ttl index e411c63..139155f 100644 --- a/ext/atom.lv2/atom.ttl +++ b/ext/atom.lv2/atom.ttl @@ -301,28 +301,6 @@ An atom with a time stamp header prepended, typically for sample accurate transmission via LV2 ports. See struct LV2_Atom_Event. """ . -atom:MidiMessage - a rdfs:Class ; - rdfs:label "MIDI Message" ; - rdfs:subClassOf atom:Atom ; - lv2:documentation """ -

A single raw MIDI message.

- -

This is a standard MIDI message, with the following restrictions to ease the -burden on plugin authors:

- -""" . - atom:Bang a rdfs:Class ; rdfs:subClassOf atom:Atom ; diff --git a/ext/midi.lv2/midi.ttl b/ext/midi.lv2/midi.ttl index 9621aa8..c63b8c2 100644 --- a/ext/midi.lv2/midi.ttl +++ b/ext/midi.lv2/midi.ttl @@ -14,65 +14,67 @@ # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -@prefix midi: . -@prefix lv2: . -@prefix lv2ev: . -@prefix rdfs: . -@prefix doap: . -@prefix foaf: . +@prefix atom: . +@prefix doap: . +@prefix ev: . +@prefix foaf: . +@prefix lv2: . +@prefix midi: . +@prefix rdfs: . a lv2:Specification ; doap:license ; - doap:name "LV2 MIDI Events" ; - doap:shortdesc "A data type for raw MIDI." ; - doap:release [ - doap:revision "1.2" ; - doap:created "2011-05-21" - ] ; + doap:name "LV2 MIDI" ; + doap:shortdesc "A data type for raw MIDI." ; + doap:release [ + doap:revision "1.3" ; + doap:created "2011-11-04" + ] ; doap:maintainer [ a foaf:Person ; foaf:name "David Robillard" ; foaf:homepage ; rdfs:seeAlso - ] , [ + ] ; + doap:developer [ a foaf:Person ; foaf:name "Lars Luthman" ; - ] . + foaf:mbox + ] ; + lv2:documentation """ +This extension defines a data type for a MIDI message (MidiEvent), which is normalized for fast and convenient +processing by plugins. It is particularly useful as the payload of an Atom or Event. +""" . -midi:MidiEvent a rdfs:Class ; - rdfs:label "LV2 MIDI event" ; - rdfs:subClassOf lv2ev:Event ; +midi:MidiEvent + a rdfs:Class ; + rdfs:label "LV2 MIDI message." ; + rdfs:subClassOf ev:Event , + atom:Atom ; lv2:documentation """ -

A single raw (sequence of bytes) MIDI event.

+

A single raw MIDI message (i.e. a sequence of bytes).

-

These events are equivalent to standard MIDI events, with the following -restrictions to ease the burden on plugin authors:

+

These is equivalent to a standard MIDI messages, except with the following +restrictions to simplify handling:

    -
  • Running status is not allowed. Every event must have its own status - byte.
    • - -
  • Note On events with velocity 0 are not allowed. These events are - equivalent to Note Off in standard MIDI streams, but in order to make - plugins and hosts easier to write, as well as more efficient, only proper - Note Off events are allowed as Note Off.
    • +
  • Running status is not allowed, every message must have its own status + byte.
    • -
  • "Realtime events" (status bytes 0xF8 to 0xFF) are allowed, but may - not occur inside other events like they are allowed to in hardware MIDI - streams.
    • +
  • 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.
    • -
  • All events must be fully contained in a single data buffer, i.e. events - may not "wrap around" by storing the first few bytes in one buffer and - then wait for the next run() call to store the rest of the event. If - there isn't enough space in the current data buffer to store an event, - the event will either have to wait until next run() call, be ignored, - or compensated for in some more clever way.
    • +
  • "Realtime messages" (status bytes 0xF8 to 0xFF) are allowed, but may + not occur inside other messages like they can in standard MIDI streams.
    • -
  • All events must be valid MIDI events. 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. - The MIDI writer (host or plugin) is responsible for writing valid MIDI - events to the buffer, and the MIDI reader (plugin or host) can assume that - all events are valid.
    • +
  • 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.
""" . -- cgit v1.2.1