/[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 708 by schoenebeck, Thu Jul 21 09:18:40 2005 UTC revision 945 by schoenebeck, Sun Nov 26 16:39:49 2006 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.29 (http://xml.resource.org/)">  <meta name="generator" content="xml2rfc v1.30 (http://xml.resource.org/)">
7  <style type='text/css'>  <style type='text/css'>
8  <!--  <!--
9      body {      body {
# Line 28  Line 28 
28          text-align: center ;          text-align: center ;
29          font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;          font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
30          font-size: x-small ; background-color: #000000; }          font-size: x-small ; background-color: #000000; }
31  /* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */      /* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */
32      div#counter{margin-top: 100px}      div#counter{margin-top: 100px}
33    
34      a.info{      a.info{
# Line 58  Line 58 
58      p { margin-left: 2em; margin-right: 2em; }      p { margin-left: 2em; margin-right: 2em; }
59      p.copyright { font-size: x-small ; }      p.copyright { font-size: x-small ; }
60      p.toc { font-size: small ; font-weight: bold ; margin-left: 3em ;}      p.toc { font-size: small ; font-weight: bold ; margin-left: 3em ;}
61        table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }
62        td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }
63    
64      span.emph { font-style: italic; }      span.emph { font-style: italic; }
65      span.strong { font-weight: bold; }      span.strong { font-weight: bold; }
# Line 95  Line 97 
97          background-color: #666666 ; width: 33% ; }          background-color: #666666 ; width: 33% ; }
98      td.author { font-weight: bold; margin-left: 4em; font-size: x-small ; }      td.author { font-weight: bold; margin-left: 4em; font-size: x-small ; }
99      td.author-text { font-size: x-small; }      td.author-text { font-size: x-small; }
100      table.data { vertical-align: top ; border-collapse: collapse ;      table.full { vertical-align: top ; border-collapse: collapse ;
101          border-style: solid solid solid solid ;          border-style: solid solid solid solid ;
102          border-color: black black black black ;          border-color: black black black black ;
103          font-size: small ; text-align: center ; }          font-size: small ; text-align: center ; }
104      table.data th { font-weight: bold ;      table.headers, table.none { vertical-align: top ; border-collapse: collapse ;
105          border-style: solid solid solid solid ;          border-style: none;
106            font-size: small ; text-align: center ; }
107        table.full th { font-weight: bold ;
108            border-style: solid ;
109            border-color: black black black black ; }
110        table.headers th { font-weight: bold ;
111            border-style: none none solid none;
112          border-color: black black black black ; }          border-color: black black black black ; }
113      table.data td {      table.none th { font-weight: bold ;
114            border-style: none; }
115        table.full td {
116          border-style: solid solid solid solid ;          border-style: solid solid solid solid ;
117          border-color: #333333 #333333 #333333 #333333 ; }          border-color: #333333 #333333 #333333 #333333 ; }
118        table.headers td, table.none td { border-style: none; }
119    
120      hr { height: 1px }      hr { height: 1px }
121  -->  -->
# Line 115  Line 126 
126  <table summary="layout" width="66%" border="0" cellpadding="0" cellspacing="0"><tr><td><table summary="layout" width="100%" border="0" cellpadding="2" cellspacing="1">  <table summary="layout" width="66%" border="0" cellpadding="0" cellspacing="0"><tr><td><table summary="layout" width="100%" border="0" cellpadding="2" cellspacing="1">
127  <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>
128  <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>
129  <tr><td class="header">Expires: November 2, 2005</td><td class="header">Engineering e. V.</td></tr>  <tr><td class="header">Expires: May 30, 2007</td><td class="header">Engineering e. V.</td></tr>
130  <tr><td class="header">&nbsp;</td><td class="header">May 2005</td></tr>  <tr><td class="header">&nbsp;</td><td class="header">November 26, 2006</td></tr>
131  </table></td></tr></table>  </table></td></tr></table>
132  <div align="right"><span class="title"><br />LinuxSampler Control Protocol</span></div>  <div align="right"><span class="title"><br />LinuxSampler Control Protocol</span></div>
133  <div align="right"><span class="title"><br />LSCP 1.1</span></div>  <div align="right"><span class="title"><br />LSCP 1.2</span></div>
134    
135  <h3>Status of this Memo</h3>  <h3>Status of this Memo</h3>
136  <p>  <p>
# Line 142  The list of current Internet-Drafts can Line 153  The list of current Internet-Drafts can
153  The list of Internet-Draft Shadow Directories can be accessed at  The list of Internet-Draft Shadow Directories can be accessed at
154  <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>
155  <p>  <p>
156  This Internet-Draft will expire on November 2, 2005.</p>  This Internet-Draft will expire on May 30, 2007.</p>
157    
158  <h3>Copyright Notice</h3>  <h3>Copyright Notice</h3>
159  <p>  <p>
160  Copyright &copy; The Internet Society (2005). All Rights Reserved.</p>  Copyright &copy; The Internet Society (2006). All Rights Reserved.</p>
161    
162  <h3>Abstract</h3>  <h3>Abstract</h3>
163    
# Line 169  Introduction<br /> Line 180  Introduction<br />
180  Focus of this protocol<br />  Focus of this protocol<br />
181  <a href="#anchor4">5.</a>&nbsp;  <a href="#anchor4">5.</a>&nbsp;
182  Communication Overview<br />  Communication Overview<br />
183  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor5">5.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor5">5.1.</a>&nbsp;
184  Request/response communication method<br />  Request/response communication method<br />
185  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor6">5.1.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor6">5.1.1.</a>&nbsp;
186  Result format<br />  Result format<br />
187  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor7">5.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor7">5.2.</a>&nbsp;
188  Subscribe/notify communication method<br />  Subscribe/notify communication method<br />
189  <a href="#control_commands">6.</a>&nbsp;  <a href="#control_commands">6.</a>&nbsp;
190  Description for control commands<br />  Description for control commands<br />
191  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor8">6.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor8">6.1.</a>&nbsp;
192  Ignored lines and comments<br />  Ignored lines and comments<br />
193  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor9">6.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor9">6.2.</a>&nbsp;
194  Configuring audio drivers<br />  Configuring audio drivers<br />
195  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AVAILABLE_AUDIO_OUTPUT_DRIVERS">6.2.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AVAILABLE_AUDIO_OUTPUT_DRIVERS">6.2.1.</a>&nbsp;
196  Getting amount of available audio output drivers<br />  Getting amount of available audio output drivers<br />
197  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">6.2.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">6.2.2.</a>&nbsp;
198  Getting all available audio output drivers<br />  Getting all available audio output drivers<br />
199  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DRIVER INFO">6.2.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DRIVER INFO">6.2.3.</a>&nbsp;
200  Getting information about a specific audio  Getting information about a specific audio
201                  output driver<br />                  output driver<br />
202  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO">6.2.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO">6.2.4.</a>&nbsp;
203  Getting information about specific audio  Getting information about specific audio
204                  output driver parameter<br />                  output driver parameter<br />
205  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CREATE AUDIO_OUTPUT_DEVICE">6.2.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CREATE AUDIO_OUTPUT_DEVICE">6.2.5.</a>&nbsp;
206  Creating an audio output device<br />  Creating an audio output device<br />
207  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#DESTROY AUDIO_OUTPUT_DEVICE">6.2.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#DESTROY AUDIO_OUTPUT_DEVICE">6.2.6.</a>&nbsp;
208  Destroying an audio output device<br />  Destroying an audio output device<br />
209  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DEVICES">6.2.7</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DEVICES">6.2.7.</a>&nbsp;
210  Getting all created audio output device count<br />  Getting all created audio output device count<br />
211  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AUDIO_OUTPUT_DEVICES">6.2.8</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AUDIO_OUTPUT_DEVICES">6.2.8.</a>&nbsp;
212  Getting all created audio output device list<br />  Getting all created audio output device list<br />
213  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DEVICE INFO">6.2.9</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_DEVICE INFO">6.2.9.</a>&nbsp;
214  Getting current settings of an audio output device<br />  Getting current settings of an audio output device<br />
215  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET AUDIO_OUTPUT_DEVICE_PARAMETER">6.2.10</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET AUDIO_OUTPUT_DEVICE_PARAMETER">6.2.10.</a>&nbsp;
216  Changing settings of audio output devices<br />  Changing settings of audio output devices<br />
217  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_CHANNEL INFO">6.2.11</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_CHANNEL INFO">6.2.11.</a>&nbsp;
218  Getting information about an audio channel<br />  Getting information about an audio channel<br />
219  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO">6.2.12</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO">6.2.12.</a>&nbsp;
220  Getting information about specific audio channel parameter<br />  Getting information about specific audio channel parameter<br />
221  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET AUDIO_OUTPUT_CHANNEL_PARAMETER">6.2.13</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET AUDIO_OUTPUT_CHANNEL_PARAMETER">6.2.13.</a>&nbsp;
222  Changing settings of audio output channels<br />  Changing settings of audio output channels<br />
223  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor10">6.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor10">6.3.</a>&nbsp;
224  Configuring MIDI input drivers<br />  Configuring MIDI input drivers<br />
225  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AVAILABLE_MIDI_INPUT_DRIVERS">6.3.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AVAILABLE_MIDI_INPUT_DRIVERS">6.3.1.</a>&nbsp;
226  Getting amount of available MIDI input drivers<br />  Getting amount of available MIDI input drivers<br />
227  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">6.3.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">6.3.2.</a>&nbsp;
228  Getting all available MIDI input drivers<br />  Getting all available MIDI input drivers<br />
229  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DRIVER INFO">6.3.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DRIVER INFO">6.3.3.</a>&nbsp;
230  Getting information about a specific MIDI input driver<br />  Getting information about a specific MIDI input driver<br />
231  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DRIVER_PARAMETER INFO">6.3.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DRIVER_PARAMETER INFO">6.3.4.</a>&nbsp;
232  Getting information about specific MIDI input driver parameter<br />  Getting information about specific MIDI input driver parameter<br />
233  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CREATE MIDI_INPUT_DEVICE">6.3.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CREATE MIDI_INPUT_DEVICE">6.3.5.</a>&nbsp;
234  Creating a MIDI input device<br />  Creating a MIDI input device<br />
235  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#DESTROY MIDI_INPUT_DEVICE">6.3.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#DESTROY MIDI_INPUT_DEVICE">6.3.6.</a>&nbsp;
236  Destroying a MIDI input device<br />  Destroying a MIDI input device<br />
237  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DEVICES">6.3.7</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DEVICES">6.3.7.</a>&nbsp;
238  Getting all created MIDI input device count<br />  Getting all created MIDI input device count<br />
239  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INPUT_DEVICES">6.3.8</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INPUT_DEVICES">6.3.8.</a>&nbsp;
240  Getting all created MIDI input device list<br />  Getting all created MIDI input device list<br />
241  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DEVICE INFO">6.3.9</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_DEVICE INFO">6.3.9.</a>&nbsp;
242  Getting current settings of a MIDI input device<br />  Getting current settings of a MIDI input device<br />
243  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET MIDI_INPUT_DEVICE_PARAMETER">6.3.10</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET MIDI_INPUT_DEVICE_PARAMETER">6.3.10.</a>&nbsp;
244  Changing settings of MIDI input devices<br />  Changing settings of MIDI input devices<br />
245  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_PORT INFO">6.3.11</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_PORT INFO">6.3.11.</a>&nbsp;
246  Getting information about a MIDI port<br />  Getting information about a MIDI port<br />
247  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_PORT_PARAMETER INFO">6.3.12</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INPUT_PORT_PARAMETER INFO">6.3.12.</a>&nbsp;
248  Getting information about specific MIDI port parameter<br />  Getting information about specific MIDI port parameter<br />
249  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET MIDI_INPUT_PORT_PARAMETER">6.3.13</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET MIDI_INPUT_PORT_PARAMETER">6.3.13.</a>&nbsp;
250  Changing settings of MIDI input ports<br />  Changing settings of MIDI input ports<br />
251  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor11">6.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor11">6.4.</a>&nbsp;
252  Configuring sampler channels<br />  Configuring sampler channels<br />
253  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LOAD INSTRUMENT">6.4.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LOAD INSTRUMENT">6.4.1.</a>&nbsp;
254  Loading an instrument<br />  Loading an instrument<br />
255  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LOAD ENGINE">6.4.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LOAD ENGINE">6.4.2.</a>&nbsp;
256  Loading a sampler engine<br />  Loading a sampler engine<br />
257  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNELS">6.4.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNELS">6.4.3.</a>&nbsp;
258  Getting all created sampler channel count<br />  Getting all created sampler channel count<br />
259  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST CHANNELS">6.4.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST CHANNELS">6.4.4.</a>&nbsp;
260  Getting all created sampler channel list<br />  Getting all created sampler channel list<br />
261  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD CHANNEL">6.4.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD CHANNEL">6.4.5.</a>&nbsp;
262  Adding a new sampler channel<br />  Adding a new sampler channel<br />
263  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE CHANNEL">6.4.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE CHANNEL">6.4.6.</a>&nbsp;
264  Removing a sampler channel<br />  Removing a sampler channel<br />
265  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AVAILABLE_ENGINES">6.4.7</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET AVAILABLE_ENGINES">6.4.7.</a>&nbsp;
266  Getting amount of available engines<br />  Getting amount of available engines<br />
267  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AVAILABLE_ENGINES">6.4.8</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST AVAILABLE_ENGINES">6.4.8.</a>&nbsp;
268  Getting all available engines<br />  Getting all available engines<br />
269  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET ENGINE INFO">6.4.9</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET ENGINE INFO">6.4.9.</a>&nbsp;
270  Getting information about an engine<br />  Getting information about an engine<br />
271  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL INFO">6.4.10</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL INFO">6.4.10.</a>&nbsp;
272  Getting sampler channel information<br />  Getting sampler channel information<br />
273  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL VOICE_COUNT">6.4.11</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL VOICE_COUNT">6.4.11.</a>&nbsp;
274  Current number of active voices<br />  Current number of active voices<br />
275  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL STREAM_COUNT">6.4.12</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL STREAM_COUNT">6.4.12.</a>&nbsp;
276  Current number of active disk streams<br />  Current number of active disk streams<br />
277  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL BUFFER_FILL">6.4.13</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET CHANNEL BUFFER_FILL">6.4.13.</a>&nbsp;
278  Current fill state of disk stream buffers<br />  Current fill state of disk stream buffers<br />
279  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL AUDIO_OUTPUT_DEVICE">6.4.14</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL AUDIO_OUTPUT_DEVICE">6.4.14.</a>&nbsp;
280  Setting audio output device<br />  Setting audio output device<br />
281  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL AUDIO_OUTPUT_TYP">6.4.15</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL AUDIO_OUTPUT_TYP">6.4.15.</a>&nbsp;
282  Setting audio output type<br />  Setting audio output type<br />
283  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL AUDIO_OUTPUT_CHANNEL">6.4.16</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL AUDIO_OUTPUT_CHANNEL">6.4.16.</a>&nbsp;
284  Setting audio output channel<br />  Setting audio output channel<br />
285  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_DEVICE">6.4.17</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_DEVICE">6.4.17.</a>&nbsp;
286  Setting MIDI input device<br />  Setting MIDI input device<br />
287  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_TYPE">6.4.18</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_TYPE">6.4.18.</a>&nbsp;
288  Setting MIDI input type<br />  Setting MIDI input type<br />
289  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_PORT">6.4.19</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_PORT">6.4.19.</a>&nbsp;
290  Setting MIDI input port<br />  Setting MIDI input port<br />
291  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_CHANNEL">6.4.20</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MIDI_INPUT_CHANNEL">6.4.20.</a>&nbsp;
292  Setting MIDI input channel<br />  Setting MIDI input channel<br />
293  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL VOLUME">6.4.21</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL VOLUME">6.4.21.</a>&nbsp;
294  Setting channel volume<br />  Setting channel volume<br />
295  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MUTE">6.4.22</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL MUTE">6.4.22.</a>&nbsp;
296  Muting a sampler channel<br />  Muting a sampler channel<br />
297  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL SOLO">6.4.23</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET CHANNEL SOLO">6.4.23.</a>&nbsp;
298  Soloing a sampler channel<br />  Soloing a sampler channel<br />
299  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.24</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.24.</a>&nbsp;
300  Resetting a sampler channel<br />  Resetting a sampler channel<br />
301  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
302  Controlling connection<br />  Controlling connection<br />
303  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE">6.5.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE">6.5.1.</a>&nbsp;
304  Register front-end for receiving event messages<br />  Register front-end for receiving event messages<br />
305  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#UNSUBSCRIBE">6.5.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#UNSUBSCRIBE">6.5.2.</a>&nbsp;
306  Unregister front-end for not receiving event messages<br />  Unregister front-end for not receiving event messages<br />
307  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET ECHO">6.5.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET ECHO">6.5.3.</a>&nbsp;
308  Enable or disable echo of commands<br />  Enable or disable echo of commands<br />
309  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#QUIT">6.5.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#QUIT">6.5.4.</a>&nbsp;
310  Close client connection<br />  Close client connection<br />
311  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor13">6.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor13">6.6.</a>&nbsp;
312  Global commands<br />  Global commands<br />
313  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_VOICE_COUNT">6.6.1.</a>&nbsp;
314    Current number of active voices<br />
315    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a>&nbsp;
316    Maximum amount of active voices<br />
317    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.3.</a>&nbsp;
318  Reset sampler<br />  Reset sampler<br />
319  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.4.</a>&nbsp;
320  General sampler informations<br />  General sampler informations<br />
321    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor14">6.7.</a>&nbsp;
322    MIDI Instrument Mapping<br />
323    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#MAP MIDI_INSTRUMENT">6.7.1.</a>&nbsp;
324    Create or replace a MIDI instrument map entry<br />
325    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENTS">6.7.2.</a>&nbsp;
326    Getting ammount of MIDI instrument map entries<br />
327    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST MIDI_INSTRUMENTS">6.7.3.</a>&nbsp;
328    Getting indeces of all MIDI instrument map entries<br />
329    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#UNMAP MIDI_INSTRUMENT">6.7.4.</a>&nbsp;
330    Remove an entry from the MIDI instrument map<br />
331    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET MIDI_INSTRUMENT INFO">6.7.5.</a>&nbsp;
332    Get current settings of MIDI instrument map entry<br />
333    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#CLEAR MIDI_INSTRUMENTS">6.7.6.</a>&nbsp;
334    Clear MIDI instrument map<br />
335  <a href="#command_syntax">7.</a>&nbsp;  <a href="#command_syntax">7.</a>&nbsp;
336  Command Syntax<br />  Command Syntax<br />
337  <a href="#events">8.</a>&nbsp;  <a href="#events">8.</a>&nbsp;
338  Events<br />  Events<br />
339  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL">8.1</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL">8.1.</a>&nbsp;
340  Number of sampler channels changed<br />  Number of sampler channels changed<br />
341  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.2</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.2.</a>&nbsp;
342  Number of active voices changed<br />  Number of active voices changed<br />
343  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.3</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.3.</a>&nbsp;
344  Number of active disk streams changed<br />  Number of active disk streams changed<br />
345  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.4</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.4.</a>&nbsp;
346  Disk stream buffer fill state changed<br />  Disk stream buffer fill state changed<br />
347  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE INFO">8.5</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE INFO">8.5.</a>&nbsp;
348  Channel information changed<br />  Channel information changed<br />
349  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.6</a>&nbsp;  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.6.</a>&nbsp;
350    Total number of active voices changed<br />
351    &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.7.</a>&nbsp;
352  Miscellaneous and debugging events<br />  Miscellaneous and debugging events<br />
353  <a href="#anchor14">9.</a>&nbsp;  <a href="#anchor15">9.</a>&nbsp;
354  Security Considerations<br />  Security Considerations<br />
355  <a href="#anchor15">10.</a>&nbsp;  <a href="#anchor16">10.</a>&nbsp;
356  Acknowledgments<br />  Acknowledgments<br />
357  <a href="#rfc.references1">11.</a>&nbsp;  <a href="#rfc.references1">11.</a>&nbsp;
358  References<br />  References<br />
# Line 359  Intellectual Property and Copyright Stat Line 390  Intellectual Property and Copyright Stat
390  <p>&nbsp;&nbsp;&nbsp;"another line"  <p>&nbsp;&nbsp;&nbsp;"another line"
391  </p>  </p>
392  </blockquote><p>  </blockquote><p>
393                
394  </p>  </p>
395  <p>must actually be interpreted as client sending the following  <p>must actually be interpreted as client sending the following
396              message:              message:
# Line 371  Intellectual Property and Copyright Stat Line 402  Intellectual Property and Copyright Stat
402                      line&lt;CR&gt;&lt;LF&gt;"                      line&lt;CR&gt;&lt;LF&gt;"
403  </p>  </p>
404  </blockquote><p>  </blockquote><p>
405                
406  </p>  </p>
407  <p>where &lt;CR&gt; symbolizes the carriage return character and  <p>where &lt;CR&gt; symbolizes the carriage return character and
408              &lt;LF&gt; the line feed character as defined in the ASCII              &lt;LF&gt; the line feed character as defined in the ASCII
# Line 386  Intellectual Property and Copyright Stat Line 417  Intellectual Property and Copyright Stat
417  <p>S: "abcd"  <p>S: "abcd"
418  </p>  </p>
419  </blockquote><p>  </blockquote><p>
420                
421  </p>  </p>
422  <p>could also happen to be sent in three messages like in the  <p>could also happen to be sent in three messages like in the
423              following sequence scenario:              following sequence scenario:
# Line 409  Intellectual Property and Copyright Stat Line 440  Intellectual Property and Copyright Stat
440                      "&lt;LF&gt;"                      "&lt;LF&gt;"
441  </li>  </li>
442  </ul><p>  </ul><p>
443                
444  </p>  </p>
445  <p>where again &lt;CR&gt; and &lt;LF&gt; symbolize the carriage  <p>where again &lt;CR&gt; and &lt;LF&gt; symbolize the carriage
446              return and line feed characters respectively.              return and line feed characters respectively.
# Line 422  Intellectual Property and Copyright Stat Line 453  Intellectual Property and Copyright Stat
453              release of the LSCP specification will be tagged with a unique version              release of the LSCP specification will be tagged with a unique version
454              tuple. The version tuple consists at least of a major and minor version              tuple. The version tuple consists at least of a major and minor version
455              number like:              number like:
456                
457  </p>  </p>
458  <p>  <p>
459                  </p>                  </p>
# Line 430  Intellectual Property and Copyright Stat Line 461  Intellectual Property and Copyright Stat
461  <p>"1.2"  <p>"1.2"
462  </p>  </p>
463  </blockquote><p>  </blockquote><p>
464                
465  </p>  </p>
466  <p>  <p>
467              In this example the major version number would be "1" and the minor              In this example the major version number would be "1" and the minor
# Line 440  Intellectual Property and Copyright Stat Line 471  Intellectual Property and Copyright Stat
471              compatible to the connected sampler if and only if the LSCP versions              compatible to the connected sampler if and only if the LSCP versions
472              to which each of the two parties complies to, match both of the              to which each of the two parties complies to, match both of the
473              following rules:              following rules:
474                
475  </p>  </p>
476  <p>Compatibility:  <p>Compatibility:
477  </p>  </p>
# Line 454  Intellectual Property and Copyright Stat Line 485  Intellectual Property and Copyright Stat
485                      the sampler's LSCP minor version.                      the sampler's LSCP minor version.
486  </li>  </li>
487  </ol><p>  </ol><p>
488                
489  </p>  </p>
490  <p>  <p>
491              Compatibility can only be claimed if both rules are true.              Compatibility can only be claimed if both rules are true.
492              The frontend can use the              The frontend can use the
493              <a class="info" href="#GET SERVER INFO">"GET SERVER INFO"<span> (</span><span class="info">General sampler informations</span><span>)</span></a> command to              <a class="info" href="#GET SERVER INFO">"GET SERVER INFO"<span> (</span><span class="info">General sampler informations</span><span>)</span></a> command to
494              get the version of the LSCP specification the sampler complies with.              get the version of the LSCP specification the sampler complies with.
495                
496  </p>  </p>
497  <a name="anchor2"></a><br /><hr />  <a name="anchor2"></a><br /><hr />
498  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
# Line 511  Intellectual Property and Copyright Stat Line 542  Intellectual Property and Copyright Stat
542              implemented in the front-end application. The two communication              implemented in the front-end application. The two communication
543              methods will be described next.              methods will be described next.
544  </p>  </p>
545  <a name="rfc.section.5.1"></a><h4><a name="anchor5">5.1</a>&nbsp;Request/response communication method</h4>  <a name="anchor5"></a><br /><hr />
546    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
547    <a name="rfc.section.5.1"></a><h3>5.1.&nbsp;Request/response communication method</h3>
548    
549  <p>This simple communication method is based on  <p>This simple communication method is based on
550                  <a class="info" href="#RFC793">TCP<span> (</span><span class="info">Defense Advanced Research Projects Agency, &ldquo;TRANSMISSION CONTROL PROTOCOL,&rdquo; 1981.</span><span>)</span></a>[RFC793]. The                  <a class="info" href="#RFC793">TCP<span> (</span><span class="info">Defense Advanced Research Projects Agency, &ldquo;TRANSMISSION CONTROL PROTOCOL,&rdquo; 1981.</span><span>)</span></a> [RFC793]. The
551                  front-end application establishes a TCP connection to the                  front-end application establishes a TCP connection to the
552                  LinuxSampler instance on a certain host system. Then the                  LinuxSampler instance on a certain host system. Then the
553                  front-end application will send certain ASCII based commands                  front-end application will send certain ASCII based commands
# Line 554  Intellectual Property and Copyright Stat Line 587  Intellectual Property and Copyright Stat
587                  processed in the order they were received and result sets                  processed in the order they were received and result sets
588                  MUST be sent back in the same order.                  MUST be sent back in the same order.
589  </p>  </p>
590  <a name="rfc.section.5.1.1"></a><h4><a name="anchor6">5.1.1</a>&nbsp;Result format</h4>  <a name="anchor6"></a><br /><hr />
591    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
592    <a name="rfc.section.5.1.1"></a><h3>5.1.1.&nbsp;Result format</h3>
593    
594  <p>Result set could be one of the following types:  <p>Result set could be one of the following types:
595  </p>  </p>
# Line 568  Intellectual Property and Copyright Stat Line 603  Intellectual Property and Copyright Stat
603  <li>Error  <li>Error
604  </li>  </li>
605  </ol><p>  </ol><p>
606                        
607  </p>  </p>
608  <p>Warning and Error result sets MUST be single line and  <p>Warning and Error result sets MUST be single line and
609                      have the following format:                      have the following format:
# Line 581  Intellectual Property and Copyright Stat Line 616  Intellectual Property and Copyright Stat
616  <li>"ERR:&lt;error-code&gt;:&lt;error-message&gt;"  <li>"ERR:&lt;error-code&gt;:&lt;error-message&gt;"
617  </li>  </li>
618  </ul><p>  </ul><p>
619                        
620  </p>  </p>
621  <p>Where &lt;warning-code&gt; and &lt;error-code&gt; are  <p>Where &lt;warning-code&gt; and &lt;error-code&gt; are
622                      numeric unique identifiers of the warning or error and                      numeric unique identifiers of the warning or error and
# Line 599  Intellectual Property and Copyright Stat Line 634  Intellectual Property and Copyright Stat
634  <p>S: "WRN:32:This is a 24 bit patch which is not supported natively yet."  <p>S: "WRN:32:This is a 24 bit patch which is not supported natively yet."
635  </p>  </p>
636  </blockquote><p>  </blockquote><p>
637                        
638  </p>  </p>
639  <p>  <p>
640                          </p>                          </p>
# Line 609  Intellectual Property and Copyright Stat Line 644  Intellectual Property and Copyright Stat
644  <p>S: "ERR:3456:Audio output driver 'ALSA' does not have a parameter 'EAR'."  <p>S: "ERR:3456:Audio output driver 'ALSA' does not have a parameter 'EAR'."
645  </p>  </p>
646  </blockquote><p>  </blockquote><p>
647                        
648  </p>  </p>
649  <p>  <p>
650                          </p>                          </p>
# Line 619  Intellectual Property and Copyright Stat Line 654  Intellectual Property and Copyright Stat
654  <p>S: "ERR:9:There is no audio output device with index 123456."  <p>S: "ERR:9:There is no audio output device with index 123456."
655  </p>  </p>
656  </blockquote><p>  </blockquote><p>
657                        
658  </p>  </p>
659  <p>Normal result sets could be:  <p>Normal result sets could be:
660  </p>  </p>
# Line 633  Intellectual Property and Copyright Stat Line 668  Intellectual Property and Copyright Stat
668  <li>Multi-line  <li>Multi-line
669  </li>  </li>
670  </ol><p>  </ol><p>
671                        
672  </p>  </p>
673  <p> Empty result set is issued when the server only  <p> Empty result set is issued when the server only
674                      needed to acknowledge the fact that the request was                      needed to acknowledge the fact that the request was
# Line 647  Intellectual Property and Copyright Stat Line 682  Intellectual Property and Copyright Stat
682  <p>"OK"  <p>"OK"
683  </p>  </p>
684  </blockquote><p>  </blockquote><p>
685                        
686  </p>  </p>
687  <p>Example:  <p>Example:
688  </p>  </p>
# Line 659  Intellectual Property and Copyright Stat Line 694  Intellectual Property and Copyright Stat
694  <p>S: "OK"  <p>S: "OK"
695  </p>  </p>
696  </blockquote><p>  </blockquote><p>
697                        
698  </p>  </p>
699  <p>Single line result sets are command specific. One  <p>Single line result sets are command specific. One
700                      example of a single line result set is an empty line.                      example of a single line result set is an empty line.
# Line 673  Intellectual Property and Copyright Stat Line 708  Intellectual Property and Copyright Stat
708  <p>"."  <p>"."
709  </p>  </p>
710  </blockquote><p>  </blockquote><p>
711                        
712  </p>  </p>
713  <p>Example:  <p>Example:
714  </p>  </p>
# Line 699  Intellectual Property and Copyright Stat Line 734  Intellectual Property and Copyright Stat
734  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
735  </p>  </p>
736  </blockquote><p>  </blockquote><p>
737                        
738  </p>  </p>
739  <p>In addition to above mentioned formats, warnings and  <p>In addition to above mentioned formats, warnings and
740                      empty result sets MAY be indexed. In this case, they                      empty result sets MAY be indexed. In this case, they
# Line 713  Intellectual Property and Copyright Stat Line 748  Intellectual Property and Copyright Stat
748  <li>"OK[&lt;index&gt;]"  <li>"OK[&lt;index&gt;]"
749  </li>  </li>
750  </ul><p>  </ul><p>
751                        
752  </p>  </p>
753  <p>where &lt;index&gt; is command specific and is used  <p>where &lt;index&gt; is command specific and is used
754                      to indicate channel number that the result set was                      to indicate channel number that the result set was
# Line 732  Intellectual Property and Copyright Stat Line 767  Intellectual Property and Copyright Stat
767  <p>S: "OK[12]"  <p>S: "OK[12]"
768  </p>  </p>
769  </blockquote><p>  </blockquote><p>
770                        
771  </p>  </p>
772  <p>  <p>
773                          </p>                          </p>
# Line 742  Intellectual Property and Copyright Stat Line 777  Intellectual Property and Copyright Stat
777  <p>S: "WRN[0]:32:Sample rate not supported, using 44100 instead."  <p>S: "WRN[0]:32:Sample rate not supported, using 44100 instead."
778  </p>  </p>
779  </blockquote><p>  </blockquote><p>
780                        
781  </p>  </p>
782  <a name="rfc.section.5.2"></a><h4><a name="anchor7">5.2</a>&nbsp;Subscribe/notify communication method</h4>  <a name="anchor7"></a><br /><hr />
783    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
784    <a name="rfc.section.5.2"></a><h3>5.2.&nbsp;Subscribe/notify communication method</h3>
785    
786  <p>This more sophisticated communication method is actually  <p>This more sophisticated communication method is actually
787                  only an extension of the simple request/response                  only an extension of the simple request/response
# Line 762  Intellectual Property and Copyright Stat Line 799  Intellectual Property and Copyright Stat
799  <p>SUBSCRIBE &lt;event-id&gt;  <p>SUBSCRIBE &lt;event-id&gt;
800  </p>  </p>
801  </blockquote><p>  </blockquote><p>
802                    
803  </p>  </p>
804  <p>where &lt;event-id&gt; will be replaced by the respective  <p>where &lt;event-id&gt; will be replaced by the respective
805                  event that client wants to subscribe to. Upon receiving such                  event that client wants to subscribe to. Upon receiving such
# Line 779  Intellectual Property and Copyright Stat Line 816  Intellectual Property and Copyright Stat
816  <p>NOTIFY:&lt;event-id&gt;:&lt;custom-event-data&gt;  <p>NOTIFY:&lt;event-id&gt;:&lt;custom-event-data&gt;
817  </p>  </p>
818  </blockquote><p>  </blockquote><p>
819                    
820  </p>  </p>
821  <p>where &lt;event-id&gt; uniquely identifies the event that  <p>where &lt;event-id&gt; uniquely identifies the event that
822                  has occurred and &lt;custom-event-data&gt; is event                  has occurred and &lt;custom-event-data&gt; is event
# Line 805  Intellectual Property and Copyright Stat Line 842  Intellectual Property and Copyright Stat
842                          response.                          response.
843  </li>  </li>
844  </ol><p>  </ol><p>
845                    
846  </p>  </p>
847  <p>If the client is not interested in a particular event  <p>If the client is not interested in a particular event
848                  anymore it MAY issue UNSUBSCRIBE command using the following                  anymore it MAY issue UNSUBSCRIBE command using the following
# Line 817  Intellectual Property and Copyright Stat Line 854  Intellectual Property and Copyright Stat
854  <p>UNSUBSCRIBE &lt;event-id&gt;  <p>UNSUBSCRIBE &lt;event-id&gt;
855  </p>  </p>
856  </blockquote><p>  </blockquote><p>
857                    
858  </p>  </p>
859  <p>where &lt;event-id&gt; will be replace by the respective  <p>where &lt;event-id&gt; will be replace by the respective
860                  event that client is no longer interested in receiving. For                  event that client is no longer interested in receiving. For
# Line 834  Intellectual Property and Copyright Stat Line 871  Intellectual Property and Copyright Stat
871  <p>NOTIFY:CHANNEL_BUFFER_FILL:4 [35]62%,[33]80%,[37]98%  <p>NOTIFY:CHANNEL_BUFFER_FILL:4 [35]62%,[33]80%,[37]98%
872  </p>  </p>
873  </blockquote><p>  </blockquote><p>
874                    
875  </p>  </p>
876  <p>Which means there are currently three active streams on  <p>Which means there are currently three active streams on
877                  sampler channel 4, where the stream with ID "35" is filled                  sampler channel 4, where the stream with ID "35" is filled
# Line 877  Intellectual Property and Copyright Stat Line 914  Intellectual Property and Copyright Stat
914              multiple-line responses. In this case LinuxSampler signals the              multiple-line responses. In this case LinuxSampler signals the
915              end of the response by a "." (single dot) line.              end of the response by a "." (single dot) line.
916  </p>  </p>
917  <a name="rfc.section.6.1"></a><h4><a name="anchor8">6.1</a>&nbsp;Ignored lines and comments</h4>  <a name="anchor8"></a><br /><hr />
918    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
919    <a name="rfc.section.6.1"></a><h3>6.1.&nbsp;Ignored lines and comments</h3>
920    
921  <p>White lines, that is lines which only contain space and  <p>White lines, that is lines which only contain space and
922                  tabulator characters, and lines that start with a "#"                  tabulator characters, and lines that start with a "#"
# Line 885  Intellectual Property and Copyright Stat Line 924  Intellectual Property and Copyright Stat
924                  group commands and to place comments in a LSCP script                  group commands and to place comments in a LSCP script
925                  file.                  file.
926  </p>  </p>
927  <a name="rfc.section.6.2"></a><h4><a name="anchor9">6.2</a>&nbsp;Configuring audio drivers</h4>  <a name="anchor9"></a><br /><hr />
928    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
929    <a name="rfc.section.6.2"></a><h3>6.2.&nbsp;Configuring audio drivers</h3>
930    
931  <p>Instances of drivers in LinuxSampler are called devices.  <p>Instances of drivers in LinuxSampler are called devices.
932                  You can use multiple audio devices simultaneously, e.g. to                  You can use multiple audio devices simultaneously, e.g. to
# Line 918  Intellectual Property and Copyright Stat Line 959  Intellectual Property and Copyright Stat
959                  what parameters drivers are offering, how to retrieve their                  what parameters drivers are offering, how to retrieve their
960                  possible values, etc.                  possible values, etc.
961  </p>  </p>
962  <a name="rfc.section.6.2.1"></a><h4><a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS">6.2.1</a>&nbsp;Getting amount of available audio output drivers</h4>  <a name="GET AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
963    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
964    <a name="rfc.section.6.2.1"></a><h3>6.2.1.&nbsp;Getting amount of available audio output drivers</h3>
965    
966  <p>Use the following command to get the number of  <p>Use the following command to get the number of
967                      audio output drivers currently available for the                      audio output drivers currently available for the
# Line 930  Intellectual Property and Copyright Stat Line 973  Intellectual Property and Copyright Stat
973  <p>GET AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>GET AVAILABLE_AUDIO_OUTPUT_DRIVERS
974  </p>  </p>
975  </blockquote><p>  </blockquote><p>
976                        
977  </p>  </p>
978  <p>Possible Answers:  <p>Possible Answers:
979  </p>  </p>
# Line 941  Intellectual Property and Copyright Stat Line 984  Intellectual Property and Copyright Stat
984                              number of audio output drivers.                              number of audio output drivers.
985  </p>  </p>
986  </blockquote><p>  </blockquote><p>
987                        
988  </p>  </p>
989  <p>Example:  <p>Example:
990  </p>  </p>
# Line 953  Intellectual Property and Copyright Stat Line 996  Intellectual Property and Copyright Stat
996  <p>S: "2"  <p>S: "2"
997  </p>  </p>
998  </blockquote><p>  </blockquote><p>
999                        
1000  </p>  </p>
1001  <a name="rfc.section.6.2.2"></a><h4><a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">6.2.2</a>&nbsp;Getting all available audio output drivers</h4>  <a name="LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"></a><br /><hr />
1002    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1003    <a name="rfc.section.6.2.2"></a><h3>6.2.2.&nbsp;Getting all available audio output drivers</h3>
1004    
1005  <p>Use the following command to list all audio output  <p>Use the following command to list all audio output
1006                      drivers currently available for the LinuxSampler                      drivers currently available for the LinuxSampler
# Line 967  Intellectual Property and Copyright Stat Line 1012  Intellectual Property and Copyright Stat
1012  <p>LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS
1013  </p>  </p>
1014  </blockquote><p>  </blockquote><p>
1015                        
1016  </p>  </p>
1017  <p>Possible Answers:  <p>Possible Answers:
1018  </p>  </p>
# Line 979  Intellectual Property and Copyright Stat Line 1024  Intellectual Property and Copyright Stat
1024                              audio output driver.                              audio output driver.
1025  </p>  </p>
1026  </blockquote><p>  </blockquote><p>
1027                        
1028  </p>  </p>
1029  <p>Example:  <p>Example:
1030  </p>  </p>
# Line 991  Intellectual Property and Copyright Stat Line 1036  Intellectual Property and Copyright Stat
1036  <p>S: "ALSA,JACK"  <p>S: "ALSA,JACK"
1037  </p>  </p>
1038  </blockquote><p>  </blockquote><p>
1039                        
1040  </p>  </p>
1041  <a name="rfc.section.6.2.3"></a><h4><a name="GET AUDIO_OUTPUT_DRIVER INFO">6.2.3</a>&nbsp;Getting information about a specific audio  <a name="GET AUDIO_OUTPUT_DRIVER INFO"></a><br /><hr />
1042                  output driver</h4>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1043    <a name="rfc.section.6.2.3"></a><h3>6.2.3.&nbsp;Getting information about a specific audio
1044                    output driver</h3>
1045    
1046  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
1047                      about a specific audio output driver:                      about a specific audio output driver:
# Line 1006  Intellectual Property and Copyright Stat Line 1053  Intellectual Property and Copyright Stat
1053                               &lt;audio-output-driver&gt;                               &lt;audio-output-driver&gt;
1054  </p>  </p>
1055  </blockquote><p>  </blockquote><p>
1056                        
1057  </p>  </p>
1058  <p>Where &lt;audio-output-driver&gt; is the name of the  <p>Where &lt;audio-output-driver&gt; is the name of the
1059                      audio output driver, returned by the                      audio output driver, returned by the
# Line 1035  Intellectual Property and Copyright Stat Line 1082  Intellectual Property and Copyright Stat
1082  <p> character string describing the  <p> character string describing the
1083                                        audio output driver                                        audio output driver
1084  </p>  </p>
1085  </blockquote><p>  </blockquote>
1086                                      
1087    
 </p>  
1088  <p>VERSION -  <p>VERSION -
1089                                      </p>                                      </p>
1090  <blockquote class="text">  <blockquote class="text">
1091  <p>character string reflecting the  <p>character string reflecting the
1092                                        driver's version                                        driver's version
1093  </p>  </p>
1094  </blockquote><p>  </blockquote>
1095                                      
1096    
 </p>  
1097  <p>PARAMETERS -  <p>PARAMETERS -
1098                                      </p>                                      </p>
1099  <blockquote class="text">  <blockquote class="text">
# Line 1057  Intellectual Property and Copyright Stat Line 1104  Intellectual Property and Copyright Stat
1104                                        and 'active' are offered by all audio                                        and 'active' are offered by all audio
1105                                        output drivers                                        output drivers
1106  </p>  </p>
1107  </blockquote><p>  </blockquote>
1108                                      
1109    
1110  </p>  </blockquote>
1111  </blockquote><p>                              
1112    
 </p>  
1113  <p>The mentioned fields above don't have to be  <p>The mentioned fields above don't have to be
1114                              in particular order.                              in particular order.
1115  </p>  </p>
1116  </blockquote><p>  </blockquote><p>
1117                        
1118  </p>  </p>
1119  <p>Example:  <p>Example:
1120  </p>  </p>
# Line 1088  Intellectual Property and Copyright Stat Line 1135  Intellectual Property and Copyright Stat
1135  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1136  </p>  </p>
1137  </blockquote><p>  </blockquote><p>
1138                        
1139  </p>  </p>
1140  <a name="rfc.section.6.2.4"></a><h4><a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO">6.2.4</a>&nbsp;Getting information about specific audio  <a name="GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
1141                  output driver parameter</h4>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1142    <a name="rfc.section.6.2.4"></a><h3>6.2.4.&nbsp;Getting information about specific audio
1143                    output driver parameter</h3>
1144    
1145  <p>Use the following command to get detailed information  <p>Use the following command to get detailed information
1146                      about a  specific audio output driver parameter:                      about a  specific audio output driver parameter:
# Line 1102  Intellectual Property and Copyright Stat Line 1151  Intellectual Property and Copyright Stat
1151  <p>GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO &lt;audio&gt; &lt;prm&gt; [&lt;deplist&gt;]  <p>GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO &lt;audio&gt; &lt;prm&gt; [&lt;deplist&gt;]
1152  </p>  </p>
1153  </blockquote><p>  </blockquote><p>
1154                        
1155  </p>  </p>
1156  <p>Where &lt;audio&gt; is the name of the audio output  <p>Where &lt;audio&gt; is the name of the audio output
1157                      driver as returned by the <a class="info" href="#LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">"LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"<span> (</span><span class="info">Getting all available audio output drivers</span><span>)</span></a> command,                      driver as returned by the <a class="info" href="#LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">"LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"<span> (</span><span class="info">Getting all available audio output drivers</span><span>)</span></a> command,
# Line 1134  Intellectual Property and Copyright Stat Line 1183  Intellectual Property and Copyright Stat
1183                              the moment the following information categories are defined:                              the moment the following information categories are defined:
1184  </p>  </p>
1185  </blockquote><p>  </blockquote><p>
1186                        
1187  </p>  </p>
1188  <p>  <p>
1189                          </p>                          </p>
# Line 1148  Intellectual Property and Copyright Stat Line 1197  Intellectual Property and Copyright Stat
1197                                  character string(s)                                  character string(s)
1198                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
1199  </p>  </p>
1200  </blockquote><p>  </blockquote>
1201                                
1202    
 </p>  
1203  <p>DESCRIPTION -  <p>DESCRIPTION -
1204                                </p>                                </p>
1205  <blockquote class="text">  <blockquote class="text">
1206  <p>arbitrary text describing the purpose of the parameter  <p>arbitrary text describing the purpose of the parameter
1207                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
1208  </p>  </p>
1209  </blockquote><p>  </blockquote>
1210                                
1211    
 </p>  
1212  <p>MANDATORY -  <p>MANDATORY -
1213                                </p>                                </p>
1214  <blockquote class="text">  <blockquote class="text">
# Line 1168  Intellectual Property and Copyright Stat Line 1217  Intellectual Property and Copyright Stat
1217                                  <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">'CREATE AUDIO_OUTPUT_DEVICE'<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>                                  <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">'CREATE AUDIO_OUTPUT_DEVICE'<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>
1218                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1219  </p>  </p>
1220  </blockquote><p>  </blockquote>
1221                                
1222    
 </p>  
1223  <p>FIX -  <p>FIX -
1224                                </p>                                </p>
1225  <blockquote class="text">  <blockquote class="text">
# Line 1179  Intellectual Property and Copyright Stat Line 1228  Intellectual Property and Copyright Stat
1228                                  the <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">'CREATE AUDIO_OUTPUT_DEVICE'<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>                                  the <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">'CREATE AUDIO_OUTPUT_DEVICE'<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>
1229                                  command (always returned, no matter which driver parameter)                                  command (always returned, no matter which driver parameter)
1230  </p>  </p>
1231  </blockquote><p>  </blockquote>
1232                                
1233    
 </p>  
1234  <p>MULTIPLICITY -  <p>MULTIPLICITY -
1235                                </p>                                </p>
1236  <blockquote class="text">  <blockquote class="text">
# Line 1190  Intellectual Property and Copyright Stat Line 1239  Intellectual Property and Copyright Stat
1239                                  multiple values and false only a single value allowed                                  multiple values and false only a single value allowed
1240                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
1241  </p>  </p>
1242  </blockquote><p>  </blockquote>
1243                                
1244    
 </p>  
1245  <p>DEPENDS -  <p>DEPENDS -
1246                                </p>                                </p>
1247  <blockquote class="text">  <blockquote class="text">
# Line 1207  Intellectual Property and Copyright Stat Line 1256  Intellectual Property and Copyright Stat
1256                                  chosen by the 'card' parameter                                  chosen by the 'card' parameter
1257                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1258  </p>  </p>
1259  </blockquote><p>  </blockquote>
1260                                
1261    
 </p>  
1262  <p>DEFAULT -  <p>DEFAULT -
1263                                </p>                                </p>
1264  <blockquote class="text">  <blockquote class="text">
# Line 1221  Intellectual Property and Copyright Stat Line 1270  Intellectual Property and Copyright Stat
1270                                  apostrophes (')                                  apostrophes (')
1271                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1272  </p>  </p>
1273  </blockquote><p>  </blockquote>
1274                                
1275    
 </p>  
1276  <p>RANGE_MIN -  <p>RANGE_MIN -
1277                                </p>                                </p>
1278  <blockquote class="text">  <blockquote class="text">
# Line 1233  Intellectual Property and Copyright Stat Line 1282  Intellectual Property and Copyright Stat
1282                                  with RANGE_MAX, but may also appear without                                  with RANGE_MAX, but may also appear without
1283                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1284  </p>  </p>
1285  </blockquote><p>  </blockquote>
1286                                
1287    
 </p>  
1288  <p>RANGE_MAX -  <p>RANGE_MAX -
1289                                </p>                                </p>
1290  <blockquote class="text">  <blockquote class="text">
# Line 1245  Intellectual Property and Copyright Stat Line 1294  Intellectual Property and Copyright Stat
1294                                  RANGE_MIN, but may also appear without                                  RANGE_MIN, but may also appear without
1295                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1296  </p>  </p>
1297  </blockquote><p>  </blockquote>
1298                                
1299    
 </p>  
1300  <p>POSSIBILITIES -  <p>POSSIBILITIES -
1301                                </p>                                </p>
1302  <blockquote class="text">  <blockquote class="text">
# Line 1256  Intellectual Property and Copyright Stat Line 1305  Intellectual Property and Copyright Stat
1305                                  apostrophes                                  apostrophes
1306                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
1307  </p>  </p>
1308  </blockquote><p>  </blockquote>
1309                                
1310    
 </p>  
1311  </blockquote><p>  </blockquote><p>
1312                        
1313  </p>  </p>
1314  <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.
1315  </p>  </p>
# Line 1288  Intellectual Property and Copyright Stat Line 1337  Intellectual Property and Copyright Stat
1337  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1338  </p>  </p>
1339  </blockquote><p>  </blockquote><p>
1340                        
1341  </p>  </p>
1342  <p>  <p>
1343                          </p>                          </p>
# Line 1312  Intellectual Property and Copyright Stat Line 1361  Intellectual Property and Copyright Stat
1361  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1362  </p>  </p>
1363  </blockquote><p>  </blockquote><p>
1364                        
1365  </p>  </p>
1366  <p>  <p>
1367                          </p>                          </p>
# Line 1340  Intellectual Property and Copyright Stat Line 1389  Intellectual Property and Copyright Stat
1389  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1390  </p>  </p>
1391  </blockquote><p>  </blockquote><p>
1392                        
1393  </p>  </p>
1394  <a name="rfc.section.6.2.5"></a><h4><a name="CREATE AUDIO_OUTPUT_DEVICE">6.2.5</a>&nbsp;Creating an audio output device</h4>  <a name="CREATE AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1395    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1396    <a name="rfc.section.6.2.5"></a><h3>6.2.5.&nbsp;Creating an audio output device</h3>
1397    
1398  <p>Use the following command to create a new audio output device for  the desired audio output system:  <p>Use the following command to create a new audio output device for  the desired audio output system:
1399  </p>  </p>
# Line 1352  Intellectual Property and Copyright Stat Line 1403  Intellectual Property and Copyright Stat
1403  <p>CREATE AUDIO_OUTPUT_DEVICE &lt;audio-output-driver&gt; [&lt;param-list&gt;]  <p>CREATE AUDIO_OUTPUT_DEVICE &lt;audio-output-driver&gt; [&lt;param-list&gt;]
1404  </p>  </p>
1405  </blockquote><p>  </blockquote><p>
1406                        
1407  </p>  </p>
1408  <p>Where &lt;audio-output-driver&gt; should be replaced by the desired audio  <p>Where &lt;audio-output-driver&gt; should be replaced by the desired audio
1409                      output system as returned by the                      output system as returned by the
# Line 1375  Intellectual Property and Copyright Stat Line 1426  Intellectual Property and Copyright Stat
1426  <p>in case the device was successfully created, where  <p>in case the device was successfully created, where
1427                                      &lt;device-id&gt; is the numerical ID of the new device                                      &lt;device-id&gt; is the numerical ID of the new device
1428  </p>  </p>
1429  </blockquote><p>  </blockquote>
1430                                
1431    
 </p>  
1432  <p>"WRN[&lt;device-id&gt;]:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN[&lt;device-id&gt;]:&lt;warning-code&gt;:&lt;warning-message&gt;" -
1433                                  </p>                                  </p>
1434  <blockquote class="text">  <blockquote class="text">
# Line 1388  Intellectual Property and Copyright Stat Line 1439  Intellectual Property and Copyright Stat
1439                                      fall-back values), providing an appropriate warning code and                                      fall-back values), providing an appropriate warning code and
1440                                      warning message                                      warning message
1441  </p>  </p>
1442  </blockquote><p>  </blockquote>
1443                                
1444    
 </p>  
1445  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
1446                                  </p>                                  </p>
1447  <blockquote class="text">  <blockquote class="text">
1448  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
1449  </p>  </p>
1450  </blockquote><p>  </blockquote>
1451                                
1452    
 </p>  
1453  </blockquote><p>  </blockquote><p>
1454                        
1455  </p>  </p>
1456  <p>Examples:  <p>Examples:
1457  </p>  </p>
# Line 1412  Intellectual Property and Copyright Stat Line 1463  Intellectual Property and Copyright Stat
1463  <p>S: "OK[0]"  <p>S: "OK[0]"
1464  </p>  </p>
1465  </blockquote><p>  </blockquote><p>
1466                        
1467  </p>  </p>
1468  <p>  <p>
1469                          </p>                          </p>
# Line 1422  Intellectual Property and Copyright Stat Line 1473  Intellectual Property and Copyright Stat
1473  <p>S: "OK[1]"  <p>S: "OK[1]"
1474  </p>  </p>
1475  </blockquote><p>  </blockquote><p>
1476                        
1477  </p>  </p>
1478  <a name="rfc.section.6.2.6"></a><h4><a name="DESTROY AUDIO_OUTPUT_DEVICE">6.2.6</a>&nbsp;Destroying an audio output device</h4>  <a name="DESTROY AUDIO_OUTPUT_DEVICE"></a><br /><hr />
1479    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1480    <a name="rfc.section.6.2.6"></a><h3>6.2.6.&nbsp;Destroying an audio output device</h3>
1481    
1482  <p>Use the following command to destroy a created output device:  <p>Use the following command to destroy a created output device:
1483  </p>  </p>
# Line 1434  Intellectual Property and Copyright Stat Line 1487  Intellectual Property and Copyright Stat
1487  <p>DESTROY AUDIO_OUTPUT_DEVICE &lt;device-id&gt;  <p>DESTROY AUDIO_OUTPUT_DEVICE &lt;device-id&gt;
1488  </p>  </p>
1489  </blockquote><p>  </blockquote><p>
1490                        
1491  </p>  </p>
1492  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the
1493                      audio output device as given by the                      audio output device as given by the
# Line 1452  Intellectual Property and Copyright Stat Line 1505  Intellectual Property and Copyright Stat
1505  <blockquote class="text">  <blockquote class="text">
1506  <p>in case the device was successfully destroyed  <p>in case the device was successfully destroyed
1507  </p>  </p>
1508  </blockquote><p>  </blockquote>
1509                                
1510    
 </p>  
1511  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
1512                                  </p>                                  </p>
1513  <blockquote class="text">  <blockquote class="text">
# Line 1464  Intellectual Property and Copyright Stat Line 1517  Intellectual Property and Copyright Stat
1517                                      informed about this situation), providing an appropriate                                      informed about this situation), providing an appropriate
1518                                      warning code and warning message                                      warning code and warning message
1519  </p>  </p>
1520  </blockquote><p>  </blockquote>
1521                                
1522    
 </p>  
1523  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
1524                                  </p>                                  </p>
1525  <blockquote class="text">  <blockquote class="text">
1526  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
1527                                      error message                                      error message
1528  </p>  </p>
1529  </blockquote><p>  </blockquote>
1530                                
1531    
 </p>  
1532  </blockquote><p>  </blockquote><p>
1533                        
1534  </p>  </p>
1535  <p>Example:  <p>Example:
1536  </p>  </p>
# Line 1489  Intellectual Property and Copyright Stat Line 1542  Intellectual Property and Copyright Stat
1542  <p>S: "OK"  <p>S: "OK"
1543  </p>  </p>
1544  </blockquote><p>  </blockquote><p>
1545                        
1546  </p>  </p>
1547  <a name="rfc.section.6.2.7"></a><h4><a name="GET AUDIO_OUTPUT_DEVICES">6.2.7</a>&nbsp;Getting all created audio output device count</h4>  <a name="GET AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1548    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1549    <a name="rfc.section.6.2.7"></a><h3>6.2.7.&nbsp;Getting all created audio output device count</h3>
1550    
1551  <p>Use the following command to count all created audio output devices:  <p>Use the following command to count all created audio output devices:
1552  </p>  </p>
# Line 1501  Intellectual Property and Copyright Stat Line 1556  Intellectual Property and Copyright Stat
1556  <p>GET AUDIO_OUTPUT_DEVICES  <p>GET AUDIO_OUTPUT_DEVICES
1557  </p>  </p>
1558  </blockquote><p>  </blockquote><p>
1559                        
1560  </p>  </p>
1561  <p>Possible Answers:  <p>Possible Answers:
1562  </p>  </p>
# Line 1512  Intellectual Property and Copyright Stat Line 1567  Intellectual Property and Copyright Stat
1567                              audio output devices.                              audio output devices.
1568  </p>  </p>
1569  </blockquote><p>  </blockquote><p>
1570                        
1571  </p>  </p>
1572  <p>Example:  <p>Example:
1573  </p>  </p>
# Line 1524  Intellectual Property and Copyright Stat Line 1579  Intellectual Property and Copyright Stat
1579  <p>S: "4"  <p>S: "4"
1580  </p>  </p>
1581  </blockquote><p>  </blockquote><p>
1582                        
1583  </p>  </p>
1584  <a name="rfc.section.6.2.8"></a><h4><a name="LIST AUDIO_OUTPUT_DEVICES">6.2.8</a>&nbsp;Getting all created audio output device list</h4>  <a name="LIST AUDIO_OUTPUT_DEVICES"></a><br /><hr />
1585    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1586    <a name="rfc.section.6.2.8"></a><h3>6.2.8.&nbsp;Getting all created audio output device list</h3>
1587    
1588  <p>Use the following command to list all created audio output devices:  <p>Use the following command to list all created audio output devices:
1589  </p>  </p>
# Line 1536  Intellectual Property and Copyright Stat Line 1593  Intellectual Property and Copyright Stat
1593  <p>LIST AUDIO_OUTPUT_DEVICES  <p>LIST AUDIO_OUTPUT_DEVICES
1594  </p>  </p>
1595  </blockquote><p>  </blockquote><p>
1596                        
1597  </p>  </p>
1598  <p>Possible Answers:  <p>Possible Answers:
1599  </p>  </p>
# Line 1547  Intellectual Property and Copyright Stat Line 1604  Intellectual Property and Copyright Stat
1604                              the numerical IDs of all audio output devices.                              the numerical IDs of all audio output devices.
1605  </p>  </p>
1606  </blockquote><p>  </blockquote><p>
1607                        
1608  </p>  </p>
1609  <p>Example:  <p>Example:
1610  </p>  </p>
# Line 1559  Intellectual Property and Copyright Stat Line 1616  Intellectual Property and Copyright Stat
1616  <p>S: "0,1,4,5"  <p>S: "0,1,4,5"
1617  </p>  </p>
1618  </blockquote><p>  </blockquote><p>
1619                        
1620  </p>  </p>
1621  <a name="rfc.section.6.2.9"></a><h4><a name="GET AUDIO_OUTPUT_DEVICE INFO">6.2.9</a>&nbsp;Getting current settings of an audio output device</h4>  <a name="GET AUDIO_OUTPUT_DEVICE INFO"></a><br /><hr />
1622    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1623    <a name="rfc.section.6.2.9"></a><h3>6.2.9.&nbsp;Getting current settings of an audio output device</h3>
1624    
1625  <p>Use the following command to get current settings of a specific, created audio output device:  <p>Use the following command to get current settings of a specific, created audio output device:
1626  </p>  </p>
# Line 1571  Intellectual Property and Copyright Stat Line 1630  Intellectual Property and Copyright Stat
1630  <p>GET AUDIO_OUTPUT_DEVICE INFO &lt;device-id&gt;  <p>GET AUDIO_OUTPUT_DEVICE INFO &lt;device-id&gt;
1631  </p>  </p>
1632  </blockquote><p>  </blockquote><p>
1633                        
1634  </p>  </p>
1635  <p>Where &lt;device-id&gt; should be replaced by numerical ID  <p>Where &lt;device-id&gt; should be replaced by numerical ID
1636                      of the audio output device as e.g. returned by the                      of the audio output device as e.g. returned by the
# Line 1598  Intellectual Property and Copyright Stat Line 1657  Intellectual Property and Copyright Stat
1657                                      <a class="info" href="#LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">"LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"<span> (</span><span class="info">Getting all available audio output drivers</span><span>)</span></a>                                      <a class="info" href="#LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS">"LIST AVAILABLE_AUDIO_OUTPUT_DRIVERS"<span> (</span><span class="info">Getting all available audio output drivers</span><span>)</span></a>
1658                                      command                                      command
1659  </p>  </p>
1660  </blockquote><p>  </blockquote>
1661                                
1662    
 </p>  
1663  <p>CHANNELS -  <p>CHANNELS -
1664                                  </p>                                  </p>
1665  <blockquote class="text">  <blockquote class="text">
1666  <p>amount of audio output channels this device currently  <p>amount of audio output channels this device currently
1667                                      offers                                      offers
1668  </p>  </p>
1669  </blockquote><p>  </blockquote>
1670                                
1671    
 </p>  
1672  <p>SAMPLERATE -  <p>SAMPLERATE -
1673                                  </p>                                  </p>
1674  <blockquote class="text">  <blockquote class="text">
1675  <p>playback sample rate the device uses  <p>playback sample rate the device uses
1676  </p>  </p>
1677  </blockquote><p>  </blockquote>
1678                                
1679    
 </p>  
1680  <p>ACTIVE -  <p>ACTIVE -
1681                                  </p>                                  </p>
1682  <blockquote class="text">  <blockquote class="text">
# Line 1626  Intellectual Property and Copyright Stat Line 1685  Intellectual Property and Copyright Stat
1685                                      sampler channels connected to this audio device render                                      sampler channels connected to this audio device render
1686                                      any audio                                      any audio
1687  </p>  </p>
1688  </blockquote><p>  </blockquote>
1689                                
1690    
 </p>  
1691  </blockquote><p>  </blockquote><p>
1692                        
1693  </p>  </p>
1694  <p>The mentioned fields above don't have to be in particular  <p>The mentioned fields above don't have to be in particular
1695                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
# Line 1663  Intellectual Property and Copyright Stat Line 1722  Intellectual Property and Copyright Stat
1722  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1723  </p>  </p>
1724  </blockquote><p>  </blockquote><p>
1725                        
1726  </p>  </p>
1727  <a name="rfc.section.6.2.10"></a><h4><a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER">6.2.10</a>&nbsp;Changing settings of audio output devices</h4>  <a name="SET AUDIO_OUTPUT_DEVICE_PARAMETER"></a><br /><hr />
1728    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1729    <a name="rfc.section.6.2.10"></a><h3>6.2.10.&nbsp;Changing settings of audio output devices</h3>
1730    
1731  <p>Use the following command to alter a specific setting of a created audio output device:  <p>Use the following command to alter a specific setting of a created audio output device:
1732  </p>  </p>
# Line 1675  Intellectual Property and Copyright Stat Line 1736  Intellectual Property and Copyright Stat
1736  <p>SET AUDIO_OUTPUT_DEVICE_PARAMETER &lt;device-id&gt; &lt;key&gt;=&lt;value&gt;  <p>SET AUDIO_OUTPUT_DEVICE_PARAMETER &lt;device-id&gt; &lt;key&gt;=&lt;value&gt;
1737  </p>  </p>
1738  </blockquote><p>  </blockquote><p>
1739                        
1740  </p>  </p>
1741  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the
1742                      audio output device as given by the                      audio output device as given by the
# Line 1694  Intellectual Property and Copyright Stat Line 1755  Intellectual Property and Copyright Stat
1755  <blockquote class="text">  <blockquote class="text">
1756  <p>in case setting was successfully changed  <p>in case setting was successfully changed
1757  </p>  </p>
1758  </blockquote><p>  </blockquote>
1759                                
1760    
 </p>  
1761  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
1762                                  </p>                                  </p>
1763  <blockquote class="text">  <blockquote class="text">
# Line 1704  Intellectual Property and Copyright Stat Line 1765  Intellectual Property and Copyright Stat
1765                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
1766                                      warning code and warning message                                      warning code and warning message
1767  </p>  </p>
1768  </blockquote><p>  </blockquote>
1769                                
1770    
 </p>  
1771  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
1772                                  </p>                                  </p>
1773  <blockquote class="text">  <blockquote class="text">
1774  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
1775                                      error message                                      error message
1776  </p>  </p>
1777  </blockquote><p>  </blockquote>
1778                                
1779    
 </p>  
1780  </blockquote><p>  </blockquote><p>
1781                        
1782  </p>  </p>
1783  <p>Example:  <p>Example:
1784  </p>  </p>
# Line 1729  Intellectual Property and Copyright Stat Line 1790  Intellectual Property and Copyright Stat
1790  <p>S: "OK"  <p>S: "OK"
1791  </p>  </p>
1792  </blockquote><p>  </blockquote><p>
1793                        
1794  </p>  </p>
1795  <a name="rfc.section.6.2.11"></a><h4><a name="GET AUDIO_OUTPUT_CHANNEL INFO">6.2.11</a>&nbsp;Getting information about an audio channel</h4>  <a name="GET AUDIO_OUTPUT_CHANNEL INFO"></a><br /><hr />
1796    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1797    <a name="rfc.section.6.2.11"></a><h3>6.2.11.&nbsp;Getting information about an audio channel</h3>
1798    
1799  <p>Use the following command to get information about an audio channel:  <p>Use the following command to get information about an audio channel:
1800  </p>  </p>
# Line 1741  Intellectual Property and Copyright Stat Line 1804  Intellectual Property and Copyright Stat
1804  <p>GET AUDIO_OUTPUT_CHANNEL INFO &lt;device-id&gt; &lt;audio-chan&gt;  <p>GET AUDIO_OUTPUT_CHANNEL INFO &lt;device-id&gt; &lt;audio-chan&gt;
1805  </p>  </p>
1806  </blockquote><p>  </blockquote><p>
1807                        
1808  </p>  </p>
1809  <p>Where &lt;device-id&gt; is the numerical ID of the audio output device as given by the  <p>Where &lt;device-id&gt; is the numerical ID of the audio output device as given by the
1810                      <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">"CREATE AUDIO_OUTPUT_DEVICE"<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>                      <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">"CREATE AUDIO_OUTPUT_DEVICE"<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>
# Line 1768  Intellectual Property and Copyright Stat Line 1831  Intellectual Property and Copyright Stat
1831  <p>arbitrary character string naming the channel, which  <p>arbitrary character string naming the channel, which
1832                                              doesn't have to be unique (always returned by all audio channels)                                              doesn't have to be unique (always returned by all audio channels)
1833  </p>  </p>
1834  </blockquote><p>  </blockquote>
1835                                        
1836    
 </p>  
1837  <p>IS_MIX_CHANNEL -  <p>IS_MIX_CHANNEL -
1838                                          </p>                                          </p>
1839  <blockquote class="text">  <blockquote class="text">
# Line 1781  Intellectual Property and Copyright Stat Line 1844  Intellectual Property and Copyright Stat
1844                                              channels than the used audio system might be able to offer                                              channels than the used audio system might be able to offer
1845                                              (always returned by all audio channels)                                              (always returned by all audio channels)
1846  </p>  </p>
1847  </blockquote><p>  </blockquote>
1848                                        
1849    
 </p>  
1850  <p>MIX_CHANNEL_DESTINATION -  <p>MIX_CHANNEL_DESTINATION -
1851                                          </p>                                          </p>
1852  <blockquote class="text">  <blockquote class="text">
# Line 1793  Intellectual Property and Copyright Stat Line 1856  Intellectual Property and Copyright Stat
1856                                              the audio signal actually will be routed / added to                                              the audio signal actually will be routed / added to
1857                                              (only returned in case the audio channel is mix channel)                                              (only returned in case the audio channel is mix channel)
1858  </p>  </p>
1859  </blockquote><p>  </blockquote>
1860                                        
1861    
1862  </p>  </blockquote>
1863  </blockquote><p>                              
1864    
 </p>  
1865  </blockquote><p>  </blockquote><p>
1866                        
1867  </p>  </p>
1868  <p>The mentioned fields above don't have to be in particular  <p>The mentioned fields above don't have to be in particular
1869                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
# Line 1823  Intellectual Property and Copyright Stat Line 1886  Intellectual Property and Copyright Stat
1886  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1887  </p>  </p>
1888  </blockquote><p>  </blockquote><p>
1889                        
1890  </p>  </p>
1891  <p>  <p>
1892                          </p>                          </p>
# Line 1837  Intellectual Property and Copyright Stat Line 1900  Intellectual Property and Copyright Stat
1900  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1901  </p>  </p>
1902  </blockquote><p>  </blockquote><p>
1903                        
1904  </p>  </p>
1905  <p>  <p>
1906                          </p>                          </p>
# Line 1853  Intellectual Property and Copyright Stat Line 1916  Intellectual Property and Copyright Stat
1916  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1917  </p>  </p>
1918  </blockquote><p>  </blockquote><p>
1919                        
1920  </p>  </p>
1921  <p>  <p>
1922                          </p>                          </p>
# Line 1869  Intellectual Property and Copyright Stat Line 1932  Intellectual Property and Copyright Stat
1932  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
1933  </p>  </p>
1934  </blockquote><p>  </blockquote><p>
1935                        
1936  </p>  </p>
1937  <a name="rfc.section.6.2.12"></a><h4><a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO">6.2.12</a>&nbsp;Getting information about specific audio channel parameter</h4>  <a name="GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO"></a><br /><hr />
1938    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
1939    <a name="rfc.section.6.2.12"></a><h3>6.2.12.&nbsp;Getting information about specific audio channel parameter</h3>
1940    
1941  <p>Use the following command to get detailed information about specific audio channel parameter:  <p>Use the following command to get detailed information about specific audio channel parameter:
1942  </p>  </p>
# Line 1881  Intellectual Property and Copyright Stat Line 1946  Intellectual Property and Copyright Stat
1946  <p>GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO &lt;dev-id&gt; &lt;chan&gt; &lt;param&gt;  <p>GET AUDIO_OUTPUT_CHANNEL_PARAMETER INFO &lt;dev-id&gt; &lt;chan&gt; &lt;param&gt;
1947  </p>  </p>
1948  </blockquote><p>  </blockquote><p>
1949                        
1950  </p>  </p>
1951  <p>Where &lt;dev-id&gt; is the numerical ID of the audio output device as returned by the  <p>Where &lt;dev-id&gt; is the numerical ID of the audio output device as returned by the
1952                      <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">"CREATE AUDIO_OUTPUT_DEVICE"<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>                      <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">"CREATE AUDIO_OUTPUT_DEVICE"<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>
# Line 1915  Intellectual Property and Copyright Stat Line 1980  Intellectual Property and Copyright Stat
1980                                              character string(s)                                              character string(s)
1981                                              (always returned)                                              (always returned)
1982  </p>  </p>
1983  </blockquote><p>  </blockquote>
1984                                        
1985    
 </p>  
1986  <p>DESCRIPTION -  <p>DESCRIPTION -
1987                                          </p>                                          </p>
1988  <blockquote class="text">  <blockquote class="text">
1989  <p>arbitrary text describing the purpose of the parameter (always returned)  <p>arbitrary text describing the purpose of the parameter (always returned)
1990  </p>  </p>
1991  </blockquote><p>  </blockquote>
1992                                        
1993    
 </p>  
1994  <p>FIX -  <p>FIX -
1995                                          </p>                                          </p>
1996  <blockquote class="text">  <blockquote class="text">
# Line 1933  Intellectual Property and Copyright Stat Line 1998  Intellectual Property and Copyright Stat
1998                                              read only, thus cannot be altered                                              read only, thus cannot be altered
1999                                              (always returned)                                              (always returned)
2000  </p>  </p>
2001  </blockquote><p>  </blockquote>
2002                                        
2003    
 </p>  
2004  <p>MULTIPLICITY -  <p>MULTIPLICITY -
2005                                          </p>                                          </p>
2006  <blockquote class="text">  <blockquote class="text">
# Line 1944  Intellectual Property and Copyright Stat Line 2009  Intellectual Property and Copyright Stat
2009                                              multiple values and false only a single value allowed                                              multiple values and false only a single value allowed
2010                                              (always returned)                                              (always returned)
2011  </p>  </p>
2012  </blockquote><p>  </blockquote>
2013                                        
2014    
 </p>  
2015  <p>RANGE_MIN -  <p>RANGE_MIN -
2016                                          </p>                                          </p>
2017  <blockquote class="text">  <blockquote class="text">
# Line 1957  Intellectual Property and Copyright Stat Line 2022  Intellectual Property and Copyright Stat
2022                                              (optionally returned, dependent to driver and channel                                              (optionally returned, dependent to driver and channel
2023                                              parameter)                                              parameter)
2024  </p>  </p>
2025  </blockquote><p>  </blockquote>
2026                                        
2027    
 </p>  
2028  <p>RANGE_MAX -  <p>RANGE_MAX -
2029                                          </p>                                          </p>
2030  <blockquote class="text">  <blockquote class="text">
# Line 1970  Intellectual Property and Copyright Stat Line 2035  Intellectual Property and Copyright Stat
2035                                              (optionally returned, dependent to driver and channel                                              (optionally returned, dependent to driver and channel
2036                                              parameter)                                              parameter)
2037  </p>  </p>
2038  </blockquote><p>  </blockquote>
2039                                        
2040    
 </p>  
2041  <p>POSSIBILITIES -  <p>POSSIBILITIES -
2042                                          </p>                                          </p>
2043  <blockquote class="text">  <blockquote class="text">
# Line 1982  Intellectual Property and Copyright Stat Line 2047  Intellectual Property and Copyright Stat
2047                                              (optionally returned, dependent to driver and channel                                              (optionally returned, dependent to driver and channel
2048                                              parameter)                                              parameter)
2049  </p>  </p>
2050  </blockquote><p>  </blockquote>
2051                                        
2052    
2053  </p>  </blockquote>
2054  </blockquote><p>                              
2055    
 </p>  
2056  <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.
2057  </p>  </p>
2058  </blockquote><p>  </blockquote><p>
2059                        
2060  </p>  </p>
2061  <p>Example:  <p>Example:
2062  </p>  </p>
# Line 2013  Intellectual Property and Copyright Stat Line 2078  Intellectual Property and Copyright Stat
2078  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2079  </p>  </p>
2080  </blockquote><p>  </blockquote><p>
2081                        
2082  </p>  </p>
2083  <a name="rfc.section.6.2.13"></a><h4><a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER">6.2.13</a>&nbsp;Changing settings of audio output channels</h4>  <a name="SET AUDIO_OUTPUT_CHANNEL_PARAMETER"></a><br /><hr />
2084    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2085    <a name="rfc.section.6.2.13"></a><h3>6.2.13.&nbsp;Changing settings of audio output channels</h3>
2086    
2087  <p>Use the following command to alter a specific setting of an audio output channel:  <p>Use the following command to alter a specific setting of an audio output channel:
2088  </p>  </p>
# Line 2025  Intellectual Property and Copyright Stat Line 2092  Intellectual Property and Copyright Stat
2092  <p>SET AUDIO_OUTPUT_CHANNEL_PARAMETER &lt;dev-id&gt; &lt;chn&gt; &lt;key&gt;=&lt;value&gt;  <p>SET AUDIO_OUTPUT_CHANNEL_PARAMETER &lt;dev-id&gt; &lt;chn&gt; &lt;key&gt;=&lt;value&gt;
2093  </p>  </p>
2094  </blockquote><p>  </blockquote><p>
2095                        
2096  </p>  </p>
2097  <p>Where &lt;dev-id&gt; should be replaced by the numerical ID of the audio output device as returned by the  <p>Where &lt;dev-id&gt; should be replaced by the numerical ID of the audio output device as returned by the
2098                      <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">"CREATE AUDIO_OUTPUT_DEVICE"<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>                      <a class="info" href="#CREATE AUDIO_OUTPUT_DEVICE">"CREATE AUDIO_OUTPUT_DEVICE"<span> (</span><span class="info">Creating an audio output device</span><span>)</span></a>
# Line 2043  Intellectual Property and Copyright Stat Line 2110  Intellectual Property and Copyright Stat
2110  <blockquote class="text">  <blockquote class="text">
2111  <p>in case setting was successfully changed  <p>in case setting was successfully changed
2112  </p>  </p>
2113  </blockquote><p>  </blockquote>
2114                                
2115    
 </p>  
2116  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2117                                  </p>                                  </p>
2118  <blockquote class="text">  <blockquote class="text">
# Line 2053  Intellectual Property and Copyright Stat Line 2120  Intellectual Property and Copyright Stat
2120                                     noteworthy issue(s) related, providing an appropriate                                     noteworthy issue(s) related, providing an appropriate
2121                                     warning code and warning message                                     warning code and warning message
2122  </p>  </p>
2123  </blockquote><p>  </blockquote>
2124                                
2125    
 </p>  
2126  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2127                                  </p>                                  </p>
2128  <blockquote class="text">  <blockquote class="text">
2129  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
2130                                     error message                                     error message
2131  </p>  </p>
2132  </blockquote><p>  </blockquote>
2133                                
2134    
 </p>  
2135  </blockquote><p>  </blockquote><p>
2136                        
2137  </p>  </p>
2138  <p>Example:  <p>Example:
2139  </p>  </p>
# Line 2078  Intellectual Property and Copyright Stat Line 2145  Intellectual Property and Copyright Stat
2145  <p>S: "OK"  <p>S: "OK"
2146  </p>  </p>
2147  </blockquote><p>  </blockquote><p>
2148                        
2149  </p>  </p>
2150  <p>  <p>
2151                          </p>                          </p>
# Line 2088  Intellectual Property and Copyright Stat Line 2155  Intellectual Property and Copyright Stat
2155  <p>S: "OK"  <p>S: "OK"
2156  </p>  </p>
2157  </blockquote><p>  </blockquote><p>
2158                        
2159  </p>  </p>
2160  <a name="rfc.section.6.3"></a><h4><a name="anchor10">6.3</a>&nbsp;Configuring MIDI input drivers</h4>  <a name="anchor10"></a><br /><hr />
2161    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2162    <a name="rfc.section.6.3"></a><h3>6.3.&nbsp;Configuring MIDI input drivers</h3>
2163    
2164  <p>Instances of drivers in LinuxSampler are called devices. You can use  <p>Instances of drivers in LinuxSampler are called devices. You can use
2165                  multiple MIDI devices simultaneously, e.g. to use MIDI over ethernet as                  multiple MIDI devices simultaneously, e.g. to use MIDI over ethernet as
# Line 2118  Intellectual Property and Copyright Stat Line 2187  Intellectual Property and Copyright Stat
2187                  showing how to retrieve what parameters drivers are offering, how to retrieve their                  showing how to retrieve what parameters drivers are offering, how to retrieve their
2188                  possible values, etc.                  possible values, etc.
2189  </p>  </p>
2190  <a name="rfc.section.6.3.1"></a><h4><a name="GET AVAILABLE_MIDI_INPUT_DRIVERS">6.3.1</a>&nbsp;Getting amount of available MIDI input drivers</h4>  <a name="GET AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2191    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2192    <a name="rfc.section.6.3.1"></a><h3>6.3.1.&nbsp;Getting amount of available MIDI input drivers</h3>
2193    
2194  <p>Use the following command to get the number of  <p>Use the following command to get the number of
2195                      MIDI input drivers currently available for the                      MIDI input drivers currently available for the
# Line 2130  Intellectual Property and Copyright Stat Line 2201  Intellectual Property and Copyright Stat
2201  <p>GET AVAILABLE_MIDI_INPUT_DRIVERS  <p>GET AVAILABLE_MIDI_INPUT_DRIVERS
2202  </p>  </p>
2203  </blockquote><p>  </blockquote><p>
2204                        
2205  </p>  </p>
2206  <p>Possible Answers:  <p>Possible Answers:
2207  </p>  </p>
# Line 2141  Intellectual Property and Copyright Stat Line 2212  Intellectual Property and Copyright Stat
2212                              number of available MIDI input drivers.                              number of available MIDI input drivers.
2213  </p>  </p>
2214  </blockquote><p>  </blockquote><p>
2215                        
2216  </p>  </p>
2217  <p>Example:  <p>Example:
2218  </p>  </p>
# Line 2153  Intellectual Property and Copyright Stat Line 2224  Intellectual Property and Copyright Stat
2224  <p>S: "2"  <p>S: "2"
2225  </p>  </p>
2226  </blockquote><p>  </blockquote><p>
2227                        
2228  </p>  </p>
2229  <a name="rfc.section.6.3.2"></a><h4><a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS">6.3.2</a>&nbsp;Getting all available MIDI input drivers</h4>  <a name="LIST AVAILABLE_MIDI_INPUT_DRIVERS"></a><br /><hr />
2230    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2231    <a name="rfc.section.6.3.2"></a><h3>6.3.2.&nbsp;Getting all available MIDI input drivers</h3>
2232    
2233  <p>Use the following command to list all MIDI input drivers currently available  <p>Use the following command to list all MIDI input drivers currently available
2234                      for the LinuxSampler instance:                      for the LinuxSampler instance:
# Line 2166  Intellectual Property and Copyright Stat Line 2239  Intellectual Property and Copyright Stat
2239  <p>LIST AVAILABLE_MIDI_INPUT_DRIVERS  <p>LIST AVAILABLE_MIDI_INPUT_DRIVERS
2240  </p>  </p>
2241  </blockquote><p>  </blockquote><p>
2242                        
2243  </p>  </p>
2244  <p>Possible Answers:  <p>Possible Answers:
2245  </p>  </p>
# Line 2177  Intellectual Property and Copyright Stat Line 2250  Intellectual Property and Copyright Stat
2250                              strings, each symbolizing a MIDI input driver.                              strings, each symbolizing a MIDI input driver.
2251  </p>  </p>
2252  </blockquote><p>  </blockquote><p>
2253                        
2254  </p>  </p>
2255  <p>Example:  <p>Example:
2256  </p>  </p>
# Line 2189  Intellectual Property and Copyright Stat Line 2262  Intellectual Property and Copyright Stat
2262  <p>S: "ALSA,JACK"  <p>S: "ALSA,JACK"
2263  </p>  </p>
2264  </blockquote><p>  </blockquote><p>
2265                        
2266  </p>  </p>
2267  <a name="rfc.section.6.3.3"></a><h4><a name="GET MIDI_INPUT_DRIVER INFO">6.3.3</a>&nbsp;Getting information about a specific MIDI input driver</h4>  <a name="GET MIDI_INPUT_DRIVER INFO"></a><br /><hr />
2268    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2269    <a name="rfc.section.6.3.3"></a><h3>6.3.3.&nbsp;Getting information about a specific MIDI input driver</h3>
2270    
2271  <p>Use the following command to get detailed information about a specific MIDI input driver:  <p>Use the following command to get detailed information about a specific MIDI input driver:
2272  </p>  </p>
# Line 2201  Intellectual Property and Copyright Stat Line 2276  Intellectual Property and Copyright Stat
2276  <p>GET MIDI_INPUT_DRIVER INFO &lt;midi-input-driver&gt;  <p>GET MIDI_INPUT_DRIVER INFO &lt;midi-input-driver&gt;
2277  </p>  </p>
2278  </blockquote><p>  </blockquote><p>
2279                        
2280  </p>  </p>
2281  <p>Where &lt;midi-input-driver&gt; is the name of the MIDI input driver as returned  <p>Where &lt;midi-input-driver&gt; is the name of the MIDI input driver as returned
2282                      by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a> command.                      by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a> command.
# Line 2225  Intellectual Property and Copyright Stat Line 2300  Intellectual Property and Copyright Stat
2300  <blockquote class="text">  <blockquote class="text">
2301  <p>arbitrary description text about the MIDI input driver  <p>arbitrary description text about the MIDI input driver
2302  </p>  </p>
2303  </blockquote><p>  </blockquote>
2304                                        
2305    
 </p>  
2306  <p>VERSION -  <p>VERSION -
2307                                          </p>                                          </p>
2308  <blockquote class="text">  <blockquote class="text">
2309  <p>arbitrary character string regarding the driver's version  <p>arbitrary character string regarding the driver's version
2310  </p>  </p>
2311  </blockquote><p>  </blockquote>
2312                                        
2313    
 </p>  
2314  <p>PARAMETERS -  <p>PARAMETERS -
2315                                          </p>                                          </p>
2316  <blockquote class="text">  <blockquote class="text">
2317  <p>comma separated list of all parameters available for the given MIDI input driver  <p>comma separated list of all parameters available for the given MIDI input driver
2318  </p>  </p>
2319  </blockquote><p>  </blockquote>
2320                                        
2321    
2322  </p>  </blockquote>
2323  </blockquote><p>                              
2324    
 </p>  
2325  <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.
2326  </p>  </p>
2327  </blockquote><p>  </blockquote><p>
2328                        
2329  </p>  </p>
2330  <p>Example:  <p>Example:
2331  </p>  </p>
# Line 2268  Intellectual Property and Copyright Stat Line 2343  Intellectual Property and Copyright Stat
2343  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2344  </p>  </p>
2345  </blockquote><p>  </blockquote><p>
2346                        
2347  </p>  </p>
2348  <a name="rfc.section.6.3.4"></a><h4><a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO">6.3.4</a>&nbsp;Getting information about specific MIDI input driver parameter</h4>  <a name="GET MIDI_INPUT_DRIVER_PARAMETER INFO"></a><br /><hr />
2349    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2350    <a name="rfc.section.6.3.4"></a><h3>6.3.4.&nbsp;Getting information about specific MIDI input driver parameter</h3>
2351    
2352  <p>Use the following command to get detailed information about a specific parameter of a specific MIDI input driver:  <p>Use the following command to get detailed information about a specific parameter of a specific MIDI input driver:
2353  </p>  </p>
# Line 2280  Intellectual Property and Copyright Stat Line 2357  Intellectual Property and Copyright Stat
2357  <p>GET MIDI_INPUT_DRIVER_PARAMETER INFO &lt;midit&gt; &lt;param&gt; [&lt;deplist&gt;]  <p>GET MIDI_INPUT_DRIVER_PARAMETER INFO &lt;midit&gt; &lt;param&gt; [&lt;deplist&gt;]
2358  </p>  </p>
2359  </blockquote><p>  </blockquote><p>
2360                        
2361  </p>  </p>
2362  <p>Where &lt;midit&gt; is the name of the MIDI input driver as returned  <p>Where &lt;midit&gt; is the name of the MIDI input driver as returned
2363                      by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a> command, &lt;param&gt; a specific                      by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a> command, &lt;param&gt; a specific
# Line 2315  Intellectual Property and Copyright Stat Line 2392  Intellectual Property and Copyright Stat
2392                                  character string(s)                                  character string(s)
2393                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2394  </p>  </p>
2395  </blockquote><p>  </blockquote>
2396                                
2397    
 </p>  
2398  <p>DESCRIPTION -  <p>DESCRIPTION -
2399                                </p>                                </p>
2400  <blockquote class="text">  <blockquote class="text">
2401  <p>arbitrary text describing the purpose of the parameter  <p>arbitrary text describing the purpose of the parameter
2402                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2403  </p>  </p>
2404  </blockquote><p>  </blockquote>
2405                                
2406    
 </p>  
2407  <p>MANDATORY -  <p>MANDATORY -
2408                                </p>                                </p>
2409  <blockquote class="text">  <blockquote class="text">
# Line 2335  Intellectual Property and Copyright Stat Line 2412  Intellectual Property and Copyright Stat
2412                                  <a class="info" href="#CREATE MIDI_INPUT_DEVICE">'CREATE MIDI_INPUT_DEVICE'<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a> command                                  <a class="info" href="#CREATE MIDI_INPUT_DEVICE">'CREATE MIDI_INPUT_DEVICE'<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a> command
2413                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2414  </p>  </p>
2415  </blockquote><p>  </blockquote>
2416                                
2417    
 </p>  
2418  <p>FIX -  <p>FIX -
2419                                </p>                                </p>
2420  <blockquote class="text">  <blockquote class="text">
# Line 2346  Intellectual Property and Copyright Stat Line 2423  Intellectual Property and Copyright Stat
2423                                  the <a class="info" href="#CREATE MIDI_INPUT_DEVICE">'CREATE MIDI_INPUT_DEVICE'<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a> command                                  the <a class="info" href="#CREATE MIDI_INPUT_DEVICE">'CREATE MIDI_INPUT_DEVICE'<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a> command
2424                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2425  </p>  </p>
2426  </blockquote><p>  </blockquote>
2427                                
2428    
 </p>  
2429  <p>MULTIPLICITY -  <p>MULTIPLICITY -
2430                                </p>                                </p>
2431  <blockquote class="text">  <blockquote class="text">
# Line 2357  Intellectual Property and Copyright Stat Line 2434  Intellectual Property and Copyright Stat
2434                                  multiple values and false only a single value allowed                                  multiple values and false only a single value allowed
2435                                  (always returned, no matter which driver parameter)                                  (always returned, no matter which driver parameter)
2436  </p>  </p>
2437  </blockquote><p>  </blockquote>
2438                                
2439    
 </p>  
2440  <p>DEPENDS -  <p>DEPENDS -
2441                                </p>                                </p>
2442  <blockquote class="text">  <blockquote class="text">
# Line 2374  Intellectual Property and Copyright Stat Line 2451  Intellectual Property and Copyright Stat
2451                                  chosen by the 'card' parameter                                  chosen by the 'card' parameter
2452                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2453  </p>  </p>
2454  </blockquote><p>  </blockquote>
2455                                
2456    
 </p>  
2457  <p>DEFAULT -  <p>DEFAULT -
2458                                </p>                                </p>
2459  <blockquote class="text">  <blockquote class="text">
# Line 2388  Intellectual Property and Copyright Stat Line 2465  Intellectual Property and Copyright Stat
2465                                  apostrophes (')                                  apostrophes (')
2466                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2467  </p>  </p>
2468  </blockquote><p>  </blockquote>
2469                                
2470    
 </p>  
2471  <p>RANGE_MIN -  <p>RANGE_MIN -
2472                                </p>                                </p>
2473  <blockquote class="text">  <blockquote class="text">
# Line 2400  Intellectual Property and Copyright Stat Line 2477  Intellectual Property and Copyright Stat
2477                                  with RANGE_MAX, but may also appear without                                  with RANGE_MAX, but may also appear without
2478                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2479  </p>  </p>
2480  </blockquote><p>  </blockquote>
2481                                
2482    
 </p>  
2483  <p>RANGE_MAX -  <p>RANGE_MAX -
2484                                </p>                                </p>
2485  <blockquote class="text">  <blockquote class="text">
# Line 2412  Intellectual Property and Copyright Stat Line 2489  Intellectual Property and Copyright Stat
2489                                  RANGE_MIN, but may also appear without                                  RANGE_MIN, but may also appear without
2490                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2491  </p>  </p>
2492  </blockquote><p>  </blockquote>
2493                                
2494    
 </p>  
2495  <p>POSSIBILITIES -  <p>POSSIBILITIES -
2496                                </p>                                </p>
2497  <blockquote class="text">  <blockquote class="text">
# Line 2423  Intellectual Property and Copyright Stat Line 2500  Intellectual Property and Copyright Stat
2500                                  apostrophes                                  apostrophes
2501                                  (optionally returned, dependent to driver parameter)                                  (optionally returned, dependent to driver parameter)
2502  </p>  </p>
2503  </blockquote><p>  </blockquote>
2504                                
2505    
 </p>  
2506  </blockquote><p>  </blockquote><p>
2507                        
2508  </p>  </p>
2509  <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.
2510  </p>  </p>
# Line 2453  Intellectual Property and Copyright Stat Line 2530  Intellectual Property and Copyright Stat
2530  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2531  </p>  </p>
2532  </blockquote><p>  </blockquote><p>
2533                        
2534  </p>  </p>
2535  <a name="rfc.section.6.3.5"></a><h4><a name="CREATE MIDI_INPUT_DEVICE">6.3.5</a>&nbsp;Creating a MIDI input device</h4>  <a name="CREATE MIDI_INPUT_DEVICE"></a><br /><hr />
2536    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2537    <a name="rfc.section.6.3.5"></a><h3>6.3.5.&nbsp;Creating a MIDI input device</h3>
2538    
2539  <p>Use the following command to create a new MIDI input device for  the desired MIDI input system:  <p>Use the following command to create a new MIDI input device for  the desired MIDI input system:
2540  </p>  </p>
# Line 2465  Intellectual Property and Copyright Stat Line 2544  Intellectual Property and Copyright Stat
2544  <p>CREATE MIDI_INPUT_DEVICE &lt;midi-input-driver&gt; [&lt;param-list&gt;]  <p>CREATE MIDI_INPUT_DEVICE &lt;midi-input-driver&gt; [&lt;param-list&gt;]
2545  </p>  </p>
2546  </blockquote><p>  </blockquote><p>
2547                        
2548  </p>  </p>
2549  <p>Where &lt;midi-input-driver&gt; should be replaced by the desired MIDI input system as returned  <p>Where &lt;midi-input-driver&gt; should be replaced by the desired MIDI input system as returned
2550                      by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a> command and &lt;param-list&gt; by an                      by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a> command and &lt;param-list&gt; by an
# Line 2486  Intellectual Property and Copyright Stat Line 2565  Intellectual Property and Copyright Stat
2565  <p>in case the device was successfully created, where  <p>in case the device was successfully created, where
2566                                      &lt;device-id&gt; is the numerical ID of the new device                                      &lt;device-id&gt; is the numerical ID of the new device
2567  </p>  </p>
2568  </blockquote><p>  </blockquote>
2569                                
2570    
 </p>  
2571  <p>"WRN[&lt;device-id&gt;]:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN[&lt;device-id&gt;]:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2572                                  </p>                                  </p>
2573  <blockquote class="text">  <blockquote class="text">
# Line 2497  Intellectual Property and Copyright Stat Line 2576  Intellectual Property and Copyright Stat
2576                                      there are noteworthy issue(s) related, providing an                                      there are noteworthy issue(s) related, providing an
2577                                      appropriate warning code and warning message                                      appropriate warning code and warning message
2578  </p>  </p>
2579  </blockquote><p>  </blockquote>
2580                                
2581    
 </p>  
2582  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2583                                  </p>                                  </p>
2584  <blockquote class="text">  <blockquote class="text">
2585  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
2586  </p>  </p>
2587  </blockquote><p>  </blockquote>
2588                                
2589    
 </p>  
2590  </blockquote><p>  </blockquote><p>
2591                        
2592  </p>  </p>
2593  <p>Example:  <p>Example:
2594  </p>  </p>
# Line 2521  Intellectual Property and Copyright Stat Line 2600  Intellectual Property and Copyright Stat
2600  <p>S: "OK[0]"  <p>S: "OK[0]"
2601  </p>  </p>
2602  </blockquote><p>  </blockquote><p>
2603                        
2604  </p>  </p>
2605  <a name="rfc.section.6.3.6"></a><h4><a name="DESTROY MIDI_INPUT_DEVICE">6.3.6</a>&nbsp;Destroying a MIDI input device</h4>  <a name="DESTROY MIDI_INPUT_DEVICE"></a><br /><hr />
2606    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2607    <a name="rfc.section.6.3.6"></a><h3>6.3.6.&nbsp;Destroying a MIDI input device</h3>
2608    
2609  <p>Use the following command to destroy a created MIDI input device:  <p>Use the following command to destroy a created MIDI input device:
2610  </p>  </p>
# Line 2533  Intellectual Property and Copyright Stat Line 2614  Intellectual Property and Copyright Stat
2614  <p>DESTROY MIDI_INPUT_DEVICE &lt;device-id&gt;  <p>DESTROY MIDI_INPUT_DEVICE &lt;device-id&gt;
2615  </p>  </p>
2616  </blockquote><p>  </blockquote><p>
2617                        
2618  </p>  </p>
2619  <p>Where &lt;device-id&gt; should be replaced by the device's numerical ID as returned by the  <p>Where &lt;device-id&gt; should be replaced by the device's numerical ID as returned by the
2620                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>
# Line 2550  Intellectual Property and Copyright Stat Line 2631  Intellectual Property and Copyright Stat
2631  <blockquote class="text">  <blockquote class="text">
2632  <p>in case the device was successfully destroyed  <p>in case the device was successfully destroyed
2633  </p>  </p>
2634  </blockquote><p>  </blockquote>
2635                                
2636    
 </p>  
2637  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2638                                  </p>                                  </p>
2639  <blockquote class="text">  <blockquote class="text">
# Line 2560  Intellectual Property and Copyright Stat Line 2641  Intellectual Property and Copyright Stat
2641                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
2642                                      warning message                                      warning message
2643  </p>  </p>
2644  </blockquote><p>  </blockquote>
2645                                
2646    
 </p>  
2647  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2648                                  </p>                                  </p>
2649  <blockquote class="text">  <blockquote class="text">
2650  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
2651  </p>  </p>
2652  </blockquote><p>  </blockquote>
2653                                
2654    
 </p>  
2655  </blockquote><p>  </blockquote><p>
2656                        
2657  </p>  </p>
2658  <p>Example:  <p>Example:
2659  </p>  </p>
# Line 2584  Intellectual Property and Copyright Stat Line 2665  Intellectual Property and Copyright Stat
2665  <p>S: "OK"  <p>S: "OK"
2666  </p>  </p>
2667  </blockquote><p>  </blockquote><p>
2668                        
2669  </p>  </p>
2670  <a name="rfc.section.6.3.7"></a><h4><a name="GET MIDI_INPUT_DEVICES">6.3.7</a>&nbsp;Getting all created MIDI input device count</h4>  <a name="GET MIDI_INPUT_DEVICES"></a><br /><hr />
2671    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2672    <a name="rfc.section.6.3.7"></a><h3>6.3.7.&nbsp;Getting all created MIDI input device count</h3>
2673    
2674  <p>Use the following command to count all created MIDI input devices:  <p>Use the following command to count all created MIDI input devices:
2675  </p>  </p>
# Line 2596  Intellectual Property and Copyright Stat Line 2679  Intellectual Property and Copyright Stat
2679  <p>GET MIDI_INPUT_DEVICES  <p>GET MIDI_INPUT_DEVICES
2680  </p>  </p>
2681  </blockquote><p>  </blockquote><p>
2682                        
2683  </p>  </p>
2684  <p>Possible Answers:  <p>Possible Answers:
2685  </p>  </p>
# Line 2607  Intellectual Property and Copyright Stat Line 2690  Intellectual Property and Copyright Stat
2690                              MIDI input devices.                              MIDI input devices.
2691  </p>  </p>
2692  </blockquote><p>  </blockquote><p>
2693                        
2694  </p>  </p>
2695  <p>Example:  <p>Example:
2696  </p>  </p>
# Line 2619  Intellectual Property and Copyright Stat Line 2702  Intellectual Property and Copyright Stat
2702  <p>S: "3"  <p>S: "3"
2703  </p>  </p>
2704  </blockquote><p>  </blockquote><p>
2705                        
2706  </p>  </p>
2707  <a name="rfc.section.6.3.8"></a><h4><a name="LIST MIDI_INPUT_DEVICES">6.3.8</a>&nbsp;Getting all created MIDI input device list</h4>  <a name="LIST MIDI_INPUT_DEVICES"></a><br /><hr />
2708    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2709    <a name="rfc.section.6.3.8"></a><h3>6.3.8.&nbsp;Getting all created MIDI input device list</h3>
2710    
2711  <p>Use the following command to list all created MIDI input devices:  <p>Use the following command to list all created MIDI input devices:
2712  </p>  </p>
# Line 2631  Intellectual Property and Copyright Stat Line 2716  Intellectual Property and Copyright Stat
2716  <p>LIST MIDI_INPUT_DEVICES  <p>LIST MIDI_INPUT_DEVICES
2717  </p>  </p>
2718  </blockquote><p>  </blockquote><p>
2719                        
2720  </p>  </p>
2721  <p>Possible Answers:  <p>Possible Answers:
2722  </p>  </p>
# Line 2642  Intellectual Property and Copyright Stat Line 2727  Intellectual Property and Copyright Stat
2727                              with the numerical Ids of all created MIDI input devices.                              with the numerical Ids of all created MIDI input devices.
2728  </p>  </p>
2729  </blockquote><p>  </blockquote><p>
2730                        
2731  </p>  </p>
2732  <p>Examples:  <p>Examples:
2733  </p>  </p>
# Line 2654  Intellectual Property and Copyright Stat Line 2739  Intellectual Property and Copyright Stat
2739  <p>S: "0,1,2"  <p>S: "0,1,2"
2740  </p>  </p>
2741  </blockquote><p>  </blockquote><p>
2742                        
2743  </p>  </p>
2744  <p>  <p>
2745                          </p>                          </p>
# Line 2664  Intellectual Property and Copyright Stat Line 2749  Intellectual Property and Copyright Stat
2749  <p>S: "1,3"  <p>S: "1,3"
2750  </p>  </p>
2751  </blockquote><p>  </blockquote><p>
2752                        
2753  </p>  </p>
2754  <a name="rfc.section.6.3.9"></a><h4><a name="GET MIDI_INPUT_DEVICE INFO">6.3.9</a>&nbsp;Getting current settings of a MIDI input device</h4>  <a name="GET MIDI_INPUT_DEVICE INFO"></a><br /><hr />
2755    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2756    <a name="rfc.section.6.3.9"></a><h3>6.3.9.&nbsp;Getting current settings of a MIDI input device</h3>
2757    
2758  <p>Use the following command to get current settings of a specific, created MIDI input device:  <p>Use the following command to get current settings of a specific, created MIDI input device:
2759  </p>  </p>
# Line 2676  Intellectual Property and Copyright Stat Line 2763  Intellectual Property and Copyright Stat
2763  <p>GET MIDI_INPUT_DEVICE INFO &lt;device-id&gt;  <p>GET MIDI_INPUT_DEVICE INFO &lt;device-id&gt;
2764  </p>  </p>
2765  </blockquote><p>  </blockquote><p>
2766                        
2767  </p>  </p>
2768  <p>Where &lt;device-id&gt; is the numerical ID of the MIDI input device as returned by the  <p>Where &lt;device-id&gt; is the numerical ID of the MIDI input device as returned by the
2769                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>
# Line 2706  Intellectual Property and Copyright Stat Line 2793  Intellectual Property and Copyright Stat
2793                                              returned by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a>                                              returned by the <a class="info" href="#LIST AVAILABLE_MIDI_INPUT_DRIVERS">"LIST AVAILABLE_MIDI_INPUT_DRIVERS"<span> (</span><span class="info">Getting all available MIDI input drivers</span><span>)</span></a>
2794                                              command                                              command
2795  </p>  </p>
2796  </blockquote><p>  </blockquote>
2797                                        
2798    
2799  </p>  </blockquote>
2800  </blockquote><p>                                  
                                 </p>  
2801  <blockquote class="text">  <blockquote class="text">
2802  <p>ACTIVE -  <p>ACTIVE -
2803                                          </p>                                          </p>
# Line 2720  Intellectual Property and Copyright Stat Line 2807  Intellectual Property and Copyright Stat
2807                                              and thus doesn't forward them to connected sampler                                              and thus doesn't forward them to connected sampler
2808                                              channels                                              channels
2809  </p>  </p>
2810  </blockquote><p>  </blockquote>
2811                                        
2812    
2813  </p>  </blockquote>
2814  </blockquote><p>                              
2815    
 </p>  
2816  </blockquote><p>  </blockquote><p>
2817                        
2818  </p>  </p>
2819  <p>The mentioned fields above don't have to be in particular  <p>The mentioned fields above don't have to be in particular
2820                      order. The fields above are only those fields which are                      order. The fields above are only those fields which are
# Line 2750  Intellectual Property and Copyright Stat Line 2837  Intellectual Property and Copyright Stat
2837  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2838  </p>  </p>
2839  </blockquote><p>  </blockquote><p>
2840                        
2841  </p>  </p>
2842  <a name="rfc.section.6.3.10"></a><h4><a name="SET MIDI_INPUT_DEVICE_PARAMETER">6.3.10</a>&nbsp;Changing settings of MIDI input devices</h4>  <a name="SET MIDI_INPUT_DEVICE_PARAMETER"></a><br /><hr />
2843    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2844    <a name="rfc.section.6.3.10"></a><h3>6.3.10.&nbsp;Changing settings of MIDI input devices</h3>
2845    
2846  <p>Use the following command to alter a specific setting of a created MIDI input device:  <p>Use the following command to alter a specific setting of a created MIDI input device:
2847  </p>  </p>
# Line 2762  Intellectual Property and Copyright Stat Line 2851  Intellectual Property and Copyright Stat
2851  <p>SET MIDI_INPUT_DEVICE_PARAMETER &lt;device-id&gt; &lt;key&gt;=&lt;value&gt;  <p>SET MIDI_INPUT_DEVICE_PARAMETER &lt;device-id&gt; &lt;key&gt;=&lt;value&gt;
2852  </p>  </p>
2853  </blockquote><p>  </blockquote><p>
2854                        
2855  </p>  </p>
2856  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the
2857                      MIDI input device as returned by the                      MIDI input device as returned by the
# Line 2781  Intellectual Property and Copyright Stat Line 2870  Intellectual Property and Copyright Stat
2870  <blockquote class="text">  <blockquote class="text">
2871  <p>in case setting was successfully changed  <p>in case setting was successfully changed
2872  </p>  </p>
2873  </blockquote><p>  </blockquote>
2874                                
2875    
 </p>  
2876  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
2877                                  </p>                                  </p>
2878  <blockquote class="text">  <blockquote class="text">
# Line 2791  Intellectual Property and Copyright Stat Line 2880  Intellectual Property and Copyright Stat
2880                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
2881                                      warning code and warning message                                      warning code and warning message
2882  </p>  </p>
2883  </blockquote><p>  </blockquote>
2884                                
2885    
 </p>  
2886  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
2887                                  </p>                                  </p>
2888  <blockquote class="text">  <blockquote class="text">
2889  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
2890  </p>  </p>
2891  </blockquote><p>  </blockquote>
2892                                
2893    
 </p>  
2894  </blockquote><p>  </blockquote><p>
2895                        
2896  </p>  </p>
2897  <p>Example:  <p>Example:
2898  </p>  </p>
# Line 2815  Intellectual Property and Copyright Stat Line 2904  Intellectual Property and Copyright Stat
2904  <p>S: "OK"  <p>S: "OK"
2905  </p>  </p>
2906  </blockquote><p>  </blockquote><p>
2907                        
2908  </p>  </p>
2909  <a name="rfc.section.6.3.11"></a><h4><a name="GET MIDI_INPUT_PORT INFO">6.3.11</a>&nbsp;Getting information about a MIDI port</h4>  <a name="GET MIDI_INPUT_PORT INFO"></a><br /><hr />
2910    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2911    <a name="rfc.section.6.3.11"></a><h3>6.3.11.&nbsp;Getting information about a MIDI port</h3>
2912    
2913  <p>Use the following command to get information about a MIDI port:  <p>Use the following command to get information about a MIDI port:
2914  </p>  </p>
# Line 2827  Intellectual Property and Copyright Stat Line 2918  Intellectual Property and Copyright Stat
2918  <p>GET MIDI_INPUT_PORT INFO &lt;device-id&gt; &lt;midi-port&gt;  <p>GET MIDI_INPUT_PORT INFO &lt;device-id&gt; &lt;midi-port&gt;
2919  </p>  </p>
2920  </blockquote><p>  </blockquote><p>
2921                        
2922  </p>  </p>
2923  <p>Where &lt;device-id&gt; is the numerical ID of the MIDI input device as returned by the  <p>Where &lt;device-id&gt; is the numerical ID of the MIDI input device as returned by the
2924                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>
# Line 2850  Intellectual Property and Copyright Stat Line 2941  Intellectual Property and Copyright Stat
2941  <blockquote class="text">  <blockquote class="text">
2942  <p>arbitrary character string naming the port  <p>arbitrary character string naming the port
2943  </p>  </p>
2944  </blockquote><p>  </blockquote>
2945                                
2946    
 </p>  
2947  </blockquote><p>  </blockquote><p>
2948                        
2949  </p>  </p>
2950  <p>The field above is only the one which is returned by all MIDI  <p>The field above is only the one which is returned by all MIDI
2951                      ports regardless of the MIDI driver and port. Every MIDI port                      ports regardless of the MIDI driver and port. Every MIDI port
# Line 2875  Intellectual Property and Copyright Stat Line 2966  Intellectual Property and Copyright Stat
2966  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
2967  </p>  </p>
2968  </blockquote><p>  </blockquote><p>
2969                        
2970  </p>  </p>
2971  <a name="rfc.section.6.3.12"></a><h4><a name="GET MIDI_INPUT_PORT_PARAMETER INFO">6.3.12</a>&nbsp;Getting information about specific MIDI port parameter</h4>  <a name="GET MIDI_INPUT_PORT_PARAMETER INFO"></a><br /><hr />
2972    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
2973    <a name="rfc.section.6.3.12"></a><h3>6.3.12.&nbsp;Getting information about specific MIDI port parameter</h3>
2974    
2975  <p>Use the following command to get detailed information about specific MIDI port parameter:  <p>Use the following command to get detailed information about specific MIDI port parameter:
2976  </p>  </p>
# Line 2887  Intellectual Property and Copyright Stat Line 2980  Intellectual Property and Copyright Stat
2980  <p>GET MIDI_INPUT_PORT_PARAMETER INFO &lt;dev-id&gt; &lt;port&gt; &lt;param&gt;  <p>GET MIDI_INPUT_PORT_PARAMETER INFO &lt;dev-id&gt; &lt;port&gt; &lt;param&gt;
2981  </p>  </p>
2982  </blockquote><p>  </blockquote><p>
2983                        
2984  </p>  </p>
2985  <p>Where &lt;dev-id&gt; is the numerical ID of the MIDI input device as returned by the  <p>Where &lt;dev-id&gt; is the numerical ID of the MIDI input device as returned by the
2986                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>                      <a class="info" href="#CREATE MIDI_INPUT_DEVICE">"CREATE MIDI_INPUT_DEVICE"<span> (</span><span class="info">Creating a MIDI input device</span><span>)</span></a>
# Line 2918  Intellectual Property and Copyright Stat Line 3011  Intellectual Property and Copyright Stat
3011                                      character string(s)                                      character string(s)
3012                                      (always returned)                                      (always returned)
3013  </p>  </p>
3014  </blockquote><p>  </blockquote>
3015                                
3016    
 </p>  
3017  <p>DESCRIPTION -  <p>DESCRIPTION -
3018                                  </p>                                  </p>
3019  <blockquote class="text">  <blockquote class="text">
3020  <p>arbitrary text describing the purpose of the parameter  <p>arbitrary text describing the purpose of the parameter
3021                                      (always returned)                                      (always returned)
3022  </p>  </p>
3023  </blockquote><p>  </blockquote>
3024                                
3025    
 </p>  
3026  <p>FIX -  <p>FIX -
3027                                  </p>                                  </p>
3028  <blockquote class="text">  <blockquote class="text">
# Line 2937  Intellectual Property and Copyright Stat Line 3030  Intellectual Property and Copyright Stat
3030                                      read only, thus cannot be altered                                      read only, thus cannot be altered
3031                                      (always returned)                                      (always returned)
3032  </p>  </p>
3033  </blockquote><p>  </blockquote>
3034                                
3035    
 </p>  
3036  <p>MULTIPLICITY -  <p>MULTIPLICITY -
3037                                  </p>                                  </p>
3038  <blockquote class="text">  <blockquote class="text">
# Line 2948  Intellectual Property and Copyright Stat Line 3041  Intellectual Property and Copyright Stat
3041                                      multiple values and false only a single value allowed                                      multiple values and false only a single value allowed
3042                                      (always returned)                                      (always returned)
3043  </p>  </p>
3044  </blockquote><p>  </blockquote>
3045                                
3046    
 </p>  
3047  <p>RANGE_MIN -  <p>RANGE_MIN -
3048                                  </p>                                  </p>
3049  <blockquote class="text">  <blockquote class="text">
# Line 2961  Intellectual Property and Copyright Stat Line 3054  Intellectual Property and Copyright Stat
3054                                      (optionally returned, dependent to driver and port                                      (optionally returned, dependent to driver and port
3055                                      parameter)                                      parameter)
3056  </p>  </p>
3057  </blockquote><p>  </blockquote>
3058                                
3059    
 </p>  
3060  <p>RANGE_MAX -  <p>RANGE_MAX -
3061                                  </p>                                  </p>
3062  <blockquote class="text">  <blockquote class="text">
# Line 2974  Intellectual Property and Copyright Stat Line 3067  Intellectual Property and Copyright Stat
3067                                      (optionally returned, dependent to driver and port                                      (optionally returned, dependent to driver and port
3068                                      parameter)                                      parameter)
3069  </p>  </p>
3070  </blockquote><p>  </blockquote>
3071                                
3072    
 </p>  
3073  <p>POSSIBILITIES -  <p>POSSIBILITIES -
3074                                  </p>                                  </p>
3075  <blockquote class="text">  <blockquote class="text">
# Line 2986  Intellectual Property and Copyright Stat Line 3079  Intellectual Property and Copyright Stat
3079                                      (optionally returned, dependent to device and port                                      (optionally returned, dependent to device and port
3080                                      parameter)                                      parameter)
3081  </p>  </p>
3082  </blockquote><p>  </blockquote>
3083                                
3084    
 </p>  
3085  </blockquote><p>  </blockquote><p>
3086                        
3087  </p>  </p>
3088  <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.
3089  </p>  </p>
# Line 3014  Intellectual Property and Copyright Stat Line 3107  Intellectual Property and Copyright Stat
3107  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
3108  </p>  </p>
3109  </blockquote><p>  </blockquote><p>
3110                        
3111  </p>  </p>
3112  <a name="rfc.section.6.3.13"></a><h4><a name="SET MIDI_INPUT_PORT_PARAMETER">6.3.13</a>&nbsp;Changing settings of MIDI input ports</h4>  <a name="SET MIDI_INPUT_PORT_PARAMETER"></a><br /><hr />
3113    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3114    <a name="rfc.section.6.3.13"></a><h3>6.3.13.&nbsp;Changing settings of MIDI input ports</h3>
3115    
3116  <p>Use the following command to alter a specific setting of a MIDI input port:  <p>Use the following command to alter a specific setting of a MIDI input port:
3117  </p>  </p>
# Line 3026  Intellectual Property and Copyright Stat Line 3121  Intellectual Property and Copyright Stat
3121  <p>SET MIDI_INPUT_PORT_PARAMETER &lt;device-id&gt; &lt;port&gt; &lt;key&gt;=&lt;value&gt;  <p>SET MIDI_INPUT_PORT_PARAMETER &lt;device-id&gt; &lt;port&gt; &lt;key&gt;=&lt;value&gt;
3122  </p>  </p>
3123  </blockquote><p>  </blockquote><p>
3124                        
3125  </p>  </p>
3126  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the  <p>Where &lt;device-id&gt; should be replaced by the numerical ID of the
3127                      MIDI device as returned by the                      MIDI device as returned by the
# Line 3046  Intellectual Property and Copyright Stat Line 3141  Intellectual Property and Copyright Stat
3141  <blockquote class="text">  <blockquote class="text">
3142  <p>in case setting was successfully changed  <p>in case setting was successfully changed
3143  </p>  </p>
3144  </blockquote><p>  </blockquote>
3145                                
3146    
 </p>  
3147  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3148                                  </p>                                  </p>
3149  <blockquote class="text">  <blockquote class="text">
# Line 3056  Intellectual Property and Copyright Stat Line 3151  Intellectual Property and Copyright Stat
3151                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
3152                                      warning code and warning message                                      warning code and warning message
3153  </p>  </p>
3154  </blockquote><p>  </blockquote>
3155                                
3156    
 </p>  
3157  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3158                                  </p>                                  </p>
3159  <blockquote class="text">  <blockquote class="text">
3160  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
3161  </p>  </p>
3162  </blockquote><p>  </blockquote>
3163                                
3164    
 </p>  
3165  </blockquote><p>  </blockquote><p>
3166                        
3167  </p>  </p>
3168  <p>Example:  <p>Example:
3169  </p>  </p>
# Line 3078  Intellectual Property and Copyright Stat Line 3173  Intellectual Property and Copyright Stat
3173  <p>  <p>
3174  </p>  </p>
3175  </blockquote><p>  </blockquote><p>
3176                        
3177  </p>  </p>
3178  <a name="rfc.section.6.4"></a><h4><a name="anchor11">6.4</a>&nbsp;Configuring sampler channels</h4>  <a name="anchor11"></a><br /><hr />
3179    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3180    <a name="rfc.section.6.4"></a><h3>6.4.&nbsp;Configuring sampler channels</h3>
3181    
3182  <p>The following commands describe how to add and remove sampler channels, associate a  <p>The following commands describe how to add and remove sampler channels, associate a
3183                  sampler channel with a sampler engine, load instruments and connect sampler channels to                  sampler channel with a sampler engine, load instruments and connect sampler channels to
3184                  MIDI and audio devices.                  MIDI and audio devices.
3185  </p>  </p>
3186  <a name="rfc.section.6.4.1"></a><h4><a name="LOAD INSTRUMENT">6.4.1</a>&nbsp;Loading an instrument</h4>  <a name="LOAD INSTRUMENT"></a><br /><hr />
3187    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3188    <a name="rfc.section.6.4.1"></a><h3>6.4.1.&nbsp;Loading an instrument</h3>
3189    
3190  <p>An instrument file can be loaded and assigned to a sampler channel by one of the following commands:  <p>An instrument file can be loaded and assigned to a sampler channel by one of the following commands:
3191  </p>  </p>
# Line 3096  Intellectual Property and Copyright Stat Line 3195  Intellectual Property and Copyright Stat
3195  <p>LOAD INSTRUMENT [NON_MODAL] '&lt;filename&gt;' &lt;instr-index&gt; &lt;sampler-channel&gt;  <p>LOAD INSTRUMENT [NON_MODAL] '&lt;filename&gt;' &lt;instr-index&gt; &lt;sampler-channel&gt;
3196  </p>  </p>
3197  </blockquote><p>  </blockquote><p>
3198                        
3199  </p>  </p>
3200  <p>Where &lt;filename&gt; is the name of the instrument file on the  <p>Where &lt;filename&gt; is the name of the instrument file on the
3201                      LinuxSampler instance's host system, &lt;instr-index&gt; the index of the                      LinuxSampler instance's host system, &lt;instr-index&gt; the index of the
# Line 3125  Intellectual Property and Copyright Stat Line 3224  Intellectual Property and Copyright Stat
3224  <blockquote class="text">  <blockquote class="text">
3225  <p>in case the instrument was successfully loaded  <p>in case the instrument was successfully loaded
3226  </p>  </p>
3227  </blockquote><p>  </blockquote>
3228                                
3229    
 </p>  
3230  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3231                                  </p>                                  </p>
3232  <blockquote class="text">  <blockquote class="text">
# Line 3137  Intellectual Property and Copyright Stat Line 3236  Intellectual Property and Copyright Stat
3236                                      instrument file), providing an appropriate warning code and                                      instrument file), providing an appropriate warning code and
3237                                      warning message                                      warning message
3238  </p>  </p>
3239  </blockquote><p>  </blockquote>
3240                                
3241    
 </p>  
