aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/lv2plug.in/ns/ext/midi/midi.ttl
blob: 64edf0e615133e30bddd4216de4c3ed359672d5b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# LV2 MIDI Extension
# Copyright 2008-2011 David Robillard <d@drobilla.net>
# Copyright 2006 Lars Luthman <lars.luthman@gmail.com>
#
# Permission to use, copy, modify, and/or distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

@prefix dcs:  <http://ontologi.es/doap-changeset#> .
@prefix atom: <http://lv2plug.in/ns/ext/atom#> .
@prefix doap: <http://usefulinc.com/ns/doap#> .
@prefix ev:   <http://lv2plug.in/ns/ext/event#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
@prefix midi: <http://lv2plug.in/ns/ext/midi#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .

<http://drobilla.net/drobilla#me>
	a foaf:Person ;
	foaf:name "David Robillard" ;
	foaf:homepage <http://drobilla.net/> ;
	foaf:mbox <mailto:d@drobilla.net> ;
	rdfs:seeAlso <http://drobilla.net/drobilla> .

_:larsl
	a foaf:Person ;
	foaf:name "Lars Luthman" ;
	foaf:mbox <mailto:lars.luthman@gmail.com> .

<http://lv2plug.in/ns/ext/midi>
	a lv2:Specification ;
	doap:license <http://opensource.org/licenses/isc> ;
	doap:name "LV2 MIDI" ;
	doap:shortdesc "A data type for raw MIDI." ;
	doap:maintainer <http://drobilla.net/drobilla#me> ;
	doap:developer _:larsl ;
	doap:release [
		doap:revision "1.4" ;
		doap:created "2011-11-21" ;
		doap:file-release <http://lv2plug.in/spec/lv2-midi-1.4.tar.bz2> ;
		dcs:blame <http://drobilla.net/drobilla#me> ;
		dcs:changeset [
			dcs:item [
				rdfs:label "Update packaging."
			] , [
				rdfs:label "Improve documentation."
			]
		]
	] , [
		doap:revision "1.2" ;
		doap:created "2011-05-26" ;
		doap:file-release <http://lv2plug.in/spec/lv2-midi-1.2.tar.bz2> ;
		dcs:blame <http://drobilla.net/drobilla#me> ;
		dcs:changeset [
			dcs:item [
				rdfs:label "Add build system for installation."
			] , [
				rdfs:label "Switch to ISC license."
			]
		]
	] , [
		doap:revision "1.0" ;
		doap:created "2010-10-04" ;
		doap:file-release <http://lv2plug.in/spec/lv2-midi-1.0.tar.gz> ;
		dcs:blame <http://drobilla.net/drobilla#me> ;
		dcs:changeset [
			dcs:item [
				rdfs:label "Initial release."
			]
		]
	] ;
	lv2:documentation """
<p>This extension defines a data type for a MIDI message, midi:MidiEvent, which
is normalized for fast and convenient processing by plugins.  It is
particularly useful as the payload of an <a
href="http://lv2plug.in/ns/ext/atom#Atom">Atom</a> or <a
href="http://lv2plug.in/ns/ext/event#Event">Event</a>.</p>
""" .

midi:MidiEvent
	a rdfs:Class ;
	rdfs:label "LV2 MIDI message." ;
	rdfs:subClassOf ev:Event ,
		atom:Atom ;
	lv2:documentation """
<p>A single raw MIDI message (i.e. a sequence of bytes).</p>

<p>This is equivalent to a standard MIDI messages, except with the following
restrictions to simplify handling:</p>
<ul>
  <li>Running status is not allowed, every message must have its own status
  byte.</li>

  <li>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.</li>

  <li>"Realtime messages" (status bytes 0xF8 to 0xFF) are allowed, but may
  not occur inside other messages like they can in standard MIDI streams.</li>

  <li>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.</li>
</ul>
""" .