/[svn]/web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html
ViewVC logotype

Diff of /web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 974 by schoenebeck, Fri Dec 15 21:46:48 2006 UTC revision 992 by iliev, Wed Dec 20 19:52:00 2006 UTC
# Line 145  Line 145 
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    
# Line 173  The list of current Internet-Drafts can Line 173  The list of current Internet-Drafts can
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>
# Line 370  Clear MIDI instrument map<br /> Line 370  Clear MIDI instrument map<br />
370  Command Syntax<br />  Command Syntax<br />
371  <a href="#events">8.</a>&nbsp;  <a href="#events">8.</a>&nbsp;
372  Events<br />  Events<br />
373  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL">8.1.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT">8.1.</a>&nbsp;
374    Number of audio output devices changed<br />
375    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_INFO">8.2.</a>&nbsp;
376    Audio output device's settings changed<br />
377    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_COUNT">8.3.</a>&nbsp;
378    Number of MIDI input devices changed<br />
379    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INPUT_DEVICE_INFO">8.4.</a>&nbsp;
380    MIDI input device's settings changed<br />
381    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;
382  Number of sampler channels changed<br />  Number of sampler channels changed<br />
383  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.2.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a>&nbsp;
384  Number of active voices changed<br />  Number of active voices changed<br />
385  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.3.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a>&nbsp;
386  Number of active disk streams changed<br />  Number of active disk streams changed<br />
387  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.4.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a>&nbsp;
388  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
389  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE INFO">8.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;
390  Channel information changed<br />  Channel information changed<br />
391  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.6.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.10.</a>&nbsp;
392  Total number of active voices changed<br />  Total number of active voices changed<br />
393  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.11.</a>&nbsp;
394    Number of MIDI instrument maps changed<br />
395    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.12.</a>&nbsp;
396    MIDI instrument map information changed<br />
397    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.13.</a>&nbsp;
398    Number of MIDI instruments changed<br />
399    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.14.</a>&nbsp;
400    MIDI instrument information changed<br />
401    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.15.</a>&nbsp;
402  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
403  <a href="#anchor14">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
404  Security Considerations<br />  Security Considerations<br />
# Line 6508  Command Syntax</h3> Line 6524  Command Syntax</h3>
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
# Line 6523  Command Syntax</h3> Line 6551  Command Syntax</h3>
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>
# Line 6535  Command Syntax</h3> Line 6575  Command Syntax</h3>
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
# Line 6550  Command Syntax</h3> Line 6602  Command Syntax</h3>
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>
# Line 7118  Events</h3> Line 7182  Events</h3>
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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7187  <a name="rfc.section.8.1"></a><h3>8.1.&nbsp;  <a name="rfc.section.8.1"></a><h3>8.1.&nbsp;
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:&lt;devices&gt;"
7207    </p>
7208    </blockquote><p>
7209                    
7210    </p>
7211    <p>where &lt;devices&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7216    <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;
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:&lt;device-id&gt;"
7236    </p>
7237    </blockquote><p>
7238                    
7239    </p>
7240    <p>where &lt;device-id&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7249    <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;
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:&lt;devices&gt;"
7269    </p>
7270    </blockquote><p>
7271                    
7272    </p>
7273    <p>where &lt;devices&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7278    <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;
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:&lt;device-id&gt;"
7298    </p>
7299    </blockquote><p>
7300                    
7301    </p>
7302    <p>where &lt;device-id&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7311    <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;
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
# Line 7149  Number of sampler channels changed</h3> Line 7337  Number of sampler channels changed</h3>
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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7340  <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
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
# Line 7179  Number of active voices changed</h3> Line 7367  Number of active voices changed</h3>
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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7370  <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
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
# Line 7209  Number of active disk streams changed</h Line 7397  Number of active disk streams changed</h
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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7400  <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;  <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
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
# Line 7238  Disk stream buffer fill state changed</h Line 7426  Disk stream buffer fill state changed</h
7426                  buffer fill data for this channel as described in <a class='info' href='#GET CHANNEL BUFFER_FILL'>Section&nbsp;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&nbsp;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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7431  <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;  <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
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
# Line 7273  Channel information changed</h3> Line 7461  Channel information changed</h3>
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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7464  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
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
# Line 7300  Total number of active voices changed</h Line 7488  Total number of active voices changed</h
7488  <p>where &lt;voices&gt; will be replaced by the new number of  <p>where &lt;voices&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7493    <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
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:&lt;maps&gt;"
7513    </p>
7514    </blockquote><p>
7515                    
7516    </p>
7517    <p>where &lt;maps&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7522    <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
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:&lt;map-id&gt;"
7542    </p>
7543    </blockquote><p>
7544                    
7545    </p>
7546    <p>where &lt;map-id&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7555    <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
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:&lt;map-id&gt; &lt;instruments&gt;"
7575    </p>
7576    </blockquote><p>
7577                    
7578    </p>
7579    <p>where &lt;map-id&gt; is the numerical ID of the MIDI instrument map, in which
7580                    the nuber of instruments has changed and &lt;instruments&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>
7585    <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
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:&lt;map-id&gt; &lt;bank&gt; &lt;program&gt;"
7605    </p>
7606    </blockquote><p>
7607                    
7608    </p>
7609    <p>where &lt;map-id&gt; will be replaced by the numerical ID of the MIDI instrument map,
7610                    in which a MIDI instrument is changed. &lt;bank&gt; and &lt;program&gt; 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">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
7619  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
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
Legend:
Removed from v.974  
changed lines
  Added in v.992
  ViewVC Help
Powered by ViewVC