3242  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3243                                  </p>                                  </p>
3244  <blockquote class="text">  <blockquote class="text">
3245  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
3246  </p>  </p>
3247  </blockquote><p>  </blockquote>
3248                                
3249    
 </p>  
3250  </blockquote><p>  </blockquote><p>
3251                        
3252  </p>  </p>
3253  <p>Example:  <p>Example:
3254  </p>  </p>
# Line 3159  Intellectual Property and Copyright Stat Line 3258  Intellectual Property and Copyright Stat
3258  <p>  <p>
3259  </p>  </p>
3260  </blockquote><p>  </blockquote><p>
3261                        
3262  </p>  </p>
3263  <a name="rfc.section.6.4.2"></a><h4><a name="LOAD ENGINE">6.4.2</a>&nbsp;Loading a sampler engine</h4>  <a name="LOAD ENGINE"></a><br /><hr />
3264    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3265    <a name="rfc.section.6.4.2"></a><h3>6.4.2.&nbsp;Loading a sampler engine</h3>
3266    
3267  <p>A sampler engine type can be associated to a specific sampler  <p>A sampler engine type can be associated to a specific sampler
3268                      channel by the following command:                      channel by the following command:
# Line 3172  Intellectual Property and Copyright Stat Line 3273  Intellectual Property and Copyright Stat
3273  <p>LOAD ENGINE &lt;engine-name&gt; &lt;sampler-channel&gt;  <p>LOAD ENGINE &lt;engine-name&gt; &lt;sampler-channel&gt;
3274  </p>  </p>
3275  </blockquote><p>  </blockquote><p>
3276                        
3277  </p>  </p>
3278  <p>Where &lt;engine-name&gt; is an engine name as obtained by the  <p>Where &lt;engine-name&gt; is an engine name as obtained by the
3279                      <a class="info" href="#LIST AVAILABLE_ENGINES">"LIST AVAILABLE_ENGINES"<span> (</span><span class="info">Getting all available engines</span><span>)</span></a> command and &lt;sampler-channel&gt;                      <a class="info" href="#LIST AVAILABLE_ENGINES">"LIST AVAILABLE_ENGINES"<span> (</span><span class="info">Getting all available engines</span><span>)</span></a> command and &lt;sampler-channel&gt;
# Line 3198  Intellectual Property and Copyright Stat Line 3299  Intellectual Property and Copyright Stat
3299  <blockquote class="text">  <blockquote class="text">
3300  <p>in case the engine was successfully deployed  <p>in case the engine was successfully deployed
3301  </p>  </p>
3302  </blockquote><p>  </blockquote>
3303                                
3304    
 </p>  
