/[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 1002 by schoenebeck, Wed Dec 27 16:23:46 2006 UTC revision 1110 by iliev, Thu Mar 22 21:12:10 2007 UTC
# Line 3  Line 3 
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">  <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.31 (http://xml.resource.org/)">  <meta name="generator" content="xml2rfc v1.32 (http://xml.resource.org/)">
7  <style type='text/css'><!--  <style type='text/css'><!--
8          body {          body {
9                  font-family: verdana, charcoal, helvetica, arial, sans-serif;                  font-family: verdana, charcoal, helvetica, arial, sans-serif;
10                  font-size: small; color: #000; background-color: #FFF;                  font-size: small; color: #000; background-color: #FFF;
11                  margin: 2em;                  margin: 2em;
12          }          }
13          h1, h2, h3, h4, h5, h6 {          h1, h2, h3, h4, h5, h6 {
14                  font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif;                  font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif;
15                  font-weight: bold; font-style: normal;                  font-weight: bold; font-style: normal;
16          }          }
17          h1 { color: #900; background-color: transparent; text-align: right; }          h1 { color: #900; background-color: transparent; text-align: right; }
18          h3 { color: #333; background-color: transparent; }          h3 { color: #333; background-color: transparent; }
19    
20          td.RFCbug {          td.RFCbug {
21                  font-size: x-small; text-decoration: none;                  font-size: x-small; text-decoration: none;
22                  width: 30px; height: 30px; padding-top: 2px;                  width: 30px; height: 30px; padding-top: 2px;
23                  text-align: justify; vertical-align: middle;                  text-align: justify; vertical-align: middle;
24                  background-color: #000;                  background-color: #000;
25          }          }
26          td.RFCbug span.RFC {          td.RFCbug span.RFC {
27                  font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;                  font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
28                  font-weight: bold; color: #666;                  font-weight: bold; color: #666;
29          }          }
30          td.RFCbug span.hotText {          td.RFCbug span.hotText {
31                  font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;                  font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
32                  font-weight: normal; text-align: center; color: #FFF;                  font-weight: normal; text-align: center; color: #FFF;
33          }          }
34    
35          table.TOCbug { width: 30px; height: 15px; }          table.TOCbug { width: 30px; height: 15px; }
36          td.TOCbug {          td.TOCbug {
37                  text-align: center; width: 30px; height: 15px;                  text-align: center; width: 30px; height: 15px;
38                  color: #FFF; background-color: #900;                  color: #FFF; background-color: #900;
39          }          }
40          td.TOCbug a {          td.TOCbug a {
41                  font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif;                  font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif;
42                  font-weight: bold; font-size: x-small; text-decoration: none;                  font-weight: bold; font-size: x-small; text-decoration: none;
43                  color: #FFF; background-color: transparent;                  color: #FFF; background-color: transparent;
44          }          }
45    
46          td.header {          td.header {
47                  font-family: arial, helvetica, sans-serif; font-size: x-small;                  font-family: arial, helvetica, sans-serif; font-size: x-small;
48                  vertical-align: top; width: 33%;                  vertical-align: top; width: 33%;
49                  color: #FFF; background-color: #666;                  color: #FFF; background-color: #666;
50          }          }
51          td.author { font-weight: bold; font-size: x-small; margin-left: 4em; }          td.author { font-weight: bold; font-size: x-small; margin-left: 4em; }
52          td.author-text { font-size: x-small; }          td.author-text { font-size: x-small; }
53    
54          /* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */          /* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */
55          a.info {          a.info {
56                  /* This is the key. */                  /* This is the key. */
57                  position: relative;                  position: relative;
58                  z-index: 24;                  z-index: 24;
59                  text-decoration: none;                  text-decoration: none;
60          }          }
61          a.info:hover {          a.info:hover {
62                  z-index: 25;                  z-index: 25;
63                  color: #FFF; background-color: #900;                  color: #FFF; background-color: #900;
64          }          }
65          a.info span { display: none; }          a.info span { display: none; }
66          a.info:hover span.info {          a.info:hover span.info {
67                  /* The span will display just on :hover state. */                  /* The span will display just on :hover state. */
68                  display: block;                  display: block;
69                  position: absolute;                  position: absolute;
70                  font-size: smaller;                  font-size: smaller;
71                  top: 2em; left: -5em; width: 15em;                  top: 2em; left: -5em; width: 15em;
72                  padding: 2px; border: 1px solid #333;                  padding: 2px; border: 1px solid #333;
73                  color: #900; background-color: #EEE;                  color: #900; background-color: #EEE;
74                  text-align: left;                  text-align: left;
75          }          }
76    
77          a { font-weight: bold; }          a { font-weight: bold; }
78          a:link    { color: #900; background-color: transparent; }          a:link    { color: #900; background-color: transparent; }
79          a:visited { color: #633; background-color: transparent; }          a:visited { color: #633; background-color: transparent; }
80          a:active  { color: #633; background-color: transparent; }          a:active  { color: #633; background-color: transparent; }
81    
82          p { margin-left: 2em; margin-right: 2em; }          p { margin-left: 2em; margin-right: 2em; }
83          p.copyright { font-size: x-small; }          p.copyright { font-size: x-small; }
84          p.toc { font-size: small; font-weight: bold; margin-left: 3em; }          p.toc { font-size: small; font-weight: bold; margin-left: 3em; }
85          table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }          table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }
86          td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }          td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }
87    
88          ol.text { margin-left: 2em; margin-right: 2em; }          ol.text { margin-left: 2em; margin-right: 2em; }
89          ul.text { margin-left: 2em; margin-right: 2em; }          ul.text { margin-left: 2em; margin-right: 2em; }
90          li      { margin-left: 3em; }          li      { margin-left: 3em; }
91    
92          /* RFC-2629 <spanx>s and <artwork>s. */          /* RFC-2629 <spanx>s and <artwork>s. */
93          em     { font-style: italic; }          em     { font-style: italic; }
94          strong { font-weight: bold; }          strong { font-weight: bold; }
95          dfn    { font-weight: bold; font-style: normal; }          dfn    { font-weight: bold; font-style: normal; }
96          cite   { font-weight: normal; font-style: normal; }          cite   { font-weight: normal; font-style: normal; }
97          tt     { color: #036; }          tt     { color: #036; }
98          tt, pre, pre dfn, pre em, pre cite, pre span {          tt, pre, pre dfn, pre em, pre cite, pre span {
99                  font-family: "Courier New", Courier, monospace; font-size: small;                  font-family: "Courier New", Courier, monospace; font-size: small;
100          }          }
101          pre {          pre {
102                  text-align: left; padding: 4px;                  text-align: left; padding: 4px;
103                  color: #000; background-color: #CCC;                  color: #000; background-color: #CCC;
104          }          }
105          pre dfn  { color: #900; }          pre dfn  { color: #900; }
106          pre em   { color: #66F; background-color: #FFC; font-weight: normal; }          pre em   { color: #66F; background-color: #FFC; font-weight: normal; }
107          pre .key { color: #33C; font-weight: bold; }          pre .key { color: #33C; font-weight: bold; }
108          pre .id  { color: #900; }          pre .id  { color: #900; }
109          pre .str { color: #000; background-color: #CFF; }          pre .str { color: #000; background-color: #CFF; }
110          pre .val { color: #066; }          pre .val { color: #066; }
111          pre .rep { color: #909; }          pre .rep { color: #909; }
112          pre .oth { color: #000; background-color: #FCF; }          pre .oth { color: #000; background-color: #FCF; }
113          pre .err { background-color: #FCC; }          pre .err { background-color: #FCC; }
114    
115          /* RFC-2629 <texttable>s. */          /* RFC-2629 <texttable>s. */
116          table.full, table.headers, table.none {          table.all, table.full, table.headers, table.none {
117                  font-size: small; text-align: center; border-width: 2px;                  font-size: small; text-align: center; border-width: 2px;
118                  vertical-align: top; border-collapse: collapse;                  vertical-align: top; border-collapse: collapse;
119          }          }
120          table.full { border-style: solid; border-color: black; }          table.all, table.full { border-style: solid; border-color: black; }
121          table.headers, table.none { border-style: none; }          table.headers, table.none { border-style: none; }
122          th {          th {
123                  font-weight: bold; border-color: black;                  font-weight: bold; border-color: black;
124                  border-width: 2px 2px 3px 2px;                  border-width: 2px 2px 3px 2px;
125          }          }
126          table.full th { border-style: solid; }          table.all th, table.full th { border-style: solid; }
127          table.headers th { border-style: none none solid none; }          table.headers th { border-style: none none solid none; }
128          table.none th { border-style: none; }          table.none th { border-style: none; }
129          table.full td {          table.all td {
130                  border-style: solid; border-color: #333;                  border-style: solid; border-color: #333;
131                  border-width: 1px 2px;                  border-width: 1px 2px;
132          }          }
133          table.headers td, table.none td { border-style: none; }          table.full td, table.headers td, table.none td { border-style: none; }
134    
135          hr { height: 1px; }          hr { height: 1px; }
136          hr.insert {          hr.insert {
137                  width: 80%; border-style: none; border-width: 0;                  width: 80%; border-style: none; border-width: 0;
138                  color: #CCC; background-color: #CCC;                  color: #CCC; background-color: #CCC;
139          }          }
140  --></style>  --></style>
141  </head>  </head>
142  <body>  <body>
# Line 145  Line 145 
145  <tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr>  <tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr>
146  <tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr>  <tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr>
147  <tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr>  <tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr>
148  <tr><td class="header">Expires: June 30, 2007</td><td class="header">December 27, 2006</td></tr>  <tr><td class="header">Expires: September 23, 2007</td><td class="header">March 22, 2007</td></tr>
149  </table></td></tr></table>  </table></td></tr></table>
150  <h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1>  <h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1>
151    
# Line 173  The list of current Internet-Drafts can Line 173  The list of current Internet-Drafts can
173  The list of Internet-Draft Shadow Directories can be accessed at  The list of Internet-Draft Shadow Directories can be accessed at
174  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>
175  <p>  <p>
176  This Internet-Draft will expire on June 30, 2007.</p>  This Internet-Draft will expire on September 23, 2007.</p>
177    
178  <h3>Copyright Notice</h3>  <h3>Copyright Notice</h3>
179  <p>  <p>
180  Copyright &copy; The Internet Society (2006).</p>  Copyright &copy; The IETF Trust (2007).</p>
181    
182  <h3>Abstract</h3>  <h3>Abstract</h3>
183    
# Line 330  Listing all effect sends on a sampler ch Line 330  Listing all effect sends on a sampler ch
330  Getting effect send information<br />  Getting effect send information<br />
331  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND AUDIO_OUTPUT_CHANNEL">6.4.30.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND AUDIO_OUTPUT_CHANNEL">6.4.30.</a>&nbsp;
332  Altering effect send's audio routing<br />  Altering effect send's audio routing<br />
333  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.31.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND MIDI_CONTROLLER">6.4.31.</a>&nbsp;
334    Altering effect send's MIDI controller<br />
335    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND LEVEL">6.4.32.</a>&nbsp;
336    Altering effect send's send level<br />
337    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.33.</a>&nbsp;
338  Resetting a sampler channel<br />  Resetting a sampler channel<br />
339  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
340  Controlling connection<br />  Controlling connection<br />
# Line 352  Maximum amount of active voices<br /> Line 356  Maximum amount of active voices<br />
356  Reset sampler<br />  Reset sampler<br />
357  &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.4.</a>&nbsp;
358  General sampler informations<br />  General sampler informations<br />
359    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOLUME">6.6.5.</a>&nbsp;
360    Getting global volume attenuation<br />
361    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOLUME">6.6.6.</a>&nbsp;
362    Setting global volume attenuation<br />
363  &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;
364  MIDI Instrument Mapping<br />  MIDI Instrument Mapping<br />
365  &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;
# Line 400  Number of active disk streams changed<br Line 408  Number of active disk streams changed<br
408  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
409  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;
410  Channel information changed<br />  Channel information changed<br />
411  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.10.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.10.</a>&nbsp;
412    Number of effect sends changed<br />
413    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.11.</a>&nbsp;
414    Effect send information changed<br />
415    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.12.</a>&nbsp;
416  Total number of active voices changed<br />  Total number of active voices changed<br />
417  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.11.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.13.</a>&nbsp;
418  Number of MIDI instrument maps changed<br />  Number of MIDI instrument maps changed<br />
419  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.12.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.14.</a>&nbsp;
420  MIDI instrument map information changed<br />  MIDI instrument map information changed<br />
421  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.13.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.15.</a>&nbsp;
422  Number of MIDI instruments changed<br />  Number of MIDI instruments changed<br />
423  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.14.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.16.</a>&nbsp;
424  MIDI instrument information changed<br />  MIDI instrument information changed<br />
425  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.15.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.17.</a>&nbsp;
426    Global settings changed<br />
427    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.18.</a>&nbsp;
428  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
429  <a href="#anchor14">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
430  Security Considerations<br />  Security Considerations<br />
# Line 3954  Getting sampler channel information</h3> Line 3968  Getting sampler channel information</h3>
3968                                          </p>                                          </p>
3969  <blockquote class="text">  <blockquote class="text">
3970  <p>optionally dotted number for the channel volume factor  <p>optionally dotted number for the channel volume factor
3971                                              (where a value < 1.0 means attenuation and a value >                                              (where a value &lt; 1.0 means attenuation and a value >
3972                                              1.0 means amplification)                                              1.0 means amplification)
3973  </p>  </p>
3974  </blockquote>  </blockquote>
# Line 5256  Getting effect send information</h3> Line 5270  Getting effect send information</h3>
5270  </blockquote>  </blockquote>
5271                                                                            
5272    
5273    <p>MIDI_CONTROLLER -
5274                                            </p>
5275    <blockquote class="text">
5276    <p>a value between 0 and 127 reflecting the MIDI controller
5277                                                which is able to modify the effect send's send level
5278    </p>
5279    </blockquote>
5280                                        
5281    
5282    <p>LEVEL -
5283                                            </p>
5284    <blockquote class="text">
5285    <p>optionally dotted number reflecting the effect send's
5286                                                current send level (where a value &lt; 1.0 means attenuation
5287                                                and a value > 1.0 means amplification)
5288    </p>
5289    </blockquote>
5290                                        
5291    
5292  <p>AUDIO_OUTPUT_ROUTING -  <p>AUDIO_OUTPUT_ROUTING -
5293                                          </p>                                          </p>
5294  <blockquote class="text">  <blockquote class="text">
# Line 5289  Getting effect send information</h3> Line 5322  Getting effect send information</h3>
5322  </p>  </p>
5323  <p>S: "NAME: Reverb Send"  <p>S: "NAME: Reverb Send"
5324  </p>  </p>
5325    <p>&nbsp;&nbsp;&nbsp;"MIDI_CONTROLLER: 91"
5326    </p>
5327    <p>&nbsp;&nbsp;&nbsp;"LEVEL: 0.3"
5328    </p>
5329  <p>&nbsp;&nbsp;&nbsp;"AUDIO_OUTPUT_ROUTING: 2,3"  <p>&nbsp;&nbsp;&nbsp;"AUDIO_OUTPUT_ROUTING: 2,3"
5330  </p>  </p>
5331  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
# Line 5379  Altering effect send's audio routing</h3 Line 5416  Altering effect send's audio routing</h3
5416  </blockquote><p>  </blockquote><p>
5417                                            
5418  </p>  </p>
5419  <a name="RESET CHANNEL"></a><br /><hr />  <a name="SET FX_SEND MIDI_CONTROLLER"></a><br /><hr />
5420  <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>
5421  <a name="rfc.section.6.4.31"></a><h3>6.4.31.&nbsp;  <a name="rfc.section.6.4.31"></a><h3>6.4.31.&nbsp;
5422    Altering effect send's MIDI controller</h3>
5423    
5424    <p>The front-end can alter the MIDI controller of an effect
5425                        send entity by sending the following command:
5426    </p>
5427    <p>
5428                            </p>
5429    <blockquote class="text">
5430    <p>SET FX_SEND MIDI_CONTROLLER &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;midi-ctrl&gt;
5431    </p>
5432    </blockquote><p>
5433                        
5434    </p>
5435    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5436                        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>
5437                        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,
5438                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5439                        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>
5440                        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
5441                        &lt;midi-ctrl&gt; reflects the MIDI controller which shall be
5442                        able to modify the effect send's send level.
5443    </p>
5444    <p>Possible Answers:
5445    </p>
5446    <p>
5447                            </p>
5448    <blockquote class="text">
5449    <p>"OK" -
5450                                    </p>
5451    <blockquote class="text">
5452    <p>on success
5453    </p>
5454    </blockquote>
5455                                
5456    
5457    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5458                                    </p>
5459    <blockquote class="text">
5460    <p>if MIDI controller was set, but there are noteworthy
5461                                        issue(s) related, providing an appropriate warning code and
5462                                        warning message
5463    </p>
5464    </blockquote>
5465                                
5466    
5467    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5468                                    </p>
5469    <blockquote class="text">
5470    <p>in case it failed, providing an appropriate error code and error message
5471    </p>
5472    </blockquote>
5473                                
5474    
5475    </blockquote><p>
5476                        
5477    </p>
5478    <p>Example:
5479    </p>
5480    <p>
5481                            </p>
5482    <blockquote class="text">
5483    <p>C: "SET FX_SEND MIDI_CONTROLLER 0 0 91"
5484    </p>
5485    <p>S: "OK"
5486    </p>
5487    </blockquote><p>
5488                        
5489    </p>
5490    <a name="SET FX_SEND LEVEL"></a><br /><hr />
5491    <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>
5492    <a name="rfc.section.6.4.32"></a><h3>6.4.32.&nbsp;
5493    Altering effect send's send level</h3>
5494    
5495    <p>The front-end can alter the current send level of an effect
5496                        send entity by sending the following command:
5497    </p>
5498    <p>
5499                            </p>
5500    <blockquote class="text">
5501    <p>SET FX_SEND LEVEL &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;volume&gt;
5502    </p>
5503    </blockquote><p>
5504                        
5505    </p>
5506    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5507                        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>
5508                        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,
5509                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5510                        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>
5511                        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
5512                        &lt;volume&gt; is an optionally dotted positive number (a value
5513                        smaller than 1.0 means attenuation, whereas a value greater than
5514                        1.0 means amplification) reflecting the new send level.
5515    </p>
5516    <p>Possible Answers:
5517    </p>
5518    <p>
5519                            </p>
5520    <blockquote class="text">
5521    <p>"OK" -
5522                                    </p>
5523    <blockquote class="text">
5524    <p>on success
5525    </p>
5526    </blockquote>
5527                                
5528    
5529    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5530                                    </p>
5531    <blockquote class="text">
5532    <p>if new send level was set, but there are noteworthy
5533                                        issue(s) related, providing an appropriate warning code and
5534                                        warning message
5535    </p>
5536    </blockquote>
5537                                
5538    
5539    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5540                                    </p>
5541    <blockquote class="text">
5542    <p>in case it failed, providing an appropriate error code and error message
5543    </p>
5544    </blockquote>
5545                                
5546    
5547    </blockquote><p>
5548                        
5549    </p>
5550    <p>Example:
5551    </p>
5552    <p>
5553                            </p>
5554    <blockquote class="text">
5555    <p>C: "SET FX_SEND LEVEL 0 0 0.15"
5556    </p>
5557    <p>S: "OK"
5558    </p>
5559    </blockquote><p>
5560                        
5561    </p>
5562    <a name="RESET CHANNEL"></a><br /><hr />
5563    <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>
5564    <a name="rfc.section.6.4.33"></a><h3>6.4.33.&nbsp;
5565  Resetting a sampler channel</h3>  Resetting a sampler channel</h3>
5566    
5567  <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 5822  General sampler informations</h3> Line 6002  General sampler informations</h3>
6002  <p>The mentioned fields above don't have to be in particular order.  <p>The mentioned fields above don't have to be in particular order.
6003                      Other fields might be added in future.                      Other fields might be added in future.
6004  </p>  </p>
6005    <a name="GET VOLUME"></a><br /><hr />
6006    <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>
6007    <a name="rfc.section.6.6.5"></a><h3>6.6.5.&nbsp;
6008    Getting global volume attenuation</h3>
6009    
6010    <p>The client can ask for the current global sampler-wide volume
6011                        attenuation by sending the following command:
6012    </p>
6013    <p>
6014                            </p>
6015    <blockquote class="text">
6016    <p>GET VOLUME
6017    </p>
6018    </blockquote><p>
6019                        
6020    </p>
6021    <p>Possible Answers:
6022    </p>
6023    <p>
6024                            </p>
6025    <blockquote class="text">
6026    <p>The sampler will always answer by returning the optional
6027                                dotted floating point coefficient, reflecting the current
6028                                global volume attenuation.
6029                                
6030    </p>
6031    </blockquote><p>
6032                        
6033    </p>
6034    <p>Note: it is up to the respective sampler engine whether to obey
6035                        that global volume parameter or not, but in general all engines SHOULD
6036                        use this parameter.
6037    </p>
6038    <a name="SET VOLUME"></a><br /><hr />
6039    <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>
6040    <a name="rfc.section.6.6.6"></a><h3>6.6.6.&nbsp;
6041    Setting global volume attenuation</h3>
6042    
6043    <p>The client can alter the current global sampler-wide volume
6044                        attenuation by sending the following command:
6045    </p>
6046    <p>
6047                            </p>
6048    <blockquote class="text">
6049    <p>SET VOLUME &lt;volume&gt;
6050    </p>
6051    </blockquote><p>
6052                        
6053    </p>
6054    <p>Where &lt;volume&gt; should be replaced by the optional dotted
6055                       floating point value, reflecting the new global volume parameter.
6056                       This value might usually be in the range between 0.0 and 1.0, that
6057                       is for attenuating the overall volume.
6058    </p>
6059    <p>Possible Answers:
6060    </p>
6061    <p>
6062                            </p>
6063    <blockquote class="text">
6064    <p>"OK" -
6065                                    </p>
6066    <blockquote class="text">
6067    <p>on success
6068    </p>
6069    </blockquote>
6070                                
6071    
6072    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
6073                                    </p>
6074    <blockquote class="text">
6075    <p>if the global volume was set, but there are noteworthy
6076                                        issue(s) related, providing an appropriate warning code and
6077                                        warning message
6078    </p>
6079    </blockquote>
6080                                
6081    
6082    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
6083                                    </p>
6084    <blockquote class="text">
6085    <p>in case it failed, providing an appropriate error code and error message
6086    </p>
6087    </blockquote>
6088                                
6089    
6090    </blockquote><p>
6091                        
6092    </p>
6093  <a name="MIDI Instrument Mapping"></a><br /><hr />  <a name="MIDI Instrument Mapping"></a><br /><hr />
6094  <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>
6095  <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;  <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;
# Line 6226  Create or replace a MIDI instrument map Line 6494  Create or replace a MIDI instrument map
6494  <p>  <p>
6495                          </p>                          </p>
6496  <blockquote class="text">  <blockquote class="text">
6497  <p>MAP MIDI_INSTRUMENT &lt;map&gt;  <p>MAP MIDI_INSTRUMENT [NON_MODAL] &lt;map&gt;
6498                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;
6499                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
6500                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]
# Line 6246  Create or replace a MIDI instrument map Line 6514  Create or replace a MIDI instrument map
6514                      &lt;instrument_index&gt; the index (integer value) of the instrument                      &lt;instrument_index&gt; the index (integer value) of the instrument
6515                      within the given file, &lt;volume_value&gt; reflects the master                      within the given file, &lt;volume_value&gt; reflects the master
6516                      volume of the instrument as optionally dotted number (where a                      volume of the instrument as optionally dotted number (where a
6517                      value < 1.0 means attenuation and a value > 1.0 means                      value &lt; 1.0 means attenuation and a value > 1.0 means
6518                      amplification). This parameter easily allows to adjust the                      amplification). This parameter easily allows to adjust the
6519                      volume of all intruments within a custom instrument map                      volume of all intruments within a custom instrument map
6520                      without having to adjust their instrument files. The                      without having to adjust their instrument files. The
# Line 6290  Create or replace a MIDI instrument map Line 6558  Create or replace a MIDI instrument map
6558                                  </p>                                  </p>
6559  <blockquote class="text">  <blockquote class="text">
6560  <p>The instrument will immediately be loaded  <p>The instrument will immediately be loaded
6561                                      into memory in the background when this mapping                                      into memory when this mapping
6562                                      command is sent and the instrument is kept all                                      command is sent and the instrument is kept all
6563                                      the time. Instruments with this mode are                                      the time. Instruments with this mode are
6564                                      only freed when the sampler is reset or all                                      only freed when the sampler is reset or all
# Line 6347  Create or replace a MIDI instrument map Line 6615  Create or replace a MIDI instrument map
6615                                            
6616  </p>  </p>
6617  <p>  <p>
6618                      The "MAP MIDI_INSTRUMENT" command                      By default, "MAP MIDI_INSTRUMENT" commands block until the mapping is
6619                      will immediately return, thus it will not block when an                      completely established in the sampler. The OPTIONAL "NON_MODAL" argument
6620                      instrument is to be loaded due to a "PERSISTENT" type                      however causes the respective "MAP MIDI_INSTRUMENT" command to return
6621                      entry as instruments are loaded in the background. As a                      immediately, that is to let the sampler establish the mapping in the
6622                      consequence this command may not necessarily return an error                      background. So this argument might be especially useful for mappings with
6623                      i.e. when the given instrument file does not exist or may                      a "PERSISTENT" type, because these have to load the respective instruments
6624                      turn out to be corrupt.                      immediately and might thus block for a very long time. It is recommended
6625                        however to use the OPTIONAL "NON_MODAL" argument only if really necessary,
6626                        because it has the following drawbacks: as "NON_MODAL" instructions return
6627                        immediately, they may not necessarily return an error i.e. when the given
6628                        instrument file turns out to be corrupt, beside that subsequent commands
6629                        in a LSCP instruction sequence might fail, because mandatory mappings are
6630                        not yet completed.
6631                                            
6632  </p>  </p>
6633  <p>Possible Answers:  <p>Possible Answers:
# Line 6420  Create or replace a MIDI instrument map Line 6694  Create or replace a MIDI instrument map
6694  <p>  <p>
6695                          </p>                          </p>
6696  <blockquote class="text">  <blockquote class="text">
6697  <p>C: "MAP MIDI_INSTRUMENT 1 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'"  <p>C: "MAP MIDI_INSTRUMENT NON_MODAL 1 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'"
6698  </p>  </p>
6699  <p>S: "OK"  <p>S: "OK"
6700  </p>  </p>
# Line 6709  Get current settings of MIDI instrument Line 6983  Get current settings of MIDI instrument
6983                                  </p>                                  </p>
6984  <blockquote class="text">  <blockquote class="text">
6985  <p>master volume of the instrument as optionally  <p>master volume of the instrument as optionally
6986                                      dotted number (where a value < 1.0 means attenuation                                      dotted number (where a value &lt; 1.0 means attenuation
6987                                      and a value > 1.0 means amplification)                                      and a value > 1.0 means amplification)
6988  </p>  </p>
6989  </blockquote>  </blockquote>
# Line 6981  Command Syntax</h3> Line 7255  Command Syntax</h3>
7255  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
7256                                    
7257  </p>  </p>
7258    <p>/ FX_SEND_COUNT
7259                    
7260    </p>
7261    <p>/ FX_SEND_INFO
7262                    
7263    </p>
7264  <p>/ MIDI_INSTRUMENT_MAP_COUNT  <p>/ MIDI_INSTRUMENT_MAP_COUNT
7265                                    
7266  </p>  </p>
# Line 6999  Command Syntax</h3> Line 7279  Command Syntax</h3>
7279  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
7280                                    
7281  </p>  </p>
7282    <p>/ GLOBAL_INFO
7283                    
7284    </p>
7285  </blockquote><p>  </blockquote><p>
7286    
7287  </p>  </p>
# Line 7032  Command Syntax</h3> Line 7315  Command Syntax</h3>
7315  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
7316                                    
7317  </p>  </p>
7318    <p>/ FX_SEND_COUNT
7319                    
7320    </p>
7321    <p>/ FX_SEND_INFO
7322                    
7323    </p>
7324  <p>/ MIDI_INSTRUMENT_MAP_COUNT  <p>/ MIDI_INSTRUMENT_MAP_COUNT
7325                                    
7326  </p>  </p>
# Line 7050  Command Syntax</h3> Line 7339  Command Syntax</h3>
7339  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
7340                                    
7341  </p>  </p>
7342    <p>/ GLOBAL_INFO
7343                    
7344    </p>
7345  </blockquote><p>  </blockquote><p>
7346    
7347  </p>  </p>
7348  <p>map_instruction =  <p>map_instruction =
7349          </p>          </p>
7350  <blockquote class="text">  <blockquote class="text">
7351  <p>MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value  <p>MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value
7352                                    
7353  </p>  </p>
7354  <p>/ MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode  <p>/ MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode
7355                                    
7356  </p>  </p>
7357  <p>/ MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP entry_name  <p>/ MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP entry_name
7358                                    
7359  </p>  </p>
7360  <p>/ MIDI_INSTRUMENT SP midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode SP entry_name  <p>/ MIDI_INSTRUMENT SP modal_arg midi_map SP midi_bank SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode SP entry_name
7361                                    
7362  </p>  </p>
7363  </blockquote><p>  </blockquote><p>
# Line 7197  Command Syntax</h3> Line 7489  Command Syntax</h3>
7489  <p>/ FX_SEND SP INFO SP sampler_channel SP fx_send_id  <p>/ FX_SEND SP INFO SP sampler_channel SP fx_send_id
7490                                    
7491  </p>  </p>
7492    <p>/ VOLUME
7493                    
7494    </p>
7495  </blockquote><p>  </blockquote><p>
7496    
7497  </p>  </p>
# Line 7224  Command Syntax</h3> Line 7519  Command Syntax</h3>
7519  <p>/ FX_SEND SP AUDIO_OUTPUT_CHANNEL SP sampler_channel SP fx_send_id SP audio_channel_index SP audio_channel_index  <p>/ FX_SEND SP AUDIO_OUTPUT_CHANNEL SP sampler_channel SP fx_send_id SP audio_channel_index SP audio_channel_index
7520                                    
7521  </p>  </p>
7522    <p>/ FX_SEND SP MIDI_CONTROLLER SP sampler_channel SP fx_send_id SP midi_ctrl
7523                    
7524    </p>
7525    <p>/ FX_SEND SP LEVEL SP sampler_channel SP fx_send_id SP volume_value
7526                    
7527    </p>
7528  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
7529                                    
7530  </p>  </p>
7531    <p>/ VOLUME SP volume_value
7532                    
7533    </p>
7534  </blockquote><p>  </blockquote><p>
7535    
7536  </p>  </p>
# Line 7350  Command Syntax</h3> Line 7654  Command Syntax</h3>
7654  </blockquote><p>  </blockquote><p>
7655    
7656  </p>  </p>
7657    <p>modal_arg =
7658            </p>
7659    <blockquote class="text">
7660    <p>/* epsilon (empty argument) */
7661                    
7662    </p>
7663    <p>/ NON_MODAL SP
7664                    
7665    </p>
7666    </blockquote><p>
7667    
7668    </p>
7669  <p>key_val_list =  <p>key_val_list =
7670          </p>          </p>
7671  <blockquote class="text">  <blockquote class="text">
# Line 7834  Number of active voices changed</h3> Line 8150  Number of active voices changed</h3>
8150  <p>  <p>
8151                      </p>                      </p>
8152  <blockquote class="text">  <blockquote class="text">
8153  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;"
8154  </p>  </p>
8155  </blockquote><p>  </blockquote><p>
8156                                    
# Line 7937  Channel information changed</h3> Line 8253  Channel information changed</h3>
8253                  time events happening on the server, it is believed that an empty notification                  time events happening on the server, it is believed that an empty notification
8254                  message is sufficient here.                  message is sufficient here.
8255  </p>  </p>
8256  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr />
8257  <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>
8258  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
8259    Number of effect sends changed</h3>
8260    
8261    <p>Client may want to be notified when the number of effect sends on
8262                    a particular sampler channel is changed by issuing the following command:
8263    </p>
8264    <p>
8265                        </p>
8266    <blockquote class="text">
8267    <p>SUBSCRIBE FX_SEND_COUNT
8268    </p>
8269    </blockquote><p>
8270                    
8271    </p>
8272    <p>Server will start sending the following notification messages:
8273    </p>
8274    <p>
8275                        </p>
8276    <blockquote class="text">
8277    <p>"NOTIFY:FX_SEND_COUNT:&lt;channel-id&gt; &lt;fx-sends&gt;"
8278    </p>
8279    </blockquote><p>
8280                    
8281    </p>
8282    <p>where &lt;channel-id&gt; will be replaced by the numerical ID of the sampler
8283                    channel, on which the effect sends number is changed and &lt;fx-sends&gt; will
8284                    be replaced by the new number of effect sends on that channel.
8285    </p>
8286    <a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr />
8287    <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>
8288    <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
8289    Effect send information changed</h3>
8290    
8291    <p>Client may want to be notified when changes were made to effect sends on a
8292                    a particular sampler channel by issuing the following command:
8293    </p>
8294    <p>
8295                        </p>
8296    <blockquote class="text">
8297    <p>SUBSCRIBE FX_SEND_INFO
8298    </p>
8299    </blockquote><p>
8300                    
8301    </p>
8302    <p>Server will start sending the following notification messages:
8303    </p>
8304    <p>
8305                        </p>
8306    <blockquote class="text">
8307    <p>"NOTIFY:FX_SEND_INFO:&lt;channel-id&gt; &lt;fx-send-id&gt;"
8308    </p>
8309    </blockquote><p>
8310                    
8311    </p>
8312    <p>where &lt;channel-id&gt; will be replaced by the numerical ID of the sampler
8313                    channel, on which an effect send entity is changed and &lt;fx-send-id&gt; will
8314                    be replaced by the numerical ID of the changed effect send.
8315    </p>
8316    <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
8317    <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>
8318    <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
8319  Total number of active voices changed</h3>  Total number of active voices changed</h3>
8320    
8321  <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 7958  Total number of active voices changed</h Line 8334  Total number of active voices changed</h
8334  <p>  <p>
8335                      </p>                      </p>
8336  <blockquote class="text">  <blockquote class="text">
8337  <p>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;  <p>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;"
8338  </p>  </p>
8339  </blockquote><p>  </blockquote><p>
8340                                    
# Line 7968  Total number of active voices changed</h Line 8344  Total number of active voices changed</h
8344  </p>  </p>
8345  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
8346  <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>
8347  <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;  <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
8348  Number of MIDI instrument maps changed</h3>  Number of MIDI instrument maps changed</h3>
8349    
8350  <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 7997  Number of MIDI instrument maps changed</ Line 8373  Number of MIDI instrument maps changed</
8373  </p>  </p>
8374  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
8375  <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>
8376  <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;  <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
8377  MIDI instrument map information changed</h3>  MIDI instrument map information changed</h3>
8378    
8379  <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 8030  MIDI instrument map information changed< Line 8406  MIDI instrument map information changed<
8406  </p>  </p>
8407  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
8408  <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>
8409  <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
8410  Number of MIDI instruments changed</h3>  Number of MIDI instruments changed</h3>
8411    
8412  <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 8060  Number of MIDI instruments changed</h3> Line 8436  Number of MIDI instruments changed</h3>
8436  </p>  </p>
8437  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
8438  <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>
8439  <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;  <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
8440  MIDI instrument information changed</h3>  MIDI instrument information changed</h3>
8441    
8442  <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 8092  MIDI instrument information changed</h3> Line 8468  MIDI instrument information changed</h3>
8468                  time events happening on the server, it is believed that an empty notification                  time events happening on the server, it is believed that an empty notification
8469                  message is sufficient here.                  message is sufficient here.
8470  </p>  </p>
8471    <a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr />
8472    <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>
8473    <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
8474    Global settings changed</h3>
8475    
8476    <p>Client may want to be notified when changes to the global settings
8477                    of the sampler were made by issuing the following command:
8478    </p>
8479    <p>
8480                        </p>
8481    <blockquote class="text">
8482    <p>SUBSCRIBE GLOBAL_INFO
8483    </p>
8484    </blockquote><p>
8485                    
8486    </p>
8487    <p>Server will start sending the following types of notification messages:
8488    </p>
8489    <p>
8490                        </p>
8491    <blockquote class="text">
8492    <p>"NOTIFY:GLOBAL_INFO:VOLUME &lt;volume&gt;" - Notifies that the
8493                            golbal volume of the sampler is changed, where &lt;volume&gt; will be
8494                            replaced by the optional dotted floating point value, reflecting the
8495                            new global volume parameter.
8496    </p>
8497    </blockquote><p>
8498                    
8499    </p>
8500  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
8501  <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>
8502  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;  <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
8503  Miscellaneous and debugging events</h3>  Miscellaneous and debugging events</h3>
8504    
8505  <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 8189  Schoenebeck</td></tr> Line 8594  Schoenebeck</td></tr>
8594  <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>
8595  <h3>Full Copyright Statement</h3>  <h3>Full Copyright Statement</h3>
8596  <p class='copyright'>  <p class='copyright'>
8597  Copyright &copy; The Internet Society (2006).</p>  Copyright &copy; The IETF Trust (2007).</p>
8598  <p class='copyright'>  <p class='copyright'>
8599  This document is subject to the rights,  This document is subject to the rights,
8600  licenses and restrictions contained in BCP&nbsp;78,  licenses and restrictions contained in BCP&nbsp;78,
# Line 8198  the authors retain all their rights.</p> Line 8603  the authors retain all their rights.</p>
8603  <p class='copyright'>  <p class='copyright'>
8604  This document and the information contained herein are provided  This document and the information contained herein are provided
8605  on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,  on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,
8606  THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY),  THE ORGANIZATION HE/SHE REPRESENTS
8607  THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM  OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST
8608  ALL WARRANTIES,  AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES,
8609  EXPRESS OR IMPLIED,  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT
8610  INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE  THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY
8611  INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED  IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
8612  WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>  PURPOSE.</p>
8613  <h3>Intellectual Property</h3>  <h3>Intellectual Property</h3>
8614  <p class='copyright'>  <p class='copyright'>
8615  The IETF takes no position regarding the validity or scope of any  The IETF takes no position regarding the validity or scope of any
Legend:
Removed from v.1002  
changed lines
  Added in v.1110
  ViewVC Help
Powered by ViewVC