16 |
to an annoying "missing Normative/Informative References" error message --> |
to an annoying "missing Normative/Informative References" error message --> |
17 |
<?rfc strict="no" ?> |
<?rfc strict="no" ?> |
18 |
|
|
19 |
<rfc category="std" ipr="full3978" docName="LSCP 1.3"> |
<rfc category="std" ipr="full3978" docName="LSCP 1.4"> |
20 |
<front> |
<front> |
21 |
<title>LinuxSampler Control Protocol</title> |
<title>LinuxSampler Control Protocol</title> |
22 |
<author initials='C.S.' surname="Schoenebeck" fullname='C. |
<author initials='C.S.' surname="Schoenebeck" fullname='C. |
34 |
<email>schoenebeck at software minus engineering dot org</email> |
<email>schoenebeck at software minus engineering dot org</email> |
35 |
</address> |
</address> |
36 |
</author> |
</author> |
37 |
<date month="December" year="2007"/> |
<date month="February" year="2008"/> |
38 |
<workgroup>LinuxSampler Developers</workgroup> |
<workgroup>LinuxSampler Developers</workgroup> |
39 |
<keyword>LSCP</keyword> |
<keyword>LSCP</keyword> |
40 |
<abstract> |
<abstract> |
6391 |
</t> |
</t> |
6392 |
<t>/ CHANNEL_COUNT |
<t>/ CHANNEL_COUNT |
6393 |
</t> |
</t> |
6394 |
|
<t>/ CHANNEL_MIDI |
6395 |
|
</t> |
6396 |
|
<t>/ DEVICE_MIDI |
6397 |
|
</t> |
6398 |
<t>/ VOICE_COUNT |
<t>/ VOICE_COUNT |
6399 |
</t> |
</t> |
6400 |
<t>/ STREAM_COUNT |
<t>/ STREAM_COUNT |
6447 |
</t> |
</t> |
6448 |
<t>/ CHANNEL_COUNT |
<t>/ CHANNEL_COUNT |
6449 |
</t> |
</t> |
6450 |
|
<t>/ CHANNEL_MIDI |
6451 |
|
</t> |
6452 |
|
<t>/ DEVICE_MIDI |
6453 |
|
</t> |
6454 |
<t>/ VOICE_COUNT |
<t>/ VOICE_COUNT |
6455 |
</t> |
</t> |
6456 |
<t>/ STREAM_COUNT |
<t>/ STREAM_COUNT |
7246 |
of sampler channels.</t> |
of sampler channels.</t> |
7247 |
</section> |
</section> |
7248 |
|
|
7249 |
|
<section title="MIDI data on a sampler channel arrived" anchor="SUBSCRIBE CHANNEL_MIDI"> |
7250 |
|
<t>Client may want to be notified when MIDI data arrive on sampler channels on |
7251 |
|
back-end side, by issuing the following command:</t> |
7252 |
|
<t> |
7253 |
|
<list> |
7254 |
|
<t>SUBSCRIBE CHANNEL_MIDI</t> |
7255 |
|
</list> |
7256 |
|
</t> |
7257 |
|
<t>Server will start sending one of the the following notification messages:</t> |
7258 |
|
<t> |
7259 |
|
<list> |
7260 |
|
<t>"NOTIFY:CHANNEL_MIDI:<channel-id> NOTE_ON <note> <velocity>"</t> |
7261 |
|
<t>"NOTIFY:CHANNEL_MIDI:<channel-id> NOTE_OFF <note> <velocity>"</t> |
7262 |
|
</list> |
7263 |
|
</t> |
7264 |
|
<t>where <channel-id> will be replaced by the ID of the sampler channel where the MIDI |
7265 |
|
data arrived. <note> and <velocity> are integer values in the range between |
7266 |
|
0 .. 127, reflecting the analog meaning of the MIDI specification. |
7267 |
|
</t> |
7268 |
|
<t>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all |
7269 |
|
delivered by this mechanism! With other words: events could be lost at any time! |
7270 |
|
This restriction was made to keep the RT-safeness of the backend's MIDI and audio |
7271 |
|
thread unaffected by this feature.</t> |
7272 |
|
</section> |
7273 |
|
|
7274 |
|
<section title="MIDI data on a MIDI input device arrived" anchor="SUBSCRIBE DEVICE_MIDI"> |
7275 |
|
<t>Client may want to be notified when MIDI data arrive on MIDI input devices by issuing the following command:</t> |
7276 |
|
<t> |
7277 |
|
<list> |
7278 |
|
<t>SUBSCRIBE DEVICE_MIDI</t> |
7279 |
|
</list> |
7280 |
|
</t> |
7281 |
|
<t>Server will start sending one of the the following notification messages:</t> |
7282 |
|
<t> |
7283 |
|
<list> |
7284 |
|
<t>"NOTIFY:CHANNEL_MIDI:<device-id> <port-id> NOTE_ON <note> <velocity>"</t> |
7285 |
|
<t>"NOTIFY:CHANNEL_MIDI:<device-id> <port-id> NOTE_OFF <note> <velocity>"</t> |
7286 |
|
</list> |
7287 |
|
</t> |
7288 |
|
<t>where <device-id> <port-id> will be replaced |
7289 |
|
by the IDs of the respective MIDI input device and the device's MIDI port where the MIDI |
7290 |
|
data arrived. <note> and <velocity> are integer values in the range between |
7291 |
|
0 .. 127, reflecting the analog meaning of the MIDI specification. |
7292 |
|
</t> |
7293 |
|
<t>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all |
7294 |
|
delivered by this mechanism! With other words: events could be lost at any time! |
7295 |
|
This restriction was made to keep the RT-safeness of the backend's MIDI and audio |
7296 |
|
thread unaffected by this feature.</t> |
7297 |
|
</section> |
7298 |
|
|
7299 |
<section title="Number of active voices changed" anchor="SUBSCRIBE VOICE_COUNT"> |
<section title="Number of active voices changed" anchor="SUBSCRIBE VOICE_COUNT"> |
7300 |
<t>Client may want to be notified when the number of voices on the |
<t>Client may want to be notified when the number of voices on the |
7301 |
back-end changes by issuing the following command:</t> |
back-end changes by issuing the following command:</t> |