3305  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3306                                  </p>                                  </p>
3307  <blockquote class="text">  <blockquote class="text">
# Line 3208  Intellectual Property and Copyright Stat Line 3309  Intellectual Property and Copyright Stat
3309                                      are noteworthy issue(s) related, providing an appropriate                                      are noteworthy issue(s) related, providing an appropriate
3310                                      warning code and warning message                                      warning code and warning message
3311  </p>  </p>
3312  </blockquote><p>  </blockquote>
3313                                
3314    
 </p>  
3315  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3316                                  </p>                                  </p>
3317  <blockquote class="text">  <blockquote class="text">
3318  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
3319                                      error message                                      error message
3320  </p>  </p>
3321  </blockquote><p>  </blockquote>
3322                                
3323    
 </p>  
3324  </blockquote><p>  </blockquote><p>
3325                        
3326  </p>  </p>
3327  <p>Example:  <p>Example:
3328  </p>  </p>
# Line 3231  Intellectual Property and Copyright Stat Line 3332  Intellectual Property and Copyright Stat
3332  <p>  <p>
3333  </p>  </p>
3334  </blockquote><p>  </blockquote><p>
3335                        
3336  </p>  </p>
3337  <a name="rfc.section.6.4.3"></a><h4><a name="GET CHANNELS">6.4.3</a>&nbsp;Getting all created sampler channel count</h4>  <a name="GET CHANNELS"></a><br /><hr />
3338    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3339    <a name="rfc.section.6.4.3"></a><h3>6.4.3.&nbsp;Getting all created sampler channel count</h3>
3340    
3341  <p>The number of sampler channels can change on runtime. To get the  <p>The number of sampler channels can change on runtime. To get the
3342                      current amount of sampler channels, the front-end can send the                      current amount of sampler channels, the front-end can send the
# Line 3245  Intellectual Property and Copyright Stat Line 3348  Intellectual Property and Copyright Stat
3348  <p>GET CHANNELS  <p>GET CHANNELS
3349  </p>  </p>
3350  </blockquote><p>  </blockquote><p>
3351                        
3352  </p>  </p>
3353  <p>Possible Answers:  <p>Possible Answers:
3354  </p>  </p>
# Line 3255  Intellectual Property and Copyright Stat Line 3358  Intellectual Property and Copyright Stat
3358  <p>LinuxSampler will answer by returning the current number of sampler channels.  <p>LinuxSampler will answer by returning the current number of sampler channels.
3359  </p>  </p>
3360  </blockquote><p>  </blockquote><p>
3361                        
3362  </p>  </p>
3363  <p>Example:  <p>Example:
3364  </p>  </p>
# Line 3267  Intellectual Property and Copyright Stat Line 3370  Intellectual Property and Copyright Stat
3370  <p>S: "12"  <p>S: "12"
3371  </p>  </p>
3372  </blockquote><p>  </blockquote><p>
3373                        
3374  </p>  </p>
3375  <a name="rfc.section.6.4.4"></a><h4><a name="LIST CHANNELS">6.4.4</a>&nbsp;Getting all created sampler channel list</h4>  <a name="LIST CHANNELS"></a><br /><hr />
3376    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3377    <a name="rfc.section.6.4.4"></a><h3>6.4.4.&nbsp;Getting all created sampler channel list</h3>
3378    
3379  <p>The number of sampler channels can change on runtime. To get the  <p>The number of sampler channels can change on runtime. To get the
3380                      current list of sampler channels, the front-end can send the                      current list of sampler channels, the front-end can send the
# Line 3281  Intellectual Property and Copyright Stat Line 3386  Intellectual Property and Copyright Stat
3386  <p>LIST CHANNELS  <p>LIST CHANNELS
3387  </p>  </p>
3388  </blockquote><p>  </blockquote><p>
3389                        
3390  </p>  </p>
3391  <p>Possible Answers:  <p>Possible Answers:
3392  </p>  </p>
# Line 3292  Intellectual Property and Copyright Stat Line 3397  Intellectual Property and Copyright Stat
3397                              with all sampler channels numerical IDs.                              with all sampler channels numerical IDs.
3398  </p>  </p>
3399  </blockquote><p>  </blockquote><p>
3400                        
3401  </p>  </p>
3402  <p>Example:  <p>Example:
3403  </p>  </p>
# Line 3304  Intellectual Property and Copyright Stat Line 3409  Intellectual Property and Copyright Stat
3409  <p>S: "0,1,2,3,4,5,6,9,10,11,15,20"  <p>S: "0,1,2,3,4,5,6,9,10,11,15,20"
3410  </p>  </p>
3411  </blockquote><p>  </blockquote><p>
3412                        
3413  </p>  </p>
3414  <a name="rfc.section.6.4.5"></a><h4><a name="ADD CHANNEL">6.4.5</a>&nbsp;Adding a new sampler channel</h4>  <a name="ADD CHANNEL"></a><br /><hr />
3415    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3416    <a name="rfc.section.6.4.5"></a><h3>6.4.5.&nbsp;Adding a new sampler channel</h3>
3417    
3418  <p>A new sampler channel can be added to the end of the sampler  <p>A new sampler channel can be added to the end of the sampler
3419                      channel list by sending the following command:                      channel list by sending the following command:
# Line 3317  Intellectual Property and Copyright Stat Line 3424  Intellectual Property and Copyright Stat
3424  <p>ADD CHANNEL  <p>ADD CHANNEL
3425  </p>  </p>
3426  </blockquote><p>  </blockquote><p>
3427                        
3428  </p>  </p>
3429  <p>This will increment the sampler channel count by one and the new  <p>This will increment the sampler channel count by one and the new
3430                      sampler channel will be appended to the end of the sampler channel                      sampler channel will be appended to the end of the sampler channel
# Line 3343  Intellectual Property and Copyright Stat Line 3450  Intellectual Property and Copyright Stat
3450                                      the sampler channel by sending subsequent initialization                                      the sampler channel by sending subsequent initialization
3451                                      commands                                      commands
3452  </p>  </p>
3453  </blockquote><p>  </blockquote>
3454                                
3455    
 </p>  
