/[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 1363 by schoenebeck, Sun Sep 30 21:51:14 2007 UTC revision 1773 by iliev, Wed Sep 10 15:14:31 2008 UTC
# Line 1  Line 1 
1  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2  <html lang="en"><head><title>LinuxSampler Control Protocol (draft)</title>  <html lang="en"><head><title>LinuxSampler Control Protocol</title>
3  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
4  <meta name="description" content="LinuxSampler Control Protocol (draft)">  <meta name="description" content="LinuxSampler Control Protocol">
5  <meta name="keywords" content="LSCP">  <meta name="keywords" content="LSCP">
6  <meta name="generator" content="xml2rfc v1.32 (http://xml.resource.org/)">  <meta name="generator" content="xml2rfc v1.32 (http://xml.resource.org/)">
7  <style type='text/css'><!--  <style type='text/css'><!--
# 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: March 4, 2008</td><td class="header">September 2007</td></tr>  <tr><td class="header">Expires: March 14, 2009</td><td class="header">September 10, 2008</td></tr>
149  </table></td></tr></table>  </table></td></tr></table>
150  <h1><br />LinuxSampler Control Protocol (draft)<br />LSCP 1.2cvs</h1>  <h1><br />LinuxSampler Control Protocol<br />LSCP 1.4</h1>
151    
152  <h3>Status of this Memo</h3>  <h3>Status of this Memo</h3>
153  <p>  <p>
# 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 March 4, 2008.</p>  This Internet-Draft will expire on March 14, 2009.</p>
177    
178  <h3>Copyright Notice</h3>  <h3>Copyright Notice</h3>
179  <p>  <p>
180  Copyright &copy; The IETF Trust (2007).</p>  Copyright &copy; The IETF Trust (2008).</p>
181    
182  <h3>Abstract</h3>  <h3>Abstract</h3>
183    
# Line 336  Altering effect send's audio routing<br Line 336  Altering effect send's audio routing<br
336  Altering effect send's MIDI controller<br />  Altering effect send's MIDI controller<br />
337  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND LEVEL">6.4.33.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND LEVEL">6.4.33.</a>&nbsp;
338  Altering effect send's send level<br />  Altering effect send's send level<br />
339  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.34.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SEND CHANNEL MIDI_DATA">6.4.34.</a>&nbsp;
340    Sending MIDI messages to sampler channel<br />
341    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.35.</a>&nbsp;
342  Resetting a sampler channel<br />  Resetting a sampler channel<br />
343  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
344  Controlling connection<br />  Controlling connection<br />
# Line 354  Global commands<br /> Line 356  Global commands<br />
356  Current number of active voices<br />  Current number of active voices<br />
357  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a>&nbsp;
358  Maximum amount of active voices<br />  Maximum amount of active voices<br />
359  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.3.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_STREAM_COUNT">6.6.3.</a>&nbsp;
360    Current number of active disk streams<br />
361    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.4.</a>&nbsp;
362  Reset sampler<br />  Reset sampler<br />
363  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.4.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.5.</a>&nbsp;
364  General sampler informations<br />  General sampler informations<br />
365  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOLUME">6.6.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOLUME">6.6.6.</a>&nbsp;
366  Getting global volume attenuation<br />  Getting global volume attenuation<br />
367  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOLUME">6.6.6.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOLUME">6.6.7.</a>&nbsp;
368  Setting global volume attenuation<br />  Setting global volume attenuation<br />
369  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#MIDI Instrument Mapping">6.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#MIDI Instrument Mapping">6.7.</a>&nbsp;
370  MIDI Instrument Mapping<br />  MIDI Instrument Mapping<br />
371  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD MIDI_INSTRUMENT MAP">6.7.1.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD MIDI_INSTRUMENT_MAP">6.7.1.</a>&nbsp;
372  Create a new MIDI instrument map<br />  Create a new MIDI instrument map<br />
373  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a>&nbsp;
374  Delete one particular or all MIDI instrument maps<br />  Delete one particular or all MIDI instrument maps<br />
# Line 434  Finding instruments<br /> Line 438  Finding instruments<br />
438  Getting job status information<br />  Getting job status information<br />
439  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FORMAT INSTRUMENTS_DB">6.8.22.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FORMAT INSTRUMENTS_DB">6.8.22.</a>&nbsp;
440  Formatting the instruments database<br />  Formatting the instruments database<br />
441    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FIND LOST DB_INSTRUMENT_FILES">6.8.23.</a>&nbsp;
442    Checking for lost instrument files<br />
443    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET DB_INSTRUMENT FILE_PATH">6.8.24.</a>&nbsp;
444    Replacing an instrument file<br />
445  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#editing_instruments">6.9.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#editing_instruments">6.9.</a>&nbsp;
446  Editing Instruments<br />  Editing Instruments<br />
447  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#EDIT INSTRUMENT">6.9.1.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#EDIT INSTRUMENT">6.9.1.</a>&nbsp;
448  Opening an appropriate instrument editor application<br />  Opening an appropriate instrument editor application<br />
449    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#file_management">6.10.</a>&nbsp;
450    Managing Files<br />
451    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FILE INSTRUMENTS">6.10.1.</a>&nbsp;
452    Retrieving amount of instruments of a file<br />
453    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST FILE INSTRUMENTS">6.10.2.</a>&nbsp;
454    Retrieving all instruments of a file<br />
455    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FILE INSTRUMENT INFO">6.10.3.</a>&nbsp;
456    Retrieving informations about one instrument in a file<br />
457  <a href="#command_syntax">7.</a>&nbsp;  <a href="#command_syntax">7.</a>&nbsp;
458  Command Syntax<br />  Command Syntax<br />
459  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#character_set">7.1.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#character_set">7.1.</a>&nbsp;
# Line 454  Number of MIDI input devices changed<br Line 470  Number of MIDI input devices changed<br
470  MIDI input device's settings changed<br />  MIDI input device's settings changed<br />
471  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;
472  Number of sampler channels changed<br />  Number of sampler channels changed<br />
473  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_MIDI">8.6.</a>&nbsp;
474    MIDI data on a sampler channel arrived<br />
475    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DEVICE_MIDI">8.7.</a>&nbsp;
476    MIDI data on a MIDI input device arrived<br />
477    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.8.</a>&nbsp;
478  Number of active voices changed<br />  Number of active voices changed<br />
479  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.9.</a>&nbsp;
480  Number of active disk streams changed<br />  Number of active disk streams changed<br />
481  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.10.</a>&nbsp;
482  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
483  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.11.</a>&nbsp;
484  Channel information changed<br />  Channel information changed<br />
485  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.10.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.12.</a>&nbsp;
486  Number of effect sends changed<br />  Number of effect sends changed<br />
487  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.11.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.13.</a>&nbsp;
488  Effect send information changed<br />  Effect send information changed<br />
489  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.12.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.14.</a>&nbsp;
490  Total number of active voices changed<br />  Total number of active voices changed<br />
491  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.13.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_STREAM_COUNT">8.15.</a>&nbsp;
492    Total number of active disk streams changed<br />
493    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.16.</a>&nbsp;
494  Number of MIDI instrument maps changed<br />  Number of MIDI instrument maps changed<br />
495  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.14.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.17.</a>&nbsp;
496  MIDI instrument map information changed<br />  MIDI instrument map information changed<br />
497  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.15.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.18.</a>&nbsp;
498  Number of MIDI instruments changed<br />  Number of MIDI instruments changed<br />
499  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.16.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.19.</a>&nbsp;
500  MIDI instrument information changed<br />  MIDI instrument information changed<br />
501  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.17.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.20.</a>&nbsp;
502  Global settings changed<br />  Global settings changed<br />
503  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.18.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.21.</a>&nbsp;
504  Number of database instrument directories changed<br />  Number of database instrument directories changed<br />
505  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.19.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.22.</a>&nbsp;
506  Database instrument directory information changed<br />  Database instrument directory information changed<br />
507  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.20.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.23.</a>&nbsp;
508  Number of database instruments changed<br />  Number of database instruments changed<br />
509  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.21.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.24.</a>&nbsp;
510  Database instrument information changed<br />  Database instrument information changed<br />
511  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.22.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.25.</a>&nbsp;
512  Database job status information changed<br />  Database job status information changed<br />
513  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.23.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.26.</a>&nbsp;
514  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
515  <a href="#anchor14">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
516  Security Considerations<br />  Security Considerations<br />
# Line 3449  Loading an instrument</h3> Line 3471  Loading an instrument</h3>
3471  </blockquote><p>  </blockquote><p>
3472                                            
3473  </p>  </p>
3474  <p>Example:  <p>Example (Unix):
3475  </p>  </p>
3476  <p>  <p>
3477                          </p>                          </p>
3478  <blockquote class="text">  <blockquote class="text">
3479    <p>C: LOAD INSTRUMENT '/home/joe/gigs/cello.gig' 0 0
3480    </p>
3481    <p>S: OK
3482    </p>
3483    </blockquote><p>
3484                        
3485    </p>
3486    <p>Example (Windows):
3487    </p>
3488  <p>  <p>
3489                            </p>
3490    <blockquote class="text">
3491    <p>C: LOAD INSTRUMENT 'D:/MySounds/cello.gig' 0 0
3492    </p>
3493    <p>S: OK
3494  </p>  </p>
3495  </blockquote><p>  </blockquote><p>
3496                                            
# Line 3869  Getting information about an engine</h3> Line 3905  Getting information about an engine</h3>
3905                                          </p>                                          </p>
3906  <blockquote class="text">  <blockquote class="text">
3907  <p>arbitrary description text about the engine  <p>arbitrary description text about the engine
3908                                                (note that the character string may contain
3909                                                <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
3910  </p>  </p>
3911  </blockquote>  </blockquote>
3912                                                                            
# Line 3988  Getting sampler channel information</h3> Line 4026  Getting sampler channel information</h3>
4026  <blockquote class="text">  <blockquote class="text">
4027  <p>the file name of the loaded instrument, "NONE" if  <p>the file name of the loaded instrument, "NONE" if
4028                                              there's no instrument yet loaded for this sampler                                              there's no instrument yet loaded for this sampler
4029                                              channel                                              channel (note: since LSCP 1.2 this path may contain
4030                                                <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
4031  </p>  </p>
4032  </blockquote>  </blockquote>
4033                                                                            
# Line 4005  Getting sampler channel information</h3> Line 4044  Getting sampler channel information</h3>
4044                                          </p>                                          </p>
4045  <blockquote class="text">  <blockquote class="text">
4046  <p>the instrument name of the loaded instrument  <p>the instrument name of the loaded instrument
4047                                                (note: since LSCP 1.2 this character string may contain
4048                                                <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
4049  </p>  </p>
4050  </blockquote>  </blockquote>
4051                                                                            
# Line 5080  Adding an effect send to a sampler chann Line 5121  Adding an effect send to a sampler chann
5121                      sampler channel on which the effect send should be created on, &lt;midi-ctrl&gt;                      sampler channel on which the effect send should be created on, &lt;midi-ctrl&gt;
5122                      is a number between 0..127 defining the MIDI controller which can alter the                      is a number between 0..127 defining the MIDI controller which can alter the
5123                      effect send level and &lt;name&gt; is an optional argument defining a name                      effect send level and &lt;name&gt; is an optional argument defining a name
5124                      for the effect send entity. The name does not have to be unique.                      for the effect send entity. The name does not have to be unique, but MUST be
5125                        encapsulated into apostrophes and supports escape sequences as described in chapter
5126                        "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>".
5127  </p>  </p>
5128  <p>By default, that is as initial routing, the effect send's audio channels  <p>By default, that is as initial routing, the effect send's audio channels
5129                      are automatically routed to the last audio channels of the sampler channel's                      are automatically routed to the last audio channels of the sampler channel's
# Line 5349  Getting effect send information</h3> Line 5392  Getting effect send information</h3>
5392                                          </p>                                          </p>
5393  <blockquote class="text">  <blockquote class="text">
5394  <p>name of the effect send entity  <p>name of the effect send entity
5395                                                (note that this character string may contain
5396                                                 <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
5397  </p>  </p>
5398  </blockquote>  </blockquote>
5399                                                                            
# Line 5439  Changing effect send's name</h3> Line 5484  Changing effect send's name</h3>
5484                      as returned by the <a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>                      as returned by the <a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
5485                      or <a class='info' href='#LIST FX_SENDS'>"LIST FX_SENDS"<span> (</span><span class='info'>Listing all effect sends on a sampler channel</span><span>)</span></a> command and                      or <a class='info' href='#LIST FX_SENDS'>"LIST FX_SENDS"<span> (</span><span class='info'>Listing all effect sends on a sampler channel</span><span>)</span></a> command and
5486                      &lt;name&gt; is the new name of the effect send entity, which                      &lt;name&gt; is the new name of the effect send entity, which
5487                      does not have to be unique.                      does not have to be unique (name MUST be encapsulated into apostrophes
5488                        and supports escape sequences as described in chapter
5489                        "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
5490                        
5491  </p>  </p>
5492  <p>Possible Answers:  <p>Possible Answers:
5493  </p>  </p>
# Line 5703  Altering effect send's send level</h3> Line 5751  Altering effect send's send level</h3>
5751  </blockquote><p>  </blockquote><p>
5752                                            
5753  </p>  </p>
5754  <a name="RESET CHANNEL"></a><br /><hr />  <a name="SEND CHANNEL MIDI_DATA"></a><br /><hr />
5755  <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>
5756  <a name="rfc.section.6.4.34"></a><h3>6.4.34.&nbsp;  <a name="rfc.section.6.4.34"></a><h3>6.4.34.&nbsp;
5757    Sending MIDI messages to sampler channel</h3>
5758    
5759    <p>The front-end can send MIDI events to specific sampler channel
5760                        by sending the following command:
5761    </p>
5762    <p>
5763                            </p>
5764    <blockquote class="text">
5765    <p>SEND CHANNEL MIDI_DATA &lt;midi-msg&gt; &lt;sampler-chan&gt; &lt;arg1&gt; &lt;arg2&gt;
5766    </p>
5767    </blockquote><p>
5768                        
5769    </p>
5770    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5771                        as returned by the <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a>
5772                        or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command,
5773                        &lt;arg1&gt; and &lt;arg2&gt; arguments depend on the &lt;midi-msg&gt; argument, which
5774                        specifies the MIDI message type. Currently, the following MIDI messages are supported:
5775    </p>
5776    <p>
5777                            </p>
5778    <blockquote class="text">
5779    <p>"NOTE_ON" -
5780                                    </p>
5781    <blockquote class="text">
5782    <p>For turning on MIDI notes, where &lt;arg1&gt;
5783                                        specifies the key number and &lt;arg2&gt; the velocity
5784                                        as described in the MIDI specification.
5785    </p>
5786    </blockquote>
5787                                
5788    
5789    <p>"NOTE_OFF" -
5790                                    </p>
5791    <blockquote class="text">
5792    <p>For turning a currently playing MIDI note off, where &lt;arg1&gt;
5793                                        specifies the key number and &lt;arg2&gt; the velocity
5794                                        as described in the MIDI specification.
5795    </p>
5796    </blockquote>
5797                                
5798    
5799    </blockquote><p>
5800                        
5801    </p>
5802    <p>CAUTION: This command is provided for implementations of virtual MIDI keyboards
5803                        and no realtime guarantee whatsoever will be made!
5804    </p>
5805    <p>Possible Answers:
5806    </p>
5807    <p>
5808                            </p>
5809    <blockquote class="text">
5810    <p>"OK" -
5811                                    </p>
5812    <blockquote class="text">
5813    <p>on success
5814    </p>
5815    </blockquote>
5816                                
5817    
5818    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5819                                    </p>
5820    <blockquote class="text">
5821    <p>in case it failed, providing an appropriate error code and error message
5822    </p>
5823    </blockquote>
5824                                
5825    
5826    </blockquote><p>
5827                        
5828    </p>
5829    <p>Example:
5830    </p>
5831    <p>
5832                            </p>
5833    <blockquote class="text">
5834    <p>C: "SEND CHANNEL MIDI_DATA NOTE_ON 0 56 112"
5835    </p>
5836    <p>S: "OK"
5837    </p>
5838    </blockquote><p>
5839                        
5840    </p>
5841    <a name="RESET CHANNEL"></a><br /><hr />
5842    <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>
5843    <a name="rfc.section.6.4.35"></a><h3>6.4.35.&nbsp;
5844  Resetting a sampler channel</h3>  Resetting a sampler channel</h3>
5845    
5846  <p>The front-end can reset a particular sampler channel by sending the following command:  <p>The front-end can reset a particular sampler channel by sending the following command:
# Line 6040  Maximum amount of active voices</h3> Line 6175  Maximum amount of active voices</h3>
6175  </blockquote><p>  </blockquote><p>
6176                                            
6177  </p>  </p>
6178  <a name="RESET"></a><br /><hr />  <a name="GET TOTAL_STREAM_COUNT"></a><br /><hr />
6179  <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>
6180  <a name="rfc.section.6.6.3"></a><h3>6.6.3.&nbsp;  <a name="rfc.section.6.6.3"></a><h3>6.6.3.&nbsp;
6181    Current number of active disk streams</h3>
6182    
6183    <p>The front-end can ask for the current number of active disk streams on
6184                        the sampler by sending the following command:
6185    </p>
6186    <p>
6187                            </p>
6188    <blockquote class="text">
6189    <p>GET TOTAL_STREAM_COUNT
6190    </p>
6191    </blockquote><p>
6192                        
6193    </p>
6194    <p>Possible Answers:
6195    </p>
6196    <p>
6197                            </p>
6198    <blockquote class="text">
6199    <p>LinuxSampler will answer by returning the number of all active
6200                                disk streams on the sampler.
6201    </p>
6202    </blockquote><p>
6203                        
6204    </p>
6205    <a name="RESET"></a><br /><hr />
6206    <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>
6207    <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;
6208  Reset sampler</h3>  Reset sampler</h3>
6209    
6210  <p>The front-end can reset the whole sampler by sending the following command:  <p>The front-end can reset the whole sampler by sending the following command:
# Line 6083  Reset sampler</h3> Line 6245  Reset sampler</h3>
6245  </p>  </p>
6246  <a name="GET SERVER INFO"></a><br /><hr />  <a name="GET SERVER INFO"></a><br /><hr />
6247  <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>
6248  <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;  <a name="rfc.section.6.6.5"></a><h3>6.6.5.&nbsp;
6249  General sampler informations</h3>  General sampler informations</h3>
6250    
6251  <p>The client can ask for general informations about the LinuxSampler  <p>The client can ask for general informations about the LinuxSampler
# Line 6116  General sampler informations</h3> Line 6278  General sampler informations</h3>
6278                                          </p>                                          </p>
6279  <blockquote class="text">  <blockquote class="text">
6280  <p>arbitrary textual description about the sampler  <p>arbitrary textual description about the sampler
6281                                                (note that the character string may contain
6282                                                <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
6283  </p>  </p>
6284  </blockquote>  </blockquote>
6285                                                                            
# Line 6157  General sampler informations</h3> Line 6321  General sampler informations</h3>
6321  </p>  </p>
6322  <a name="GET VOLUME"></a><br /><hr />  <a name="GET VOLUME"></a><br /><hr />
6323  <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>
6324  <a name="rfc.section.6.6.5"></a><h3>6.6.5.&nbsp;  <a name="rfc.section.6.6.6"></a><h3>6.6.6.&nbsp;
6325  Getting global volume attenuation</h3>  Getting global volume attenuation</h3>
6326    
6327  <p>The client can ask for the current global sampler-wide volume  <p>The client can ask for the current global sampler-wide volume
# Line 6190  Getting global volume attenuation</h3> Line 6354  Getting global volume attenuation</h3>
6354  </p>  </p>
6355  <a name="SET VOLUME"></a><br /><hr />  <a name="SET VOLUME"></a><br /><hr />
6356  <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>
6357  <a name="rfc.section.6.6.6"></a><h3>6.6.6.&nbsp;  <a name="rfc.section.6.6.7"></a><h3>6.6.7.&nbsp;
6358  Setting global volume attenuation</h3>  Setting global volume attenuation</h3>
6359    
6360  <p>The client can alter the current global sampler-wide volume  <p>The client can alter the current global sampler-wide volume
# Line 6277  MIDI Instrument Mapping</h3> Line 6441  MIDI Instrument Mapping</h3>
6441                  cause the sampler to switch to the respective instrument as                  cause the sampler to switch to the respective instrument as
6442                  reflected by the current MIDI instrument map.                  reflected by the current MIDI instrument map.
6443  </p>  </p>
6444  <a name="ADD MIDI_INSTRUMENT MAP"></a><br /><hr />  <a name="ADD MIDI_INSTRUMENT_MAP"></a><br /><hr />
6445  <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>
6446  <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;  <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;
6447  Create a new MIDI instrument map</h3>  Create a new MIDI instrument map</h3>
# Line 6295  Create a new MIDI instrument map</h3> Line 6459  Create a new MIDI instrument map</h3>
6459  </p>  </p>
6460  <p>Where &lt;name&gt; is an optional argument allowing to  <p>Where &lt;name&gt; is an optional argument allowing to
6461                      assign a custom name to the new map. MIDI instrument Map                      assign a custom name to the new map. MIDI instrument Map
6462                      names do not have to be unique.                      names do not have to be unique, but MUST be encapsulated
6463                        into apostrophes and support escape sequences as described
6464                        in chapter "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>".
6465                        
6466  </p>  </p>
6467  <p>Possible Answers:  <p>Possible Answers:
6468  </p>  </p>
# Line 6553  Getting MIDI instrument map information< Line 6720  Getting MIDI instrument map information<
6720  <blockquote class="text">  <blockquote class="text">
6721  <p>custom name of the given map,  <p>custom name of the given map,
6722                                              which does not have to be unique                                              which does not have to be unique
6723                                                (note that this character string may contain
6724                                                 <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
6725  </p>  </p>
6726  </blockquote>  </blockquote>
6727                                                                            
# Line 6608  Renaming a MIDI instrument map</h3> Line 6777  Renaming a MIDI instrument map</h3>
6777  </p>  </p>
6778  <p>Where &lt;map&gt; is the numerical ID of the map and  <p>Where &lt;map&gt; is the numerical ID of the map and
6779                      &lt;name&gt; the new custom name of the map, which does not                      &lt;name&gt; the new custom name of the map, which does not
6780                      have to be unique.                      have to be unique (name MUST be encapsulated into apostrophes
6781                        and supports escape sequences as described in chapter
6782                        "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
6783                        
6784  </p>  </p>
6785  <p>Possible Answers:  <p>Possible Answers:
6786  </p>  </p>
# Line 6773  Create or replace a MIDI instrument map Line 6945  Create or replace a MIDI instrument map
6945                      load modes of entries, the frontend should retrieve the actual                      load modes of entries, the frontend should retrieve the actual
6946                      mode by i.e. sending                      mode by i.e. sending
6947                      <a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>                      <a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>
6948                      command(s). Finally the OPTIONAL &lt;name&gt; argument allows to                      command(s). Finally the OPTIONAL &lt;name&gt; argument allows to set a custom name
6949                      set a custom name (encapsulated into apostrophes) for the mapping                      (encapsulated into apostrophes, supporting escape sequences as described in chapter
6950                      entry, useful for frontends for displaying an appropriate name for                      "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>") for the
6951                        mapping entry, useful for frontends for displaying an appropriate name for
6952                      mapped instruments (using                      mapped instruments (using
6953                      <a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>).                      <a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>).
6954                                            
# Line 7097  Get current settings of MIDI instrument Line 7270  Get current settings of MIDI instrument
7270                                      changed with the                                      changed with the
7271                                      <a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>                                      <a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>
7272                                      command and does not have to be unique.                                      command and does not have to be unique.
7273                                        (note that this character string may contain
7274                                        <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
7275  </p>  </p>
7276  </blockquote>  </blockquote>
7277                                                            
# Line 7113  Get current settings of MIDI instrument Line 7288  Get current settings of MIDI instrument
7288  <p>"INSTRUMENT_FILE" -  <p>"INSTRUMENT_FILE" -
7289                                  </p>                                  </p>
7290  <blockquote class="text">  <blockquote class="text">
7291  <p>File name of the instrument.  <p>File name of the instrument
7292                                        (note that this path may contain
7293                                        <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>).
7294  </p>  </p>
7295  </blockquote>  </blockquote>
7296                                                            
# Line 7131  Get current settings of MIDI instrument Line 7308  Get current settings of MIDI instrument
7308  <blockquote class="text">  <blockquote class="text">
7309  <p>Name of the loaded instrument as reflected by its file.  <p>Name of the loaded instrument as reflected by its file.
7310                                      In contrast to the "NAME" field, the "INSTRUMENT_NAME" field                                      In contrast to the "NAME" field, the "INSTRUMENT_NAME" field
7311                                      cannot be changed.                                      cannot be changed (note that this character string may contain
7312                                        <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>).
7313  </p>  </p>
7314  </blockquote>  </blockquote>
7315                                                            
# Line 8637  Changing the description of instrument</ Line 8815  Changing the description of instrument</
8815                                            
8816  </p>  </p>
8817  <p>Where &lt;instr&gt; is the absolute path name of the instrument and  <p>Where &lt;instr&gt; is the absolute path name of the instrument and
8818                      &lt;desc&gt; is the new description for the instrument                      &lt;desc&gt; is the new description for the instrument
8819                      (encapsulated into apostrophes, supporting escape sequences as described in chapter                      (encapsulated into apostrophes, supporting escape sequences as described in chapter
8820                      "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").                      "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
8821  </p>  </p>
# Line 9019  Formatting the instruments database</h3> Line 9197  Formatting the instruments database</h3>
9197  </blockquote><p>  </blockquote><p>
9198                                            
9199  </p>  </p>
9200    <a name="FIND LOST DB_INSTRUMENT_FILES"></a><br /><hr />
9201    <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>
9202    <a name="rfc.section.6.8.23"></a><h3>6.8.23.&nbsp;
9203    Checking for lost instrument files</h3>
9204    
9205    <p>The front-end can retrieve the list of all instrument files in the instruments database
9206                        that don't exist in the filesystem by sending the following command:
9207    </p>
9208    <p>
9209                            </p>
9210    <blockquote class="text">
9211    <p>FIND LOST DB_INSTRUMENT_FILES
9212    </p>
9213    </blockquote><p>
9214                        
9215    </p>
9216    <p>Possible Answers:
9217    </p>
9218    <p>
9219                            </p>
9220    <blockquote class="text">
9221    <p>A comma separated list with the absolute path names
9222                                (encapsulated into apostrophes) of all lost instrument files.
9223    </p>
9224    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
9225                                    </p>
9226    <blockquote class="text">
9227    <p>in case it failed, providing an appropriate error code and error message.
9228    </p>
9229    </blockquote>
9230                                
9231    
9232    </blockquote><p>
9233                        
9234    </p>
9235    <p>Example:
9236    </p>
9237    <p>
9238                            </p>
9239    <blockquote class="text">
9240    <p>C: "FIND LOST DB_INSTRUMENT_FILES"
9241    </p>
9242    <p>S: "'/gigs/Bosendorfer 290.gig','/gigs/Steinway D.gig','/gigs/Free Piano.gig'"
9243    </p>
9244    </blockquote><p>
9245                        
9246    </p>
9247    <a name="SET DB_INSTRUMENT FILE_PATH"></a><br /><hr />
9248    <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>
9249    <a name="rfc.section.6.8.24"></a><h3>6.8.24.&nbsp;
9250    Replacing an instrument file</h3>
9251    
9252    <p>The front-end can substitute all occurrences of an instrument file
9253                        in the instruments database with a new one by sending the following command:
9254    </p>
9255    <p>
9256                            </p>
9257    <blockquote class="text">
9258    <p>SET DB_INSTRUMENT FILE_PATH &lt;old_path&gt; &lt;new_path&gt;
9259    </p>
9260    </blockquote><p>
9261                        
9262    </p>
9263    <p>Where &lt;old_path&gt; is the absolute path name of the instrument file
9264                        to substitute with &lt;new_path&gt;.
9265    </p>
9266    <p>Possible Answers:
9267    </p>
9268    <p>
9269                            </p>
9270    <blockquote class="text">
9271    <p>"OK" -
9272                                    </p>
9273    <blockquote class="text">
9274    <p>on success
9275    </p>
9276    </blockquote>
9277                                
9278    
9279    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
9280                                    </p>
9281    <blockquote class="text">
9282    <p>in case it failed, providing an appropriate error code and error message.
9283    </p>
9284    </blockquote>
9285                                
9286    
9287    </blockquote><p>
9288                        
9289    </p>
9290    <p>Example:
9291    </p>
9292    <p>
9293                            </p>
9294    <blockquote class="text">
9295    <p>C: "SET DB_INSTRUMENT FILE_PATH '/gigs/Bosendorfer 290.gig' '/gigs/pianos/Bosendorfer 290.gig'"
9296    </p>
9297    <p>S: "OK"
9298    </p>
9299    </blockquote><p>
9300                        
9301    </p>
9302  <a name="editing_instruments"></a><br /><hr />  <a name="editing_instruments"></a><br /><hr />
9303  <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>
9304  <a name="rfc.section.6.9"></a><h3>6.9.&nbsp;  <a name="rfc.section.6.9"></a><h3>6.9.&nbsp;
# Line 9046  Opening an appropriate instrument editor Line 9326  Opening an appropriate instrument editor
9326  <p>  <p>
9327                          </p>                          </p>
9328  <blockquote class="text">  <blockquote class="text">
9329  <p>EDIT INSTRUMENT &lt;sampler-channel&gt;  <p>EDIT CHANNEL INSTRUMENT &lt;sampler-channel&gt;
9330  </p>  </p>
9331  </blockquote><p>  </blockquote><p>
9332                                            
# Line 9113  Opening an appropriate instrument editor Line 9393  Opening an appropriate instrument editor
9393  <p>  <p>
9394                          </p>                          </p>
9395  <blockquote class="text">  <blockquote class="text">
9396  <p>C: "EDIT INSTRUMENT 0"  <p>C: "EDIT CHANNEL INSTRUMENT 0"
9397  </p>  </p>
9398  <p>S: "OK"  <p>S: "OK"
9399  </p>  </p>
9400  </blockquote><p>  </blockquote><p>
9401                                            
9402  </p>  </p>
9403    <a name="file_management"></a><br /><hr />
9404    <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>
9405    <a name="rfc.section.6.10"></a><h3>6.10.&nbsp;
9406    Managing Files</h3>
9407    
9408    <p>You can query detailed informations about files located
9409                    at the same system where the sampler instance is running on.
9410                    Using this command set allows to retrieve file informations
9411                    even remotely from another machine.
9412    </p>
9413    <a name="GET FILE INSTRUMENTS"></a><br /><hr />
9414    <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>
9415    <a name="rfc.section.6.10.1"></a><h3>6.10.1.&nbsp;
9416    Retrieving amount of instruments of a file</h3>
9417    
9418    <p>The front-end can retrieve the amount of instruments
9419                        within a given instrument file by sending the
9420                        following command:
9421    </p>
9422    <p>
9423                            </p>
9424    <blockquote class="text">
9425    <p>GET FILE INSTRUMENTS &lt;filename&gt;
9426    </p>
9427    </blockquote><p>
9428                        
9429    </p>
9430    <p>Where &lt;filename&gt; is the name of the instrument
9431                        file (encapsulated into apostrophes, supporting escape
9432                        sequences as described in chapter
9433                        "<a class='info' href='#character_set'>Character Set and Escape
9434                            Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
9435    </p>
9436    <p>The sampler will try to ask all sampler engines,
9437                        whether they support the given file and ask the first
9438                        engine with a positive answer for the amount of
9439                        instruments.
9440    </p>
9441    <p>Possible Answers:
9442    </p>
9443    <p>
9444                            </p>
9445    <blockquote class="text">
9446    <p>On success, the sampler will answer by
9447                                   returning the amount of instruments.
9448                                
9449    </p>
9450    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
9451                                    </p>
9452    <blockquote class="text">
9453    <p>if the file could not be handled
9454    </p>
9455    </blockquote>
9456                                
9457    
9458    </blockquote><p>
9459                        
9460    </p>
9461    <p>Examples:
9462    </p>
9463    <p>
9464                            </p>
9465    <blockquote class="text">
9466    <p>C: "GET FILE INSTRUMENTS 'D:/Sounds/Foo.gig'"
9467    </p>
9468    <p>S: "10"
9469    </p>
9470    </blockquote><p>
9471                        
9472    </p>
9473    <a name="LIST FILE INSTRUMENTS"></a><br /><hr />
9474    <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>
9475    <a name="rfc.section.6.10.2"></a><h3>6.10.2.&nbsp;
9476    Retrieving all instruments of a file</h3>
9477    
9478    <p>The front-end can retrieve a list of all instruments
9479                        within a given instrument file by sending the
9480                        following command:
9481    </p>
9482    <p>
9483                            </p>
9484    <blockquote class="text">
9485    <p>LIST FILE INSTRUMENTS &lt;filename&gt;
9486    </p>
9487    </blockquote><p>
9488                        
9489    </p>
9490    <p>Where &lt;filename&gt; is the name of the instrument
9491                        file (encapsulated into apostrophes, supporting escape
9492                        sequences as described in chapter
9493                        "<a class='info' href='#character_set'>Character Set and Escape
9494                            Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
9495    </p>
9496    <p>The sampler will try to ask all sampler engines,
9497                        whether they support the given file and ask the first
9498                        engine with a positive answer for a list of IDs for the
9499                        instruments in the given file.
9500    </p>
9501    <p>Possible Answers:
9502    </p>
9503    <p>
9504                            </p>
9505    <blockquote class="text">
9506    <p>On success, the sampler will answer by
9507                                   returning a comma separated list of
9508                                   instrument IDs.
9509                                
9510    </p>
9511    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
9512                                    </p>
9513    <blockquote class="text">
9514    <p>if the file could not be handled
9515    </p>
9516    </blockquote>
9517                                
9518    
9519    </blockquote><p>
9520                        
9521    </p>
9522    <p>Examples:
9523    </p>
9524    <p>
9525                            </p>
9526    <blockquote class="text">
9527    <p>C: "LIST FILE INSTRUMENTS 'D:/Sounds/Foo.gig'"
9528    </p>
9529    <p>S: "0,1,2,3,4,5,6,7,8,9"
9530    </p>
9531    </blockquote><p>
9532                        
9533    </p>
9534    <a name="GET FILE INSTRUMENT INFO"></a><br /><hr />
9535    <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>
9536    <a name="rfc.section.6.10.3"></a><h3>6.10.3.&nbsp;
9537    Retrieving informations about one instrument in a file</h3>
9538    
9539    <p>The front-end can retrieve detailed informations
9540                        about a specific instrument within a given instrument
9541                        file by sending the following command:
9542    </p>
9543    <p>
9544                            </p>
9545    <blockquote class="text">
9546    <p>GET FILE INSTRUMENT INFO &lt;filename&gt;
9547                                &lt;instr-id&gt;
9548    </p>
9549    </blockquote><p>
9550                        
9551    </p>
9552    <p>Where &lt;filename&gt; is the name of the instrument
9553                        file (encapsulated into apostrophes, supporting escape
9554                        sequences as described in chapter
9555                        "<a class='info' href='#character_set'>Character Set and Escape
9556                            Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>") and &lt;instr-id&gt; is the numeric
9557                        instrument ID as returned by the
9558                        <a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a> command.
9559    </p>
9560    <p>The sampler will try to ask all sampler engines,
9561                        whether they support the given file and ask the first
9562                        engine with a positive answer for informations about the
9563                        specific instrument in the given file.
9564    </p>
9565    <p>Possible Answers:
9566    </p>
9567    <p>
9568                            </p>
9569    <blockquote class="text">
9570    <p>LinuxSampler will answer by sending a &lt;CRLF&gt; separated list.
9571                                Each answer line begins with the settings category name
9572                                followed by a colon and then a space character &lt;SP&gt; and finally
9573                                the info character string to that setting category. At the
9574                                moment the following categories are defined:
9575    </p>
9576    <p>
9577                                    </p>
9578    <blockquote class="text">
9579    <p>NAME -
9580                                            </p>
9581    <blockquote class="text">
9582    <p>name of the instrument as
9583                                                stored in the instrument file
9584    </p>
9585    </blockquote>
9586                                        
9587    
9588    <p>FORMAT_FAMILY -
9589                                            </p>
9590    <blockquote class="text">
9591    <p>name of the sampler format
9592                                                of the given instrument
9593    </p>
9594    </blockquote>
9595                                        
9596    
9597    <p>FORMAT_VERSION -
9598                                            </p>
9599    <blockquote class="text">
9600    <p>version of the sampler format
9601                                                the instrumen is stored as
9602    </p>
9603    </blockquote>
9604                                        
9605    
9606    <p>PRODUCT -
9607                                            </p>
9608    <blockquote class="text">
9609    <p>official product name of the
9610                                                instrument as stored in the file
9611                                                
9612    </p>
9613    </blockquote>
9614                                        
9615    
9616    <p>ARTISTS -
9617                                            </p>
9618    <blockquote class="text">
9619    <p>artists / sample library
9620                                                vendor of the instrument
9621    </p>
9622    </blockquote>
9623                                        
9624    
9625    <p>KEY_BINDINGS -
9626                                            </p>
9627    <blockquote class="text">
9628    <p>comma separated list of integer values representing
9629                                                   the instrument's key mapping in the range between 0 .. 127,
9630                                                   reflecting the analog meaning of the MIDI specification.
9631    </p>
9632    </blockquote>
9633                                        
9634    
9635    <p>KEYSWITCH_BINDINGS -
9636                                            </p>
9637    <blockquote class="text">
9638    <p>comma separated list of integer values representing
9639                                                   the instrument's keyswitch mapping in the range between 0 .. 127,
9640                                                   reflecting the analog meaning of the MIDI specification.
9641    </p>
9642    </blockquote>
9643                                        
9644    
9645    </blockquote>
9646                                
9647    
9648    </blockquote><p>
9649                        
9650    </p>
9651    <p>The mentioned fields above don't have to be in particular order.
9652    </p>
9653    <p>Example:
9654    </p>
9655    <p>
9656                            </p>
9657    <blockquote class="text">
9658    <p>C: "GET FILE INSTRUMENT INFO 'D:/Sounds/Foo.gig' 0"
9659    </p>
9660    <p>S: "NAME: Lunatic Loops"
9661    </p>
9662    <p>&nbsp;&nbsp;&nbsp;"FORMAT_FAMILY: GIG"
9663    </p>
9664    <p>&nbsp;&nbsp;&nbsp;"FORMAT_VERSION: 3"
9665    </p>
9666    <p>&nbsp;&nbsp;&nbsp;"PRODUCT: The Backbone Bongo Beats"
9667    </p>
9668    <p>&nbsp;&nbsp;&nbsp;"ARTISTS: Jimmy the Fish"
9669    </p>
9670    <p>&nbsp;&nbsp;&nbsp;"."
9671    </p>
9672    </blockquote><p>
9673                        
9674    </p>
9675  <a name="command_syntax"></a><br /><hr />  <a name="command_syntax"></a><br /><hr />
9676  <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>
9677  <a name="rfc.section.7"></a><h3>7.&nbsp;  <a name="rfc.section.7"></a><h3>7.&nbsp;
# Line 9239  Command Syntax</h3> Line 9791  Command Syntax</h3>
9791                                    
9792  </p>  </p>
9793  <p>/ FORMAT SP format_instruction  <p>/ FORMAT SP format_instruction
9794                    
9795    </p>
9796    <p>SEND SP send_instruction
9797                                    
9798  </p>  </p>
9799  <p>/ RESET  <p>/ RESET
# Line 9304  Command Syntax</h3> Line 9859  Command Syntax</h3>
9859  <p>/ CHANNEL_COUNT  <p>/ CHANNEL_COUNT
9860                                    
9861  </p>  </p>
9862    <p>/ CHANNEL_MIDI
9863                    
9864    </p>
9865    <p>/ DEVICE_MIDI
9866                    
9867    </p>
9868  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
9869                                    
9870  </p>  </p>
# Line 9352  Command Syntax</h3> Line 9913  Command Syntax</h3>
9913  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
9914                                    
9915  </p>  </p>
9916    <p>/ TOTAL_STREAM_COUNT
9917                    
9918    </p>
9919  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
9920                                    
9921  </p>  </p>
# Line 9379  Command Syntax</h3> Line 9943  Command Syntax</h3>
9943  <p>/ CHANNEL_COUNT  <p>/ CHANNEL_COUNT
9944                                    
9945  </p>  </p>
9946    <p>/ CHANNEL_MIDI
9947                    
9948    </p>
9949    <p>/ DEVICE_MIDI
9950                    
9951    </p>
9952  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
9953                                    
9954  </p>  </p>
# Line 9427  Command Syntax</h3> Line 9997  Command Syntax</h3>
9997  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
9998                                    
9999  </p>  </p>
10000    <p>/ TOTAL_STREAM_COUNT
10001                    
10002    </p>
10003  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
10004                                    
10005  </p>  </p>
# Line 9562  Command Syntax</h3> Line 10135  Command Syntax</h3>
10135  <p>/ SERVER SP INFO  <p>/ SERVER SP INFO
10136                                    
10137  </p>  </p>
10138    <p>/ TOTAL_STREAM_COUNT
10139                    
10140    </p>
10141  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
10142                                    
10143  </p>  </p>
# Line 9613  Command Syntax</h3> Line 10189  Command Syntax</h3>
10189  <p>/ VOLUME  <p>/ VOLUME
10190                                    
10191  </p>  </p>
10192    <p>/ FILE SP INSTRUMENTS SP filename
10193                    
10194    </p>
10195    <p>/ FILE SP INSTRUMENT SP INFO SP filename SP instrument_index
10196                    
10197    </p>
10198  </blockquote><p>  </blockquote><p>
10199    
10200  </p>  </p>
# Line 9664  Command Syntax</h3> Line 10246  Command Syntax</h3>
10246  <p>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped  <p>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped
10247                                    
10248  </p>  </p>
10249    <p>/ DB_INSTRUMENT SP FILE_PATH SP filename SP filename
10250                    
10251    </p>
10252  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
10253                                    
10254  </p>  </p>
# Line 9733  Command Syntax</h3> Line 10318  Command Syntax</h3>
10318  <p>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list  <p>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list
10319                                    
10320  </p>  </p>
10321    <p>/ LOST SP DB_INSTRUMENT_FILES
10322                    
10323    </p>
10324  </blockquote><p>  </blockquote><p>
10325    
10326  </p>  </p>
# Line 9838  Command Syntax</h3> Line 10426  Command Syntax</h3>
10426  <p>edit_instruction =  <p>edit_instruction =
10427          </p>          </p>
10428  <blockquote class="text">  <blockquote class="text">
10429  <p>INSTRUMENT SP sampler_channel  <p>CHANNEL SP INSTRUMENT SP sampler_channel
10430                                    
10431  </p>  </p>
10432  </blockquote><p>  </blockquote><p>
# Line 9934  Command Syntax</h3> Line 10522  Command Syntax</h3>
10522  <p>/ DB_INSTRUMENTS SP db_path  <p>/ DB_INSTRUMENTS SP db_path
10523                                    
10524  </p>  </p>
10525    <p>/ FILE SP INSTRUMENTS SP filename
10526                    
10527    </p>
10528    </blockquote><p>
10529    
10530    </p>
10531    <p>send_instruction =
10532            </p>
10533    <blockquote class="text">
10534    <p>CHANNEL SP MIDI_DATA SP string SP sampler_channel SP number SP number
10535                    
10536    </p>
10537  </blockquote><p>  </blockquote><p>
10538    
10539  </p>  </p>
# Line 10135  Command Syntax</h3> Line 10735  Command Syntax</h3>
10735  <p>map_name =  <p>map_name =
10736          </p>          </p>
10737  <blockquote class="text">  <blockquote class="text">
10738  <p>stringval  <p>stringval_escaped
10739                                    
10740  </p>  </p>
10741  </blockquote><p>  </blockquote><p>
# Line 10144  Command Syntax</h3> Line 10744  Command Syntax</h3>
10744  <p>entry_name =  <p>entry_name =
10745          </p>          </p>
10746  <blockquote class="text">  <blockquote class="text">
10747  <p>stringval  <p>stringval_escaped
10748                                    
10749  </p>  </p>
10750  </blockquote><p>  </blockquote><p>
# Line 10153  Command Syntax</h3> Line 10753  Command Syntax</h3>
10753  <p>fx_send_name =  <p>fx_send_name =
10754          </p>          </p>
10755  <blockquote class="text">  <blockquote class="text">
10756  <p>stringval  <p>stringval_escaped
10757                                    
10758  </p>  </p>
10759  </blockquote><p>  </blockquote><p>
# Line 10204  Command Syntax</h3> Line 10804  Command Syntax</h3>
10804  <p>query_val =  <p>query_val =
10805          </p>          </p>
10806  <blockquote class="text">  <blockquote class="text">
10807  <p>textval_escaped  <p>text_escaped
10808                                    
10809  </p>  </p>
10810  <p>/ stringval_escaped  <p>/ stringval_escaped
# Line 10294  Character Set and Escape Sequences</h3> Line 10894  Character Set and Escape Sequences</h3>
10894                  MUST be escaped as well (that is as double backslash), whereas                  MUST be escaped as well (that is as double backslash), whereas
10895                  in the old versions a single backslash was sufficient.                  in the old versions a single backslash was sufficient.
10896  </p>  </p>
10897    <p>The following LSCP commands support escape sequences as part
10898                    of their filename / path based arguments and / or may contain
10899                    a filename / path with escape sequences in their response:
10900                    </p>
10901    <blockquote class="text">
10902    <p><a class='info' href='#LOAD INSTRUMENT'>"LOAD INSTRUMENT"<span> (</span><span class='info'>Loading an instrument</span><span>)</span></a>
10903    </p>
10904    <p><a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a>
10905    </p>
10906    <p><a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>
10907    </p>
10908    <p><a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>
10909    </p>
10910    <p><a class='info' href='#ADD DB_INSTRUMENT_DIRECTORY'>"ADD DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Creating a new instrument directory</span><span>)</span></a>
10911    </p>
10912    <p><a class='info' href='#ADD DB_INSTRUMENTS'>"ADD DB_INSTRUMENTS"<span> (</span><span class='info'>Adding instruments to the instruments database</span><span>)</span></a>
10913    </p>
10914    <p><a class='info' href='#REMOVE DB_INSTRUMENT_DIRECTORY'>"REMOVE DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Deleting an instrument directory</span><span>)</span></a>
10915    </p>
10916    <p><a class='info' href='#REMOVE DB_INSTRUMENT'>"REMOVE DB_INSTRUMENT"<span> (</span><span class='info'>Removing an instrument</span><span>)</span></a>
10917    </p>
10918    <p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORIES'>"GET DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Getting amount of instrument directories</span><span>)</span></a>
10919    </p>
10920    <p><a class='info' href='#LIST DB_INSTRUMENT_DIRECTORIES'>"LIST DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Listing all directories in specific directory</span><span>)</span></a>
10921    </p>
10922    <p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORY INFO'>"GET DB_INSTRUMENT_DIRECTORY INFO"<span> (</span><span class='info'>Getting instrument directory information</span><span>)</span></a>
10923    </p>
10924    <p><a class='info' href='#GET DB_INSTRUMENTS'>"GET DB_INSTRUMENTS"<span> (</span><span class='info'>Getting amount of instruments</span><span>)</span></a>
10925    </p>
10926    <p><a class='info' href='#LIST DB_INSTRUMENTS'>"LIST DB_INSTRUMENTS"<span> (</span><span class='info'>Listing all instruments in specific directory</span><span>)</span></a>
10927    </p>
10928    <p><a class='info' href='#GET DB_INSTRUMENT INFO'>"GET DB_INSTRUMENT INFO"<span> (</span><span class='info'>Getting instrument information</span><span>)</span></a>
10929    </p>
10930    <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY NAME'>"SET DB_INSTRUMENT_DIRECTORY NAME"<span> (</span><span class='info'>Renaming an instrument directory</span><span>)</span></a>
10931    </p>
10932    <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION'>"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"<span> (</span><span class='info'>Changing the description of directory</span><span>)</span></a>
10933    </p>
10934    <p><a class='info' href='#SET DB_INSTRUMENT NAME'>"SET DB_INSTRUMENT NAME"<span> (</span><span class='info'>Renaming an instrument</span><span>)</span></a>
10935    </p>
10936    <p><a class='info' href='#SET DB_INSTRUMENT DESCRIPTION'>"SET DB_INSTRUMENT DESCRIPTION"<span> (</span><span class='info'>Changing the description of instrument</span><span>)</span></a>
10937    </p>
10938    <p><a class='info' href='#FIND DB_INSTRUMENTS'>"FIND DB_INSTRUMENTS"<span> (</span><span class='info'>Finding instruments</span><span>)</span></a>
10939    </p>
10940    <p><a class='info' href='#FIND DB_INSTRUMENT_DIRECTORIES'>"FIND DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Finding directories</span><span>)</span></a>
10941    </p>
10942    <p><a class='info' href='#MOVE DB_INSTRUMENT'>"MOVE DB_INSTRUMENT"<span> (</span><span class='info'>Moving an instrument</span><span>)</span></a>
10943    </p>
10944    <p><a class='info' href='#MOVE DB_INSTRUMENT_DIRECTORY'>"MOVE DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Moving an instrument directory</span><span>)</span></a>
10945    </p>
10946    <p><a class='info' href='#COPY DB_INSTRUMENT'>"COPY DB_INSTRUMENT"<span> (</span><span class='info'>Copying instruments</span><span>)</span></a>
10947    </p>
10948    <p><a class='info' href='#COPY DB_INSTRUMENT_DIRECTORY'>"COPY DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Copying instrument directories</span><span>)</span></a>
10949    </p>
10950    <p><a class='info' href='#FIND LOST DB_INSTRUMENT_FILES'>"FIND LOST DB_INSTRUMENT_FILES"<span> (</span><span class='info'>Checking for lost instrument files</span><span>)</span></a>
10951    </p>
10952    <p><a class='info' href='#SET DB_INSTRUMENT FILE_PATH'>"SET DB_INSTRUMENT FILE_PATH"<span> (</span><span class='info'>Replacing an instrument file</span><span>)</span></a>
10953    </p>
10954    <p><a class='info' href='#GET FILE INSTRUMENTS'>"GET FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving amount of instruments of a file</span><span>)</span></a>
10955    </p>
10956    <p><a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a>
10957    </p>
10958    <p><a class='info' href='#GET FILE INSTRUMENT INFO'>"GET FILE INSTRUMENT INFO"<span> (</span><span class='info'>Retrieving informations about one instrument in a file</span><span>)</span></a>
10959    </p>
10960    </blockquote><p>
10961                    Note that the forward slash character ('/') has a special meaning in
10962                    filename / path based arguments: it acts as separator of the nodes in
10963                    the path, thus if a directory- or filename includes a forward slash
10964                    (not intended as path node separator), you MUST escape that slash
10965                    either with the respective hex escape sequence ("\x2f") or with the
10966                    respective octal escape sequence ("\057").
10967                    
10968    </p>
10969    <p>
10970                    Note for Windows: file path arguments in LSCP are expected
10971                    to use forward slashes as directory node separator similar
10972                    to Unix based operating systems. In contrast to Unix however
10973                    a Windows typical drive character is expected to be
10974                    prefixed to the path. That is an original Windows file path
10975                    like "D:\Sounds\My.gig" would become in LSCP:
10976                    "D:/Sounds/My.gig".
10977                    
10978    </p>
10979    <p>
10980                    The following LSCP commands even support escape sequences as
10981                    part of at least one of their text-based arguments (i.e. entity name,
10982                    description) and / or may contain escape sequences in at least one of
10983                    their text-based fields in their response:
10984                    </p>
10985    <blockquote class="text">
10986    <p><a class='info' href='#GET SERVER INFO'>"GET SERVER INFO"<span> (</span><span class='info'>General sampler informations</span><span>)</span></a>
10987    </p>
10988    <p><a class='info' href='#GET ENGINE INFO'>"GET ENGINE INFO"<span> (</span><span class='info'>Getting information about an engine</span><span>)</span></a>
10989    </p>
10990    <p><a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a>
10991    </p>
10992    <p><a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
10993    </p>
10994    <p><a class='info' href='#GET FX_SEND INFO'>"GET FX_SEND INFO"<span> (</span><span class='info'>Getting effect send information</span><span>)</span></a>
10995    </p>
10996    <p><a class='info' href='#SET FX_SEND NAME'>"SET FX_SEND NAME"<span> (</span><span class='info'>Changing effect send's name</span><span>)</span></a>
10997    </p>
10998    <p><a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>
10999    </p>
11000    <p><a class='info' href='#GET MIDI_INSTRUMENT_MAP INFO'>"GET MIDI_INSTRUMENT_MAP INFO"<span> (</span><span class='info'>Getting MIDI instrument map information</span><span>)</span></a>
11001    </p>
11002    <p><a class='info' href='#ADD MIDI_INSTRUMENT_MAP'>"ADD MIDI_INSTRUMENT_MAP"<span> (</span><span class='info'>Create a new MIDI instrument map</span><span>)</span></a>
11003    </p>
11004    <p><a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>
11005    </p>
11006    <p><a class='info' href='#SET MIDI_INSTRUMENT_MAP NAME'>"SET MIDI_INSTRUMENT_MAP NAME"<span> (</span><span class='info'>Renaming a MIDI instrument map</span><span>)</span></a>
11007    </p>
11008    <p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORY INFO'>"GET DB_INSTRUMENT_DIRECTORY INFO"<span> (</span><span class='info'>Getting instrument directory information</span><span>)</span></a>
11009    </p>
11010    <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY NAME'>"SET DB_INSTRUMENT_DIRECTORY NAME"<span> (</span><span class='info'>Renaming an instrument directory</span><span>)</span></a>
11011    </p>
11012    <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION'>"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"<span> (</span><span class='info'>Changing the description of directory</span><span>)</span></a>
11013    </p>
11014    <p><a class='info' href='#FIND DB_INSTRUMENT_DIRECTORIES'>"FIND DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Finding directories</span><span>)</span></a>
11015    </p>
11016    <p><a class='info' href='#GET DB_INSTRUMENT INFO'>"GET DB_INSTRUMENT INFO"<span> (</span><span class='info'>Getting instrument information</span><span>)</span></a>
11017    </p>
11018    <p><a class='info' href='#SET DB_INSTRUMENT NAME'>"SET DB_INSTRUMENT NAME"<span> (</span><span class='info'>Renaming an instrument</span><span>)</span></a>
11019    </p>
11020    <p><a class='info' href='#SET DB_INSTRUMENT DESCRIPTION'>"SET DB_INSTRUMENT DESCRIPTION"<span> (</span><span class='info'>Changing the description of instrument</span><span>)</span></a>
11021    </p>
11022    <p><a class='info' href='#FIND DB_INSTRUMENTS'>"FIND DB_INSTRUMENTS"<span> (</span><span class='info'>Finding instruments</span><span>)</span></a>
11023    </p>
11024    </blockquote><p>
11025                    Please note that these lists are manually maintained. If you
11026                    find a command that also supports escape sequences we forgot to
11027                    mention here, please report it!
11028                    
11029    </p>
11030  <a name="events"></a><br /><hr />  <a name="events"></a><br /><hr />
11031  <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>
11032  <a name="rfc.section.8"></a><h3>8.&nbsp;  <a name="rfc.section.8"></a><h3>8.&nbsp;
# Line 10454  Number of sampler channels changed</h3> Line 11187  Number of sampler channels changed</h3>
11187  <p>where &lt;channels&gt; will be replaced by the new number  <p>where &lt;channels&gt; will be replaced by the new number
11188                  of sampler channels.                  of sampler channels.
11189  </p>  </p>
11190  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE CHANNEL_MIDI"></a><br /><hr />
11191  <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>
11192  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
11193    MIDI data on a sampler channel arrived</h3>
11194    
11195    <p>Client may want to be notified when MIDI data arrive on sampler channels on
11196                    back-end side, by issuing the following command:
11197    </p>
11198    <p>
11199                        </p>
11200    <blockquote class="text">
11201    <p>SUBSCRIBE CHANNEL_MIDI
11202    </p>
11203    </blockquote><p>
11204                    
11205    </p>
11206    <p>Server will start sending one of the the following notification messages:
11207    </p>
11208    <p>
11209                        </p>
11210    <blockquote class="text">
11211    <p>"NOTIFY:CHANNEL_MIDI:&lt;channel-id&gt; NOTE_ON  &lt;note&gt; &lt;velocity&gt;"
11212    </p>
11213    <p>"NOTIFY:CHANNEL_MIDI:&lt;channel-id&gt; NOTE_OFF &lt;note&gt; &lt;velocity&gt;"
11214    </p>
11215    </blockquote><p>
11216                    
11217    </p>
11218    <p>where &lt;channel-id&gt; will be replaced by the ID of the sampler channel where the MIDI
11219                    data arrived. &lt;note&gt; and &lt;velocity&gt; are integer values in the range between
11220                    0 .. 127, reflecting the analog meaning of the MIDI specification.
11221                    
11222    </p>
11223    <p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all
11224                    delivered by this mechanism! With other words: events could be lost at any time!
11225                    This restriction was made to keep the RT-safeness of the backend's MIDI and audio
11226                    thread unaffected by this feature.
11227    </p>
11228    <a name="SUBSCRIBE DEVICE_MIDI"></a><br /><hr />
11229    <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>
11230    <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
11231    MIDI data on a MIDI input device arrived</h3>
11232    
11233    <p>Client may want to be notified when MIDI data arrive on MIDI input devices by issuing the following command:
11234    </p>
11235    <p>
11236                                </p>
11237    <blockquote class="text">
11238    <p>SUBSCRIBE DEVICE_MIDI
11239    </p>
11240    </blockquote><p>
11241                        
11242    </p>
11243    <p>Server will start sending one of the the following notification messages:
11244    </p>
11245    <p>
11246                                </p>
11247    <blockquote class="text">
11248    <p>"NOTIFY:DEVICE_MIDI:&lt;device-id&gt; &lt;port-id&gt; NOTE_ON &lt;note&gt; &lt;velocity&gt;"
11249    </p>
11250    <p>"NOTIFY:DEVICE_MIDI:&lt;device-id&gt; &lt;port-id&gt; NOTE_OFF &lt;note&gt; &lt;velocity&gt;"
11251    </p>
11252    </blockquote><p>
11253                        
11254    </p>
11255    <p>where &lt;device-id&gt; &lt;port-id&gt; will be replaced
11256                           by the IDs of the respective MIDI input device and the device's MIDI port where the MIDI
11257                           data arrived. &lt;note&gt; and &lt;velocity&gt; are integer values in the range between
11258                           0 .. 127, reflecting the analog meaning of the MIDI specification.
11259                        
11260    </p>
11261    <p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all
11262                           delivered by this mechanism! With other words: events could be lost at any time!
11263                           This restriction was made to keep the RT-safeness of the backend's MIDI and audio
11264                           thread unaffected by this feature.
11265    </p>
11266    <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
11267    <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>
11268    <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
11269  Number of active voices changed</h3>  Number of active voices changed</h3>
11270    
11271  <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 10486  Number of active voices changed</h3> Line 11295  Number of active voices changed</h3>
11295  </p>  </p>
11296  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
11297  <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>
11298  <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;  <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
11299  Number of active disk streams changed</h3>  Number of active disk streams changed</h3>
11300    
11301  <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 10516  Number of active disk streams changed</h Line 11325  Number of active disk streams changed</h
11325  </p>  </p>
11326  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
11327  <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>
11328  <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
11329  Disk stream buffer fill state changed</h3>  Disk stream buffer fill state changed</h3>
11330    
11331  <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 10547  Disk stream buffer fill state changed</h Line 11356  Disk stream buffer fill state changed</h
11356  </p>  </p>
11357  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />
11358  <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>
11359  <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;  <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
11360  Channel information changed</h3>  Channel information changed</h3>
11361    
11362  <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 10580  Channel information changed</h3> Line 11389  Channel information changed</h3>
11389  </p>  </p>
11390  <a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr />  <a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr />
11391  <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>
11392  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;  <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
11393  Number of effect sends changed</h3>  Number of effect sends changed</h3>
11394    
11395  <p>Client may want to be notified when the number of effect sends on  <p>Client may want to be notified when the number of effect sends on
# Line 10610  Number of effect sends changed</h3> Line 11419  Number of effect sends changed</h3>
11419  </p>  </p>
11420  <a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr />  <a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr />
11421  <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>
11422  <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;  <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
11423  Effect send information changed</h3>  Effect send information changed</h3>
11424    
11425  <p>Client may want to be notified when changes were made to effect sends on a  <p>Client may want to be notified when changes were made to effect sends on a
# Line 10640  Effect send information changed</h3> Line 11449  Effect send information changed</h3>
11449  </p>  </p>
11450  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
11451  <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>
11452  <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;  <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
11453  Total number of active voices changed</h3>  Total number of active voices changed</h3>
11454    
11455  <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 10667  Total number of active voices changed</h Line 11476  Total number of active voices changed</h
11476  <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
11477                  all currently active voices.                  all currently active voices.
11478  </p>  </p>
11479    <a name="SUBSCRIBE TOTAL_STREAM_COUNT"></a><br /><hr />
11480    <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>
11481    <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
11482    Total number of active disk streams changed</h3>
11483    
11484    <p>Client may want to be notified when the total number of disk streams on the
11485                    back-end changes by issuing the following command:
11486    </p>
11487    <p>
11488                        </p>
11489    <blockquote class="text">
11490    <p>SUBSCRIBE TOTAL_STREAM_COUNT
11491    </p>
11492    </blockquote><p>
11493                    
11494    </p>
11495    <p>Server will start sending the following notification messages:
11496    </p>
11497    <p>
11498                        </p>
11499    <blockquote class="text">
11500    <p>"NOTIFY:TOTAL_STREAM_COUNT:&lt;streams&gt;"
11501    </p>
11502    </blockquote><p>
11503                    
11504    </p>
11505    <p>where &lt;streams&gt; will be replaced by the new number of
11506                    all currently active disk streams.
11507    </p>
11508  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
11509  <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>
11510  <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;  <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
11511  Number of MIDI instrument maps changed</h3>  Number of MIDI instrument maps changed</h3>
11512    
11513  <p>Client may want to be notified when the number of MIDI instrument maps on the  <p>Client may want to be notified when the number of MIDI instrument maps on the
# Line 10698  Number of MIDI instrument maps changed</ Line 11536  Number of MIDI instrument maps changed</
11536  </p>  </p>
11537  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
11538  <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>
11539  <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;  <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
11540  MIDI instrument map information changed</h3>  MIDI instrument map information changed</h3>
11541    
11542  <p>Client may want to be notified when changes were made to MIDI instrument maps on the  <p>Client may want to be notified when changes were made to MIDI instrument maps on the
# Line 10731  MIDI instrument map information changed< Line 11569  MIDI instrument map information changed<
11569  </p>  </p>
11570  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
11571  <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>
11572  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;  <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
11573  Number of MIDI instruments changed</h3>  Number of MIDI instruments changed</h3>
11574    
11575  <p>Client may want to be notified when the number of MIDI instrument maps on the  <p>Client may want to be notified when the number of MIDI instrument maps on the
# Line 10761  Number of MIDI instruments changed</h3> Line 11599  Number of MIDI instruments changed</h3>
11599  </p>  </p>
11600  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
11601  <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>
11602  <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;  <a name="rfc.section.8.19"></a><h3>8.19.&nbsp;
11603  MIDI instrument information changed</h3>  MIDI instrument information changed</h3>
11604    
11605  <p>Client may want to be notified when changes were made to MIDI instruments on the  <p>Client may want to be notified when changes were made to MIDI instruments on the
# Line 10795  MIDI instrument information changed</h3> Line 11633  MIDI instrument information changed</h3>
11633  </p>  </p>
11634  <a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr />  <a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr />
11635  <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>
11636  <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;  <a name="rfc.section.8.20"></a><h3>8.20.&nbsp;
11637  Global settings changed</h3>  Global settings changed</h3>
11638    
11639  <p>Client may want to be notified when changes to the global settings  <p>Client may want to be notified when changes to the global settings
# Line 10824  Global settings changed</h3> Line 11662  Global settings changed</h3>
11662  </p>  </p>
11663  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT"></a><br /><hr />  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT"></a><br /><hr />
11664  <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>
11665  <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;  <a name="rfc.section.8.21"></a><h3>8.21.&nbsp;
11666  Number of database instrument directories changed</h3>  Number of database instrument directories changed</h3>
11667    
11668  <p>Client may want to be notified when the number of instrument  <p>Client may want to be notified when the number of instrument
# Line 10858  Number of database instrument directorie Line 11696  Number of database instrument directorie
11696  </p>  </p>
11697  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO"></a><br /><hr />  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO"></a><br /><hr />
11698  <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>
11699  <a name="rfc.section.8.19"></a><h3>8.19.&nbsp;  <a name="rfc.section.8.22"></a><h3>8.22.&nbsp;
11700  Database instrument directory information changed</h3>  Database instrument directory information changed</h3>
11701    
11702  <p>Client may want to be notified when changes were made to directories  <p>Client may want to be notified when changes were made to directories
# Line 10903  Database instrument directory informatio Line 11741  Database instrument directory informatio
11741  </p>  </p>
11742  <a name="SUBSCRIBE DB_INSTRUMENT_COUNT"></a><br /><hr />  <a name="SUBSCRIBE DB_INSTRUMENT_COUNT"></a><br /><hr />
11743  <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>
11744  <a name="rfc.section.8.20"></a><h3>8.20.&nbsp;  <a name="rfc.section.8.23"></a><h3>8.23.&nbsp;
11745  Number of database instruments changed</h3>  Number of database instruments changed</h3>
11746    
11747  <p>Client may want to be notified when the number of instruments  <p>Client may want to be notified when the number of instruments
# Line 10937  Number of database instruments changed</ Line 11775  Number of database instruments changed</
11775  </p>  </p>
11776  <a name="SUBSCRIBE DB_INSTRUMENT_INFO"></a><br /><hr />  <a name="SUBSCRIBE DB_INSTRUMENT_INFO"></a><br /><hr />
11777  <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>
11778  <a name="rfc.section.8.21"></a><h3>8.21.&nbsp;  <a name="rfc.section.8.24"></a><h3>8.24.&nbsp;
11779  Database instrument information changed</h3>  Database instrument information changed</h3>
11780    
11781  <p>Client may want to be notified when changes were made to instruments  <p>Client may want to be notified when changes were made to instruments
# Line 10982  Database instrument information changed< Line 11820  Database instrument information changed<
11820  </p>  </p>
11821  <a name="SUBSCRIBE DB_INSTRUMENTS_JOB_INFO"></a><br /><hr />  <a name="SUBSCRIBE DB_INSTRUMENTS_JOB_INFO"></a><br /><hr />
11822  <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>
11823  <a name="rfc.section.8.22"></a><h3>8.22.&nbsp;  <a name="rfc.section.8.25"></a><h3>8.25.&nbsp;
11824  Database job status information changed</h3>  Database job status information changed</h3>
11825    
11826  <p>Client may want to be notified when the status of particular database  <p>Client may want to be notified when the status of particular database
# Line 11015  Database job status information changed< Line 11853  Database job status information changed<
11853  </p>  </p>
11854  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
11855  <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>
11856  <a name="rfc.section.8.23"></a><h3>8.23.&nbsp;  <a name="rfc.section.8.26"></a><h3>8.26.&nbsp;
11857  Miscellaneous and debugging events</h3>  Miscellaneous and debugging events</h3>
11858    
11859  <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
# Line 11112  Schoenebeck</td></tr> Line 11950  Schoenebeck</td></tr>
11950  <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>
11951  <h3>Full Copyright Statement</h3>  <h3>Full Copyright Statement</h3>
11952  <p class='copyright'>  <p class='copyright'>
11953  Copyright &copy; The IETF Trust (2007).</p>  Copyright &copy; The IETF Trust (2008).</p>
11954  <p class='copyright'>  <p class='copyright'>
11955  This document is subject to the rights,  This document is subject to the rights,
11956  licenses and restrictions contained in BCP&nbsp;78,  licenses and restrictions contained in BCP&nbsp;78,
# Line 11159  Please address the information to the IE Line 11997  Please address the information to the IE
11997  Funding for the RFC Editor function is provided by  Funding for the RFC Editor function is provided by
11998  the IETF Administrative Support Activity (IASA).</p>  the IETF Administrative Support Activity (IASA).</p>
11999  </body></html>  </body></html>
   
Legend:
Removed from v.1363  
changed lines
  Added in v.1773
  ViewVC Help
Powered by ViewVC