145 |
<tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr> |
<tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr> |
146 |
<tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr> |
<tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr> |
147 |
<tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr> |
<tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr> |
148 |
<tr><td class="header">Expires: June 18, 2007</td><td class="header">December 15, 2006</td></tr> |
<tr><td class="header">Expires: June 23, 2007</td><td class="header">December 20, 2006</td></tr> |
149 |
</table></td></tr></table> |
</table></td></tr></table> |
150 |
<h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1> |
<h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1> |
151 |
|
|
173 |
The list of Internet-Draft Shadow Directories can be accessed at |
The list of Internet-Draft Shadow Directories can be accessed at |
174 |
<a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p> |
<a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p> |
175 |
<p> |
<p> |
176 |
This Internet-Draft will expire on June 18, 2007.</p> |
This Internet-Draft will expire on June 23, 2007.</p> |
177 |
|
|
178 |
<h3>Copyright Notice</h3> |
<h3>Copyright Notice</h3> |
179 |
<p> |
<p> |
370 |
Command Syntax<br /> |
Command Syntax<br /> |
371 |
<a href="#events">8.</a> |
<a href="#events">8.</a> |
372 |
Events<br /> |
Events<br /> |
373 |
<a href="#SUBSCRIBE CHANNEL">8.1.</a> |
<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT">8.1.</a> |
374 |
|
Number of audio output devices changed<br /> |
375 |
|
<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO">8.2.</a> |
376 |
|
Audio output device's settings changed<br /> |
377 |
|
<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_COUNT">8.3.</a> |
378 |
|
Number of MIDI input devices changed<br /> |
379 |
|
<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_INFO">8.4.</a> |
380 |
|
MIDI input device's settings changed<br /> |
381 |
|
<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a> |
382 |
Number of sampler channels changed<br /> |
Number of sampler channels changed<br /> |
383 |
<a href="#SUBSCRIBE VOICE_COUNT">8.2.</a> |
<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a> |
384 |
Number of active voices changed<br /> |
Number of active voices changed<br /> |
385 |
<a href="#SUBSCRIBE STREAM_COUNT">8.3.</a> |
<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a> |
386 |
Number of active disk streams changed<br /> |
Number of active disk streams changed<br /> |
387 |
<a href="#SUBSCRIBE BUFFER_FILL">8.4.</a> |
<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a> |
388 |
Disk stream buffer fill state changed<br /> |
Disk stream buffer fill state changed<br /> |
389 |
<a href="#SUBSCRIBE INFO">8.5.</a> |
<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a> |
390 |
Channel information changed<br /> |
Channel information changed<br /> |
391 |
<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.6.</a> |
<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.10.</a> |
392 |
Total number of active voices changed<br /> |
Total number of active voices changed<br /> |
393 |
<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a> |
<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.11.</a> |
394 |
|
Number of MIDI instrument maps changed<br /> |
395 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.12.</a> |
396 |
|
MIDI instrument map information changed<br /> |
397 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.13.</a> |
398 |
|
Number of MIDI instruments changed<br /> |
399 |
|
<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.14.</a> |
400 |
|
MIDI instrument information changed<br /> |
401 |
|
<a href="#SUBSCRIBE MISCELLANEOUS">8.15.</a> |
402 |
Miscellaneous and debugging events<br /> |
Miscellaneous and debugging events<br /> |
403 |
<a href="#anchor14">9.</a> |
<a href="#anchor14">9.</a> |
404 |
Security Considerations<br /> |
Security Considerations<br /> |
6524 |
<p>subscribe_event = |
<p>subscribe_event = |
6525 |
</p> |
</p> |
6526 |
<blockquote class="text"> |
<blockquote class="text"> |
6527 |
<p>CHANNEL_COUNT |
<p>AUDIO_OUTPUT_DEVICE_COUNT |
6528 |
|
|
6529 |
|
</p> |
6530 |
|
<p>/ AUDIO_OUTPUT_DEVICE_INFO |
6531 |
|
|
6532 |
|
</p> |
6533 |
|
<p>/ MIDI_INPUT_DEVICE_COUNT |
6534 |
|
|
6535 |
|
</p> |
6536 |
|
<p>/ MIDI_INPUT_DEVICE_INFO |
6537 |
|
|
6538 |
|
</p> |
6539 |
|
<p>/ CHANNEL_COUNT |
6540 |
|
|
6541 |
</p> |
</p> |
6542 |
<p>/ VOICE_COUNT |
<p>/ VOICE_COUNT |
6551 |
<p>/ CHANNEL_INFO |
<p>/ CHANNEL_INFO |
6552 |
|
|
6553 |
</p> |
</p> |
6554 |
|
<p>/ MIDI_INSTRUMENT_MAP_COUNT |
6555 |
|
|
6556 |
|
</p> |
6557 |
|
<p>/ MIDI_INSTRUMENT_MAP_INFO |
6558 |
|
|
6559 |
|
</p> |
6560 |
|
<p>/ MIDI_INSTRUMENT_COUNT |
6561 |
|
|
6562 |
|
</p> |
6563 |
|
<p>/ MIDI_INSTRUMENT_INFO |
6564 |
|
|
6565 |
|
</p> |
6566 |
<p>/ MISCELLANEOUS |
<p>/ MISCELLANEOUS |
6567 |
|
|
6568 |
</p> |
</p> |
6575 |
<p>unsubscribe_event = |
<p>unsubscribe_event = |
6576 |
</p> |
</p> |
6577 |
<blockquote class="text"> |
<blockquote class="text"> |
6578 |
<p>CHANNEL_COUNT |
<p>AUDIO_OUTPUT_DEVICE_COUNT |
6579 |
|
|
6580 |
|
</p> |
6581 |
|
<p>/ AUDIO_OUTPUT_DEVICE_INFO |
6582 |
|
|
6583 |
|
</p> |
6584 |
|
<p>/ MIDI_INPUT_DEVICE_COUNT |
6585 |
|
|
6586 |
|
</p> |
6587 |
|
<p>/ MIDI_INPUT_DEVICE_INFO |
6588 |
|
|
6589 |
|
</p> |
6590 |
|
<p>/ CHANNEL_COUNT |
6591 |
|
|
6592 |
</p> |
</p> |
6593 |
<p>/ VOICE_COUNT |
<p>/ VOICE_COUNT |
6602 |
<p>/ CHANNEL_INFO |
<p>/ CHANNEL_INFO |
6603 |
|
|
6604 |
</p> |
</p> |
6605 |
|
<p>/ MIDI_INSTRUMENT_MAP_COUNT |
6606 |
|
|
6607 |
|
</p> |
6608 |
|
<p>/ MIDI_INSTRUMENT_MAP_INFO |
6609 |
|
|
6610 |
|
</p> |
6611 |
|
<p>/ MIDI_INSTRUMENT_COUNT |
6612 |
|
|
6613 |
|
</p> |
6614 |
|
<p>/ MIDI_INSTRUMENT_INFO |
6615 |
|
|
6616 |
|
</p> |
6617 |
<p>/ MISCELLANEOUS |
<p>/ MISCELLANEOUS |
6618 |
|
|
6619 |
</p> |
</p> |
7182 |
|
|
7183 |
<p>This chapter will describe all currently defined events supported by LinuxSampler. |
<p>This chapter will describe all currently defined events supported by LinuxSampler. |
7184 |
</p> |
</p> |
7185 |
<a name="SUBSCRIBE CHANNEL"></a><br /><hr /> |
<a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT"></a><br /><hr /> |
7186 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7187 |
<a name="rfc.section.8.1"></a><h3>8.1. |
<a name="rfc.section.8.1"></a><h3>8.1. |
7188 |
|
Number of audio output devices changed</h3> |
7189 |
|
|
7190 |
|
<p>Client may want to be notified when the total number of audio output devices on the |
7191 |
|
back-end changes by issuing the following command: |
7192 |
|
</p> |
7193 |
|
<p> |
7194 |
|
</p> |
7195 |
|
<blockquote class="text"> |
7196 |
|
<p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT |
7197 |
|
</p> |
7198 |
|
</blockquote><p> |
7199 |
|
|
7200 |
|
</p> |
7201 |
|
<p>Server will start sending the following notification messages: |
7202 |
|
</p> |
7203 |
|
<p> |
7204 |
|
</p> |
7205 |
|
<blockquote class="text"> |
7206 |
|
<p>"NOTIFY:AUDIO_OUTPUT_DEVICE_COUNT:<devices>" |
7207 |
|
</p> |
7208 |
|
</blockquote><p> |
7209 |
|
|
7210 |
|
</p> |
7211 |
|
<p>where <devices> will be replaced by the new number |
7212 |
|
of audio output devices. |
7213 |
|
</p> |
7214 |
|
<a name="SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO"></a><br /><hr /> |
7215 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7216 |
|
<a name="rfc.section.8.2"></a><h3>8.2. |
7217 |
|
Audio output device's settings changed</h3> |
7218 |
|
|
7219 |
|
<p>Client may want to be notified when changes were made to audio output devices on the |
7220 |
|
back-end by issuing the following command: |
7221 |
|
</p> |
7222 |
|
<p> |
7223 |
|
</p> |
7224 |
|
<blockquote class="text"> |
7225 |
|
<p>SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO |
7226 |
|
</p> |
7227 |
|
</blockquote><p> |
7228 |
|
|
7229 |
|
</p> |
7230 |
|
<p>Server will start sending the following notification messages: |
7231 |
|
</p> |
7232 |
|
<p> |
7233 |
|
</p> |
7234 |
|
<blockquote class="text"> |
7235 |
|
<p>"NOTIFY:AUDIO_OUTPUT_DEVICE_INFO:<device-id>" |
7236 |
|
</p> |
7237 |
|
</blockquote><p> |
7238 |
|
|
7239 |
|
</p> |
7240 |
|
<p>where <device-id> will be replaced by the numerical ID of the audio output device, |
7241 |
|
which settings has been changed. The front-end will have to send |
7242 |
|
the respective command to actually get the audio output device info. Because these messages |
7243 |
|
will be triggered by LSCP commands issued by other clients rather than real |
7244 |
|
time events happening on the server, it is believed that an empty notification |
7245 |
|
message is sufficient here. |
7246 |
|
</p> |
7247 |
|
<a name="SUBSCRIBE MIDI_INPUT_DEVICE_COUNT"></a><br /><hr /> |
7248 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7249 |
|
<a name="rfc.section.8.3"></a><h3>8.3. |
7250 |
|
Number of MIDI input devices changed</h3> |
7251 |
|
|
7252 |
|
<p>Client may want to be notified when the total number of MIDI input devices on the |
7253 |
|
back-end changes by issuing the following command: |
7254 |
|
</p> |
7255 |
|
<p> |
7256 |
|
</p> |
7257 |
|
<blockquote class="text"> |
7258 |
|
<p>SUBSCRIBE MIDI_INPUT_DEVICE_COUNT |
7259 |
|
</p> |
7260 |
|
</blockquote><p> |
7261 |
|
|
7262 |
|
</p> |
7263 |
|
<p>Server will start sending the following notification messages: |
7264 |
|
</p> |
7265 |
|
<p> |
7266 |
|
</p> |
7267 |
|
<blockquote class="text"> |
7268 |
|
<p>"NOTIFY:MIDI_INPUT_DEVICE_COUNT:<devices>" |
7269 |
|
</p> |
7270 |
|
</blockquote><p> |
7271 |
|
|
7272 |
|
</p> |
7273 |
|
<p>where <devices> will be replaced by the new number |
7274 |
|
of MIDI input devices. |
7275 |
|
</p> |
7276 |
|
<a name="SUBSCRIBE MIDI_INPUT_DEVICE_INFO"></a><br /><hr /> |
7277 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7278 |
|
<a name="rfc.section.8.4"></a><h3>8.4. |
7279 |
|
MIDI input device's settings changed</h3> |
7280 |
|
|
7281 |
|
<p>Client may want to be notified when changes were made to MIDI input devices on the |
7282 |
|
back-end by issuing the following command: |
7283 |
|
</p> |
7284 |
|
<p> |
7285 |
|
</p> |
7286 |
|
<blockquote class="text"> |
7287 |
|
<p>SUBSCRIBE MIDI_INPUT_DEVICE_INFO |
7288 |
|
</p> |
7289 |
|
</blockquote><p> |
7290 |
|
|
7291 |
|
</p> |
7292 |
|
<p>Server will start sending the following notification messages: |
7293 |
|
</p> |
7294 |
|
<p> |
7295 |
|
</p> |
7296 |
|
<blockquote class="text"> |
7297 |
|
<p>"NOTIFY:MIDI_INPUT_DEVICE_INFO:<device-id>" |
7298 |
|
</p> |
7299 |
|
</blockquote><p> |
7300 |
|
|
7301 |
|
</p> |
7302 |
|
<p>where <device-id> will be replaced by the numerical ID of the MIDI input device, |
7303 |
|
which settings has been changed. The front-end will have to send |
7304 |
|
the respective command to actually get the MIDI input device info. Because these messages |
7305 |
|
will be triggered by LSCP commands issued by other clients rather than real |
7306 |
|
time events happening on the server, it is believed that an empty notification |
7307 |
|
message is sufficient here. |
7308 |
|
</p> |
7309 |
|
<a name="SUBSCRIBE CHANNEL_COUNT"></a><br /><hr /> |
7310 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7311 |
|
<a name="rfc.section.8.5"></a><h3>8.5. |
7312 |
Number of sampler channels changed</h3> |
Number of sampler channels changed</h3> |
7313 |
|
|
7314 |
<p>Client may want to be notified when the total number of channels on the |
<p>Client may want to be notified when the total number of channels on the |
7337 |
</p> |
</p> |
7338 |
<a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr /> |
<a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr /> |
7339 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7340 |
<a name="rfc.section.8.2"></a><h3>8.2. |
<a name="rfc.section.8.6"></a><h3>8.6. |
7341 |
Number of active voices changed</h3> |
Number of active voices changed</h3> |
7342 |
|
|
7343 |
<p>Client may want to be notified when the number of voices on the |
<p>Client may want to be notified when the number of voices on the |
7367 |
</p> |
</p> |
7368 |
<a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr /> |
<a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr /> |
7369 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7370 |
<a name="rfc.section.8.3"></a><h3>8.3. |
<a name="rfc.section.8.7"></a><h3>8.7. |
7371 |
Number of active disk streams changed</h3> |
Number of active disk streams changed</h3> |
7372 |
|
|
7373 |
<p>Client may want to be notified when the number of streams on the back-end |
<p>Client may want to be notified when the number of streams on the back-end |
7397 |
</p> |
</p> |
7398 |
<a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr /> |
<a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr /> |
7399 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7400 |
<a name="rfc.section.8.4"></a><h3>8.4. |
<a name="rfc.section.8.8"></a><h3>8.8. |
7401 |
Disk stream buffer fill state changed</h3> |
Disk stream buffer fill state changed</h3> |
7402 |
|
|
7403 |
<p>Client may want to be notified when the buffer fill state of a disk stream |
<p>Client may want to be notified when the buffer fill state of a disk stream |
7426 |
buffer fill data for this channel as described in <a class='info' href='#GET CHANNEL BUFFER_FILL'>Section 6.4.13<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a> |
buffer fill data for this channel as described in <a class='info' href='#GET CHANNEL BUFFER_FILL'>Section 6.4.13<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a> |
7427 |
as if the <a class='info' href='#GET CHANNEL BUFFER_FILL'>"GET CHANNEL BUFFER_FILL PERCENTAGE"<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a> command was issued on this channel. |
as if the <a class='info' href='#GET CHANNEL BUFFER_FILL'>"GET CHANNEL BUFFER_FILL PERCENTAGE"<span> (</span><span class='info'>Current fill state of disk stream buffers</span><span>)</span></a> command was issued on this channel. |
7428 |
</p> |
</p> |
7429 |
<a name="SUBSCRIBE INFO"></a><br /><hr /> |
<a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr /> |
7430 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7431 |
<a name="rfc.section.8.5"></a><h3>8.5. |
<a name="rfc.section.8.9"></a><h3>8.9. |
7432 |
Channel information changed</h3> |
Channel information changed</h3> |
7433 |
|
|
7434 |
<p>Client may want to be notified when changes were made to sampler channels on the |
<p>Client may want to be notified when changes were made to sampler channels on the |
7461 |
</p> |
</p> |
7462 |
<a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr /> |
<a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr /> |
7463 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7464 |
<a name="rfc.section.8.6"></a><h3>8.6. |
<a name="rfc.section.8.10"></a><h3>8.10. |
7465 |
Total number of active voices changed</h3> |
Total number of active voices changed</h3> |
7466 |
|
|
7467 |
<p>Client may want to be notified when the total number of voices on the |
<p>Client may want to be notified when the total number of voices on the |
7488 |
<p>where <voices> will be replaced by the new number of |
<p>where <voices> will be replaced by the new number of |
7489 |
all currently active voices. |
all currently active voices. |
7490 |
</p> |
</p> |
7491 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr /> |
7492 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7493 |
|
<a name="rfc.section.8.11"></a><h3>8.11. |
7494 |
|
Number of MIDI instrument maps changed</h3> |
7495 |
|
|
7496 |
|
<p>Client may want to be notified when the number of MIDI instrument maps on the |
7497 |
|
back-end changes by issuing the following command: |
7498 |
|
</p> |
7499 |
|
<p> |
7500 |
|
</p> |
7501 |
|
<blockquote class="text"> |
7502 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT |
7503 |
|
</p> |
7504 |
|
</blockquote><p> |
7505 |
|
|
7506 |
|
</p> |
7507 |
|
<p>Server will start sending the following notification messages: |
7508 |
|
</p> |
7509 |
|
<p> |
7510 |
|
</p> |
7511 |
|
<blockquote class="text"> |
7512 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_MAP_COUNT:<maps>" |
7513 |
|
</p> |
7514 |
|
</blockquote><p> |
7515 |
|
|
7516 |
|
</p> |
7517 |
|
<p>where <maps> will be replaced by the new number |
7518 |
|
of MIDI instrument maps. |
7519 |
|
</p> |
7520 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr /> |
7521 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7522 |
|
<a name="rfc.section.8.12"></a><h3>8.12. |
7523 |
|
MIDI instrument map information changed</h3> |
7524 |
|
|
7525 |
|
<p>Client may want to be notified when changes were made to MIDI instrument maps on the |
7526 |
|
back-end by issuing the following command: |
7527 |
|
</p> |
7528 |
|
<p> |
7529 |
|
</p> |
7530 |
|
<blockquote class="text"> |
7531 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO |
7532 |
|
</p> |
7533 |
|
</blockquote><p> |
7534 |
|
|
7535 |
|
</p> |
7536 |
|
<p>Server will start sending the following notification messages: |
7537 |
|
</p> |
7538 |
|
<p> |
7539 |
|
</p> |
7540 |
|
<blockquote class="text"> |
7541 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_MAP_INFO:<map-id>" |
7542 |
|
</p> |
7543 |
|
</blockquote><p> |
7544 |
|
|
7545 |
|
</p> |
7546 |
|
<p>where <map-id> will be replaced by the numerical ID of the MIDI instrument map, |
7547 |
|
for which information changes occurred. The front-end will have to send |
7548 |
|
the respective command to actually get the MIDI instrument map info. Because these messages |
7549 |
|
will be triggered by LSCP commands issued by other clients rather than real |
7550 |
|
time events happening on the server, it is believed that an empty notification |
7551 |
|
message is sufficient here. |
7552 |
|
</p> |
7553 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr /> |
7554 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7555 |
|
<a name="rfc.section.8.13"></a><h3>8.13. |
7556 |
|
Number of MIDI instruments changed</h3> |
7557 |
|
|
7558 |
|
<p>Client may want to be notified when the number of MIDI instrument maps on the |
7559 |
|
back-end changes by issuing the following command: |
7560 |
|
</p> |
7561 |
|
<p> |
7562 |
|
</p> |
7563 |
|
<blockquote class="text"> |
7564 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_COUNT |
7565 |
|
</p> |
7566 |
|
</blockquote><p> |
7567 |
|
|
7568 |
|
</p> |
7569 |
|
<p>Server will start sending the following notification messages: |
7570 |
|
</p> |
7571 |
|
<p> |
7572 |
|
</p> |
7573 |
|
<blockquote class="text"> |
7574 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_COUNT:<map-id> <instruments>" |
7575 |
|
</p> |
7576 |
|
</blockquote><p> |
7577 |
|
|
7578 |
|
</p> |
7579 |
|
<p>where <map-id> is the numerical ID of the MIDI instrument map, in which |
7580 |
|
the nuber of instruments has changed and <instruments> will be replaced by |
7581 |
|
the new number of MIDI instruments in the specified map. |
7582 |
|
</p> |
7583 |
|
<a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr /> |
7584 |
|
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7585 |
|
<a name="rfc.section.8.14"></a><h3>8.14. |
7586 |
|
MIDI instrument information changed</h3> |
7587 |
|
|
7588 |
|
<p>Client may want to be notified when changes were made to MIDI instruments on the |
7589 |
|
back-end by issuing the following command: |
7590 |
|
</p> |
7591 |
|
<p> |
7592 |
|
</p> |
7593 |
|
<blockquote class="text"> |
7594 |
|
<p>SUBSCRIBE MIDI_INSTRUMENT_INFO |
7595 |
|
</p> |
7596 |
|
</blockquote><p> |
7597 |
|
|
7598 |
|
</p> |
7599 |
|
<p>Server will start sending the following notification messages: |
7600 |
|
</p> |
7601 |
|
<p> |
7602 |
|
</p> |
7603 |
|
<blockquote class="text"> |
7604 |
|
<p>"NOTIFY:MIDI_INSTRUMENT_INFO:<map-id> <bank> <program>" |
7605 |
|
</p> |
7606 |
|
</blockquote><p> |
7607 |
|
|
7608 |
|
</p> |
7609 |
|
<p>where <map-id> will be replaced by the numerical ID of the MIDI instrument map, |
7610 |
|
in which a MIDI instrument is changed. <bank> and <program> specifies |
7611 |
|
the location of the changed MIDI instrument in the map. The front-end will have to send |
7612 |
|
the respective command to actually get the MIDI instrument info. Because these messages |
7613 |
|
will be triggered by LSCP commands issued by other clients rather than real |
7614 |
|
time events happening on the server, it is believed that an empty notification |
7615 |
|
message is sufficient here. |
7616 |
|
</p> |
7617 |
<a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr /> |
<a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr /> |
7618 |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table> |
7619 |
<a name="rfc.section.8.7"></a><h3>8.7. |
<a name="rfc.section.8.15"></a><h3>8.15. |
7620 |
Miscellaneous and debugging events</h3> |
Miscellaneous and debugging events</h3> |
7621 |
|
|
7622 |
<p>Client may want to be notified of miscellaneous and debugging events occurring at |
<p>Client may want to be notified of miscellaneous and debugging events occurring at |