3456  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3457                                  </p>                                  </p>
3458  <blockquote class="text">  <blockquote class="text">
# Line 3353  Intellectual Property and Copyright Stat Line 3460  Intellectual Property and Copyright Stat
3460                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
3461                                      warning code and warning message                                      warning code and warning message
3462  </p>  </p>
3463  </blockquote><p>  </blockquote>
3464                                
3465    
 </p>  
3466  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3467                                  </p>                                  </p>
3468  <blockquote class="text">  <blockquote class="text">
3469  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
3470                                      error message                                      error message
3471  </p>  </p>
3472  </blockquote><p>  </blockquote>
3473                                
3474    
 </p>  
3475  </blockquote><p>  </blockquote><p>
3476                        
3477  </p>  </p>
3478  <p>Example:  <p>Example:
3479  </p>  </p>
# Line 3376  Intellectual Property and Copyright Stat Line 3483  Intellectual Property and Copyright Stat
3483  <p>  <p>
3484  </p>  </p>
3485  </blockquote><p>  </blockquote><p>
3486                        
3487  </p>  </p>
3488  <a name="rfc.section.6.4.6"></a><h4><a name="REMOVE CHANNEL">6.4.6</a>&nbsp;Removing a sampler channel</h4>  <a name="REMOVE CHANNEL"></a><br /><hr />
3489    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3490    <a name="rfc.section.6.4.6"></a><h3>6.4.6.&nbsp;Removing a sampler channel</h3>
3491    
3492  <p>A sampler channel can be removed by sending the following command:  <p>A sampler channel can be removed by sending the following command:
3493  </p>  </p>
# Line 3388  Intellectual Property and Copyright Stat Line 3497  Intellectual Property and Copyright Stat
3497  <p>REMOVE CHANNEL &lt;sampler-channel&gt;  <p>REMOVE CHANNEL &lt;sampler-channel&gt;
3498  </p>  </p>
3499  </blockquote><p>  </blockquote><p>
3500                        
3501  </p>  </p>
3502  <p>Where &lt;sampler-channel&gt; should be replaced by the  <p>Where &lt;sampler-channel&gt; should be replaced by the
3503                      number of the sampler channel as given by the                      number of the sampler channel as given by the
# Line 3407  Intellectual Property and Copyright Stat Line 3516  Intellectual Property and Copyright Stat
3516  <blockquote class="text">  <blockquote class="text">
3517  <p>in case the given sampler channel could be removed  <p>in case the given sampler channel could be removed
3518  </p>  </p>
3519  </blockquote><p>  </blockquote>
3520                                
3521    
 </p>  
