/[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 992 by iliev, Wed Dec 20 19:52:00 2006 UTC revision 1137 by iliev, Thu Mar 29 10:06:37 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 23, 2007</td><td class="header">December 20, 2006</td></tr>  <tr><td class="header">Expires: September 30, 2007</td><td class="header">March 29, 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 23, 2007.</p>  This Internet-Draft will expire on September 30, 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 318  Muting a sampler channel<br /> Line 318  Muting a sampler channel<br />
318  Soloing a sampler channel<br />  Soloing a sampler channel<br />
319  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INSTRUMENT_MAP">6.4.24.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INSTRUMENT_MAP">6.4.24.</a>&nbsp;
320  Assigning a MIDI instrument map to a sampler channel<br />  Assigning a MIDI instrument map to a sampler channel<br />
321  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.25.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CREATE FX_SEND">6.4.25.</a>&nbsp;
322    Adding an effect send to a sampler channel<br />
323    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#DESTROY FX_SEND">6.4.26.</a>&nbsp;
324    Removing an effect send from a sampler channel<br />
325    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FX_SENDS">6.4.27.</a>&nbsp;
326    Getting amount of effect sends on a sampler channel<br />
327    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST FX_SENDS">6.4.28.</a>&nbsp;
328    Listing all effect sends on a sampler channel<br />
329    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FX_SEND INFO">6.4.29.</a>&nbsp;
330    Getting effect send information<br />
331    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND NAME">6.4.30.</a>&nbsp;
332    Changing effect send's name<br />
333    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND AUDIO_OUTPUT_CHANNEL">6.4.31.</a>&nbsp;
334    Altering effect send's audio routing<br />
335    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND MIDI_CONTROLLER">6.4.32.</a>&nbsp;
336    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;
338    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;
340  Resetting a sampler channel<br />  Resetting a sampler channel<br />
341  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
342  Controlling connection<br />  Controlling connection<br />
# Line 340  Maximum amount of active voices<br /> Line 358  Maximum amount of active voices<br />
358  Reset sampler<br />  Reset sampler<br />
359  &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;
360  General sampler informations<br />  General sampler informations<br />
361    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOLUME">6.6.5.</a>&nbsp;
362    Getting global volume attenuation<br />
363    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOLUME">6.6.6.</a>&nbsp;
364    Setting global volume attenuation<br />
365  &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;
366  MIDI Instrument Mapping<br />  MIDI Instrument Mapping<br />
367  &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 388  Number of active disk streams changed<br Line 410  Number of active disk streams changed<br
410  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
411  &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;
412  Channel information changed<br />  Channel information changed<br />
413  &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;
414    Number of effect sends changed<br />
415    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.11.</a>&nbsp;
416    Effect send information changed<br />
417    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.12.</a>&nbsp;
418  Total number of active voices changed<br />  Total number of active voices changed<br />
419  &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;
420  Number of MIDI instrument maps changed<br />  Number of MIDI instrument maps changed<br />
421  &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;
422  MIDI instrument map information changed<br />  MIDI instrument map information changed<br />
423  &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;
424  Number of MIDI instruments changed<br />  Number of MIDI instruments changed<br />
425  &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;
426  MIDI instrument information changed<br />  MIDI instrument information changed<br />
427  &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;
428    Global settings changed<br />
429    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.18.</a>&nbsp;
430  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
431  <a href="#anchor14">9.</a>&nbsp;  <a href="#anchor14">9.</a>&nbsp;
432  Security Considerations<br />  Security Considerations<br />
# Line 3942  Getting sampler channel information</h3> Line 3970  Getting sampler channel information</h3>
3970                                          </p>                                          </p>
3971  <blockquote class="text">  <blockquote class="text">
3972  <p>optionally dotted number for the channel volume factor  <p>optionally dotted number for the channel volume factor
3973                                              (where a value < 1.0 means attenuation and a value >                                              (where a value &lt; 1.0 means attenuation and a value >
3974                                              1.0 means amplification)                                              1.0 means amplification)
3975  </p>  </p>
3976  </blockquote>  </blockquote>
# Line 4949  Assigning a MIDI instrument map to a sam Line 4977  Assigning a MIDI instrument map to a sam
4977  </blockquote><p>  </blockquote><p>
4978                                            
4979  </p>  </p>
4980  <a name="RESET CHANNEL"></a><br /><hr />  <a name="CREATE FX_SEND"></a><br /><hr />
4981  <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>
4982  <a name="rfc.section.6.4.25"></a><h3>6.4.25.&nbsp;  <a name="rfc.section.6.4.25"></a><h3>6.4.25.&nbsp;
4983    Adding an effect send to a sampler channel</h3>
4984    
4985    <p>The front-end can create an additional effect send on a specific sampler channel
4986                        by sending the following command:
4987    </p>
4988    <p>
4989                            </p>
4990    <blockquote class="text">
4991    <p>CREATE FX_SEND &lt;sampler-channel&gt; &lt;midi-ctrl&gt; [&lt;name&gt;]
4992    </p>
4993    </blockquote><p>
4994                        
4995    </p>
4996    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4997                        number 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>
4998                        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, that is the
4999                        sampler channel on which the effect send should be created on, &lt;midi-ctrl&gt;
5000                        is a number between 0..127 defining the MIDI controller which can alter the
5001                        effect send level and &lt;name&gt; is an optional argument defining a name
5002                        for the effect send entity. The name does not have to be unique.
5003    </p>
5004    <p>By default, that is as initial routing, the effect send's audio channels
5005                        are automatically routed to the last audio channels of the sampler channel's
5006                        audio output device, that way you can i.e. first increase the amount of audio
5007                        channels on the audio output device for having dedicated effect send output
5008                        channels and when "CREATE FX_SEND" is called, those channels will automatically
5009                        be picked. You can alter the destination channels however with
5010                        <a class='info' href='#SET FX_SEND AUDIO_OUTPUT_CHANNEL'>"SET FX_SEND AUDIO_OUTPUT_CHANNEL"<span> (</span><span class='info'>Altering effect send's audio routing</span><span>)</span></a>.
5011                        
5012    </p>
5013    <p>Note: Create effect sends on a sampler channel only when needed, because having effect
5014                        sends on a sampler channel will decrease runtime performance, because for implementing channel
5015                        effect sends, separate (sampler channel local) audio buffers are needed to render and mix
5016                        the voices and route the audio signal afterwards to the master outputs and effect send
5017                        outputs (along with their respective effect send levels). A sampler channel without effect
5018                        sends however can mix its voices directly into the audio output devices's audio buffers
5019                        and is thus faster.
5020                        
5021    </p>
5022    <p>Possible Answers:
5023    </p>
5024    <p>
5025                            </p>
5026    <blockquote class="text">
5027    <p>"OK[&lt;fx-send-id&gt;]" -
5028                                    </p>
5029    <blockquote class="text">
5030    <p>in case a new effect send could be added to the
5031                                        sampler channel, where &lt;fx-send-id&gt; reflects the
5032                                        unique ID of the newly created effect send entity
5033    </p>
5034    </blockquote>
5035                                
5036    
5037    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5038                                    </p>
5039    <blockquote class="text">
5040    <p>when a new effect send could not be added, i.e.
5041                                        due to invalid parameters
5042    </p>
5043    </blockquote>
5044                                
5045    
5046    </blockquote><p>
5047                        
5048    </p>
5049    <p>Examples:
5050    </p>
5051    <p>
5052                            </p>
5053    <blockquote class="text">
5054    <p>C: "CREATE FX_SEND 0 91 'Reverb Send'"
5055    </p>
5056    <p>S: "OK[0]"
5057    </p>
5058    </blockquote><p>
5059                        
5060    </p>
5061    <p>
5062                            </p>
5063    <blockquote class="text">
5064    <p>C: "CREATE FX_SEND 0 93"
5065    </p>
5066    <p>S: "OK[1]"
5067    </p>
5068    </blockquote><p>
5069                        
5070    </p>
5071    <a name="DESTROY FX_SEND"></a><br /><hr />
5072    <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>
5073    <a name="rfc.section.6.4.26"></a><h3>6.4.26.&nbsp;
5074    Removing an effect send from a sampler channel</h3>
5075    
5076    <p>The front-end can remove an existing effect send on a specific sampler channel
5077                        by sending the following command:
5078    </p>
5079    <p>
5080                            </p>
5081    <blockquote class="text">
5082    <p>DESTROY FX_SEND &lt;sampler-channel&gt; &lt;fx-send-id&gt;
5083    </p>
5084    </blockquote><p>
5085                        
5086    </p>
5087    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
5088                        number 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>
5089                        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, that is the
5090                        sampler channel from which the effect send should be removed from and
5091                        &lt;fx-send-id&gt; is the respective effect send number as returned by the
5092                        <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>
5093                        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.
5094    </p>
5095    <p>Possible Answers:
5096    </p>
5097    <p>
5098                            </p>
5099    <blockquote class="text">
5100    <p>"OK" -
5101                                    </p>
5102    <blockquote class="text">
5103    <p>on success
5104    </p>
5105    </blockquote>
5106                                
5107    
5108    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5109                                    </p>
5110    <blockquote class="text">
5111    <p>in case it failed, providing an appropriate error code and
5112                                        error message
5113    </p>
5114    </blockquote>
5115                                
5116    
5117    </blockquote><p>
5118                        
5119    </p>
5120    <p>Example:
5121    </p>
5122    <p>
5123                            </p>
5124    <blockquote class="text">
5125    <p>C: "DESTROY FX_SEND 0 0"
5126    </p>
5127    <p>S: "OK"
5128    </p>
5129    </blockquote><p>
5130                        
5131    </p>
5132    <a name="GET FX_SENDS"></a><br /><hr />
5133    <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>
5134    <a name="rfc.section.6.4.27"></a><h3>6.4.27.&nbsp;
5135    Getting amount of effect sends on a sampler channel</h3>
5136    
5137    <p>The front-end can ask for the amount of effect sends on a specific sampler channel
5138                        by sending the following command:
5139    </p>
5140    <p>
5141                            </p>
5142    <blockquote class="text">
5143    <p>GET FX_SENDS &lt;sampler-channel&gt;
5144    </p>
5145    </blockquote><p>
5146                        
5147    </p>
5148    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
5149                        number 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>
5150                        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.
5151    </p>
5152    <p>Possible Answers:
5153    </p>
5154    <p>
5155                            </p>
5156    <blockquote class="text">
5157    <p>The sampler will answer by returning the number of effect
5158                                sends on the given sampler channel.
5159    </p>
5160    </blockquote><p>
5161                        
5162    </p>
5163    <p>Example:
5164    </p>
5165    <p>
5166                            </p>
5167    <blockquote class="text">
5168    <p>C: "GET FX_SENDS 0"
5169    </p>
5170    <p>S: "2"
5171    </p>
5172    </blockquote><p>
5173                        
5174    </p>
5175    <a name="LIST FX_SENDS"></a><br /><hr />
5176    <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>
5177    <a name="rfc.section.6.4.28"></a><h3>6.4.28.&nbsp;
5178    Listing all effect sends on a sampler channel</h3>
5179    
5180    <p>The front-end can ask for a list of effect sends on a specific sampler channel
5181                        by sending the following command:
5182    </p>
5183    <p>
5184                            </p>
5185    <blockquote class="text">
5186    <p>LIST FX_SENDS &lt;sampler-channel&gt;
5187    </p>
5188    </blockquote><p>
5189                        
5190    </p>
5191    <p>Where &lt;sampler-channel&gt; is the respective sampler channel
5192                        number 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>
5193                        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.
5194    </p>
5195    <p>Possible Answers:
5196    </p>
5197    <p>
5198                            </p>
5199    <blockquote class="text">
5200    <p>The sampler will answer by returning a comma separated list
5201                                with all effect sends' numerical IDs on the given sampler
5202                                channel.
5203    </p>
5204    </blockquote><p>
5205                        
5206    </p>
5207    <p>Examples:
5208    </p>
5209    <p>
5210                            </p>
5211    <blockquote class="text">
5212    <p>C: "LIST FX_SENDS 0"
5213    </p>
5214    <p>S: "0,1"
5215    </p>
5216    </blockquote><p>
5217                        
5218    </p>
5219    <p>
5220                            </p>
5221    <blockquote class="text">
5222    <p>C: "LIST FX_SENDS 1"
5223    </p>
5224    <p>S: ""
5225    </p>
5226    </blockquote><p>
5227                        
5228    </p>
5229    <a name="GET FX_SEND INFO"></a><br /><hr />
5230    <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>
5231    <a name="rfc.section.6.4.29"></a><h3>6.4.29.&nbsp;
5232    Getting effect send information</h3>
5233    
5234    <p>The front-end can ask for the current settings of an effect send entity
5235                        by sending the following command:
5236    </p>
5237    <p>
5238                            </p>
5239    <blockquote class="text">
5240    <p>GET FX_SEND INFO &lt;sampler-channel&gt; &lt;fx-send-id&gt;
5241    </p>
5242    </blockquote><p>
5243                        
5244    </p>
5245    <p>Where &lt;sampler-channel&gt; is the sampler channel number
5246                        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>
5247                        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 and
5248                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5249                        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>
5250                        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.
5251                      
5252    </p>
5253    <p>Possible Answers:
5254    </p>
5255    <p>
5256                            </p>
5257    <blockquote class="text">
5258    <p>The sampler will answer by sending a &lt;CRLF&gt; separated list.
5259                                Each answer line begins with the settings category name
5260                                followed by a colon and then a space character &lt;SP&gt; and finally
5261                                the info character string to that setting category. At the
5262                                moment the following categories are defined:
5263    </p>
5264    <p>
5265                                    </p>
5266    <blockquote class="text">
5267    <p>NAME -
5268                                            </p>
5269    <blockquote class="text">
5270    <p>name of the effect send entity
5271    </p>
5272    </blockquote>
5273                                        
5274    
5275    <p>MIDI_CONTROLLER -
5276                                            </p>
5277    <blockquote class="text">
5278    <p>a value between 0 and 127 reflecting the MIDI controller
5279                                                which is able to modify the effect send's send level
5280    </p>
5281    </blockquote>
5282                                        
5283    
5284    <p>LEVEL -
5285                                            </p>
5286    <blockquote class="text">
5287    <p>optionally dotted number reflecting the effect send's
5288                                                current send level (where a value &lt; 1.0 means attenuation
5289                                                and a value > 1.0 means amplification)
5290    </p>
5291    </blockquote>
5292                                        
5293    
5294    <p>AUDIO_OUTPUT_ROUTING -
5295                                            </p>
5296    <blockquote class="text">
5297    <p>comma separated list which reflects to which audio
5298                                                channel of the selected audio output device each
5299                                                effect send output channel is routed to, e.g. "0,3" would
5300                                                mean the effect send's output channel 0 is routed to channel
5301                                                0 of the audio output device and the effect send's output
5302                                                channel 1 is routed to the channel 3 of the audio
5303                                                output device (see
5304                                                <a class='info' href='#SET FX_SEND AUDIO_OUTPUT_CHANNEL'>"SET FX_SEND AUDIO_OUTPUT_CHANNEL"<span> (</span><span class='info'>Altering effect send's audio routing</span><span>)</span></a>
5305                                                for details)
5306    </p>
5307    </blockquote>
5308                                        
5309    
5310    </blockquote>
5311                                
5312    
5313    </blockquote><p>
5314                        
5315    </p>
5316    <p>The mentioned fields above don't have to be in particular order.
5317    </p>
5318    <p>Example:
5319    </p>
5320    <p>
5321                            </p>
5322    <blockquote class="text">
5323    <p>C: "GET FX_SEND INFO 0 0"
5324    </p>
5325    <p>S: "NAME: Reverb Send"
5326    </p>
5327    <p>&nbsp;&nbsp;&nbsp;"MIDI_CONTROLLER: 91"
5328    </p>
5329    <p>&nbsp;&nbsp;&nbsp;"LEVEL: 0.3"
5330    </p>
5331    <p>&nbsp;&nbsp;&nbsp;"AUDIO_OUTPUT_ROUTING: 2,3"
5332    </p>
5333    <p>&nbsp;&nbsp;&nbsp;"."
5334    </p>
5335    </blockquote><p>
5336                        
5337    </p>
5338    <a name="SET FX_SEND NAME"></a><br /><hr />
5339    <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>
5340    <a name="rfc.section.6.4.30"></a><h3>6.4.30.&nbsp;
5341    Changing effect send's name</h3>
5342    
5343    <p>The front-end can alter the current name of an effect
5344                        send entity by sending the following command:
5345    </p>
5346    <p>
5347                            </p>
5348    <blockquote class="text">
5349    <p>SET FX_SEND NAME &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;name&gt;
5350    </p>
5351    </blockquote><p>
5352                        
5353    </p>
5354    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5355                        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>
5356                        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,
5357                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5358                        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>
5359                        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
5360                        &lt;name&gt; is the new name of the effect send entity, which
5361                        does not have to be unique.
5362    </p>
5363    <p>Possible Answers:
5364    </p>
5365    <p>
5366                            </p>
5367    <blockquote class="text">
5368    <p>"OK" -
5369                                    </p>
5370    <blockquote class="text">
5371    <p>on success
5372    </p>
5373    </blockquote>
5374                                
5375    
5376    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5377                                    </p>
5378    <blockquote class="text">
5379    <p>in case it failed, providing an appropriate error code and error message
5380    </p>
5381    </blockquote>
5382                                
5383    
5384    </blockquote><p>
5385                        
5386    </p>
5387    <p>Example:
5388    </p>
5389    <p>
5390                            </p>
5391    <blockquote class="text">
5392    <p>C: "SET FX_SEND NAME 0 0 'Fx Send 1'"
5393    </p>
5394    <p>S: "OK"
5395    </p>
5396    </blockquote><p>
5397                        
5398    </p>
5399    <a name="SET FX_SEND AUDIO_OUTPUT_CHANNEL"></a><br /><hr />
5400    <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>
5401    <a name="rfc.section.6.4.31"></a><h3>6.4.31.&nbsp;
5402    Altering effect send's audio routing</h3>
5403    
5404    <p>The front-end can alter the destination of an effect send's audio channel on a specific
5405                        sampler channel by sending the following command:
5406    </p>
5407    <p>
5408                            </p>
5409    <blockquote class="text">
5410    <p>SET FX_SEND AUDIO_OUTPUT_CHANNEL &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;audio-src&gt; &lt;audio-dst&gt;
5411    </p>
5412    </blockquote><p>
5413                        
5414    </p>
5415    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5416                        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>
5417                        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,
5418                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5419                        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>
5420                        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,
5421                        &lt;audio-src&gt; is the numerical ID of the effect send's audio channel
5422                        which should be rerouted and &lt;audio-dst&gt; is the numerical ID of
5423                        the audio channel of the selected audio output device where &lt;audio-src&gt;
5424                        should be routed to.
5425    </p>
5426    <p>Note that effect sends can only route audio to the same audio output
5427                        device as assigned to the effect send's sampler channel. Also note that an
5428                        effect send entity does always have exactly as much audio channels as its
5429                        sampler channel. So if the sampler channel is stereo, the effect send does
5430                        have two audio channels as well. Also keep in mind that the amount of audio
5431                        channels on a sampler channel might be dependant not only to the deployed
5432                        sampler engine on the sampler channel, but also dependant to the instrument
5433                        currently loaded. However you can (effectively) turn an i.e. stereo effect
5434                        send into a mono one by simply altering its audio routing appropriately.
5435    </p>
5436    <p>Possible Answers:
5437    </p>
5438    <p>
5439                            </p>
5440    <blockquote class="text">
5441    <p>"OK" -
5442                                    </p>
5443    <blockquote class="text">
5444    <p>on success
5445    </p>
5446    </blockquote>
5447                                
5448    
5449    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5450                                    </p>
5451    <blockquote class="text">
5452    <p>if audio output channel was set, but there are noteworthy
5453                                        issue(s) related, providing an appropriate warning code and
5454                                        warning message
5455    </p>
5456    </blockquote>
5457                                
5458    
5459    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5460                                    </p>
5461    <blockquote class="text">
5462    <p>in case it failed, providing an appropriate error code and error message
5463    </p>
5464    </blockquote>
5465                                
5466    
5467    </blockquote><p>
5468                        
5469    </p>
5470    <p>Example:
5471    </p>
5472    <p>
5473                            </p>
5474    <blockquote class="text">
5475    <p>C: "SET FX_SEND AUDIO_OUTPUT_CHANNEL 0 0 0 2"
5476    </p>
5477    <p>S: "OK"
5478    </p>
5479    </blockquote><p>
5480                        
5481    </p>
5482    <a name="SET FX_SEND MIDI_CONTROLLER"></a><br /><hr />
5483    <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>
5484    <a name="rfc.section.6.4.32"></a><h3>6.4.32.&nbsp;
5485    Altering effect send's MIDI controller</h3>
5486    
5487    <p>The front-end can alter the MIDI controller of an effect
5488                        send entity by sending the following command:
5489    </p>
5490    <p>
5491                            </p>
5492    <blockquote class="text">
5493    <p>SET FX_SEND MIDI_CONTROLLER &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;midi-ctrl&gt;
5494    </p>
5495    </blockquote><p>
5496                        
5497    </p>
5498    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5499                        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>
5500                        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,
5501                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5502                        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>
5503                        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
5504                        &lt;midi-ctrl&gt; reflects the MIDI controller which shall be
5505                        able to modify the effect send's send level.
5506    </p>
5507    <p>Possible Answers:
5508    </p>
5509    <p>
5510                            </p>
5511    <blockquote class="text">
5512    <p>"OK" -
5513                                    </p>
5514    <blockquote class="text">
5515    <p>on success
5516    </p>
5517    </blockquote>
5518                                
5519    
5520    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5521                                    </p>
5522    <blockquote class="text">
5523    <p>if MIDI controller was set, but there are noteworthy
5524                                        issue(s) related, providing an appropriate warning code and
5525                                        warning message
5526    </p>
5527    </blockquote>
5528                                
5529    
5530    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5531                                    </p>
5532    <blockquote class="text">
5533    <p>in case it failed, providing an appropriate error code and error message
5534    </p>
5535    </blockquote>
5536                                
5537    
5538    </blockquote><p>
5539                        
5540    </p>
5541    <p>Example:
5542    </p>
5543    <p>
5544                            </p>
5545    <blockquote class="text">
5546    <p>C: "SET FX_SEND MIDI_CONTROLLER 0 0 91"
5547    </p>
5548    <p>S: "OK"
5549    </p>
5550    </blockquote><p>
5551                        
5552    </p>
5553    <a name="SET FX_SEND LEVEL"></a><br /><hr />
5554    <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>
5555    <a name="rfc.section.6.4.33"></a><h3>6.4.33.&nbsp;
5556    Altering effect send's send level</h3>
5557    
5558    <p>The front-end can alter the current send level of an effect
5559                        send entity by sending the following command:
5560    </p>
5561    <p>
5562                            </p>
5563    <blockquote class="text">
5564    <p>SET FX_SEND LEVEL &lt;sampler-chan&gt; &lt;fx-send-id&gt; &lt;volume&gt;
5565    </p>
5566    </blockquote><p>
5567                        
5568    </p>
5569    <p>Where &lt;sampler-chan&gt; is the sampler channel number
5570                        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>
5571                        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,
5572                        &lt;fx-send-id&gt; reflects the numerical ID of the effect send entity
5573                        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>
5574                        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
5575                        &lt;volume&gt; is an optionally dotted positive number (a value
5576                        smaller than 1.0 means attenuation, whereas a value greater than
5577                        1.0 means amplification) reflecting the new send level.
5578    </p>
5579    <p>Possible Answers:
5580    </p>
5581    <p>
5582                            </p>
5583    <blockquote class="text">
5584    <p>"OK" -
5585                                    </p>
5586    <blockquote class="text">
5587    <p>on success
5588    </p>
5589    </blockquote>
5590                                
5591    
5592    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
5593                                    </p>
5594    <blockquote class="text">
5595    <p>if new send level was set, but there are noteworthy
5596                                        issue(s) related, providing an appropriate warning code and
5597                                        warning message
5598    </p>
5599    </blockquote>
5600                                
5601    
5602    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5603                                    </p>
5604    <blockquote class="text">
5605    <p>in case it failed, providing an appropriate error code and error message
5606    </p>
5607    </blockquote>
5608                                
5609    
5610    </blockquote><p>
5611                        
5612    </p>
5613    <p>Example:
5614    </p>
5615    <p>
5616                            </p>
5617    <blockquote class="text">
5618    <p>C: "SET FX_SEND LEVEL 0 0 0.15"
5619    </p>
5620    <p>S: "OK"
5621    </p>
5622    </blockquote><p>
5623                        
5624    </p>
5625    <a name="RESET CHANNEL"></a><br /><hr />
5626    <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>
5627    <a name="rfc.section.6.4.34"></a><h3>6.4.34.&nbsp;
5628  Resetting a sampler channel</h3>  Resetting a sampler channel</h3>
5629    
5630  <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 5392  General sampler informations</h3> Line 6065  General sampler informations</h3>
6065  <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.
6066                      Other fields might be added in future.                      Other fields might be added in future.
6067  </p>  </p>
6068    <a name="GET VOLUME"></a><br /><hr />
6069    <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>
6070    <a name="rfc.section.6.6.5"></a><h3>6.6.5.&nbsp;
6071    Getting global volume attenuation</h3>
6072    
6073    <p>The client can ask for the current global sampler-wide volume
6074                        attenuation by sending the following command:
6075    </p>
6076    <p>
6077                            </p>
6078    <blockquote class="text">
6079    <p>GET VOLUME
6080    </p>
6081    </blockquote><p>
6082                        
6083    </p>
6084    <p>Possible Answers:
6085    </p>
6086    <p>
6087                            </p>
6088    <blockquote class="text">
6089    <p>The sampler will always answer by returning the optional
6090                                dotted floating point coefficient, reflecting the current
6091                                global volume attenuation.
6092                                
6093    </p>
6094    </blockquote><p>
6095                        
6096    </p>
6097    <p>Note: it is up to the respective sampler engine whether to obey
6098                        that global volume parameter or not, but in general all engines SHOULD
6099                        use this parameter.
6100    </p>
6101    <a name="SET VOLUME"></a><br /><hr />
6102    <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>
6103    <a name="rfc.section.6.6.6"></a><h3>6.6.6.&nbsp;
6104    Setting global volume attenuation</h3>
6105    
6106    <p>The client can alter the current global sampler-wide volume
6107                        attenuation by sending the following command:
6108    </p>
6109    <p>
6110                            </p>
6111    <blockquote class="text">
6112    <p>SET VOLUME &lt;volume&gt;
6113    </p>
6114    </blockquote><p>
6115                        
6116    </p>
6117    <p>Where &lt;volume&gt; should be replaced by the optional dotted
6118                       floating point value, reflecting the new global volume parameter.
6119                       This value might usually be in the range between 0.0 and 1.0, that
6120                       is for attenuating the overall volume.
6121    </p>
6122    <p>Possible Answers:
6123    </p>
6124    <p>
6125                            </p>
6126    <blockquote class="text">
6127    <p>"OK" -
6128                                    </p>
6129    <blockquote class="text">
6130    <p>on success
6131    </p>
6132    </blockquote>
6133                                
6134    
6135    <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
6136                                    </p>
6137    <blockquote class="text">
6138    <p>if the global volume was set, but there are noteworthy
6139                                        issue(s) related, providing an appropriate warning code and
6140                                        warning message
6141    </p>
6142    </blockquote>
6143                                
6144    
6145    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
6146                                    </p>
6147    <blockquote class="text">
6148    <p>in case it failed, providing an appropriate error code and error message
6149    </p>
6150    </blockquote>
6151                                
6152    
6153    </blockquote><p>
6154                        
6155    </p>
6156  <a name="MIDI Instrument Mapping"></a><br /><hr />  <a name="MIDI Instrument Mapping"></a><br /><hr />
6157  <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>
6158  <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;  <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;
# Line 5706  Getting MIDI instrument map information< Line 6467  Getting MIDI instrument map information<
6467  </blockquote>  </blockquote>
6468                                                                            
6469    
6470    <p>DEFAULT -
6471                                            </p>
6472    <blockquote class="text">
6473    <p>either true or false,
6474                                                defines whether this map is the default map
6475    </p>
6476    </blockquote>
6477                                        
6478    
6479  </blockquote>  </blockquote>
6480                                                            
6481    
# Line 5723  Getting MIDI instrument map information< Line 6493  Getting MIDI instrument map information<
6493  </p>  </p>
6494  <p>S: "NAME: Standard Map"  <p>S: "NAME: Standard Map"
6495  </p>  </p>
6496    <p>&nbsp;&nbsp;&nbsp;"DEFAULT: true"
6497    </p>
6498  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
6499  </p>  </p>
6500  </blockquote><p>  </blockquote><p>
# Line 5796  Create or replace a MIDI instrument map Line 6568  Create or replace a MIDI instrument map
6568  <p>  <p>
6569                          </p>                          </p>
6570  <blockquote class="text">  <blockquote class="text">
6571  <p>MAP MIDI_INSTRUMENT &lt;map&gt;  <p>MAP MIDI_INSTRUMENT [NON_MODAL] &lt;map&gt;
6572                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;                              &lt;midi_bank&gt; &lt;midi_prog&gt; &lt;engine_name&gt;
6573                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;                              &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
6574                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]                              [&lt;instr_load_mode&gt;] [&lt;name&gt;]
# Line 5816  Create or replace a MIDI instrument map Line 6588  Create or replace a MIDI instrument map
6588                      &lt;instrument_index&gt; the index (integer value) of the instrument                      &lt;instrument_index&gt; the index (integer value) of the instrument
6589                      within the given file, &lt;volume_value&gt; reflects the master                      within the given file, &lt;volume_value&gt; reflects the master
6590                      volume of the instrument as optionally dotted number (where a                      volume of the instrument as optionally dotted number (where a
6591                      value < 1.0 means attenuation and a value > 1.0 means                      value &lt; 1.0 means attenuation and a value > 1.0 means
6592                      amplification). This parameter easily allows to adjust the                      amplification). This parameter easily allows to adjust the
6593                      volume of all intruments within a custom instrument map                      volume of all intruments within a custom instrument map
6594                      without having to adjust their instrument files. The                      without having to adjust their instrument files. The
# Line 5860  Create or replace a MIDI instrument map Line 6632  Create or replace a MIDI instrument map
6632                                  </p>                                  </p>
6633  <blockquote class="text">  <blockquote class="text">
6634  <p>The instrument will immediately be loaded  <p>The instrument will immediately be loaded
6635                                      into memory in the background when this mapping                                      into memory when this mapping
6636                                      command is sent and the instrument is kept all                                      command is sent and the instrument is kept all
6637                                      the time. Instruments with this mode are                                      the time. Instruments with this mode are
6638                                      only freed when the sampler is reset or all                                      only freed when the sampler is reset or all
# Line 5917  Create or replace a MIDI instrument map Line 6689  Create or replace a MIDI instrument map
6689                                            
6690  </p>  </p>
6691  <p>  <p>
6692                      The "MAP MIDI_INSTRUMENT" command                      By default, "MAP MIDI_INSTRUMENT" commands block until the mapping is
6693                      will immediately return, thus it will not block when an                      completely established in the sampler. The OPTIONAL "NON_MODAL" argument
6694                      instrument is to be loaded due to a "PERSISTENT" type                      however causes the respective "MAP MIDI_INSTRUMENT" command to return
6695                      entry as instruments are loaded in the background. As a                      immediately, that is to let the sampler establish the mapping in the
6696                      consequence this command may not necessarily return an error                      background. So this argument might be especially useful for mappings with
6697                      i.e. when the given instrument file does not exist or may                      a "PERSISTENT" type, because these have to load the respective instruments
6698                      turn out to be corrupt.                      immediately and might thus block for a very long time. It is recommended
6699                        however to use the OPTIONAL "NON_MODAL" argument only if really necessary,
6700                        because it has the following drawbacks: as "NON_MODAL" instructions return
6701                        immediately, they may not necessarily return an error i.e. when the given
6702                        instrument file turns out to be corrupt, beside that subsequent commands
6703                        in a LSCP instruction sequence might fail, because mandatory mappings are
6704                        not yet completed.
6705                                            
6706  </p>  </p>
6707  <p>Possible Answers:  <p>Possible Answers:
# Line 5990  Create or replace a MIDI instrument map Line 6768  Create or replace a MIDI instrument map
6768  <p>  <p>
6769                          </p>                          </p>
6770  <blockquote class="text">  <blockquote class="text">
6771  <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'"
6772  </p>  </p>
6773  <p>S: "OK"  <p>S: "OK"
6774  </p>  </p>
# Line 6279  Get current settings of MIDI instrument Line 7057  Get current settings of MIDI instrument
7057                                  </p>                                  </p>
7058  <blockquote class="text">  <blockquote class="text">
7059  <p>master volume of the instrument as optionally  <p>master volume of the instrument as optionally
7060                                      dotted number (where a value < 1.0 means attenuation                                      dotted number (where a value &lt; 1.0 means attenuation
7061                                      and a value > 1.0 means amplification)                                      and a value > 1.0 means amplification)
7062  </p>  </p>
7063  </blockquote>  </blockquote>
# Line 6551  Command Syntax</h3> Line 7329  Command Syntax</h3>
7329  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
7330                                    
7331  </p>  </p>
7332    <p>/ FX_SEND_COUNT
7333                    
7334    </p>
7335    <p>/ FX_SEND_INFO
7336                    
7337    </p>
7338  <p>/ MIDI_INSTRUMENT_MAP_COUNT  <p>/ MIDI_INSTRUMENT_MAP_COUNT
7339                                    
7340  </p>  </p>
# Line 6569  Command Syntax</h3> Line 7353  Command Syntax</h3>
7353  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
7354                                    
7355  </p>  </p>
7356    <p>/ GLOBAL_INFO
7357                    
7358    </p>
7359  </blockquote><p>  </blockquote><p>
7360    
7361  </p>  </p>
# Line 6602  Command Syntax</h3> Line 7389  Command Syntax</h3>
7389  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
7390                                    
7391  </p>  </p>
7392    <p>/ FX_SEND_COUNT
7393                    
7394    </p>
7395    <p>/ FX_SEND_INFO
7396                    
7397    </p>
7398  <p>/ MIDI_INSTRUMENT_MAP_COUNT  <p>/ MIDI_INSTRUMENT_MAP_COUNT
7399                                    
7400  </p>  </p>
# Line 6620  Command Syntax</h3> Line 7413  Command Syntax</h3>
7413  <p>/ TOTAL_VOICE_COUNT  <p>/ TOTAL_VOICE_COUNT
7414                                    
7415  </p>  </p>
7416    <p>/ GLOBAL_INFO
7417                    
7418    </p>
7419  </blockquote><p>  </blockquote><p>
7420    
7421  </p>  </p>
7422  <p>map_instruction =  <p>map_instruction =
7423          </p>          </p>
7424  <blockquote class="text">  <blockquote class="text">
7425  <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
7426                                    
7427  </p>  </p>
7428  <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
7429                                    
7430  </p>  </p>
7431  <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
7432                                    
7433  </p>  </p>
7434  <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
7435                                    
7436  </p>  </p>
7437  </blockquote><p>  </blockquote><p>
# Line 6761  Command Syntax</h3> Line 7557  Command Syntax</h3>
7557  <p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map  <p>/ MIDI_INSTRUMENT_MAP SP INFO SP midi_map
7558                                    
7559  </p>  </p>
7560    <p>/ FX_SENDS SP sampler_channel
7561                    
7562    </p>
7563    <p>/ FX_SEND SP INFO SP sampler_channel SP fx_send_id
7564                    
7565    </p>
7566    <p>/ VOLUME
7567                    
7568    </p>
7569  </blockquote><p>  </blockquote><p>
7570    
7571  </p>  </p>
# Line 6785  Command Syntax</h3> Line 7590  Command Syntax</h3>
7590  <p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name  <p>/ MIDI_INSTRUMENT_MAP SP NAME SP midi_map SP map_name
7591                                    
7592  </p>  </p>
7593    <p>/ FX_SEND SP NAME SP sampler_channel SP fx_send_id SP fx_send_name
7594                    
7595    </p>
7596    <p>/ FX_SEND SP AUDIO_OUTPUT_CHANNEL SP sampler_channel SP fx_send_id SP audio_channel_index SP audio_channel_index
7597                    
7598    </p>
7599    <p>/ FX_SEND SP MIDI_CONTROLLER SP sampler_channel SP fx_send_id SP midi_ctrl
7600                    
7601    </p>
7602    <p>/ FX_SEND SP LEVEL SP sampler_channel SP fx_send_id SP volume_value
7603                    
7604    </p>
7605  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
7606                                    
7607  </p>  </p>
7608    <p>/ VOLUME SP volume_value
7609                    
7610    </p>
7611  </blockquote><p>  </blockquote><p>
7612    
7613  </p>  </p>
# Line 6806  Command Syntax</h3> Line 7626  Command Syntax</h3>
7626  <p>/ MIDI_INPUT_DEVICE SP string  <p>/ MIDI_INPUT_DEVICE SP string
7627                                    
7628  </p>  </p>
7629    <p>/ FX_SEND SP sampler_channel SP midi_ctrl
7630                    
7631    </p>
7632    <p>/ FX_SEND SP sampler_channel SP midi_ctrl SP fx_send_name
7633                    
7634    </p>
7635  </blockquote><p>  </blockquote><p>
7636    
7637  </p>  </p>
# Line 6839  Command Syntax</h3> Line 7665  Command Syntax</h3>
7665  <p>/ MIDI_INPUT_DEVICE SP number  <p>/ MIDI_INPUT_DEVICE SP number
7666                                    
7667  </p>  </p>
7668    <p>/ FX_SEND SP sampler_channel SP fx_send_id
7669                    
7670    </p>
7671  </blockquote><p>  </blockquote><p>
7672    
7673  </p>  </p>
# Line 6902  Command Syntax</h3> Line 7731  Command Syntax</h3>
7731  </blockquote><p>  </blockquote><p>
7732    
7733  </p>  </p>
7734    <p>modal_arg =
7735            </p>
7736    <blockquote class="text">
7737    <p>/* epsilon (empty argument) */
7738                    
7739    </p>
7740    <p>/ NON_MODAL SP
7741                    
7742    </p>
7743    </blockquote><p>
7744    
7745    </p>
7746  <p>key_val_list =  <p>key_val_list =
7747          </p>          </p>
7748  <blockquote class="text">  <blockquote class="text">
# Line 6956  Command Syntax</h3> Line 7797  Command Syntax</h3>
7797  <p>/ MIDI_INSTRUMENT_MAPS  <p>/ MIDI_INSTRUMENT_MAPS
7798                                    
7799  </p>  </p>
7800    <p>/ FX_SENDS SP sampler_channel
7801                    
7802    </p>
7803  </blockquote><p>  </blockquote><p>
7804    
7805  </p>  </p>
# Line 7079  Command Syntax</h3> Line 7923  Command Syntax</h3>
7923  </blockquote><p>  </blockquote><p>
7924    
7925  </p>  </p>
7926    <p>midi_ctrl =
7927            </p>
7928    <blockquote class="text">
7929    <p>number
7930                    
7931    </p>
7932    </blockquote><p>
7933    
7934    </p>
7935  <p>volume_value =  <p>volume_value =
7936          </p>          </p>
7937  <blockquote class="text">  <blockquote class="text">
# Line 7109  Command Syntax</h3> Line 7962  Command Syntax</h3>
7962  </blockquote><p>  </blockquote><p>
7963    
7964  </p>  </p>
7965    <p>fx_send_id =
7966            </p>
7967    <blockquote class="text">
7968    <p>number
7969                    
7970    </p>
7971    </blockquote><p>
7972    
7973    </p>
7974  <p>engine_name =  <p>engine_name =
7975          </p>          </p>
7976  <blockquote class="text">  <blockquote class="text">
# Line 7145  Command Syntax</h3> Line 8007  Command Syntax</h3>
8007  </blockquote><p>  </blockquote><p>
8008    
8009  </p>  </p>
8010    <p>fx_send_name =
8011            </p>
8012    <blockquote class="text">
8013    <p>stringval
8014                    
8015    </p>
8016    </blockquote><p>
8017    
8018    </p>
8019  <p>param_val_list =  <p>param_val_list =
8020          </p>          </p>
8021  <blockquote class="text">  <blockquote class="text">
# Line 7356  Number of active voices changed</h3> Line 8227  Number of active voices changed</h3>
8227  <p>  <p>
8228                      </p>                      </p>
8229  <blockquote class="text">  <blockquote class="text">
8230  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;"
8231  </p>  </p>
8232  </blockquote><p>  </blockquote><p>
8233                                    
# Line 7459  Channel information changed</h3> Line 8330  Channel information changed</h3>
8330                  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
8331                  message is sufficient here.                  message is sufficient here.
8332  </p>  </p>
8333  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />  <a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr />
8334  <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>
8335  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;  <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
8336    Number of effect sends changed</h3>
8337    
8338    <p>Client may want to be notified when the number of effect sends on
8339                    a particular sampler channel is changed by issuing the following command:
8340    </p>
8341    <p>
8342                        </p>
8343    <blockquote class="text">
8344    <p>SUBSCRIBE FX_SEND_COUNT
8345    </p>
8346    </blockquote><p>
8347                    
8348    </p>
8349    <p>Server will start sending the following notification messages:
8350    </p>
8351    <p>
8352                        </p>
8353    <blockquote class="text">
8354    <p>"NOTIFY:FX_SEND_COUNT:&lt;channel-id&gt; &lt;fx-sends&gt;"
8355    </p>
8356    </blockquote><p>
8357                    
8358    </p>
8359    <p>where &lt;channel-id&gt; will be replaced by the numerical ID of the sampler
8360                    channel, on which the effect sends number is changed and &lt;fx-sends&gt; will
8361                    be replaced by the new number of effect sends on that channel.
8362    </p>
8363    <a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr />
8364    <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>
8365    <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
8366    Effect send information changed</h3>
8367    
8368    <p>Client may want to be notified when changes were made to effect sends on a
8369                    a particular sampler channel by issuing the following command:
8370    </p>
8371    <p>
8372                        </p>
8373    <blockquote class="text">
8374    <p>SUBSCRIBE FX_SEND_INFO
8375    </p>
8376    </blockquote><p>
8377                    
8378    </p>
8379    <p>Server will start sending the following notification messages:
8380    </p>
8381    <p>
8382                        </p>
8383    <blockquote class="text">
8384    <p>"NOTIFY:FX_SEND_INFO:&lt;channel-id&gt; &lt;fx-send-id&gt;"
8385    </p>
8386    </blockquote><p>
8387                    
8388    </p>
8389    <p>where &lt;channel-id&gt; will be replaced by the numerical ID of the sampler
8390                    channel, on which an effect send entity is changed and &lt;fx-send-id&gt; will
8391                    be replaced by the numerical ID of the changed effect send.
8392    </p>
8393    <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
8394    <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>
8395    <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
8396  Total number of active voices changed</h3>  Total number of active voices changed</h3>
8397    
8398  <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 7480  Total number of active voices changed</h Line 8411  Total number of active voices changed</h
8411  <p>  <p>
8412                      </p>                      </p>
8413  <blockquote class="text">  <blockquote class="text">
8414  <p>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;  <p>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;"
8415  </p>  </p>
8416  </blockquote><p>  </blockquote><p>
8417                                    
# Line 7490  Total number of active voices changed</h Line 8421  Total number of active voices changed</h
8421  </p>  </p>
8422  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
8423  <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>
8424  <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;  <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
8425  Number of MIDI instrument maps changed</h3>  Number of MIDI instrument maps changed</h3>
8426    
8427  <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 7519  Number of MIDI instrument maps changed</ Line 8450  Number of MIDI instrument maps changed</
8450  </p>  </p>
8451  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
8452  <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>
8453  <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;  <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
8454  MIDI instrument map information changed</h3>  MIDI instrument map information changed</h3>
8455    
8456  <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 7552  MIDI instrument map information changed< Line 8483  MIDI instrument map information changed<
8483  </p>  </p>
8484  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
8485  <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>
8486  <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
8487  Number of MIDI instruments changed</h3>  Number of MIDI instruments changed</h3>
8488    
8489  <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 7582  Number of MIDI instruments changed</h3> Line 8513  Number of MIDI instruments changed</h3>
8513  </p>  </p>
8514  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
8515  <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>
8516  <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;  <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
8517  MIDI instrument information changed</h3>  MIDI instrument information changed</h3>
8518    
8519  <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 7614  MIDI instrument information changed</h3> Line 8545  MIDI instrument information changed</h3>
8545                  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
8546                  message is sufficient here.                  message is sufficient here.
8547  </p>  </p>
8548    <a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr />
8549    <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>
8550    <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
8551    Global settings changed</h3>
8552    
8553    <p>Client may want to be notified when changes to the global settings
8554                    of the sampler were made by issuing the following command:
8555    </p>
8556    <p>
8557                        </p>
8558    <blockquote class="text">
8559    <p>SUBSCRIBE GLOBAL_INFO
8560    </p>
8561    </blockquote><p>
8562                    
8563    </p>
8564    <p>Server will start sending the following types of notification messages:
8565    </p>
8566    <p>
8567                        </p>
8568    <blockquote class="text">
8569    <p>"NOTIFY:GLOBAL_INFO:VOLUME &lt;volume&gt;" - Notifies that the
8570                            golbal volume of the sampler is changed, where &lt;volume&gt; will be
8571                            replaced by the optional dotted floating point value, reflecting the
8572                            new global volume parameter.
8573    </p>
8574    </blockquote><p>
8575                    
8576    </p>
8577  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
8578  <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>
8579  <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;  <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
8580  Miscellaneous and debugging events</h3>  Miscellaneous and debugging events</h3>
8581    
8582  <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 7711  Schoenebeck</td></tr> Line 8671  Schoenebeck</td></tr>
8671  <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>
8672  <h3>Full Copyright Statement</h3>  <h3>Full Copyright Statement</h3>
8673  <p class='copyright'>  <p class='copyright'>
8674  Copyright &copy; The Internet Society (2006).</p>  Copyright &copy; The IETF Trust (2007).</p>
8675  <p class='copyright'>  <p class='copyright'>
8676  This document is subject to the rights,  This document is subject to the rights,
8677  licenses and restrictions contained in BCP&nbsp;78,  licenses and restrictions contained in BCP&nbsp;78,
# Line 7720  the authors retain all their rights.</p> Line 8680  the authors retain all their rights.</p>
8680  <p class='copyright'>  <p class='copyright'>
8681  This document and the information contained herein are provided  This document and the information contained herein are provided
8682  on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,  on an &ldquo;AS IS&rdquo; basis and THE CONTRIBUTOR,
8683  THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY),  THE ORGANIZATION HE/SHE REPRESENTS
8684  THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM  OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST
8685  ALL WARRANTIES,  AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES,
8686  EXPRESS OR IMPLIED,  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT
8687  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
8688  INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED  IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
8689  WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.</p>  PURPOSE.</p>
8690  <h3>Intellectual Property</h3>  <h3>Intellectual Property</h3>
8691  <p class='copyright'>  <p class='copyright'>
8692  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.992  
changed lines
  Added in v.1137
  ViewVC Help
Powered by ViewVC