3522  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
3523                                  </p>                                  </p>
3524  <blockquote class="text">  <blockquote class="text">
# Line 3417  Intellectual Property and Copyright Stat Line 3526  Intellectual Property and Copyright Stat
3526                                      noteworthy issue(s) related, providing an appropriate                                      noteworthy issue(s) related, providing an appropriate
3527                                      warning code and warning message                                      warning code and warning message
3528  </p>  </p>
3529  </blockquote><p>  </blockquote>
3530                                
3531    
 </p>  
3532  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
3533                                  </p>                                  </p>
3534  <blockquote class="text">  <blockquote class="text">
3535  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
3536                                      error message                                      error message
3537  </p>  </p>
3538  </blockquote><p>  </blockquote>
3539                                
3540    
 </p>  
3541  </blockquote><p>  </blockquote><p>
3542                        
3543  </p>  </p>
3544  <p>Example:  <p>Example:
3545  </p>  </p>
# Line 3440  Intellectual Property and Copyright Stat Line 3549  Intellectual Property and Copyright Stat
3549  <p>  <p>
3550  </p>  </p>
3551  </blockquote><p>  </blockquote><p>
3552                        
3553  </p>  </p>
3554  <a name="rfc.section.6.4.7"></a><h4><a name="GET AVAILABLE_ENGINES">6.4.7</a>&nbsp;Getting amount of available engines</h4>  <a name="GET AVAILABLE_ENGINES"></a><br /><hr />
3555    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3556    <a name="rfc.section.6.4.7"></a><h3>6.4.7.&nbsp;Getting amount of available engines</h3>
3557    
3558  <p>The front-end can ask for the number of available engines by sending the following command:  <p>The front-end can ask for the number of available engines by sending the following command:
3559  </p>  </p>
# Line 3452  Intellectual Property and Copyright Stat Line 3563  Intellectual Property and Copyright Stat
3563  <p>GET AVAILABLE_ENGINES  <p>GET AVAILABLE_ENGINES
3564  </p>  </p>
3565  </blockquote><p>  </blockquote><p>
3566                        
3567  </p>  </p>
3568  <p>Possible Answers:  <p>Possible Answers:
3569  </p>  </p>
# Line 3462  Intellectual Property and Copyright Stat Line 3573  Intellectual Property and Copyright Stat
3573  <p>LinuxSampler will answer by sending the number of available engines.  <p>LinuxSampler will answer by sending the number of available engines.
3574  </p>  </p>
3575  </blockquote><p>  </blockquote><p>
3576                        
3577  </p>  </p>
3578  <p>Example:  <p>Example:
3579  </p>  </p>
# Line 3474  Intellectual Property and Copyright Stat Line 3585  Intellectual Property and Copyright Stat
3585  <p>S: "4"  <p>S: "4"
3586  </p>  </p>
3587  </blockquote><p>  </blockquote><p>
3588                        
3589  </p>  </p>
3590  <a name="rfc.section.6.4.8"></a><h4><a name="LIST AVAILABLE_ENGINES">6.4.8</a>&nbsp;Getting all available engines</h4>  <a name="LIST AVAILABLE_ENGINES"></a><br /><hr />
3591    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3592    <a name="rfc.section.6.4.8"></a><h3>6.4.8.&nbsp;Getting all available engines</h3>
3593    
3594  <p>The front-end can ask for a list of all available engines by sending the following command:  <p>The front-end can ask for a list of all available engines by sending the following command:
3595  </p>  </p>
# Line 3486  Intellectual Property and Copyright Stat Line 3599  Intellectual Property and Copyright Stat
3599  <p>LIST AVAILABLE_ENGINES  <p>LIST AVAILABLE_ENGINES
3600  </p>  </p>
3601  </blockquote><p>  </blockquote><p>
3602                        
3603  </p>  </p>
3604  <p>Possible Answers:  <p>Possible Answers:
3605  </p>  </p>
# Line 3499  Intellectual Property and Copyright Stat Line 3612  Intellectual Property and Copyright Stat
3612                              digits and underlines ("_" character).                              digits and underlines ("_" character).
3613  </p>  </p>
3614  </blockquote><p>  </blockquote><p>
3615                        
3616  </p>  </p>
3617  <p>Example:  <p>Example:
3618  </p>  </p>
# Line 3511  Intellectual Property and Copyright Stat Line 3624  Intellectual Property and Copyright Stat
3624  <p>S: "'GigEngine','AkaiEngine','DLSEngine','JoesCustomEngine'"  <p>S: "'GigEngine','AkaiEngine','DLSEngine','JoesCustomEngine'"
3625  </p>  </p>
3626  </blockquote><p>  </blockquote><p>
3627                        
3628  </p>  </p>
3629  <a name="rfc.section.6.4.9"></a><h4><a name="GET ENGINE INFO">6.4.9</a>&nbsp;Getting information about an engine</h4>  <a name="GET ENGINE INFO"></a><br /><hr />
3630    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3631    <a name="rfc.section.6.4.9"></a><h3>6.4.9.&nbsp;Getting information about an engine</h3>
3632    
3633  <p>The front-end can ask for information about a specific engine by  <p>The front-end can ask for information about a specific engine by
3634                      sending the following command:                      sending the following command:
# Line 3524  Intellectual Property and Copyright Stat Line 3639  Intellectual Property and Copyright Stat
3639  <p>GET ENGINE INFO &lt;engine-name&gt;  <p>GET ENGINE INFO &lt;engine-name&gt;
3640  </p>  </p>
3641  </blockquote><p>  </blockquote><p>
3642                        
3643  </p>  </p>
3644  <p>Where &lt;engine-name&gt; is an engine name as obtained by the  <p>Where &lt;engine-name&gt; is an engine name as obtained by the
3645                      <a class="info" href="#LIST AVAILABLE_ENGINES">"LIST AVAILABLE_ENGINES"<span> (</span><span class="info">Getting all available engines</span><span>)</span></a> command.                      <a class="info" href="#LIST AVAILABLE_ENGINES">"LIST AVAILABLE_ENGINES"<span> (</span><span class="info">Getting all available engines</span><span>)</span></a> command.
# Line 3548  Intellectual Property and Copyright Stat Line 3663  Intellectual Property and Copyright Stat
3663  <blockquote class="text">  <blockquote class="text">
3664  <p>arbitrary description text about the engine  <p>arbitrary description text about the engine
3665  </p>  </p>
3666  </blockquote><p>  </blockquote>
3667                                        
3668    
 </p>  
3669  <p>VERSION -  <p>VERSION -
3670                                          </p>                                          </p>
3671  <blockquote class="text">  <blockquote class="text">
3672  <p>arbitrary character string regarding the engine's version  <p>arbitrary character string regarding the engine's version
3673  </p>  </p>
3674  </blockquote><p>  </blockquote>
3675                                        
3676    
3677  </p>  </blockquote>
3678  </blockquote><p>                              
3679    
 </p>  
3680  </blockquote><p>  </blockquote><p>
3681                        
3682  </p>  </p>
3683  <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.
3684  </p>  </p>
# Line 3581  Intellectual Property and Copyright Stat Line 3696  Intellectual Property and Copyright Stat
3696  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
3697  </p>  </p>
3698  </blockquote><p>  </blockquote><p>
3699                        
3700  </p>  </p>
3701  <a name="rfc.section.6.4.10"></a><h4><a name="GET CHANNEL INFO">6.4.10</a>&nbsp;Getting sampler channel information</h4>  <a name="GET CHANNEL INFO"></a><br /><hr />
3702    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3703    <a name="rfc.section.6.4.10"></a><h3>6.4.10.&nbsp;Getting sampler channel information</h3>
3704    
3705  <p>The front-end can ask for the current settings of a sampler channel  <p>The front-end can ask for the current settings of a sampler channel
3706                      by sending the following command:                      by sending the following command:
# Line 3594  Intellectual Property and Copyright Stat Line 3711  Intellectual Property and Copyright Stat
3711  <p>GET CHANNEL INFO &lt;sampler-channel&gt;  <p>GET CHANNEL INFO &lt;sampler-channel&gt;
3712  </p>  </p>
3713  </blockquote><p>  </blockquote><p>
3714                        
3715  </p>  </p>
3716  <p>Where &lt;sampler-channel&gt; is the sampler channel number the front-end is interested in  <p>Where &lt;sampler-channel&gt; is the sampler channel number the front-end is interested in
3717                      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>                      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>
# Line 3621  Intellectual Property and Copyright Stat Line 3738  Intellectual Property and Copyright Stat
3738                                              channel, "NONE" if there's no engine associated yet for                                              channel, "NONE" if there's no engine associated yet for
3739                                              this sampler channel                                              this sampler channel
3740  </p>  </p>
3741  </blockquote><p>  </blockquote>
3742                                        
3743    
 </p>  
3744  <p>AUDIO_OUTPUT_DEVICE -  <p>AUDIO_OUTPUT_DEVICE -
3745                                          </p>                                          </p>
3746  <blockquote class="text">  <blockquote class="text">
# Line 3632  Intellectual Property and Copyright Stat Line 3749  Intellectual Property and Copyright Stat
3749                                              the audio signal, "NONE" if there's no device                                              the audio signal, "NONE" if there's no device
3750                                              connected to this sampler channel                                              connected to this sampler channel
3751  </p>  </p>
3752  </blockquote><p>  </blockquote>
3753                                        
3754    
 </p>  
3755  <p>AUDIO_OUTPUT_CHANNELS -  <p>AUDIO_OUTPUT_CHANNELS -
3756                                          </p>                                          </p>
3757  <blockquote class="text">  <blockquote class="text">
3758  <p>number of output channels the sampler channel offers  <p>number of output channels the sampler channel offers
3759                                              (dependent to used sampler engine and loaded instrument)                                              (dependent to used sampler engine and loaded instrument)
3760  </p>  </p>
3761  </blockquote><p>  </blockquote>
3762                                        
3763    
 </p>  
3764  <p>AUDIO_OUTPUT_ROUTING -  <p>AUDIO_OUTPUT_ROUTING -
3765                                          </p>                                          </p>
3766  <blockquote class="text">  <blockquote class="text">
# Line 3655  Intellectual Property and Copyright Stat Line 3772  Intellectual Property and Copyright Stat
3772                                              channel 1 is routed to the channel 3 of the audio                                              channel 1 is routed to the channel 3 of the audio
3773                                              output device                                              output device
3774  </p>  </p>
3775  </blockquote><p>  </blockquote>
3776                                        
3777    
 </p>  
3778  <p>INSTRUMENT_FILE -  <p>INSTRUMENT_FILE -
3779                                          </p>                                          </p>
3780  <blockquote class="text">  <blockquote class="text">
# Line 3665  Intellectual Property and Copyright Stat Line 3782  Intellectual Property and Copyright Stat
3782                                              there's no instrument yet loaded for this sampler                                              there's no instrument yet loaded for this sampler
3783                                              channel                                              channel
3784  </p>  </p>
3785  </blockquote><p>  </blockquote>
3786                                        
3787    
 </p>  
3788  <p>INSTRUMENT_NR -  <p>INSTRUMENT_NR -
3789                                          </p>                                          </p>
3790  <blockquote class="text">  <blockquote class="text">
3791  <p>the instrument index number of the loaded instrument  <p>the instrument index number of the loaded instrument
3792  </p>  </p>
3793  </blockquote><p>  </blockquote>
3794                                        
3795    
 </p>  
3796  <p>INSTRUMENT_NAME -  <p>INSTRUMENT_NAME -
3797                                          </p>                                          </p>
3798  <blockquote class="text">  <blockquote class="text">
3799  <p>the instrument name of the loaded instrument  <p>the instrument name of the loaded instrument
3800  </p>  </p>
3801  </blockquote><p>  </blockquote>
3802                                        
3803    
 </p>  
3804  <p>INSTRUMENT_STATUS -  <p>INSTRUMENT_STATUS -
3805                                          </p>                                          </p>
3806  <blockquote class="text">  <blockquote class="text">
# Line 3691  Intellectual Property and Copyright Stat Line 3808  Intellectual Property and Copyright Stat
3808                                              value indicates a loading exception. Value of 100 indicates that the instrument is fully                                              value indicates a loading exception. Value of 100 indicates that the instrument is fully
3809                                              loaded.                                              loaded.
3810  </p>  </p>
3811  </blockquote><p>  </blockquote>
3812                                        
3813    
 </p>  
3814  <p>MIDI_INPUT_DEVICE -  <p>MIDI_INPUT_DEVICE -
3815                                          </p>                                          </p>
3816  <blockquote class="text">  <blockquote class="text">
# Line 3702  Intellectual Property and Copyright Stat Line 3819  Intellectual Property and Copyright Stat
3819                                              MIDI input commands, "NONE" if there's no device                                              MIDI input commands, "NONE" if there's no device
3820                                              connected to this sampler channel                                              connected to this sampler channel
3821  </p>  </p>
3822  </blockquote><p>  </blockquote>
3823                                        
3824    
 </p>  
3825  <p>MIDI_INPUT_PORT -  <p>MIDI_INPUT_PORT -
3826                                          </p>                                          </p>
3827  <blockquote class="text">  <blockquote class="text">
3828  <p>port number of the MIDI input device  <p>port number of the MIDI input device
3829  </p>  </p>
3830  </blockquote><p>  </blockquote>
3831                                        
3832    
 </p>  
3833  <p>MIDI_INPUT_CHANNEL -  <p>MIDI_INPUT_CHANNEL -
3834                                          </p>                                          </p>
3835  <blockquote class="text">  <blockquote class="text">
3836  <p>the MIDI input channel number this sampler channel  <p>the MIDI input channel number this sampler channel
3837                                              should listen to or "ALL" to listen on all MIDI channels                                              should listen to or "ALL" to listen on all MIDI channels
3838  </p>  </p>
3839  </blockquote><p>  </blockquote>
3840                                        
3841    
 </p>  
3842  <p>VOLUME -  <p>VOLUME -
3843                                          </p>                                          </p>
3844  <blockquote class="text">  <blockquote class="text">
# Line 3729  Intellectual Property and Copyright Stat Line 3846  Intellectual Property and Copyright Stat
3846                                              (where a value < 1.0 means attenuation and a value >                                              (where a value < 1.0 means attenuation and a value >
3847                                              1.0 means amplification)                                              1.0 means amplification)
3848  </p>  </p>
3849  </blockquote><p>  </blockquote>
3850                                        
3851    
 </p>  
3852  <p>MUTE -  <p>MUTE -
3853                                          </p>                                          </p>
3854  <blockquote class="text">  <blockquote class="text">
# Line 3741  Intellectual Property and Copyright Stat Line 3858  Intellectual Property and Copyright Stat
3858                                              presence of a solo channel and will be unmuted when                                              presence of a solo channel and will be unmuted when
3859                                              there are no solo channels left                                              there are no solo channels left
3860  </p>  </p>
3861  </blockquote><p>  </blockquote>
3862                                        
3863    
 </p>  
3864  <p>SOLO -  <p>SOLO -
3865                                          </p>                                          </p>
3866  <blockquote class="text">  <blockquote class="text">
3867  <p>Determines whether this is a solo channel, "true" if  <p>Determines whether this is a solo channel, "true" if
3868                                              the channel is a solo channel; "false" otherwise                                              the channel is a solo channel; "false" otherwise
3869  </p>  </p>
3870  </blockquote><p>  </blockquote>
3871                                        
3872    
3873  </p>  </blockquote>
3874  </blockquote><p>                              
3875    
 </p>  
3876  </blockquote><p>  </blockquote><p>
3877                        
3878  </p>  </p>
3879  <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.
3880  </p>  </p>
# Line 3795  Intellectual Property and Copyright Stat Line 3912  Intellectual Property and Copyright Stat
3912  <p>&nbsp;&nbsp;&nbsp;"."  <p>&nbsp;&nbsp;&nbsp;"."
3913  </p>  </p>
3914  </blockquote><p>  </blockquote><p>
3915                        
3916  </p>  </p>
3917  <a name="rfc.section.6.4.11"></a><h4><a name="GET CHANNEL VOICE_COUNT">6.4.11</a>&nbsp;Current number of active voices</h4>  <a name="GET CHANNEL VOICE_COUNT"></a><br /><hr />
3918    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3919    <a name="rfc.section.6.4.11"></a><h3>6.4.11.&nbsp;Current number of active voices</h3>
3920    
3921  <p>The front-end can ask for the current number of active voices on a  <p>The front-end can ask for the current number of active voices on a
3922                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 3808  Intellectual Property and Copyright Stat Line 3927  Intellectual Property and Copyright Stat
3927  <p>GET CHANNEL VOICE_COUNT &lt;sampler-channel&gt;  <p>GET CHANNEL VOICE_COUNT &lt;sampler-channel&gt;
3928  </p>  </p>
3929  </blockquote><p>  </blockquote><p>
3930                        
3931  </p>  </p>
3932  <p>Where &lt;sampler-channel&gt; is the sampler channel number the front-end is interested in  <p>Where &lt;sampler-channel&gt; is the sampler channel number the front-end is interested in
3933                      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>                      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>
# Line 3823  Intellectual Property and Copyright Stat Line 3942  Intellectual Property and Copyright Stat
3942                              voices on that channel.                              voices on that channel.
3943  </p>  </p>
3944  </blockquote><p>  </blockquote><p>
3945                        
3946  </p>  </p>
3947  <p>Example:  <p>Example:
3948  </p>  </p>
# Line 3833  Intellectual Property and Copyright Stat Line 3952  Intellectual Property and Copyright Stat
3952  <p>  <p>
3953  </p>  </p>
3954  </blockquote><p>  </blockquote><p>
3955                        
3956  </p>  </p>
3957  <a name="rfc.section.6.4.12"></a><h4><a name="GET CHANNEL STREAM_COUNT">6.4.12</a>&nbsp;Current number of active disk streams</h4>  <a name="GET CHANNEL STREAM_COUNT"></a><br /><hr />
3958    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
3959    <a name="rfc.section.6.4.12"></a><h3>6.4.12.&nbsp;Current number of active disk streams</h3>
3960    
3961  <p>The front-end can ask for the current number of active disk streams  <p>The front-end can ask for the current number of active disk streams
3962                      on a sampler channel by sending the following command:                      on a sampler channel by sending the following command:
# Line 3846  Intellectual Property and Copyright Stat Line 3967  Intellectual Property and Copyright Stat
3967  <p>GET CHANNEL STREAM_COUNT &lt;sampler-channel&gt;  <p>GET CHANNEL STREAM_COUNT &lt;sampler-channel&gt;
3968  </p>  </p>
3969  </blockquote><p>  </blockquote><p>
3970                        
3971  </p>  </p>
3972  <p>Where &lt;sampler-channel&gt; is the sampler channel number the front-end is interested in  <p>Where &lt;sampler-channel&gt; is the sampler channel number the front-end is interested in
3973                      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>                      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>
# Line 3863  Intellectual Property and Copyright Stat Line 3984  Intellectual Property and Copyright Stat
3984                              return "NA" for not available.                              return "NA" for not available.
3985  </p>  </p>
3986  </blockquote><p>  </blockquote><p>
3987                        
3988  </p>  </p>
3989  <p>Example:  <p>Example:
3990  </p>  </p>
# Line 3873  Intellectual Property and Copyright Stat Line 3994  Intellectual Property and Copyright Stat
3994  <p>  <p>
3995  </p>  </p>
3996  </blockquote><p>  </blockquote><p>
3997                        
3998  </p>  </p>
3999  <a name="rfc.section.6.4.13"></a><h4><a name="GET CHANNEL BUFFER_FILL">6.4.13</a>&nbsp;Current fill state of disk stream buffers</h4>  <a name="GET CHANNEL BUFFER_FILL"></a><br /><hr />
4000    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4001    <a name="rfc.section.6.4.13"></a><h3>6.4.13.&nbsp;Current fill state of disk stream buffers</h3>
4002    
4003  <p>The front-end can ask for the current fill state of all disk streams  <p>The front-end can ask for the current fill state of all disk streams
4004                      on a sampler channel by sending the following command:                      on a sampler channel by sending the following command:
# Line 3886  Intellectual Property and Copyright Stat Line 4009  Intellectual Property and Copyright Stat
4009  <p>GET CHANNEL BUFFER_FILL BYTES &lt;sampler-channel&gt;  <p>GET CHANNEL BUFFER_FILL BYTES &lt;sampler-channel&gt;
4010  </p>  </p>
4011  </blockquote><p>  </blockquote><p>
4012                        
4013  </p>  </p>
4014  <p>to get the fill state in bytes or  <p>to get the fill state in bytes or
4015  </p>  </p>
# Line 3896  Intellectual Property and Copyright Stat Line 4019  Intellectual Property and Copyright Stat
4019  <p>GET CHANNEL BUFFER_FILL PERCENTAGE &lt;sampler-channel&gt;  <p>GET CHANNEL BUFFER_FILL PERCENTAGE &lt;sampler-channel&gt;
4020  </p>  </p>
4021  </blockquote><p>  </blockquote><p>
4022                        
4023  </p>  </p>
4024  <p>to get the fill state in percent, where &lt;sampler-channel&gt; is the  <p>to get the fill state in percent, where &lt;sampler-channel&gt; is the
4025                      sampler channel number the front-end is interested in                      sampler channel number the front-end is interested in
# Line 3920  Intellectual Property and Copyright Stat Line 4043  Intellectual Property and Copyright Stat
4043                              to sort them by itself if necessary.                              to sort them by itself if necessary.
4044  </p>  </p>
4045  </blockquote><p>  </blockquote><p>
4046                        
4047  </p>  </p>
4048  <p>Examples:  <p>Examples:
4049  </p>  </p>
# Line 3948  Intellectual Property and Copyright Stat Line 4071  Intellectual Property and Copyright Stat
4071  <p>S: ""  <p>S: ""
4072  </p>  </p>
4073  </blockquote><p>  </blockquote><p>
4074                        
4075  </p>  </p>
4076  <a name="rfc.section.6.4.14"></a><h4><a name="SET CHANNEL AUDIO_OUTPUT_DEVICE">6.4.14</a>&nbsp;Setting audio output device</h4>  <a name="SET CHANNEL AUDIO_OUTPUT_DEVICE"></a><br /><hr />
4077    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4078    <a name="rfc.section.6.4.14"></a><h3>6.4.14.&nbsp;Setting audio output device</h3>
4079    
4080  <p>The front-end can set the audio output device on a specific sampler  <p>The front-end can set the audio output device on a specific sampler
4081                      channel by sending the following command:                      channel by sending the following command:
# Line 3961  Intellectual Property and Copyright Stat Line 4086  Intellectual Property and Copyright Stat
4086  <p>SET CHANNEL AUDIO_OUTPUT_DEVICE &lt;sampler-channel&gt; &lt;audio-device-id&gt;  <p>SET CHANNEL AUDIO_OUTPUT_DEVICE &lt;sampler-channel&gt; &lt;audio-device-id&gt;
4087  </p>  </p>
4088  </blockquote><p>  </blockquote><p>
4089                        
4090  </p>  </p>
4091  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4092                      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>                      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>
# Line 3981  Intellectual Property and Copyright Stat Line 4106  Intellectual Property and Copyright Stat
4106  <blockquote class="text">  <blockquote class="text">
4107  <p>on success  <p>on success
4108  </p>  </p>
4109  </blockquote><p>  </blockquote>
4110                                
4111    
 </p>  
4112  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4113                                  </p>                                  </p>
4114  <blockquote class="text">  <blockquote class="text">
# Line 3991  Intellectual Property and Copyright Stat Line 4116  Intellectual Property and Copyright Stat
4116                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4117                                      warning message                                      warning message
4118  </p>  </p>
4119  </blockquote><p>  </blockquote>
4120                                
4121    
 </p>  
4122  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4123                                  </p>                                  </p>
4124  <blockquote class="text">  <blockquote class="text">
4125  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4126  </p>  </p>
4127  </blockquote><p>  </blockquote>
4128                                
4129    
 </p>  
4130  </blockquote><p>  </blockquote><p>
4131                        
4132  </p>  </p>
4133  <p>Examples:  <p>Examples:
4134  </p>  </p>
# Line 4013  Intellectual Property and Copyright Stat Line 4138  Intellectual Property and Copyright Stat
4138  <p>  <p>
4139  </p>  </p>
4140  </blockquote><p>  </blockquote><p>
4141                        
4142  </p>  </p>
4143  <a name="rfc.section.6.4.15"></a><h4><a name="SET CHANNEL AUDIO_OUTPUT_TYP">6.4.15</a>&nbsp;Setting audio output type</h4>  <a name="SET CHANNEL AUDIO_OUTPUT_TYP"></a><br /><hr />
4144    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4145    <a name="rfc.section.6.4.15"></a><h3>6.4.15.&nbsp;Setting audio output type</h3>
4146    
4147  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4148  </p>  </p>
# Line 4028  Intellectual Property and Copyright Stat Line 4155  Intellectual Property and Copyright Stat
4155  <p>SET CHANNEL AUDIO_OUTPUT_TYPE &lt;sampler-channel&gt; &lt;audio-output-type&gt;  <p>SET CHANNEL AUDIO_OUTPUT_TYPE &lt;sampler-channel&gt; &lt;audio-output-type&gt;
4156  </p>  </p>
4157  </blockquote><p>  </blockquote><p>
4158                        
4159  </p>  </p>
4160  <p>Where &lt;audio-output-type&gt; is currently either "ALSA" or "JACK" and  <p>Where &lt;audio-output-type&gt; is currently either "ALSA" or "JACK" and
4161                      &lt;sampler-channel&gt; is the respective sampler channel number.                      &lt;sampler-channel&gt; is the respective sampler channel number.
# Line 4043  Intellectual Property and Copyright Stat Line 4170  Intellectual Property and Copyright Stat
4170  <blockquote class="text">  <blockquote class="text">
4171  <p>on success  <p>on success
4172  </p>  </p>
4173  </blockquote><p>  </blockquote>
4174                                
4175    
 </p>  
4176  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4177                                  </p>                                  </p>
4178  <blockquote class="text">  <blockquote class="text">
# Line 4053  Intellectual Property and Copyright Stat Line 4180  Intellectual Property and Copyright Stat
4180                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4181                                      warning message                                      warning message
4182  </p>  </p>
4183  </blockquote><p>  </blockquote>
4184                                
4185    
 </p>  
4186  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4187                                  </p>                                  </p>
4188  <blockquote class="text">  <blockquote class="text">
4189  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4190  </p>  </p>
4191  </blockquote><p>  </blockquote>
4192                                
4193    
 </p>  
4194  </blockquote><p>  </blockquote><p>
4195                        
4196  </p>  </p>
4197  <p>Examples:  <p>Examples:
4198  </p>  </p>
# Line 4075  Intellectual Property and Copyright Stat Line 4202  Intellectual Property and Copyright Stat
4202  <p>  <p>
4203  </p>  </p>
4204  </blockquote><p>  </blockquote><p>
4205                        
4206  </p>  </p>
4207  <a name="rfc.section.6.4.16"></a><h4><a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL">6.4.16</a>&nbsp;Setting audio output channel</h4>  <a name="SET CHANNEL AUDIO_OUTPUT_CHANNEL"></a><br /><hr />
4208    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4209    <a name="rfc.section.6.4.16"></a><h3>6.4.16.&nbsp;Setting audio output channel</h3>
4210    
4211  <p>The front-end can alter the audio output channel on a specific  <p>The front-end can alter the audio output channel on a specific
4212                      sampler channel by sending the following command:                      sampler channel by sending the following command:
# Line 4088  Intellectual Property and Copyright Stat Line 4217  Intellectual Property and Copyright Stat
4217  <p>SET CHANNEL AUDIO_OUTPUT_CHANNEL &lt;sampler-chan&gt; &lt;audio-out&gt; &lt;audio-in&gt;  <p>SET CHANNEL AUDIO_OUTPUT_CHANNEL &lt;sampler-chan&gt; &lt;audio-out&gt; &lt;audio-in&gt;
4218  </p>  </p>
4219  </blockquote><p>  </blockquote><p>
4220                        
4221  </p>  </p>
4222  <p>Where &lt;sampler-chan&gt; is the sampler channel number  <p>Where &lt;sampler-chan&gt; is the sampler channel number
4223                      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>                      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>
# Line 4107  Intellectual Property and Copyright Stat Line 4236  Intellectual Property and Copyright Stat
4236  <blockquote class="text">  <blockquote class="text">
4237  <p>on success  <p>on success
4238  </p>  </p>
4239  </blockquote><p>  </blockquote>
4240                                
4241    
 </p>  
4242  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4243                                  </p>                                  </p>
4244  <blockquote class="text">  <blockquote class="text">
# Line 4117  Intellectual Property and Copyright Stat Line 4246  Intellectual Property and Copyright Stat
4246                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4247                                      warning message                                      warning message
4248  </p>  </p>
4249  </blockquote><p>  </blockquote>
4250                                
4251    
 </p>  
4252  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4253                                  </p>                                  </p>
4254  <blockquote class="text">  <blockquote class="text">
4255  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4256  </p>  </p>
4257  </blockquote><p>  </blockquote>
4258                                
4259    
 </p>  
4260  </blockquote><p>  </blockquote><p>
4261                        
4262  </p>  </p>
4263  <p>Examples:  <p>Examples:
4264  </p>  </p>
# Line 4139  Intellectual Property and Copyright Stat Line 4268  Intellectual Property and Copyright Stat
4268  <p>  <p>
4269  </p>  </p>
4270  </blockquote><p>  </blockquote><p>
4271                        
4272  </p>  </p>
4273  <a name="rfc.section.6.4.17"></a><h4><a name="SET CHANNEL MIDI_INPUT_DEVICE">6.4.17</a>&nbsp;Setting MIDI input device</h4>  <a name="SET CHANNEL MIDI_INPUT_DEVICE"></a><br /><hr />
4274    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4275    <a name="rfc.section.6.4.17"></a><h3>6.4.17.&nbsp;Setting MIDI input device</h3>
4276    
4277  <p>The front-end can set the MIDI input device on a specific sampler  <p>The front-end can set the MIDI input device on a specific sampler
4278                      channel by sending the following command:                      channel by sending the following command:
# Line 4152  Intellectual Property and Copyright Stat Line 4283  Intellectual Property and Copyright Stat
4283  <p>SET CHANNEL MIDI_INPUT_DEVICE &lt;sampler-channel&gt; &lt;midi-device-id&gt;  <p>SET CHANNEL MIDI_INPUT_DEVICE &lt;sampler-channel&gt; &lt;midi-device-id&gt;
4284  </p>  </p>
4285  </blockquote><p>  </blockquote><p>
4286                        
4287  </p>  </p>
4288  <p>Where &lt;sampler-channel&gt; is the sampler channel number  <p>Where &lt;sampler-channel&gt; is the sampler channel number
4289                      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>                      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>
# Line 4171  Intellectual Property and Copyright Stat Line 4302  Intellectual Property and Copyright Stat
4302  <blockquote class="text">  <blockquote class="text">
4303  <p>on success  <p>on success
4304  </p>  </p>
4305  </blockquote><p>  </blockquote>
4306                                
4307    
 </p>  
4308  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4309                                  </p>                                  </p>
4310  <blockquote class="text">  <blockquote class="text">
# Line 4181  Intellectual Property and Copyright Stat Line 4312  Intellectual Property and Copyright Stat
4312                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4313                                      warning message                                      warning message
4314  </p>  </p>
4315  </blockquote><p>  </blockquote>
4316                                
4317    
 </p>  
4318  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4319                                  </p>                                  </p>
4320  <blockquote class="text">  <blockquote class="text">
4321  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4322  </p>  </p>
4323  </blockquote><p>  </blockquote>
4324                                
4325    
 </p>  
4326  </blockquote><p>  </blockquote><p>
4327                        
4328  </p>  </p>
4329  <p>Examples:  <p>Examples:
4330  </p>  </p>
# Line 4203  Intellectual Property and Copyright Stat Line 4334  Intellectual Property and Copyright Stat
4334  <p>  <p>
4335  </p>  </p>
4336  </blockquote><p>  </blockquote><p>
4337                        
4338  </p>  </p>
4339  <a name="rfc.section.6.4.18"></a><h4><a name="SET CHANNEL MIDI_INPUT_TYPE">6.4.18</a>&nbsp;Setting MIDI input type</h4>  <a name="SET CHANNEL MIDI_INPUT_TYPE"></a><br /><hr />
4340    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4341    <a name="rfc.section.6.4.18"></a><h3>6.4.18.&nbsp;Setting MIDI input type</h3>
4342    
4343  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!  <p>DEPRECATED: THIS COMMAND WILL DISAPPEAR SOON!
4344  </p>  </p>
# Line 4218  Intellectual Property and Copyright Stat Line 4351  Intellectual Property and Copyright Stat
4351  <p>SET CHANNEL MIDI_INPUT_TYPE &lt;sampler-channel&gt; &lt;midi-input-type&gt;  <p>SET CHANNEL MIDI_INPUT_TYPE &lt;sampler-channel&gt; &lt;midi-input-type&gt;
4352  </p>  </p>
4353  </blockquote><p>  </blockquote><p>
4354                        
4355  </p>  </p>
4356  <p>Where &lt;midi-input-type&gt; is currently only "ALSA" and  <p>Where &lt;midi-input-type&gt; is currently only "ALSA" and
4357                      &lt;sampler-channel&gt; is the respective sampler channel number.                      &lt;sampler-channel&gt; is the respective sampler channel number.
# Line 4233  Intellectual Property and Copyright Stat Line 4366  Intellectual Property and Copyright Stat
4366  <blockquote class="text">  <blockquote class="text">
4367  <p>on success  <p>on success
4368  </p>  </p>
4369  </blockquote><p>  </blockquote>
4370                                
4371    
 </p>  
4372  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4373                                  </p>                                  </p>
4374  <blockquote class="text">  <blockquote class="text">
# Line 4243  Intellectual Property and Copyright Stat Line 4376  Intellectual Property and Copyright Stat
4376                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4377                                      warning message                                      warning message
4378  </p>  </p>
4379  </blockquote><p>  </blockquote>
4380                                
4381    
 </p>  
4382  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4383                                  </p>                                  </p>
4384  <blockquote class="text">  <blockquote class="text">
4385  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4386  </p>  </p>
4387  </blockquote><p>  </blockquote>
4388                                
4389    
 </p>  
4390  </blockquote><p>  </blockquote><p>
4391                        
4392  </p>  </p>
4393  <p>Examples:  <p>Examples:
4394  </p>  </p>
# Line 4265  Intellectual Property and Copyright Stat Line 4398  Intellectual Property and Copyright Stat
4398  <p>  <p>
4399  </p>  </p>
4400  </blockquote><p>  </blockquote><p>
4401                        
4402  </p>  </p>
4403  <a name="rfc.section.6.4.19"></a><h4><a name="SET CHANNEL MIDI_INPUT_PORT">6.4.19</a>&nbsp;Setting MIDI input port</h4>  <a name="SET CHANNEL MIDI_INPUT_PORT"></a><br /><hr />
4404    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4405    <a name="rfc.section.6.4.19"></a><h3>6.4.19.&nbsp;Setting MIDI input port</h3>
4406    
4407  <p>The front-end can alter the MIDI input port on a specific sampler  <p>The front-end can alter the MIDI input port on a specific sampler
4408                      channel by sending the following command:                      channel by sending the following command:
# Line 4278  Intellectual Property and Copyright Stat Line 4413  Intellectual Property and Copyright Stat
4413  <p>SET CHANNEL MIDI_INPUT_PORT &lt;sampler-channel&gt; &lt;midi-input-port&gt;  <p>SET CHANNEL MIDI_INPUT_PORT &lt;sampler-channel&gt; &lt;midi-input-port&gt;
4414  </p>  </p>
4415  </blockquote><p>  </blockquote><p>
4416                        
4417  </p>  </p>
4418  <p>Where &lt;midi-input-port&gt; is a MIDI input port number of the  <p>Where &lt;midi-input-port&gt; is a MIDI input port number of the
4419                      MIDI input device connected to the sampler channel given by                      MIDI input device connected to the sampler channel given by
# Line 4294  Intellectual Property and Copyright Stat Line 4429  Intellectual Property and Copyright Stat
4429  <blockquote class="text">  <blockquote class="text">
4430  <p>on success  <p>on success
4431  </p>  </p>
4432  </blockquote><p>  </blockquote>
4433                                
4434    
 </p>  
4435  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4436                                  </p>                                  </p>
4437  <blockquote class="text">  <blockquote class="text">
# Line 4304  Intellectual Property and Copyright Stat Line 4439  Intellectual Property and Copyright Stat
4439                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4440                                      warning message                                      warning message
4441  </p>  </p>
4442  </blockquote><p>  </blockquote>
4443                                
4444    
 </p>  
4445  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4446                                  </p>                                  </p>
4447  <blockquote class="text">  <blockquote class="text">
4448  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4449  </p>  </p>
4450  </blockquote><p>  </blockquote>
4451                                
4452    
 </p>  
4453  </blockquote><p>  </blockquote><p>
4454                        
4455  </p>  </p>
4456  <p>Examples:  <p>Examples:
4457  </p>  </p>
# Line 4326  Intellectual Property and Copyright Stat Line 4461  Intellectual Property and Copyright Stat
4461  <p>  <p>
4462  </p>  </p>
4463  </blockquote><p>  </blockquote><p>
4464                        
4465  </p>  </p>
4466  <a name="rfc.section.6.4.20"></a><h4><a name="SET CHANNEL MIDI_INPUT_CHANNEL">6.4.20</a>&nbsp;Setting MIDI input channel</h4>  <a name="SET CHANNEL MIDI_INPUT_CHANNEL"></a><br /><hr />
4467    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4468    <a name="rfc.section.6.4.20"></a><h3>6.4.20.&nbsp;Setting MIDI input channel</h3>
4469    
4470  <p>The front-end can alter the MIDI channel a sampler channel should  <p>The front-end can alter the MIDI channel a sampler channel should
4471                      listen to by sending the following command:                      listen to by sending the following command:
# Line 4339  Intellectual Property and Copyright Stat Line 4476  Intellectual Property and Copyright Stat
4476  <p>SET CHANNEL MIDI_INPUT_CHANNEL &lt;sampler-channel&gt; &lt;midi-input-chan&gt;  <p>SET CHANNEL MIDI_INPUT_CHANNEL &lt;sampler-channel&gt; &lt;midi-input-chan&gt;
4477  </p>  </p>
4478  </blockquote><p>  </blockquote><p>
4479                        
4480  </p>  </p>
4481  <p>Where &lt;midi-input-chan&gt; is the number of the new MIDI input channel where  <p>Where &lt;midi-input-chan&gt; is the number of the new MIDI input channel where
4482                      &lt;sampler-channel&gt; should listen to or "ALL" to listen on all 16 MIDI                      &lt;sampler-channel&gt; should listen to or "ALL" to listen on all 16 MIDI
# Line 4355  Intellectual Property and Copyright Stat Line 4492  Intellectual Property and Copyright Stat
4492  <blockquote class="text">  <blockquote class="text">
4493  <p>on success  <p>on success
4494  </p>  </p>
4495  </blockquote><p>  </blockquote>
4496                                
4497    
 </p>  
4498  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4499                                  </p>                                  </p>
4500  <blockquote class="text">  <blockquote class="text">
# Line 4365  Intellectual Property and Copyright Stat Line 4502  Intellectual Property and Copyright Stat
4502                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4503                                      warning message                                      warning message
4504  </p>  </p>
4505  </blockquote><p>  </blockquote>
4506                                
4507    
 </p>  
4508  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4509                                  </p>                                  </p>
4510  <blockquote class="text">  <blockquote class="text">
4511  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4512  </p>  </p>
4513  </blockquote><p>  </blockquote>
4514                                
4515    
 </p>  
4516  </blockquote><p>  </blockquote><p>
4517                        
4518  </p>  </p>
4519  <p>Examples:  <p>Examples:
4520  </p>  </p>
# Line 4387  Intellectual Property and Copyright Stat Line 4524  Intellectual Property and Copyright Stat
4524  <p>  <p>
4525  </p>  </p>
4526  </blockquote><p>  </blockquote><p>
4527                        
4528  </p>  </p>
4529  <a name="rfc.section.6.4.21"></a><h4><a name="SET CHANNEL VOLUME">6.4.21</a>&nbsp;Setting channel volume</h4>  <a name="SET CHANNEL VOLUME"></a><br /><hr />
4530    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4531    <a name="rfc.section.6.4.21"></a><h3>6.4.21.&nbsp;Setting channel volume</h3>
4532    
4533  <p>The front-end can alter the volume of a sampler channel by sending  <p>The front-end can alter the volume of a sampler channel by sending
4534                      the following command:                      the following command:
# Line 4400  Intellectual Property and Copyright Stat Line 4539  Intellectual Property and Copyright Stat
4539  <p>SET CHANNEL VOLUME &lt;sampler-channel&gt; &lt;volume&gt;  <p>SET CHANNEL VOLUME &lt;sampler-channel&gt; &lt;volume&gt;
4540  </p>  </p>
4541  </blockquote><p>  </blockquote><p>
4542                        
4543  </p>  </p>
4544  <p>Where &lt;volume&gt; is an optionally dotted positive number (a value  <p>Where &lt;volume&gt; is an optionally dotted positive number (a value
4545                      smaller than 1.0 means attenuation, whereas a value greater than                      smaller than 1.0 means attenuation, whereas a value greater than
# Line 4417  Intellectual Property and Copyright Stat Line 4556  Intellectual Property and Copyright Stat
4556  <blockquote class="text">  <blockquote class="text">
4557  <p>on success  <p>on success
4558  </p>  </p>
4559  </blockquote><p>  </blockquote>
4560                                
4561    
 </p>  
4562  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4563                                  </p>                                  </p>
4564  <blockquote class="text">  <blockquote class="text">
# Line 4427  Intellectual Property and Copyright Stat Line 4566  Intellectual Property and Copyright Stat
4566                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4567                                      warning message                                      warning message
4568  </p>  </p>
4569  </blockquote><p>  </blockquote>
4570                                
4571    
 </p>  
4572  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4573                                  </p>                                  </p>
4574  <blockquote class="text">  <blockquote class="text">
4575  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4576  </p>  </p>
4577  </blockquote><p>  </blockquote>
4578                                
4579    
 </p>  
4580  </blockquote><p>  </blockquote><p>
4581                        
4582  </p>  </p>
4583  <p>Examples:  <p>Examples:
4584  </p>  </p>
# Line 4449  Intellectual Property and Copyright Stat Line 4588  Intellectual Property and Copyright Stat
4588  <p>  <p>
4589  </p>  </p>
4590  </blockquote><p>  </blockquote><p>
4591                        
4592  </p>  </p>
4593  <a name="rfc.section.6.4.22"></a><h4><a name="SET CHANNEL MUTE">6.4.22</a>&nbsp;Muting a sampler channel</h4>  <a name="SET CHANNEL MUTE"></a><br /><hr />
4594    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4595    <a name="rfc.section.6.4.22"></a><h3>6.4.22.&nbsp;Muting a sampler channel</h3>
4596    
4597  <p>The front-end can mute/unmute a specific sampler  <p>The front-end can mute/unmute a specific sampler
4598                      channel by sending the following command:                      channel by sending the following command:
# Line 4462  Intellectual Property and Copyright Stat Line 4603  Intellectual Property and Copyright Stat
4603  <p>SET CHANNEL MUTE &lt;sampler-channel&gt; &lt;mute&gt;  <p>SET CHANNEL MUTE &lt;sampler-channel&gt; &lt;mute&gt;
4604  </p>  </p>
4605  </blockquote><p>  </blockquote><p>
4606                        
4607  </p>  </p>
4608  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4609                      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>                      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>
# Line 4480  Intellectual Property and Copyright Stat Line 4621  Intellectual Property and Copyright Stat
4621  <blockquote class="text">  <blockquote class="text">
4622  <p>on success  <p>on success
4623  </p>  </p>
4624  </blockquote><p>  </blockquote>
4625                                
4626    
 </p>  
4627  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4628                                  </p>                                  </p>
4629  <blockquote class="text">  <blockquote class="text">
# Line 4490  Intellectual Property and Copyright Stat Line 4631  Intellectual Property and Copyright Stat
4631                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4632                                      warning message                                      warning message
4633  </p>  </p>
4634  </blockquote><p>  </blockquote>
4635                                
4636    
 </p>  
4637  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4638                                  </p>                                  </p>
4639  <blockquote class="text">  <blockquote class="text">
4640  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4641  </p>  </p>
4642  </blockquote><p>  </blockquote>
4643                                
4644    
 </p>  
4645  </blockquote><p>  </blockquote><p>
4646                        
4647  </p>  </p>
4648  <p>Examples:  <p>Examples:
4649  </p>  </p>
# Line 4512  Intellectual Property and Copyright Stat Line 4653  Intellectual Property and Copyright Stat
4653  <p>  <p>
4654  </p>  </p>
4655  </blockquote><p>  </blockquote><p>
4656                        
4657  </p>  </p>
4658  <a name="rfc.section.6.4.23"></a><h4><a name="SET CHANNEL SOLO">6.4.23</a>&nbsp;Soloing a sampler channel</h4>  <a name="SET CHANNEL SOLO"></a><br /><hr />
4659    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4660    <a name="rfc.section.6.4.23"></a><h3>6.4.23.&nbsp;Soloing a sampler channel</h3>
4661    
4662  <p>The front-end can solo/unsolo a specific sampler channel  <p>The front-end can solo/unsolo a specific sampler channel
4663                      by sending the following command:                      by sending the following command:
# Line 4525  Intellectual Property and Copyright Stat Line 4668  Intellectual Property and Copyright Stat
4668  <p>SET CHANNEL SOLO &lt;sampler-channel&gt; &lt;solo&gt;  <p>SET CHANNEL SOLO &lt;sampler-channel&gt; &lt;solo&gt;
4669  </p>  </p>
4670  </blockquote><p>  </blockquote><p>
4671                        
4672  </p>  </p>
4673  <p>Where &lt;sampler-channel&gt; is the respective sampler channel  <p>Where &lt;sampler-channel&gt; is the respective sampler channel
4674                      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>                      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>
# Line 4543  Intellectual Property and Copyright Stat Line 4686  Intellectual Property and Copyright Stat
4686  <blockquote class="text">  <blockquote class="text">
4687  <p>on success  <p>on success
4688  </p>  </p>
4689  </blockquote><p>  </blockquote>
4690                                
4691    
 </p>  
4692  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4693                                  </p>                                  </p>
4694  <blockquote class="text">  <blockquote class="text">
# Line 4553  Intellectual Property and Copyright Stat Line 4696  Intellectual Property and Copyright Stat
4696                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4697                                      warning message                                      warning message
4698  </p>  </p>
4699  </blockquote><p>  </blockquote>
4700                                
4701    
 </p>  
4702  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4703                                  </p>                                  </p>
4704  <blockquote class="text">  <blockquote class="text">
4705  <p>in case it failed, providing an appropriate error code and error message  <p>in case it failed, providing an appropriate error code and error message
4706  </p>  </p>
4707  </blockquote><p>  </blockquote>
4708                                
4709    
 </p>  
4710  </blockquote><p>  </blockquote><p>
4711                        
4712  </p>  </p>
4713  <p>Examples:  <p>Examples:
4714  </p>  </p>
# Line 4575  Intellectual Property and Copyright Stat Line 4718  Intellectual Property and Copyright Stat
4718  <p>  <p>
4719  </p>  </p>
4720  </blockquote><p>  </blockquote><p>
4721                        
4722  </p>  </p>
4723  <a name="rfc.section.6.4.24"></a><h4><a name="RESET CHANNEL">6.4.24</a>&nbsp;Resetting a sampler channel</h4>  <a name="RESET CHANNEL"></a><br /><hr />
4724    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4725    <a name="rfc.section.6.4.24"></a><h3>6.4.24.&nbsp;Resetting a sampler channel</h3>
4726    
4727  <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:
4728  </p>  </p>
# Line 4587  Intellectual Property and Copyright Stat Line 4732  Intellectual Property and Copyright Stat
4732  <p>RESET CHANNEL &lt;sampler-channel&gt;  <p>RESET CHANNEL &lt;sampler-channel&gt;
4733  </p>  </p>
4734  </blockquote><p>  </blockquote><p>
4735                        
4736  </p>  </p>
4737  <p>  <p>
4738                      Where &lt;sampler-channel&gt; defines the sampler channel to be reset.                      Where &lt;sampler-channel&gt; defines the sampler channel to be reset.
# Line 4605  Intellectual Property and Copyright Stat Line 4750  Intellectual Property and Copyright Stat
4750  <blockquote class="text">  <blockquote class="text">
4751  <p>on success  <p>on success
4752  </p>  </p>
4753  </blockquote><p>  </blockquote>
4754                                
4755    
 </p>  
4756  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4757                                  </p>                                  </p>
4758  <blockquote class="text">  <blockquote class="text">
# Line 4615  Intellectual Property and Copyright Stat Line 4760  Intellectual Property and Copyright Stat
4760                                      related, providing an appropriate warning code and warning                                      related, providing an appropriate warning code and warning
4761                                      message                                      message
4762  </p>  </p>
4763  </blockquote><p>  </blockquote>
4764                                
4765    
 </p>  
4766  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4767                                  </p>                                  </p>
4768  <blockquote class="text">  <blockquote class="text">
4769  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
4770                                      error message                                      error message
4771  </p>  </p>
4772  </blockquote><p>  </blockquote>
4773                                
4774    
 </p>  
4775  </blockquote><p>  </blockquote><p>
4776                        
4777  </p>  </p>
4778  <p>Examples:  <p>Examples:
4779  </p>  </p>
# Line 4638  Intellectual Property and Copyright Stat Line 4783  Intellectual Property and Copyright Stat
4783  <p>  <p>
4784  </p>  </p>
4785  </blockquote><p>  </blockquote><p>
4786                        
4787  </p>  </p>
4788  <a name="rfc.section.6.5"></a><h4><a name="anchor12">6.5</a>&nbsp;Controlling connection</h4>  <a name="anchor12"></a><br /><hr />
4789    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4790    <a name="rfc.section.6.5"></a><h3>6.5.&nbsp;Controlling connection</h3>
4791    
4792  <p>The following commands are used to control the connection to LinuxSampler.  <p>The following commands are used to control the connection to LinuxSampler.
4793  </p>  </p>
4794  <a name="rfc.section.6.5.1"></a><h4><a name="SUBSCRIBE">6.5.1</a>&nbsp;Register front-end for receiving event messages</h4>  <a name="SUBSCRIBE"></a><br /><hr />
4795    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4796    <a name="rfc.section.6.5.1"></a><h3>6.5.1.&nbsp;Register front-end for receiving event messages</h3>
4797    
4798  <p>The front-end can register itself to the LinuxSampler application to  <p>The front-end can register itself to the LinuxSampler application to
4799                      be informed about noteworthy events by sending this command:                      be informed about noteworthy events by sending this command:
# Line 4655  Intellectual Property and Copyright Stat Line 4804  Intellectual Property and Copyright Stat
4804  <p>SUBSCRIBE &lt;event-id&gt;  <p>SUBSCRIBE &lt;event-id&gt;
4805  </p>  </p>
4806  </blockquote><p>  </blockquote><p>
4807                        
4808  </p>  </p>
4809  <p>where &lt;event-id&gt; will be replaced by the respective event that  <p>where &lt;event-id&gt; will be replaced by the respective event that
4810                      client wants to subscribe to.                      client wants to subscribe to.
# Line 4670  Intellectual Property and Copyright Stat Line 4819  Intellectual Property and Copyright Stat
4819  <blockquote class="text">  <blockquote class="text">
4820  <p>on success  <p>on success
4821  </p>  </p>
4822  </blockquote><p>  </blockquote>
4823                                
4824    
 </p>  
4825  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4826                                  </p>                                  </p>
4827  <blockquote class="text">  <blockquote class="text">
# Line 4680  Intellectual Property and Copyright Stat Line 4829  Intellectual Property and Copyright Stat
4829                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4830                                      warning message                                      warning message
4831  </p>  </p>
4832  </blockquote><p>  </blockquote>
4833                                
4834    
 </p>  
4835  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4836                                  </p>                                  </p>
4837  <blockquote class="text">  <blockquote class="text">
4838  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
4839                                      error message                                      error message
4840  </p>  </p>
4841  </blockquote><p>  </blockquote>
4842                                
4843    
 </p>  
4844  </blockquote><p>  </blockquote><p>
4845                        
4846  </p>  </p>
4847  <p>Examples:  <p>Examples:
4848  </p>  </p>
# Line 4703  Intellectual Property and Copyright Stat Line 4852  Intellectual Property and Copyright Stat
4852  <p>  <p>
4853  </p>  </p>
4854  </blockquote><p>  </blockquote><p>
4855                        
4856  </p>  </p>
4857  <a name="rfc.section.6.5.2"></a><h4><a name="UNSUBSCRIBE">6.5.2</a>&nbsp;Unregister front-end for not receiving event messages</h4>  <a name="UNSUBSCRIBE"></a><br /><hr />
4858    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4859    <a name="rfc.section.6.5.2"></a><h3>6.5.2.&nbsp;Unregister front-end for not receiving event messages</h3>
4860    
4861  <p>The front-end can unregister itself if it doesn't want to receive event  <p>The front-end can unregister itself if it doesn't want to receive event
4862                      messages anymore by sending the following command:                      messages anymore by sending the following command:
# Line 4716  Intellectual Property and Copyright Stat Line 4867  Intellectual Property and Copyright Stat
4867  <p>UNSUBSCRIBE &lt;event-id&gt;  <p>UNSUBSCRIBE &lt;event-id&gt;
4868  </p>  </p>
4869  </blockquote><p>  </blockquote><p>
4870                        
4871  </p>  </p>
4872  <p>Where &lt;event-id&gt; will be replaced by the respective event that  <p>Where &lt;event-id&gt; will be replaced by the respective event that
4873                      client doesn't want to receive anymore.                      client doesn't want to receive anymore.
# Line 4731  Intellectual Property and Copyright Stat Line 4882  Intellectual Property and Copyright Stat
4882  <blockquote class="text">  <blockquote class="text">
4883  <p>on success  <p>on success
4884  </p>  </p>
4885  </blockquote><p>  </blockquote>
4886                                
4887    
 </p>  
4888  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -  <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
4889                                  </p>                                  </p>
4890  <blockquote class="text">  <blockquote class="text">
# Line 4741  Intellectual Property and Copyright Stat Line 4892  Intellectual Property and Copyright Stat
4892                                      issue(s) related, providing an appropriate warning code and                                      issue(s) related, providing an appropriate warning code and
4893                                      warning message                                      warning message
4894  </p>  </p>
4895  </blockquote><p>  </blockquote>
4896                                
4897    
 </p>  
4898  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4899                                  </p>                                  </p>
4900  <blockquote class="text">  <blockquote class="text">
4901  <p>in case it failed, providing an appropriate error code and  <p>in case it failed, providing an appropriate error code and
4902                                      error message                                      error message
4903  </p>  </p>
4904  </blockquote><p>  </blockquote>
4905                                
4906    
 </p>  
4907  </blockquote><p>  </blockquote><p>
4908                        
4909  </p>  </p>
4910  <p>Examples:  <p>Examples:
4911  </p>  </p>
# Line 4764  Intellectual Property and Copyright Stat Line 4915  Intellectual Property and Copyright Stat
4915  <p>  <p>
4916  </p>  </p>
4917  </blockquote><p>  </blockquote><p>
4918                        
4919  </p>  </p>
4920  <a name="rfc.section.6.5.3"></a><h4><a name="SET ECHO">6.5.3</a>&nbsp;Enable or disable echo of commands</h4>  <a name="SET ECHO"></a><br /><hr />
4921    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4922    <a name="rfc.section.6.5.3"></a><h3>6.5.3.&nbsp;Enable or disable echo of commands</h3>
4923    
4924  <p>To enable or disable back sending of commands to the client the following command can be used:  <p>To enable or disable back sending of commands to the client the following command can be used:
4925  </p>  </p>
# Line 4776  Intellectual Property and Copyright Stat Line 4929  Intellectual Property and Copyright Stat
4929  <p>SET ECHO &lt;value&gt;  <p>SET ECHO &lt;value&gt;
4930  </p>  </p>
4931  </blockquote><p>  </blockquote><p>
4932                        
4933  </p>  </p>
4934  <p>Where &lt;value&gt; should be replaced either by "1" to enable echo mode  <p>Where &lt;value&gt; should be replaced either by "1" to enable echo mode
4935                      or "0" to disable echo mode. When echo mode is enabled, all                      or "0" to disable echo mode. When echo mode is enabled, all
# Line 4796  Intellectual Property and Copyright Stat Line 4949  Intellectual Property and Copyright Stat
4949  <blockquote class="text">  <blockquote class="text">
4950  <p>usually  <p>usually
4951  </p>  </p>
4952  </blockquote><p>  </blockquote>
4953                                
4954    
 </p>  
4955  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -  <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
4956                                  </p>                                  </p>
4957  <blockquote class="text">  <blockquote class="text">
4958  <p>on syntax error, e.g. non boolean value  <p>on syntax error, e.g. non boolean value
4959  </p>  </p>
4960  </blockquote><p>  </blockquote>
4961                                
4962    
 </p>  
4963  </blockquote><p>  </blockquote><p>
4964                        
4965  </p>  </p>
4966  <p>Examples:  <p>Examples:
4967  </p>  </p>
# Line 4818  Intellectual Property and Copyright Stat Line 4971  Intellectual Property and Copyright Stat
4971  <p>  <p>
4972  </p>  </p>
4973  </blockquote><p>  </blockquote><p>
4974                        
4975  </p>  </p>
4976  <a name="rfc.section.6.5.4"></a><h4><a name="QUIT">6.5.4</a>&nbsp;Close client connection</h4>  <a name="QUIT"></a><br /><hr />
4977    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4978    <a name="rfc.section.6.5.4"></a><h3>6.5.4.&nbsp;Close client connection</h3>
4979    
4980  <p>The client can close its network connection to LinuxSampler by sending the following command:  <p>The client can close its network connection to LinuxSampler by sending the following command:
4981  </p>  </p>
# Line 4830  Intellectual Property and Copyright Stat Line 4985  Intellectual Property and Copyright Stat
4985  <p>QUIT  <p>QUIT
4986  </p>  </p>
4987  </blockquote><p>  </blockquote><p>
4988                        
4989  </p>  </p>
4990  <p>This is probably more interesting for manual telnet connections to  <p>This is probably more interesting for manual telnet connections to
4991                      LinuxSampler than really useful for a front-end implementation.                      LinuxSampler than really useful for a front-end implementation.
4992  </p>  </p>
4993  <a name="rfc.section.6.6"></a><h4><a name="anchor13">6.6</a>&nbsp;Global commands</h4>  <a name="anchor13"></a><br /><hr />
4994    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
4995    <a name="rfc.section.6.6"></a><h3>6.6.&nbsp;Global commands</h3>
4996    
4997  <p>The following commands have global impact on the sampler.  <p>The following commands have global impact on the sampler.
4998  </p>  </p>
4999  <a name="rfc.section.6.6.1"></a><h4><a name="RESET">6.6.1</a>&nbsp;Reset sampler</h4>  <a name="GET TOTAL_VOICE_COUNT"></a><br /><hr />
5000    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5001    <a name="rfc.section.6.6.1"></a><h3>6.6.1.&nbsp;Current number of active voices</h3>
5002    
5003    <p>The front-end can ask for the current number of active voices on
5004                        the sampler by sending the following command:
5005    </p>
5006    <p>
5007                            </p>
5008    <blockquote class="text">
5009    <p>GET TOTAL_VOICE_COUNT
5010    </p>
5011    </blockquote><p>
5012                        
5013    </p>
5014    <p>Possible Answers:
5015    </p>
5016    <p>
5017                            </p>
5018    <blockquote class="text">
5019    <p>LinuxSampler will answer by returning the number of all active
5020                                voices on the sampler.
5021    </p>
5022    </blockquote><p>
5023                        
5024    </p>
5025    <a name="GET TOTAL_VOICE_COUNT_MAX"></a><br /><hr />
5026    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5027    <a name="rfc.section.6.6.2"></a><h3>6.6.2.&nbsp;Maximum amount of active voices</h3>
5028    
5029    <p>The front-end can ask for the maximum number of active voices
5030                        by sending the following command:
5031    </p>
5032    <p>
5033                            </p>
5034    <blockquote class="text">
5035    <p>GET TOTAL_VOICE_COUNT_MAX
5036    </p>
5037    </blockquote><p>
5038                        
5039    </p>
5040    <p>Possible Answers:
5041    </p>
5042    <p>
5043                            </p>
5044    <blockquote class="text">
5045    <p>LinuxSampler will answer by returning the maximum number
5046                                of active voices.
5047    </p>
5048    </blockquote><p>
5049                        
5050    </p>
5051    <a name="RESET"></a><br /><hr />
5052    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5053    <a name="rfc.section.6.6.3"></a><h3>6.6.3.&nbsp;Reset sampler</h3>
5054    
5055  <p>The front-end can reset the whole sampler by sending the following command:  <p>The front-end can reset the whole sampler by sending the following command:
5056  </p>  </p>
# Line 4849  Intellectual Property and Copyright Stat Line 5060  Intellectual Property and Copyright Stat
5060  <p>RESET  <p>RESET
5061  </p>  </p>
5062  </blockquote><p>  </blockquote><p>
5063                        
5064  </p>  </p>
5065  <p>Possible Answers:  <p>Possible Answers:
5066  </p>  </p>
# Line 4861  Intellectual Property and Copyright Stat Line 5072  Intellectual Property and Copyright Stat
5072  <blockquote class="text">  <blockquote class="text">
5073  <p>always  <p>always
5074  </p>  </p>
5075  </blockquote><p>  </blockquote>
5076                                
5077    
 </p>  
5078  </blockquote><p>  </blockquote><p>
5079                        
5080  </p>  </p>
5081  <p>Examples:  <p>Examples:
5082  </p>  </p>
# Line 4875  Intellectual Property and Copyright Stat Line 5086  Intellectual Property and Copyright Stat
5086  <p>  <p>
5087  </p>  </p>
5088  </blockquote><p>  </blockquote><p>
5089                        
5090  </p>  </p>
5091  <a name="rfc.section.6.6.2"></a><h4><a name="GET SERVER INFO">6.6.2</a>&nbsp;General sampler informations</h4>  <a name="GET SERVER INFO"></a><br /><hr />
5092    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5093    <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;General sampler informations</h3>
5094    
5095  <p>The client can ask for general informations about the LinuxSampler  <p>The client can ask for general informations about the LinuxSampler
5096                         instance by sending the following command:                         instance by sending the following command:
# Line 4888  Intellectual Property and Copyright Stat Line 5101  Intellectual Property and Copyright Stat
5101  <p>GET SERVER INFO  <p>GET SERVER INFO
5102  </p>  </p>
5103  </blockquote><p>  </blockquote><p>
5104                        
5105  </p>  </p>
5106  <p>Possible Answers:  <p>Possible Answers:
5107  </p>  </p>
# Line 4900  Intellectual Property and Copyright Stat Line 5113  Intellectual Property and Copyright Stat
5113                                 followed by a colon and then a space character &lt;SP&gt; and finally                                 followed by a colon and then a space character &lt;SP&gt; and finally
5114                                 the info character string to that information category. At the                                 the info character string to that information category. At the
5115                                 moment the following categories are defined:                                 moment the following categories are defined:
5116                                
5117  </p>  </p>
5118  <p>  <p>
5119                                  </p>                                  </p>
# Line 4910  Intellectual Property and Copyright Stat Line 5123  Intellectual Property and Copyright Stat
5123  <blockquote class="text">  <blockquote class="text">
5124  <p>arbitrary textual description about the sampler  <p>arbitrary textual description about the sampler
5125  </p>  </p>
5126  </blockquote><p>  </blockquote>
5127                                        
5128    
 </p>  
5129  <p>VERSION -  <p>VERSION -
5130                                          </p>                                          </p>
5131  <blockquote class="text">  <blockquote class="text">
5132  <p>version of the sampler  <p>version of the sampler
5133  </p>  </p>
5134  </blockquote><p>  </blockquote>
5135                                        
5136    
 </p>  
5137  <p>PROTOCOL_VERSION -  <p>PROTOCOL_VERSION -
5138                                          </p>                                          </p>
5139  <blockquote class="text">  <blockquote class="text">
5140  <p>version of the LSCP specification the sampler  <p>version of the LSCP specification the sampler
5141                                              complies with (see <a class="info" href="#LSCP versioning">Section&nbsp;2<span> (</span><span class="info">Versioning of this specification</span><span>)</span></a> for details)                                              complies with (see <a class="info" href="#LSCP versioning">Section&nbsp;2<span> (</span><span class="info">Versioning of this specification</span><span>)</span></a> for details)
5142  </p>  </p>
5143    </blockquote>
5144                                        
5145    
5146    </blockquote>
5147                                
5148    
5149    </blockquote><p>
5150                        
5151    </p>
5152    <p>The mentioned fields above don't have to be in particular order.
5153                        Other fields might be added in future.
5154    </p>
5155    <a name="anchor14"></a><br /><hr />
5156    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5157    <a name="rfc.section.6.7"></a><h3>6.7.&nbsp;MIDI Instrument Mapping</h3>
5158    
5159    <p>The MIDI protocol provides a way to switch between instruments
5160                    by sending so called MIDI bank select and MIDI program change
5161                    messages which are essentially just numbers. The following commands
5162                    allow to actually map arbitrary MIDI bank select / program change
5163                    numbers with real instruments.
5164    </p>
5165    <p>By default, that is when the sampler is launched, this map will
5166                    be empty, thus the sampler will simply ignore all program change
5167                    messages. The front-end has to explicitly add entries to the map
5168                    so the sampler knows how to react on a given program change
5169                    message, that is by switching to the respectively defined engine
5170                    type and loading the respective instrument.
5171    </p>
5172    <p>Also note per MIDI specification a bank select message does not
5173                    cause to switch to another instrument. Instead when receiving a
5174                    bank select message the bank value will be stored and a subsequent
5175                    program change message (which may occur at any time) will finally
5176                    cause the sampler to switch to the respective instrument as
5177                    reflected by the current MIDI instrument map.
5178    </p>
5179    <a name="MAP MIDI_INSTRUMENT"></a><br /><hr />
5180    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5181    <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;Create or replace a MIDI instrument map entry</h3>
5182    
5183    <p>The front-end can create a new or replace an existing entry
5184                        in the sampler's MIDI instrument map by sending the following
5185                        command:
5186    </p>
5187    <p>
5188                            </p>
5189    <blockquote class="text">
5190    <p>MAP MIDI_INSTRUMENT &lt;midi_bank_msb&gt;
5191                                &lt;midi_bank_lsb&gt; &lt;midi_prog&gt; &lt;engine_name&gt;
5192                                &lt;filename&gt; &lt;instrument_index&gt; &lt;volume_value&gt;
5193                                [&lt;instr_load_mode&gt;] [&lt;name&gt;]
5194    </p>
5195    </blockquote><p>
5196                        
5197    </p>
5198    <p>Where &lt;midi_bank_msb&gt; is an integer value between
5199                        0..127 reflecting the MIDI bank select MSB (coarse) index,
5200                        &lt;midi_bank_lsb&gt; an integer value between 0..127 reflecting
5201                        the MIDI bank select LSB (fine) index, &lt;midi_prog&gt; an
5202                        integer value between 0..127 reflecting the MIDI program change
5203                        index, &lt;engine_name&gt; a sampler engine name as returned by
5204                        the <a class="info" href="#LIST AVAILABLE_ENGINES">"LIST AVAILABLE_ENGINES"<span> (</span><span class="info">Getting all available engines</span><span>)</span></a>
5205                        command (not encapsulated into apostrophes), &lt;filename&gt; the name
5206                        of the instrument's file to be deployed (encapsulated into apostrophes), &lt;instrument_index&gt; the index (integer value) of the instrument
5207                        within the given file, &lt;volume_value&gt; reflects the master
5208                        volume of the instrument as optionally dotted number (where a
5209                        value < 1.0 means attenuation and a value > 1.0 means
5210                        amplification). This parameter easily allows to adjust the
5211                        volume of all intruments within a custom instrument map
5212                        without having to adjust their instrument files. The
5213                        OPTIONAL &lt;instr_load_mode&gt; argument defines the life
5214                        time of the instrument, that is when the instrument should
5215                        be loaded, when freed and has exactly the following
5216                        possibilities:
5217    </p>
5218    <p>
5219                            </p>
5220    <blockquote class="text">
5221    <p>"ON_DEMAND" -
5222                                    </p>
5223    <blockquote class="text">
5224    <p>The instrument will be loaded when needed,
5225                                        that is when demanded by at least one sampler
5226                                        channel. It will immediately be freed from memory
5227                                        when not needed by any sampler channel anymore.
5228    </p>
5229    </blockquote>
5230                                
5231    
5232    <p>"ON_DEMAND_HOLD" -
5233                                    </p>
5234    <blockquote class="text">
5235    <p>The instrument will be loaded when needed,
5236                                        that is when demanded by at least one sampler
5237                                        channel. It will be kept in memory even when
5238                                        not needed by any sampler channel anymore.
5239                                        Instruments with this mode are only freed
5240                                        when the sampler is reset or all mapping
5241                                        entries with this mode (and respective
5242                                        instrument) are explicitly changed to
5243                                        "ON_DEMAND" and no sampler channel is using
5244                                        the instrument anymore.
5245    </p>
5246    </blockquote>
5247                                
5248    
5249    <p>"PERSISTENT" -
5250                                    </p>
5251    <blockquote class="text">
5252    <p>The instrument will immediately be loaded
5253                                        into memory in the background when this mapping
5254                                        command is sent and the instrument is kept all
5255                                        the time. Instruments with this mode are
5256                                        only freed when the sampler is reset or all
5257                                        mapping entries with this mode (and
5258                                        respective instrument) are explicitly
5259                                        changed to "ON_DEMAND" and no sampler
5260                                        channel is using the instrument anymore.
5261    </p>
5262    </blockquote>
5263                                
5264    
5265    <p>not supplied -
5266                                    </p>
5267    <blockquote class="text">
5268    <p>In case there is no &lt;instr_load_mode&gt;
5269                                        argument given, it will be up to the
5270                                        InstrumentManager to decide which mode to use.
5271                                        Usually it will use "ON_DEMAND" if an entry
5272                                        for the given instrument does not exist in
5273                                        the InstrumentManager's list yet, otherwise
5274                                        if an entry already exists, it will simply
5275                                        stick with the mode currently reflected by
5276                                        the already existing entry, that is it will
5277                                        not change the mode.
5278    </p>
5279    </blockquote>
5280                                
5281    
5282    </blockquote><p>
5283                        
5284    </p>
5285    <p>
5286                        The &lt;instr_load_mode&gt; argument thus allows to define an
5287                        appropriate strategy (low memory consumption vs. fast
5288                        instrument switching) for each instrument individually. Note, the
5289                        following restrictions apply to this argument: "ON_DEMAND_HOLD" and
5290                        "PERSISTENT" have to be supported by the respective sampler engine
5291                        (which is technically the case when the engine provides an
5292                        InstrumentManager for its format). If this is not the case the
5293                        argument will automatically fall back to the default value
5294                        "ON_DEMAND". Also the load mode of one instrument may
5295                        automatically change the laod mode of other instrument(s), i.e.
5296                        because the instruments are part of the same file and the
5297                        engine does not allow a way to manage load modes for them
5298                        individually. Due to this, in case the frontend shows the
5299                        load modes of entries, the frontend should retrieve the actual
5300                        mode by i.e. sending
5301                        <a class="info" href="#GET MIDI_INSTRUMENT INFO">"GET MIDI_INSTRUMENT INFO"<span> (</span><span class="info">Get current settings of MIDI instrument map entry</span><span>)</span></a>
5302                        command(s). Finally the OPTIONAL &lt;name&gt; argument allows to
5303                        set a custom name (encapsulated into apostrophes) for the mapping
5304                        entry, useful for frontends for displaying an appropriate name for
5305                        mapped instruments (using
5306                        <a class="info" href="#GET MIDI_INSTRUMENT INFO">"GET MIDI_INSTRUMENT INFO"<span> (</span><span class="info">Get current settings of MIDI instrument map entry</span><span>)</span></a>).
5307                        
5308    </p>
5309    <p>
5310                        The "MAP MIDI_INSTRUMENT" command
5311                        will immediately return, thus it will not block when an
5312                        instrument is to be loaded due to a "PERSISTENT" type
5313                        entry as instruments are loaded in the background. As a
5314                        consequence this command may not necessarily return an error
5315                        i.e. when the given instrument file does not exist or may
5316                        turn out to be corrupt.
5317                        
5318    </p>
5319    <p>Possible Answers:
5320    </p>
5321    <p>
5322                            </p>
5323    <blockquote class="text">
5324    <p>"OK" -
5325                                    </p>
5326    <blockquote class="text">
5327    <p>usually
5328    </p>
5329    </blockquote>
5330                                
5331    
5332    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5333                                    </p>
5334    <blockquote class="text">
5335    <p>when the given engine does not exist or a value
5336                                        is out of range
5337    </p>
5338    </blockquote>
5339                                
5340    
5341    </blockquote><p>
5342                        
5343    </p>
5344    <p>Examples:
5345    </p>
5346    <p>
5347                            </p>
5348    <blockquote class="text">
5349    <p>C: "MAP MIDI_INSTRUMENT 3 0 0 gig '/usr/share/Steinway D.gig' 0 0.8 PERSISTENT"
5350    </p>
5351    <p>S: "OK"
5352    </p>
5353    </blockquote><p>
5354                        
5355    </p>
5356    <p>
5357                            </p>
5358    <blockquote class="text">
5359    <p>C: "MAP MIDI_INSTRUMENT 127 4 50 gig '/home/john/foostrings.gig' 7 1.0"
5360    </p>
5361    <p>S: "OK"
5362    </p>
5363    </blockquote><p>
5364                        
5365    </p>
5366    <p>
5367                            </p>
5368    <blockquote class="text">
5369    <p>C: "MAP MIDI_INSTRUMENT 0 0 0 gig '/usr/share/piano.gig' 0 1.0 'Normal Piano'"
5370    </p>
5371    <p>S: "OK"
5372    </p>
5373    <p>C: "MAP MIDI_INSTRUMENT 1 0 0 gig '/usr/share/piano.gig' 0 0.25 'Silent Piano'"
5374    </p>
5375    <p>S: "OK"
5376    </p>
5377    </blockquote><p>
5378                        
5379    </p>
5380    <p>
5381                            </p>
5382    <blockquote class="text">
5383    <p>C: "MAP MIDI_INSTRUMENT 99 8 120 gig '/home/joe/foodrums.gig' 0 1.0 PERSISTENT 'Foo Drumkit'"
5384    </p>
5385    <p>S: "OK"
5386    </p>
5387    </blockquote><p>
5388                        
5389    </p>
5390    <a name="GET MIDI_INSTRUMENTS"></a><br /><hr />
5391    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5392    <a name="rfc.section.6.7.2"></a><h3>6.7.2.&nbsp;Getting ammount of MIDI instrument map entries</h3>
5393    
5394    <p>The front-end can query the amount of currently existing MIDI
5395                        instrument map entries by sending the following
5396                        command:
5397    </p>
5398    <p>
5399                            </p>
5400    <blockquote class="text">
5401    <p>GET MIDI_INSTRUMENTS
5402    </p>
5403    </blockquote><p>
5404                        
5405    </p>
5406    <p>Possible Answers:
5407    </p>
5408    <p>
5409                            </p>
5410    <blockquote class="text">
5411    <p>LinuxSampler will answer by sending the current number of
5412                                entries in the sampler's MIDI instrument map.
5413    </p>
5414  </blockquote><p>  </blockquote><p>
5415                        
5416    </p>
5417    <p>Example:
5418    </p>
5419    <p>
5420                            </p>
5421    <blockquote class="text">
5422    <p>C: "GET MIDI_INSTRUMENTS"
5423    </p>
5424    <p>S: "634"
5425    </p>
5426    </blockquote><p>
5427                        
5428    </p>
5429    <a name="LIST MIDI_INSTRUMENTS"></a><br /><hr />
5430    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5431    <a name="rfc.section.6.7.3"></a><h3>6.7.3.&nbsp;Getting indeces of all MIDI instrument map entries</h3>
5432    
5433    <p>The front-end can query a list of all currently existing MIDI
5434                        instrument map entries by sending the following command:
5435    </p>
5436    <p>
5437                            </p>
5438    <blockquote class="text">
5439    <p>LIST MIDI_INSTRUMENTS
5440  </p>  </p>
5441  </blockquote><p>  </blockquote><p>
5442                        
5443    </p>
5444    <p>Possible Answers:
5445    </p>
5446    <p>
5447                            </p>
5448    <blockquote class="text">
5449    <p>LinuxSampler will answer by sending a comma separated
5450                                list of MIDI bank MSB (coarse) - MIDI bank LSB (fine) -
5451                                MIDI program triples, where each triple is encapsulated
5452                                into curly braces. The list is returned in one single
5453                                line. Each triple just reflects the key of the respective
5454                                map entry, thus subsequent
5455                                <a class="info" href="#GET MIDI_INSTRUMENT INFO">"GET MIDI_INSTRUMENT INFO"<span> (</span><span class="info">Get current settings of MIDI instrument map entry</span><span>)</span></a>
5456                                command(s) are necessary to retrieve detailed informations
5457                                about each entry.
5458    </p>
5459    </blockquote><p>
5460                        
5461    </p>
5462    <p>Example:
5463    </p>
5464    <p>
5465                            </p>
5466    <blockquote class="text">
5467    <p>C: "LIST MIDI_INSTRUMENTS"
5468    </p>
5469    <p>S: "{0,0,0},{0,0,1},{120,0,3},{120,0,4},{23,127,127}"
5470    </p>
5471    </blockquote><p>
5472                        
5473    </p>
5474    <a name="UNMAP MIDI_INSTRUMENT"></a><br /><hr />
5475    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5476    <a name="rfc.section.6.7.4"></a><h3>6.7.4.&nbsp;Remove an entry from the MIDI instrument map</h3>
5477    
5478    <p>The front-end can delete an entry from the MIDI instrument
5479                        map by sending the following command:
5480    </p>
5481    <p>
5482                            </p>
5483    <blockquote class="text">
5484    <p>UNMAP MIDI_INSTRUMENT &lt;midi_bank_msb&gt; &lt;midi_bank_lsb&gt; &lt;midi_prog&gt;
5485  </p>  </p>
5486  </blockquote><p>  </blockquote><p>
5487                        
5488    </p>
5489    <p>
5490                        Where &lt;midi_bank_msb&gt; is an integer value between 0..127
5491                        reflecting the MIDI bank MSB (coarse) value, &lt;midi_bank_lsb&gt;
5492                        an integer value between 0..127 reflecting the MIDI bank LSB
5493                        (fine) value and &lt;midi_prog&gt; an integer value between
5494                        0..127 reflecting the MIDI program value of the map entrie's key
5495                        index triple.
5496                        
5497    </p>
5498    <p>Possible Answers:
5499    </p>
5500    <p>
5501                            </p>
5502    <blockquote class="text">
5503    <p>"OK" -
5504                                    </p>
5505    <blockquote class="text">
5506    <p>usually
5507    </p>
5508    </blockquote>
5509                                
5510    
5511    <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
5512                                    </p>
5513    <blockquote class="text">
5514    <p>when index out of bounds
5515  </p>  </p>
5516    </blockquote>
5517                                
5518    
5519    </blockquote><p>
5520                        
5521    </p>
5522    <p>Example:
5523    </p>
5524    <p>
5525                            </p>
5526    <blockquote class="text">
5527    <p>C: "UNMAP MIDI_INSTRUMENT 2 40 127"
5528    </p>
5529    <p>S: "OK"
5530    </p>
5531    </blockquote><p>
5532                        
5533    </p>
5534    <a name="GET MIDI_INSTRUMENT INFO"></a><br /><hr />
5535    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5536    <a name="rfc.section.6.7.5"></a><h3>6.7.5.&nbsp;Get current settings of MIDI instrument map entry</h3>
5537    
5538    <p>The front-end can retrieve the current settings of a certain
5539                        instrument map entry by sending the following command:
5540    </p>
5541    <p>
5542                            </p>
5543    <blockquote class="text">
5544    <p>GET MIDI_INSTRUMENT INFO &lt;midi_bank_msb&gt; &lt;midi_bank_lsb&gt; &lt;midi_prog&gt;
5545    </p>
5546    </blockquote><p>
5547                        
5548    </p>
5549    <p>
5550                        Where &lt;midi_bank_msb&gt; is an integer value between 0..127
5551                        reflecting the MIDI bank MSB (coarse) value, &lt;midi_bank_lsb&gt;
5552                        an integer value between 0..127 reflecting the MIDI bank LSB
5553                        (fine) value and &lt;midi_prog&gt; an integer value between
5554                        0..127 reflecting the MIDI program value of the map entrie's key
5555                        index triple.
5556                        
5557    </p>
5558    <p>Possible Answers:
5559    </p>
5560    <p>
5561                            </p>
5562    <blockquote class="text">
5563    <p>LinuxSampler will answer by sending a &lt;CRLF&gt;
5564                                separated list. Each answer line begins with the
5565                                information category name followed by a colon and then
5566                                a space character &lt;SP&gt; and finally the info
5567                                character string to that info category. At the moment
5568                                the following categories are defined:
5569    </p>
5570    <p>"NAME" -
5571                                    </p>
5572    <blockquote class="text">
5573    <p>Name for this MIDI instrument map entry (if defined).
5574                                        This name shall be used by frontends for displaying a
5575                                        name for this mapped instrument. It can be set and
5576                                        changed with the
5577                                        <a class="info" href="#MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"<span> (</span><span class="info">Create or replace a MIDI instrument map entry</span><span>)</span></a>
5578                                        command and does not have to be unique.
5579    </p>
5580    </blockquote>
5581                                
5582    
5583    <p>"ENGINE_NAME" -
5584                                    </p>
5585    <blockquote class="text">
5586    <p>Name of the engine to be deployed for this
5587                                        instrument.
5588    </p>
5589    </blockquote>
5590                                
5591    
5592    <p>"INSTRUMENT_FILE" -
5593                                    </p>
5594    <blockquote class="text">
5595    <p>File name of the instrument.
5596    </p>
5597    </blockquote>
5598                                
5599    
5600    <p>"INSTRUMENT_NR" -
5601                                    </p>
5602    <blockquote class="text">
5603    <p>Index of the instrument within the file.
5604    </p>
5605    </blockquote>
5606                                
5607    
5608    <p>"INSTRUMENT_NAME" -
5609                                    </p>
5610    <blockquote class="text">
5611    <p>Name of the loaded instrument as reflected by its file.
5612                                        In contrast to the "NAME" field, the "INSTRUMENT_NAME" field
5613                                        cannot be changed.
5614    </p>
5615    </blockquote>
5616                                
5617    
5618    <p>"LOAD_MODE" -
5619                                    </p>
5620    <blockquote class="text">
5621    <p>Life time of instrument
5622                                        (see <a class="info" href="#MAP MIDI_INSTRUMENT">"MAP MIDI_INSTRUMENT"<span> (</span><span class="info">Create or replace a MIDI instrument map entry</span><span>)</span></a> for details about this setting).
5623    </p>
5624    </blockquote>
5625                                
5626    
5627    <p>"VOLUME" -
5628                                    </p>
5629    <blockquote class="text">
5630    <p>master volume of the instrument as optionally
5631                                        dotted number (where a value < 1.0 means attenuation
5632                                        and a value > 1.0 means amplification)
5633    </p>
5634    </blockquote>
5635                                
5636    
5637  <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.
5638                      Other fields might be added in future.  </p>
5639    </blockquote><p>
5640                        
5641    </p>
5642    <p>Example:
5643    </p>
5644    <p>
5645                            </p>
5646    <blockquote class="text">
5647    <p>C: "GET MIDI_INSTRUMENT INFO 3 45 120"
5648    </p>
5649    <p>S: "NAME: Drums for Foo Song"
5650    </p>
5651    <p>&nbsp;&nbsp;&nbsp;"ENGINE_NAME: GigEngine"
5652    </p>
5653    <p>&nbsp;&nbsp;&nbsp;"INSTRUMENT_FILE: /usr/share/joesdrumkit.gig"
5654    </p>
5655    <p>&nbsp;&nbsp;&nbsp;"INSTRUMENT_NR: 0"
5656    </p>
5657    <p>&nbsp;&nbsp;&nbsp;"INSTRUMENT_NAME: Joe's Drumkit"
5658    </p>
5659    <p>&nbsp;&nbsp;&nbsp;"LOAD_MODE: PERSISTENT"
5660    </p>
5661    <p>&nbsp;&nbsp;&nbsp;"VOLUME: 1.0"
5662    </p>
5663    <p>&nbsp;&nbsp;&nbsp;"."
5664    </p>
5665    </blockquote><p>
5666                        
5667    </p>
5668    <a name="CLEAR MIDI_INSTRUMENTS"></a><br /><hr />
5669    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
5670    <a name="rfc.section.6.7.6"></a><h3>6.7.6.&nbsp;Clear MIDI instrument map</h3>
5671    
5672    <p>The front-end can clear the whole MIDI instrument map, that
5673                        is delete all entries by sending the following command:
5674    </p>
5675    <p>
5676                            </p>
5677    <blockquote class="text">
5678    <p>CLEAR MIDI_INSTRUMENTS
5679    </p>
5680    </blockquote><p>
5681                        
5682    </p>
5683    <p>Possible Answers:
5684    </p>
5685    <p>
5686                            </p>
5687    <blockquote class="text">
5688    <p>"OK" -
5689                                    </p>
5690    <blockquote class="text">
5691    <p>always
5692    </p>
5693    </blockquote>
5694                                
5695    
5696    </blockquote><p>
5697                        
5698    </p>
5699    <p>Example:
5700    </p>
5701    <p>
5702                           </p>
5703    <blockquote class="text">
5704    <p>C: "CLEAR MIDI_INSTRUMENTS"
5705    </p>
5706    <p>S: "OK"
5707    </p>
5708    </blockquote><p>
5709                        
5710  </p>  </p>
5711  <a name="command_syntax"></a><br /><hr />  <a name="command_syntax"></a><br /><hr />
5712  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
# Line 4946  Intellectual Property and Copyright Stat Line 5715  Intellectual Property and Copyright Stat
5715  <p>The grammar of the control protocol as descibed in <a class="info" href="#control_commands">Section&nbsp;6<span> (</span><span class="info">Description for control commands</span><span>)</span></a>  <p>The grammar of the control protocol as descibed in <a class="info" href="#control_commands">Section&nbsp;6<span> (</span><span class="info">Description for control commands</span><span>)</span></a>
5716              is defined below using Backus-Naur Form (BNF as described in <a class="info" href="#RFC2234">[RFC2234]<span> (</span><span class="info">Crocker, D. and P. Overell, &ldquo;Augmented BNF for Syntax Specifications,&rdquo; 1997.</span><span>)</span></a>)              is defined below using Backus-Naur Form (BNF as described in <a class="info" href="#RFC2234">[RFC2234]<span> (</span><span class="info">Crocker, D. and P. Overell, &ldquo;Augmented BNF for Syntax Specifications,&rdquo; 1997.</span><span>)</span></a>)
5717              where applicable.              where applicable.
5718                
5719  </p>  </p>
5720  <p>input =  <p>input =
5721          </p>          </p>
5722  <blockquote class="text">  <blockquote class="text">
5723  <p>line LF  <p>line LF
5724                    
5725  </p>  </p>
5726  <p>/ line CR LF  <p>/ line CR LF
5727                    
5728  </p>  </p>
5729  </blockquote><p>  </blockquote><p>
5730    
# Line 4964  Intellectual Property and Copyright Stat Line 5733  Intellectual Property and Copyright Stat
5733          </p>          </p>
5734  <blockquote class="text">  <blockquote class="text">
5735  <p>/* epsilon (empty line ignored) */  <p>/* epsilon (empty line ignored) */
5736                    
5737  </p>  </p>
5738  <p>/ comment  <p>/ comment
5739                    
5740  </p>  </p>
5741  <p>/ command  <p>/ command
5742                    
5743  </p>  </p>
5744  <p>/ error  <p>/ error
5745                    
5746  </p>  </p>
5747  </blockquote><p>  </blockquote><p>
5748    
# Line 4982  Intellectual Property and Copyright Stat Line 5751  Intellectual Property and Copyright Stat
5751          </p>          </p>
5752  <blockquote class="text">  <blockquote class="text">
5753  <p>'#'  <p>'#'
5754                    
5755  </p>  </p>
5756  <p>/ comment '#'  <p>/ comment '#'
5757                    
5758  </p>  </p>
5759  <p>/ comment SP  <p>/ comment SP
5760                    
5761  </p>  </p>
5762  <p>/ comment number  <p>/ comment number
5763                    
5764  </p>  </p>
5765  <p>/ comment string  <p>/ comment string
5766                    
5767  </p>  </p>
5768  </blockquote><p>  </blockquote><p>
5769    
# Line 5003  Intellectual Property and Copyright Stat Line 5772  Intellectual Property and Copyright Stat
5772          </p>          </p>
5773  <blockquote class="text">  <blockquote class="text">
5774  <p>ADD SP CHANNEL  <p>ADD SP CHANNEL
5775                    
5776    </p>
5777    <p>/ MAP SP map_instruction
5778                    
5779    </p>
5780    <p>/ UNMAP SP unmap_instruction
5781                    
5782  </p>  </p>
5783  <p>/ GET SP get_instruction  <p>/ GET SP get_instruction
5784                    
5785  </p>  </p>
5786  <p>/ CREATE SP create_instruction  <p>/ CREATE SP create_instruction
5787                    
5788  </p>  </p>
5789  <p>/ DESTROY SP destroy_instruction  <p>/ DESTROY SP destroy_instruction
5790                    
5791  </p>  </p>
5792  <p>/ LIST SP list_instruction  <p>/ LIST SP list_instruction
5793                    
5794  </p>  </p>
5795  <p>/ LOAD SP load_instruction  <p>/ LOAD SP load_instruction
5796                    
5797  </p>  </p>
5798  <p>/ REMOVE SP CHANNEL SP sampler_channel  <p>/ REMOVE SP remove_instruction
5799    
5800                    
5801  </p>  </p>
5802  <p>/ SET SP set_instruction  <p>/ SET SP set_instruction
5803                    
5804  </p>  </p>
5805  <p>/ SUBSCRIBE SP subscribe_event  <p>/ SUBSCRIBE SP subscribe_event
5806                    
5807  </p>  </p>
5808  <p>/ UNSUBSCRIBE SP unsubscribe_event  <p>/ UNSUBSCRIBE SP unsubscribe_event
5809                    
5810  </p>  </p>
5811  <p>/ SELECT SP text  <p>/ SELECT SP text
5812                    
5813  </p>  </p>
5814  <p>/ RESET SP CHANNEL SP sampler_channel  <p>/ RESET SP reset_instruction
5815                    
5816    </p>
5817    <p>/ CLEAR SP clear_instruction
5818                    
5819  </p>  </p>
5820  <p>/ RESET  <p>/ RESET
5821                    
5822  </p>  </p>
5823  <p>/ QUIT  <p>/ QUIT
5824                    
5825  </p>  </p>
5826  </blockquote><p>  </blockquote><p>
5827    
# Line 5051  Intellectual Property and Copyright Stat Line 5830  Intellectual Property and Copyright Stat
5830          </p>          </p>
5831  <blockquote class="text">  <blockquote class="text">
5832  <p>CHANNEL_COUNT  <p>CHANNEL_COUNT
5833                    
5834  </p>  </p>
5835  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
5836                    
5837  </p>  </p>
5838  <p>/ STREAM_COUNT  <p>/ STREAM_COUNT
5839                    
5840  </p>  </p>
5841  <p>/ BUFFER_FILL  <p>/ BUFFER_FILL
5842                    
5843  </p>  </p>
5844  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
5845                    
5846  </p>  </p>
5847  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
5848                    
5849    </p>
5850    <p>/ TOTAL_VOICE_COUNT
5851                    
5852  </p>  </p>
5853  </blockquote><p>  </blockquote><p>
5854    
# Line 5075  Intellectual Property and Copyright Stat Line 5857  Intellectual Property and Copyright Stat
5857          </p>          </p>
5858  <blockquote class="text">  <blockquote class="text">
5859  <p>CHANNEL_COUNT  <p>CHANNEL_COUNT
5860                    
5861  </p>  </p>
5862  <p>/ VOICE_COUNT  <p>/ VOICE_COUNT
5863                    
5864  </p>  </p>
5865  <p>/ STREAM_COUNT  <p>/ STREAM_COUNT
5866                    
5867  </p>  </p>
5868  <p>/ BUFFER_FILL  <p>/ BUFFER_FILL
5869                    
5870  </p>  </p>
5871  <p>/ CHANNEL_INFO  <p>/ CHANNEL_INFO
5872                    
5873  </p>  </p>
5874  <p>/ MISCELLANEOUS  <p>/ MISCELLANEOUS
5875                    
5876    </p>
5877    <p>/ TOTAL_VOICE_COUNT
5878                    
5879    </p>
5880    </blockquote><p>
5881    
5882  </p>  </p>
5883    <p>map_instruction =
5884            </p>
5885    <blockquote class="text">
5886    <p>MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value
5887                    
5888    </p>
5889    <p>/ MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode
5890                    
5891    </p>
5892    <p>/ MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP entry_name
5893                    
5894    </p>
5895    <p>/ MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog SP engine_name SP filename SP instrument_index SP volume_value SP instr_load_mode SP entry_name
5896                    
5897    </p>
5898    </blockquote><p>
5899    
5900    </p>
5901    <p>unmap_instruction =
5902            </p>
5903    <blockquote class="text">
5904    <p>MIDI_INSTRUMENT SP midi_bank_msb SP midi_bank_lsb SP midi_prog
5905                    
5906    </p>
5907    </blockquote><p>
5908    
5909    </p>
5910    <p>remove_instruction =
5911            </p>
5912    <blockquote class="text">
5913    <p>CHANNEL SP sampler_channel
5914                    
5915    </p>
5916  </blockquote><p>  </blockquote><p>
5917    
5918  </p>  </p>
# Line 5099  Intellectual Property and Copyright Stat Line 5920  Intellectual Property and Copyright Stat
5920          </p>          </p>
5921  <blockquote class="text">  <blockquote class="text">
5922  <p>AVAILABLE_ENGINES  <p>AVAILABLE_ENGINES
5923                    
5924  </p>  </p>
5925  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS
5926                    
5927  </p>  </p>
5928  <p>/ MIDI_INPUT_DRIVER SP INFO SP string  <p>/ MIDI_INPUT_DRIVER SP INFO SP string
5929                    
5930  </p>  </p>
5931  <p>/ MIDI_INPUT_DRIVER_PARAMETER SP INFO SP string SP string  <p>/ MIDI_INPUT_DRIVER_PARAMETER SP INFO SP string SP string
5932                    
5933  </p>  </p>
5934  <p>/ MIDI_INPUT_DRIVER_PARAMETER SP INFO SP string SP string SP key_val_list  <p>/ MIDI_INPUT_DRIVER_PARAMETER SP INFO SP string SP string SP key_val_list
5935                    
5936  </p>  </p>
5937  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
5938                    
5939  </p>  </p>
5940  <p>/ AUDIO_OUTPUT_DRIVER SP INFO SP string  <p>/ AUDIO_OUTPUT_DRIVER SP INFO SP string
5941                    
5942  </p>  </p>
5943  <p>/ AUDIO_OUTPUT_DRIVER_PARAMETER SP INFO SP string SP string  <p>/ AUDIO_OUTPUT_DRIVER_PARAMETER SP INFO SP string SP string
5944                    
5945  </p>  </p>
5946  <p>/ AUDIO_OUTPUT_DRIVER_PARAMETER SP INFO SP string SP string SP key_val_list  <p>/ AUDIO_OUTPUT_DRIVER_PARAMETER SP INFO SP string SP string SP key_val_list
5947                    
5948  </p>  </p>
5949  <p>/ AUDIO_OUTPUT_DEVICES  <p>/ AUDIO_OUTPUT_DEVICES
5950                    
5951  </p>  </p>
5952  <p>/ MIDI_INPUT_DEVICES  <p>/ MIDI_INPUT_DEVICES
5953                    
5954  </p>  </p>
5955  <p>/ AUDIO_OUTPUT_DEVICE SP INFO SP number  <p>/ AUDIO_OUTPUT_DEVICE SP INFO SP number
5956                    
5957  </p>  </p>
5958  <p>/ MIDI_INPUT_DEVICE SP INFO SP number  <p>/ MIDI_INPUT_DEVICE SP INFO SP number
5959                    
5960  </p>  </p>
5961  <p>/ MIDI_INPUT_PORT SP INFO SP number SP number  <p>/ MIDI_INPUT_PORT SP INFO SP number SP number
5962                    
5963  </p>  </p>
5964  <p>/ MIDI_INPUT_PORT_PARAMETER SP INFO SP number SP number SP string  <p>/ MIDI_INPUT_PORT_PARAMETER SP INFO SP number SP number SP string
5965                    
5966  </p>  </p>
5967  <p>/ AUDIO_OUTPUT_CHANNEL SP INFO SP number SP number  <p>/ AUDIO_OUTPUT_CHANNEL SP INFO SP number SP number
5968                    
5969  </p>  </p>
5970  <p>/ AUDIO_OUTPUT_CHANNEL_PARAMETER SP INFO SP number SP number SP string  <p>/ AUDIO_OUTPUT_CHANNEL_PARAMETER SP INFO SP number SP number SP string
5971                    
5972  </p>  </p>
5973  <p>/ CHANNELS  <p>/ CHANNELS
5974                    
5975  </p>  </p>
5976  <p>/ CHANNEL SP INFO SP sampler_channel  <p>/ CHANNEL SP INFO SP sampler_channel
5977                    
5978  </p>  </p>
5979  <p>/ CHANNEL SP BUFFER_FILL SP buffer_size_type SP sampler_channel  <p>/ CHANNEL SP BUFFER_FILL SP buffer_size_type SP sampler_channel
5980                    
5981  </p>  </p>
5982  <p>/ CHANNEL SP STREAM_COUNT SP sampler_channel  <p>/ CHANNEL SP STREAM_COUNT SP sampler_channel
5983                    
5984  </p>  </p>
5985  <p>/ CHANNEL SP VOICE_COUNT SP sampler_channel  <p>/ CHANNEL SP VOICE_COUNT SP sampler_channel
5986                    
5987  </p>  </p>
5988  <p>/ ENGINE SP INFO SP engine_name  <p>/ ENGINE SP INFO SP engine_name
5989                    
5990  </p>  </p>
5991  <p>/ SERVER SP INFO  <p>/ SERVER SP INFO
5992                    
5993    </p>
5994    <p>/ TOTAL_VOICE_COUNT
5995                    
5996    </p>
5997    <p>/ TOTAL_VOICE_COUNT_MAX
5998                    
5999    </p>
6000    <p>/ MIDI_INSTRUMENTS
6001                    
6002    </p>
6003    <p>/ MIDI_INSTRUMENT SP INFO SP midi_bank_msb SP midi_bank_lsb SP midi_prog
6004                    
6005  </p>  </p>
6006  </blockquote><p>  </blockquote><p>
6007    
# Line 5177  Intellectual Property and Copyright Stat Line 6010  Intellectual Property and Copyright Stat
6010          </p>          </p>
6011  <blockquote class="text">  <blockquote class="text">
6012  <p>AUDIO_OUTPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list  <p>AUDIO_OUTPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list
6013                    
6014  </p>  </p>
6015  <p>/ AUDIO_OUTPUT_CHANNEL_PARAMETER SP number SP number SP string '=' param_val_list  <p>/ AUDIO_OUTPUT_CHANNEL_PARAMETER SP number SP number SP string '=' param_val_list
6016                    
6017  </p>  </p>
6018  <p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list  <p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list
6019                    
6020  </p>  </p>
6021  <p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' param_val_list  <p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' param_val_list
6022                    
6023  </p>  </p>
6024  <p>/ CHANNEL SP set_chan_instruction  <p>/ CHANNEL SP set_chan_instruction
6025                    
6026  </p>  </p>
6027  <p>/ ECHO SP boolean  <p>/ ECHO SP boolean
6028                    
6029  </p>  </p>
6030  </blockquote><p>  </blockquote><p>
6031    
# Line 5201  Intellectual Property and Copyright Stat Line 6034  Intellectual Property and Copyright Stat
6034          </p>          </p>
6035  <blockquote class="text">  <blockquote class="text">
6036  <p>AUDIO_OUTPUT_DEVICE SP string SP key_val_list  <p>AUDIO_OUTPUT_DEVICE SP string SP key_val_list
6037                    
6038  </p>  </p>
6039  <p>/ AUDIO_OUTPUT_DEVICE SP string  <p>/ AUDIO_OUTPUT_DEVICE SP string
6040                    
6041  </p>  </p>
6042  <p>/ MIDI_INPUT_DEVICE SP string SP key_val_list  <p>/ MIDI_INPUT_DEVICE SP string SP key_val_list
6043                    
6044  </p>  </p>
6045  <p>/ MIDI_INPUT_DEVICE SP string  <p>/ MIDI_INPUT_DEVICE SP string
6046                    
6047    </p>
6048    </blockquote><p>
6049    
6050  </p>  </p>
6051    <p>reset_instruction =
6052            </p>
6053    <blockquote class="text">
6054    <p>CHANNEL SP sampler_channel
6055                    
6056    </p>
6057    </blockquote><p>
6058    
6059    </p>
6060    <p>clear_instruction =
6061            </p>
6062    <blockquote class="text">
6063    <p>MIDI_INSTRUMENTS
6064                    
6065    </p>
6066  </blockquote><p>  </blockquote><p>
6067    
6068  </p>  </p>
# Line 5219  Intellectual Property and Copyright Stat Line 6070  Intellectual Property and Copyright Stat
6070          </p>          </p>
6071  <blockquote class="text">  <blockquote class="text">
6072  <p>AUDIO_OUTPUT_DEVICE SP number  <p>AUDIO_OUTPUT_DEVICE SP number
6073                    
6074  </p>  </p>
6075  <p>/ MIDI_INPUT_DEVICE SP number  <p>/ MIDI_INPUT_DEVICE SP number
6076                    
6077  </p>  </p>
6078  </blockquote><p>  </blockquote><p>
6079    
# Line 5231  Intellectual Property and Copyright Stat Line 6082  Intellectual Property and Copyright Stat
6082          </p>          </p>
6083  <blockquote class="text">  <blockquote class="text">
6084  <p>INSTRUMENT SP load_instr_args  <p>INSTRUMENT SP load_instr_args
6085                    
6086  </p>  </p>
6087  <p>/ ENGINE SP load_engine_args  <p>/ ENGINE SP load_engine_args
6088                    
6089  </p>  </p>
6090  </blockquote><p>  </blockquote><p>
6091    
# Line 5243  Intellectual Property and Copyright Stat Line 6094  Intellectual Property and Copyright Stat
6094          </p>          </p>
6095  <blockquote class="text">  <blockquote class="text">
6096  <p>AUDIO_OUTPUT_DEVICE SP sampler_channel SP device_index  <p>AUDIO_OUTPUT_DEVICE SP sampler_channel SP device_index
6097                    
6098  </p>  </p>
6099  <p>/ AUDIO_OUTPUT_CHANNEL SP sampler_channel SP audio_channel_index SP audio_channel_index  <p>/ AUDIO_OUTPUT_CHANNEL SP sampler_channel SP audio_channel_index SP audio_channel_index
6100                    
6101  </p>  </p>
6102  <p>/ AUDIO_OUTPUT_TYPE SP sampler_channel SP audio_output_type_name  <p>/ AUDIO_OUTPUT_TYPE SP sampler_channel SP audio_output_type_name
6103                    
6104  </p>  </p>
6105  <p>/ MIDI_INPUT SP sampler_channel SP device_index SP midi_input_port_index SP midi_input_channel_index  <p>/ MIDI_INPUT SP sampler_channel SP device_index SP midi_input_port_index SP midi_input_channel_index
6106                    
6107  </p>  </p>
6108  <p>/ MIDI_INPUT_DEVICE SP sampler_channel SP device_index  <p>/ MIDI_INPUT_DEVICE SP sampler_channel SP device_index
6109                    
6110  </p>  </p>
6111  <p>/ MIDI_INPUT_PORT SP sampler_channel SP midi_input_port_index  <p>/ MIDI_INPUT_PORT SP sampler_channel SP midi_input_port_index
6112                    
6113  </p>  </p>
6114  <p>/ MIDI_INPUT_CHANNEL SP sampler_channel SP midi_input_channel_index  <p>/ MIDI_INPUT_CHANNEL SP sampler_channel SP midi_input_channel_index
6115                    
6116  </p>  </p>
6117  <p>/ MIDI_INPUT_TYPE SP sampler_channel SP midi_input_type_name  <p>/ MIDI_INPUT_TYPE SP sampler_channel SP midi_input_type_name
6118                    
6119  </p>  </p>
6120  <p>/ VOLUME SP sampler_channel SP volume_value  <p>/ VOLUME SP sampler_channel SP volume_value
6121                    
6122  </p>  </p>
6123  <p>/ MUTE SP sampler_channel SP boolean  <p>/ MUTE SP sampler_channel SP boolean
6124                    
6125  </p>  </p>
6126  <p>/ SOLO SP sampler_channel SP boolean  <p>/ SOLO SP sampler_channel SP boolean
6127                    
6128  </p>  </p>
6129  </blockquote><p>  </blockquote><p>
6130    
# Line 5282  Intellectual Property and Copyright Stat Line 6133  Intellectual Property and Copyright Stat
6133          </p>          </p>
6134  <blockquote class="text">  <blockquote class="text">
6135  <p>string '=' param_val_list  <p>string '=' param_val_list
6136                    
6137  </p>  </p>
6138  <p>/ key_val_list SP string '=' param_val_list  <p>/ key_val_list SP string '=' param_val_list
6139                    
6140  </p>  </p>
6141  </blockquote><p>  </blockquote><p>
6142    
# Line 5294  Intellectual Property and Copyright Stat Line 6145  Intellectual Property and Copyright Stat
6145          </p>          </p>
6146  <blockquote class="text">  <blockquote class="text">
6147  <p>BYTES  <p>BYTES
6148                    
6149  </p>  </p>
6150  <p>/ PERCENTAGE  <p>/ PERCENTAGE
6151                    
6152  </p>  </p>
6153  </blockquote><p>  </blockquote><p>
6154    
# Line 5306  Intellectual Property and Copyright Stat Line 6157  Intellectual Property and Copyright Stat
6157          </p>          </p>
6158  <blockquote class="text">  <blockquote class="text">
6159  <p>AUDIO_OUTPUT_DEVICES  <p>AUDIO_OUTPUT_DEVICES
6160                    
6161  </p>  </p>
6162  <p>/ MIDI_INPUT_DEVICES  <p>/ MIDI_INPUT_DEVICES
6163                    
6164  </p>  </p>
6165  <p>/ CHANNELS  <p>/ CHANNELS
6166                    
6167  </p>  </p>
6168  <p>/ AVAILABLE_ENGINES  <p>/ AVAILABLE_ENGINES
6169                    
6170  </p>  </p>
6171  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS  <p>/ AVAILABLE_MIDI_INPUT_DRIVERS
6172                    
6173  </p>  </p>
6174  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS  <p>/ AVAILABLE_AUDIO_OUTPUT_DRIVERS
6175                    
6176    </p>
6177    <p>/ MIDI_INSTRUMENTS
6178                    
6179  </p>  </p>
6180  </blockquote><p>  </blockquote><p>
6181    
# Line 5330  Intellectual Property and Copyright Stat Line 6184  Intellectual Property and Copyright Stat
6184          </p>          </p>
6185  <blockquote class="text">  <blockquote class="text">
6186  <p>filename SP instrument_index SP sampler_channel  <p>filename SP instrument_index SP sampler_channel
6187                    
6188  </p>  </p>
6189  <p>/ NON_MODAL SP filename SP instrument_index SP sampler_channel  <p>/ NON_MODAL SP filename SP instrument_index SP sampler_channel
6190                    
6191  </p>  </p>
6192  </blockquote><p>  </blockquote><p>
6193    
# Line 5342  Intellectual Property and Copyright Stat Line 6196  Intellectual Property and Copyright Stat
6196          </p>          </p>
6197  <blockquote class="text">  <blockquote class="text">
6198  <p>engine_name SP sampler_channel  <p>engine_name SP sampler_channel
6199                    
6200    </p>
6201    </blockquote><p>
6202    
6203  </p>  </p>
6204    <p>instr_load_mode =
6205            </p>
6206    <blockquote class="text">
6207    <p>ON_DEMAND
6208                    
6209    </p>
6210    <p>/ ON_DEMAND_HOLD
6211                    
6212    </p>
6213    <p>/ PERSISTENT
6214                    
6215    </p>
6216  </blockquote><p>  </blockquote><p>
6217    
6218  </p>  </p>
# Line 5351  Intellectual Property and Copyright Stat Line 6220  Intellectual Property and Copyright Stat
6220          </p>          </p>
6221  <blockquote class="text">  <blockquote class="text">
6222  <p>number  <p>number
6223                    
6224  </p>  </p>
6225  </blockquote><p>  </blockquote><p>
6226    
# Line 5360  Intellectual Property and Copyright Stat Line 6229  Intellectual Property and Copyright Stat
6229          </p>          </p>
6230  <blockquote class="text">  <blockquote class="text">
6231  <p>number  <p>number
6232                    
6233  </p>  </p>
6234  </blockquote><p>  </blockquote><p>
6235    
# Line 5369  Intellectual Property and Copyright Stat Line 6238  Intellectual Property and Copyright Stat
6238          </p>          </p>
6239  <blockquote class="text">  <blockquote class="text">
6240  <p>string  <p>string
6241                    
6242  </p>  </p>
6243  </blockquote><p>  </blockquote><p>
6244    
# Line 5378  Intellectual Property and Copyright Stat Line 6247  Intellectual Property and Copyright Stat
6247          </p>          </p>
6248  <blockquote class="text">  <blockquote class="text">
6249  <p>number  <p>number
6250                    
6251  </p>  </p>
6252  </blockquote><p>  </blockquote><p>
6253    
# Line 5387  Intellectual Property and Copyright Stat Line 6256  Intellectual Property and Copyright Stat
6256          </p>          </p>
6257  <blockquote class="text">  <blockquote class="text">
6258  <p>number  <p>number
6259                    
6260  </p>  </p>
6261  <p>/ ALL  <p>/ ALL
6262                    
6263  </p>  </p>
6264  </blockquote><p>  </blockquote><p>
6265    
# Line 5399  Intellectual Property and Copyright Stat Line 6268  Intellectual Property and Copyright Stat
6268          </p>          </p>
6269  <blockquote class="text">  <blockquote class="text">
6270  <p>string  <p>string
6271                    
6272    </p>
6273    </blockquote><p>
6274    
6275    </p>
6276    <p>midi_bank_msb =
6277            </p>
6278    <blockquote class="text">
6279    <p>number
6280                    
6281    </p>
6282    </blockquote><p>
6283    
6284    </p>
6285    <p>midi_bank_lsb =
6286            </p>
6287    <blockquote class="text">
6288    <p>number
6289                    
6290    </p>
6291    </blockquote><p>
6292    
6293  </p>  </p>
6294    <p>midi_prog =
6295            </p>
6296    <blockquote class="text">
6297    <p>number
6298                    
6299    </p>
6300  </blockquote><p>  </blockquote><p>
6301    
6302  </p>  </p>
# Line 5408  Intellectual Property and Copyright Stat Line 6304  Intellectual Property and Copyright Stat
6304          </p>          </p>
6305  <blockquote class="text">  <blockquote class="text">
6306  <p>dotnum  <p>dotnum
6307                    
6308  </p>  </p>
6309  <p>/ number  <p>/ number
6310                    
6311  </p>  </p>
6312  </blockquote><p>  </blockquote><p>
6313    
# Line 5420  Intellectual Property and Copyright Stat Line 6316  Intellectual Property and Copyright Stat
6316          </p>          </p>
6317  <blockquote class="text">  <blockquote class="text">
6318  <p>number  <p>number
6319                    
6320  </p>  </p>
6321  </blockquote><p>  </blockquote><p>
6322    
# Line 5429  Intellectual Property and Copyright Stat Line 6325  Intellectual Property and Copyright Stat
6325          </p>          </p>
6326  <blockquote class="text">  <blockquote class="text">
6327  <p>number  <p>number
6328                    
6329  </p>  </p>
6330  </blockquote><p>  </blockquote><p>
6331    
# Line 5438  Intellectual Property and Copyright Stat Line 6334  Intellectual Property and Copyright Stat
6334          </p>          </p>
6335  <blockquote class="text">  <blockquote class="text">
6336  <p>string  <p>string
6337                    
6338  </p>  </p>
6339  </blockquote><p>  </blockquote><p>
6340    
# Line 5447  Intellectual Property and Copyright Stat Line 6343  Intellectual Property and Copyright Stat
6343          </p>          </p>
6344  <blockquote class="text">  <blockquote class="text">
6345  <p>stringval  <p>stringval
6346                    
6347    </p>
6348    </blockquote><p>
6349    
6350  </p>  </p>
6351    <p>entry_name =
6352            </p>
6353    <blockquote class="text">
6354    <p>stringval
6355                    
6356    </p>
6357  </blockquote><p>  </blockquote><p>
6358    
6359  </p>  </p>
# Line 5456  Intellectual Property and Copyright Stat Line 6361  Intellectual Property and Copyright Stat
6361          </p>          </p>
6362  <blockquote class="text">  <blockquote class="text">
6363  <p>param_val  <p>param_val
6364                    
6365  </p>  </p>
6366  <p>/ param_val_list','param_val  <p>/ param_val_list','param_val
6367                    
6368  </p>  </p>
6369  </blockquote><p>  </blockquote><p>
6370    
# Line 5468  Intellectual Property and Copyright Stat Line 6373  Intellectual Property and Copyright Stat
6373          </p>          </p>
6374  <blockquote class="text">  <blockquote class="text">
6375  <p>string  <p>string
6376                    
6377  </p>  </p>
6378  <p>/ '\'' string '\''  <p>/ stringval
6379                    
 </p>  
 <p>/ '\"' string '\"'  
   
6380  </p>  </p>
6381  <p>/ number  <p>/ number
6382                    
6383  </p>  </p>
6384  <p>/ dotnum  <p>/ dotnum
6385                    
6386  </p>  </p>
6387  </blockquote><p>  </blockquote><p>
6388    
# Line 5491  Intellectual Property and Copyright Stat Line 6393  Intellectual Property and Copyright Stat
6393    
6394  <p>This chapter will describe all currently defined events supported by LinuxSampler.  <p>This chapter will describe all currently defined events supported by LinuxSampler.
6395  </p>  </p>
6396  <a name="rfc.section.8.1"></a><h4><a name="SUBSCRIBE CHANNEL">8.1</a>&nbsp;Number of sampler channels changed</h4>  <a name="SUBSCRIBE CHANNEL"></a><br /><hr />
6397    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6398    <a name="rfc.section.8.1"></a><h3>8.1.&nbsp;Number of sampler channels changed</h3>
6399    
6400  <p>Client may want to be notified when the total number of channels on the  <p>Client may want to be notified when the total number of channels on the
6401                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 5502  Intellectual Property and Copyright Stat Line 6406  Intellectual Property and Copyright Stat
6406  <p>SUBSCRIBE CHANNEL_COUNT  <p>SUBSCRIBE CHANNEL_COUNT
6407  </p>  </p>
6408  </blockquote><p>  </blockquote><p>
6409                    
6410  </p>  </p>
6411  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
6412  </p>  </p>
# Line 5512  Intellectual Property and Copyright Stat Line 6416  Intellectual Property and Copyright Stat
6416  <p>"NOTIFY:CHANNEL_COUNT:&lt;channels&gt;"  <p>"NOTIFY:CHANNEL_COUNT:&lt;channels&gt;"
6417  </p>  </p>
6418  </blockquote><p>  </blockquote><p>
6419                    
6420  </p>  </p>
6421  <p>where &lt;channels&gt; will be replaced by the new number  <p>where &lt;channels&gt; will be replaced by the new number
6422                  of sampler channels.                  of sampler channels.
6423  </p>  </p>
6424  <a name="rfc.section.8.2"></a><h4><a name="SUBSCRIBE VOICE_COUNT">8.2</a>&nbsp;Number of active voices changed</h4>  <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
6425    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6426    <a name="rfc.section.8.2"></a><h3>8.2.&nbsp;Number of active voices changed</h3>
6427    
6428  <p>Client may want to be notified when the number of voices on the  <p>Client may want to be notified when the number of voices on the
6429                  back-end changes by issuing the following command:                  back-end changes by issuing the following command:
# Line 5528  Intellectual Property and Copyright Stat Line 6434  Intellectual Property and Copyright Stat
6434  <p>SUBSCRIBE VOICE_COUNT  <p>SUBSCRIBE VOICE_COUNT
6435  </p>  </p>
6436  </blockquote><p>  </blockquote><p>
6437                    
6438  </p>  </p>
6439  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
6440  </p>  </p>
# Line 5538  Intellectual Property and Copyright Stat Line 6444  Intellectual Property and Copyright Stat
6444  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;  <p>"NOTIFY:VOICE_COUNT:&lt;sampler-channel&gt; &lt;voices&gt;
6445  </p>  </p>
6446  </blockquote><p>  </blockquote><p>
6447                    
6448  </p>  </p>
6449  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the
6450                  voice count change occurred and &lt;voices&gt; by the new number of                  voice count change occurred and &lt;voices&gt; by the new number of
6451                  active voices on that channel.                  active voices on that channel.
6452  </p>  </p>
6453  <a name="rfc.section.8.3"></a><h4><a name="SUBSCRIBE STREAM_COUNT">8.3</a>&nbsp;Number of active disk streams changed</h4>  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
6454    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6455    <a name="rfc.section.8.3"></a><h3>8.3.&nbsp;Number of active disk streams changed</h3>
6456    
6457  <p>Client may want to be notified when the number of streams on the back-end  <p>Client may want to be notified when the number of streams on the back-end
6458                  changes by issuing the following command: SUBSCRIBE STREAM_COUNT                  changes by issuing the following command: SUBSCRIBE STREAM_COUNT
# Line 5555  Intellectual Property and Copyright Stat Line 6463  Intellectual Property and Copyright Stat
6463  <p>SUBSCRIBE STREAM_COUNT  <p>SUBSCRIBE STREAM_COUNT
6464  </p>  </p>
6465  </blockquote><p>  </blockquote><p>
6466                    
6467  </p>  </p>
6468  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
6469  </p>  </p>
# Line 5565  Intellectual Property and Copyright Stat Line 6473  Intellectual Property and Copyright Stat
6473  <p>"NOTIFY:STREAM_COUNT:&lt;sampler-channel&gt; &lt;streams&gt;"  <p>"NOTIFY:STREAM_COUNT:&lt;sampler-channel&gt; &lt;streams&gt;"
6474  </p>  </p>
6475  </blockquote><p>  </blockquote><p>
6476                    
6477  </p>  </p>
6478  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the
6479                  stream count change occurred and &lt;streams&gt; by the new number of                  stream count change occurred and &lt;streams&gt; by the new number of
6480                  active disk streams on that channel.                  active disk streams on that channel.
6481  </p>  </p>
6482  <a name="rfc.section.8.4"></a><h4><a name="SUBSCRIBE BUFFER_FILL">8.4</a>&nbsp;Disk stream buffer fill state changed</h4>  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
6483    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6484    <a name="rfc.section.8.4"></a><h3>8.4.&nbsp;Disk stream buffer fill state changed</h3>
6485    
6486  <p>Client may want to be notified when the buffer fill state of a disk stream  <p>Client may want to be notified when the buffer fill state of a disk stream
6487                  on the back-end changes by issuing the following command:                  on the back-end changes by issuing the following command:
# Line 5582  Intellectual Property and Copyright Stat Line 6492  Intellectual Property and Copyright Stat
6492  <p>SUBSCRIBE BUFFER_FILL  <p>SUBSCRIBE BUFFER_FILL
6493  </p>  </p>
6494  </blockquote><p>  </blockquote><p>
6495                    
6496  </p>  </p>
6497  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
6498  </p>  </p>
# Line 5592  Intellectual Property and Copyright Stat Line 6502  Intellectual Property and Copyright Stat
6502  <p>"NOTIFY:BUFFER_FILL:&lt;sampler-channel&gt; &lt;fill-data&gt;"  <p>"NOTIFY:BUFFER_FILL:&lt;sampler-channel&gt; &lt;fill-data&gt;"
6503  </p>  </p>
6504  </blockquote><p>  </blockquote><p>
6505                    
6506  </p>  </p>
6507  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the
6508                  buffer fill state change occurred on and &lt;fill-data&gt; will be replaced by the                  buffer fill state change occurred on and &lt;fill-data&gt; will be replaced by the
6509                  buffer fill data for this channel as described in <a class="info" href="#GET CHANNEL BUFFER_FILL">Section&nbsp;6.4.13<span> (</span><span class="info">Current fill state of disk stream buffers</span><span>)</span></a>                  buffer fill data for this channel as described in <a class="info" href="#GET CHANNEL BUFFER_FILL">Section&nbsp;6.4.13<span> (</span><span class="info">Current fill state of disk stream buffers</span><span>)</span></a>
6510                  as if the <a class="info" href="#GET CHANNEL BUFFER_FILL">"GET CHANNEL BUFFER_FILL PERCENTAGE"<span> (</span><span class="info">Current fill state of disk stream buffers</span><span>)</span></a> command was issued on this channel.                  as if the <a class="info" href="#GET CHANNEL BUFFER_FILL">"GET CHANNEL BUFFER_FILL PERCENTAGE"<span> (</span><span class="info">Current fill state of disk stream buffers</span><span>)</span></a> command was issued on this channel.
6511  </p>  </p>
6512  <a name="rfc.section.8.5"></a><h4><a name="SUBSCRIBE INFO">8.5</a>&nbsp;Channel information changed</h4>  <a name="SUBSCRIBE INFO"></a><br /><hr />
6513    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6514    <a name="rfc.section.8.5"></a><h3>8.5.&nbsp;Channel information changed</h3>
6515    
6516  <p>Client may want to be notified when changes were made to sampler channels on the  <p>Client may want to be notified when changes were made to sampler channels on the
6517                  back-end by issuing the following command:                  back-end by issuing the following command:
# Line 5610  Intellectual Property and Copyright Stat Line 6522  Intellectual Property and Copyright Stat
6522  <p>SUBSCRIBE CHANNEL_INFO  <p>SUBSCRIBE CHANNEL_INFO
6523  </p>  </p>
6524  </blockquote><p>  </blockquote><p>
6525                    
6526  </p>  </p>
6527  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
6528  </p>  </p>
# Line 5620  Intellectual Property and Copyright Stat Line 6532  Intellectual Property and Copyright Stat
6532  <p>"NOTIFY:CHANNEL_INFO:&lt;sampler-channel&gt;"  <p>"NOTIFY:CHANNEL_INFO:&lt;sampler-channel&gt;"
6533  </p>  </p>
6534  </blockquote><p>  </blockquote><p>
6535                    
6536  </p>  </p>
6537  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the  <p>where &lt;sampler-channel&gt; will be replaced by the sampler channel the
6538                  channel info change occurred. The front-end will have to send                  channel info change occurred. The front-end will have to send
# Line 5629  Intellectual Property and Copyright Stat Line 6541  Intellectual Property and Copyright Stat
6541                  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
6542                  message is sufficient here.                  message is sufficient here.
6543  </p>  </p>
6544  <a name="rfc.section.8.6"></a><h4><a name="SUBSCRIBE MISCELLANEOUS">8.6</a>&nbsp;Miscellaneous and debugging events</h4>  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
6545    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6546    <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;Total number of active voices changed</h3>
6547    
6548    <p>Client may want to be notified when the total number of voices on the
6549                    back-end changes by issuing the following command:
6550    </p>
6551    <p>
6552                        </p>
6553    <blockquote class="text">
6554    <p>SUBSCRIBE TOTAL_VOICE_COUNT
6555    </p>
6556    </blockquote><p>
6557                    
6558    </p>
6559    <p>Server will start sending the following notification messages:
6560    </p>
6561    <p>
6562                        </p>
6563    <blockquote class="text">
6564    <p>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;
6565    </p>
6566    </blockquote><p>
6567                    
6568    </p>
6569    <p>where &lt;voices&gt; will be replaced by the new number of
6570                    all currently active voices.
6571    </p>
6572    <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
6573    <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6574    <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;Miscellaneous and debugging events</h3>
6575    
6576  <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
6577                  the server by issuing the following command:                  the server by issuing the following command:
# Line 5640  Intellectual Property and Copyright Stat Line 6582  Intellectual Property and Copyright Stat
6582  <p>SUBSCRIBE MISCELLANEOUS  <p>SUBSCRIBE MISCELLANEOUS
6583  </p>  </p>
6584  </blockquote><p>  </blockquote><p>
6585                    
6586  </p>  </p>
6587  <p>Server will start sending the following notification messages:  <p>Server will start sending the following notification messages:
6588  </p>  </p>
# Line 5650  Intellectual Property and Copyright Stat Line 6592  Intellectual Property and Copyright Stat
6592  <p>"NOTIFY:MISCELLANEOUS:&lt;string&gt;"  <p>"NOTIFY:MISCELLANEOUS:&lt;string&gt;"
6593  </p>  </p>
6594  </blockquote><p>  </blockquote><p>
6595                    
6596  </p>  </p>
6597  <p>where &lt;string&gt; will be replaced by whatever data server  <p>where &lt;string&gt; will be replaced by whatever data server
6598                  wants to send to the client. Client MAY display this data to the                  wants to send to the client. Client MAY display this data to the
6599                  user AS IS to facilitate debugging.                  user AS IS to facilitate debugging.
6600  </p>  </p>
6601  <a name="anchor14"></a><br /><hr />  <a name="anchor15"></a><br /><hr />
6602  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6603  <a name="rfc.section.9"></a><h3>9.&nbsp;Security Considerations</h3>  <a name="rfc.section.9"></a><h3>9.&nbsp;Security Considerations</h3>
6604    
# Line 5665  Intellectual Property and Copyright Stat Line 6607  Intellectual Property and Copyright Stat
6607              connect, running LinuxSampler might be a security risk for the host              connect, running LinuxSampler might be a security risk for the host
6608              system the LinuxSampler instance is running on.              system the LinuxSampler instance is running on.
6609  </p>  </p>
6610  <a name="anchor15"></a><br /><hr />  <a name="anchor16"></a><br /><hr />
6611  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
6612  <a name="rfc.section.10"></a><h3>10.&nbsp;Acknowledgments</h3>  <a name="rfc.section.10"></a><h3>10.&nbsp;Acknowledgments</h3>
6613    
# Line 5685  Intellectual Property and Copyright Stat Line 6627  Intellectual Property and Copyright Stat
6627  <p>Grigor Iliev  <p>Grigor Iliev
6628  </p>  </p>
6629  </blockquote><p>  </blockquote><p>
6630                
6631  </p>  </p>
6632  <a name="rfc.references1"></a><br /><hr />  <a name="rfc.references1"></a><br /><hr />
6633  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>  <table summary="layout" cellpadding="0" cellspacing="2" class="bug" align="right"><tr><td class="bug"><a href="#toc" class="link2">&nbsp;TOC&nbsp;</a></td></tr></table>
# Line 5743  required to practice this standard. Plea Line 6685  required to practice this standard. Plea
6685  information to the IETF Executive Director.</p>  information to the IETF Executive Director.</p>
6686  <h3>Full Copyright Statement</h3>  <h3>Full Copyright Statement</h3>
6687  <p class='copyright'>  <p class='copyright'>
6688  Copyright &copy; The Internet Society (2005). All Rights Reserved.</p>  Copyright &copy; The Internet Society (2006). All Rights Reserved.</p>
6689  <p class='copyright'>  <p class='copyright'>
6690  This document and translations of it may be copied and furnished to  This document and translations of it may be copied and furnished to
6691  others, and derivative works that comment on or otherwise explain it  others, and derivative works that comment on or otherwise explain it
Legend:
Removed from v.708  
changed lines
  Added in v.945
  ViewVC Help
Powered by ViewVC